OpenClaw

Conecte o OpenClaw à CometAPI: instale via curl ou npm, armazene sua chave em ~/.openclaw/.env, configure provedores OpenAI/Anthropic/Google e execute mais de 500 modelos.

Use a CometAPI como provedor de modelos para o OpenClaw — mais de 500 modelos em uma única API. Este guia cobre o fluxo de onboarding atual (2026.3.8+).

​

Pré-requisitos

• Node.js ≥ 22 — recomendado via nvm
• Uma conta CometAPI com uma API key ativa — obtenha a sua aqui

1. Obtenha sua API key da CometAPI

   Faça login no console da CometAPI. Clique em Add API Key e copie sua chave sk-xxxxx.

   

   
2. Instale ou atualize o OpenClaw

   Recomendado — use o instalador oficial:

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Ou instale via npm:

   npm install -g openclaw@latest
   

   Depois, execute o assistente de configuração uma vez:

   openclaw onboard --install-daemon
   

   Durante o onboarding, escolha Skip na etapa Model/Auth se quiser configurar a CometAPI manualmente. Após o onboarding, confirme que o gateway está em execução:

   openclaw gateway status
   openclaw dashboard
   
3. Armazene sua chave da CometAPI

   Grave sua chave em ~/.openclaw/.env para que ela fique disponível ao daemon sem ser embutida diretamente em arquivos de configuração:

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   Se você já injeta COMETAPI_KEY pelo seu shell, gerenciador de serviços ou fluxo de secrets, pule esta etapa — a configuração abaixo usa $\{COMETAPI_KEY\} independentemente de como a variável é definida.

4. Configure os providers da CometAPI

   A CometAPI oferece suporte a quatro formatos de API. Adicione um ou mais blocos de provider em ~/.openclaw/openclaw.json:

   Provider	Formato de API	Endpoint chamado	URL base
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /v1beta/...	https://api.cometapi.com/v1beta

   {
     "agents": {
       "defaults": {
         "model": {
           "primary": "cometapi-claude/your-claude-model-id"
         }
       }
     },
     "models": {
       "mode": "merge",
       "providers": {
         "cometapi-openai": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-completions",
           "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
         },
         "cometapi-openai-responses": {
           "baseUrl": "https://api.cometapi.com/v1",
           "apiKey": "${COMETAPI_KEY}",
           "api": "openai-responses",
           "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
         },
         "cometapi-claude": {
           "baseUrl": "https://api.cometapi.com",
           "apiKey": "${COMETAPI_KEY}",
           "api": "anthropic-messages",
           "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
         },
         "cometapi-google": {
           "baseUrl": "https://api.cometapi.com/v1beta",
           "apiKey": "${COMETAPI_KEY}",
           "api": "google-generative-ai",
           "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
         }
       }
     }
   }
   

   Você pode manter apenas os providers de que precisa, ou manter os quatro para rotear entre formatos usando referências provider/model.

   Substitua cada placeholder your-...-model-id por um ID de modelo atual da página de Models da CometAPI que corresponda ao bloco de provider.

   Use cometapi-openai-responses (api: "openai-responses") para modelos que exigem a OpenAI Responses API. Use cometapi-openai (api: "openai-completions") para modelos no caminho clássico de Chat Completions. Ambos compartilham o mesmo baseUrl (https://api.cometapi.com/v1); a única diferença é qual endpoint downstream o OpenClaw chama.

   O arquivo auth-profiles.json não é necessário para esta configuração. As chaves de provider são resolvidas a partir de models.providers.*.apiKey via a variável de ambiente $\{COMETAPI_KEY\}. O auth-profiles.json só é necessário se você quiser rotação de credenciais por perfil em múltiplas chaves.

5. Reinicie e verifique

   Reinicie o gateway após adicionar .env ou alterar a configuração do provider:

   openclaw gateway restart
   

   Depois, execute os diagnósticos:

   openclaw models status
   openclaw models list --provider cometapi-claude
   openclaw doctor
   

   Uma configuração bem-sucedida se parece com isto:

   • openclaw models status resolve o modelo primário para cometapi-claude/your-claude-model-id sem avisos de autenticação ausente para os providers da CometAPI
   • openclaw models list --provider cometapi-claude lista seus modelos configurados
   • openclaw doctor não relata erros de configuração ou autenticação para os providers da CometAPI

   
6. Troque de modelo

   # Set the default model in config
   openclaw models set cometapi-claude/your-claude-model-id
   
   # Switch for the current chat session
   /model cometapi-openai/your-chat-model-id
   /model cometapi-openai-responses/your-responses-model-id
   /model cometapi-claude/your-claude-model-id
   /model cometapi-google/your-gemini-model-id
   

Reinstalação limpa (opcional)

Se você está corrigindo uma configuração antiga com problemas, pare o gateway, remova ~/.openclaw e depois execute novamente o onboarding antes de aplicar a configuração da CometAPI:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

Isso remove toda a configuração local, sessões, logs, estado de autenticação e workspaces. Depois, siga novamente as Etapas 3–5.