Referência

Configuração

Para conectar Kimi pela interface, abra Configurações → Conexões → Conectar por API e selecione Kimi / Moonshot. Use Obter chave Kimi, cole a chave e clique em Testar e salvar API; a URL e o formato da API já vêm preenchidos. Escolha um modelo do catálogo e use Ativar executor para esta conexão ou Preparar execução, conforme o status. Na missão, use Adicionar agente e selecione esse provedor, modelo e executor DSH. Se o K3 não aparecer, confira o acesso da conta na plataforma Kimi. Consultar o catálogo não testa geração nem ferramentas. Kimi, OpenAI, Grok/xAI, OpenRouter, OpenCode Go, FreeLLMAPI e APIs personalizadas podem ficar salvos ao mesmo tempo, com credenciais separadas. O gateway antigo continua disponível para compatibilidade.

Para usar Grok como CLI, abra Configurações → Conexões → Usar ou instalar CLI e escolha Grok CLI · comunidade. Instale pelo botão no servidor (Linux x64 ou macOS arm64), ou siga o link do projeto. O adaptador suporta o CLI superagent-ai/grok-cli. Use a autenticação existente em ~/.grok/user-settings.json ou GROK_API_KEY; também é possível salvar uma chave cifrada na própria tela do CLI. Não é necessário cadastrar uma conexão por API. Clique em Verificar CLI no servidor e adicione Grok CLI à missão, com executor CLI e o modelo desejado. O teste verifica o executável e a presença da credencial; acesso e saldo são confirmados ao executar tarefas. A ponte MCP usa configurações separadas por painel, preservando o arquivo do usuário.

O CLI lê o ambiente do processo. Não há carregamento automático de .env. Exporte variáveis antes de iniciar ou use seu gerenciador de processos. Não grave segredos no Git.

VariávelUso / padrão
COCKPIT_HOSTCLI: 127.0.0.1; script npm start: 0.0.0.0 se ausente/vazia.
COCKPIT_PORTPorta; 4000.
COCKPIT_TOKENToken mestre API/WS; autenticação por token desativada se ausente.
COCKPIT_LOG_LEVELLog; info.
COCKPIT_STATIC_DIRPasta alternativa da SPA com index.html e assets.
COCKPIT_HOMERaízes globais de projetos, catálogo, skills e DSH; não muda <cwd>/.cockpit dos motores.
COCKPIT_PROJECTS_FILEArquivo alternativo de projetos recentes.
COCKPIT_CATALOG_PATHPasta com um cockpit.json externo a usar como catálogo. Opcional: sem ela, o Cockpit usa o catálogo embutido e não procura em pastas vizinhas.
COCKPIT_CATALOG_CONFIGCaminho direto para cockpit.json, com precedência sobre COCKPIT_CATALOG_PATH.
DSH_REPO_PATHCheckout DSH; padrão histórico /DATA/Projetos/deepseek-harness.
DSH_BINEntrypoint; padrão <DSH_REPO_PATH>/apps/cli/lib/bin.js.
DSH_HOMEDados isolados; padrão ~/.cockpit/dsh-home ou <COCKPIT_HOME>/dsh-home.
CODEX_HOMELocal do cache de modelos usado pela descoberta do Codex.
OPENAI_API_KEY, ANTHROPIC_API_KEYConfiguração dos agentes, conforme o modo de autenticação do CLI.
GEMINI_API_KEY, ELEVENLABS_API_KEY, REPLICATE_API_TOKENProvedores de mídia; GPT Image também usa OPENAI_API_KEY.

Exemplo Bash:

export COCKPIT_PORT=4100
export COCKPIT_HOST=127.0.0.1
npm start

COCKPIT_CONNECTION_FILE, COCKPIT_URL, COCKPIT_MISSION_ID e COCKPIT_PANE_ID são contexto da ponte, normalmente injetado. Não invente IDs nem reutilize conexão de outra instância.

#Catálogo v1

Sem v1, há catálogo embutido. Quando encontra cockpit.json, ele pode fornecer perfis, receitas, runners, modelos, mídia, ambientes e pools de contas. Use configuração confiável: pode definir comandos executados no servidor. O código também lê cofre legado quando disponível; v1 continua opcional.