nas-runbooks/common/OPENCODE-GO-MIGRATION.md

Migration OpenRouter → OpenCode Go — 2026-06-16

Objectif : basculer la stack LLM du NAS vers OpenCode Go (forfait Go, endpoint https://opencode.ai/zen/go/v1, auth Authorization: Bearer <clé> uniquement — pas de x-bf-vk, pas de HTTP-Referer/X-Title).

Modèles OpenCode Go

IDs sans préfixe (glm-5.1, deepseek-v4-pro…), PAS openrouter/ ni deepseek/. Utilisables en OpenAI-compat (oa-compat) : deepseek-v4-flash, deepseek-v4-pro, glm-5.1, qwen3.7-plus, kimi-k2.6, kimi-k2.7-code, minimax-m3, glm-5, qwen3.6-plus, mimo-v2.5-pro…

⚠️ NE FONCTIONNE PAS :

• qwen3.7-max → Model not supported for format oa-compat (dispo seulement en format Anthropic côté OpenCode Go). Tout consommateur OpenAI-compat (Bifrost custom provider, Open WebUI, family-help) doit utiliser glm-5.1 à la place.
• MiniMax M2.7 vision via OpenCode Go = prompt_tokens:0 (vision cassée).

Ce qui a été migré

Cible	Avant	Après	Clé
hermes-tt (config.yaml)	deepseek-v4-flash	défaut deepseek-v4-pro, fallback deepseek-v4-flash, délégation (data-engineer) deepseek-v4-pro	HERMES_TT_OPENCODE_KEY (provider opencode-go)
hermes-nyora	deepseek-v4-flash	défaut glm-5.1, fallback qwen3.7-plus	HERMES_NYORA_OPENCODE_KEY
hermes-perso	deepseek-v4-flash	défaut qwen3.7-plus, fallback deepseek-v4-flash	HERMES_PERSO_OPENCODE_KEY
Bifrost	—	provider opencode route glm-5.1, deepseek-v4-pro, qwen3.7-plus, kimi-k2.6, minimax-m3 ; alias claude-*→deepseek-v4-flash (openrouter) conservé	BIFROST_OPENCODE_KEY
Open WebUI	Bifrost seul	2e connexion directe OpenCode Go (OPENAI_API_BASE_URLS pluriel)	BIFROST_OPENCODE_KEY
family-help	OpenRouter (modèle unique)	routing par skill : medical/nutrition glm-5.1, homework qwen3.7-plus, legal_admin deepseek-v4-pro, tech/general deepseek-v4-flash ; fallback OpenRouter (web + erreur)	OPENCODE_API_KEY (=BIFROST_OPENCODE_KEY)
n8n actifs	commentaires/refs OpenRouter	nettoyés (NABIL.md Quotidien, Monitoring sources IA, Ingest Opportunités)	—

Hermes — config.yaml

Modèle défini dans /volume1/docker/hermes-platform/hermes-{tt,nyora,perso}/data/config.yaml : model.default + model.provider: opencode-go, fallback_providers[0], fallback_model. Hermes réécrit config.yaml au shutdown → procédure : docker stop → éditer → docker start (éditer container arrêté pour éviter le clobber). Healthcheck port 8642, API OpenAI-compat (/v1/chat/completions, modèle proxy hermes-agent).

Bifrost — PIÈGE MAJEUR (voir mémoire bifrost-keys-config-json)

Bifrost v1.5.13 ne recharge PAS les clés des providers au redémarrage (elles ne vivaient qu'en mémoire). Fix durable = /volume1/docker/bifrost/data/config.json (providers + clés, chargé au boot) + allow_all_keys=1 dans governance_virtual_key_provider_configs.

• Providers dans config.json NE doivent PAS être aussi dans le store (sqlite3 config.db "DELETE FROM config_providers; DELETE FROM config_keys;", bifrost stoppé).
• sqlite3 config.db "UPDATE governance_virtual_key_provider_configs SET allow_all_keys=1;".
• ⚠️ éditer providers/clés/VK via l'UI Bifrost peut re-casser (reset allow_all_keys / conflit config.json).
• Backup config.db pré-migration : /tmp/config.db.backup-* (NAS).

n8n — workflows AO inactifs : NON migrés (à faire délibérément)

Les 15 workflows AO/veille contenant encore OpenRouter sont archivés (isArchived=true) → l'API n8n refuse de les éditer (Cannot update an archived workflow). Le pipeline AO actif (AO — Insertion Baserow FINAL, hisVAANSYpixR4Si) est déjà propre. Pour réutiliser un workflow AO archivé : le désarchiver (UI), migrer son Code node (openrouter.ai/api/v1/chat/completions → opencode.ai/zen/go/v1/chat/completions, clé sk-or → OpenCode, retirer HTTP-Referer/X-Title, modèle → deepseek-v4-pro), re-tester, ré-archiver. Règle Code node n8n : require('https') + parsing manuel d'URL, jamais fetch/new URL/$helpers. Liste des archivés concernés : edFMGtI2HHWW72aT, JTwurk7XVBUXSHKn, BCgZYRJcxoHOMDhm, iuxVgZFfpKdYFNqG, xJtW4algsBcx6r1E, EEDr0xx9krRq2nwN, 7zWWJhP2aQbzQhZG, QALWT3NwMQjOuY6u, N3yQWk0XyhyS5wZX, hcOmozHadfBnHzri, nZiXRcwSAXsoj2M6, Mdl5SRcT9rYw48VZ, dPnpoHkc6hEXdsFF, wS3SzRFfcaDDD34g, xu4smQdEGrHFx1zK, RRKUk3GvnULj7edE.

Hors scope (laissés sur OpenRouter, actifs/famille — à migrer sur décision)

Workflows n8n actifs encore sur OpenRouter en direct (endpoint+clé) : Mode-nedya, FAMILLE | Recettes Weekend, Labellisation Auto.