Use OpenClaw com CometAPI

Use o CometAPI como provedor de model para o OpenClaw — mais de 500 models em uma única API.

Pré-requisitos

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

Instalação

Obtenha sua chave de API da CometAPI

Faça login no console do CometAPI. Clique em Add API Key e copie sua chave de API da CometAPI.

Painel do CometAPI mostrando o botão Add API Key

Detalhes da chave de API da CometAPI com URL base

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

Em seguida, execute o assistente de configuração uma vez:

openclaw onboard --install-daemon

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

openclaw gateway status
openclaw dashboard

Configuração

Armazene sua chave da CometAPI

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

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

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

Configure os provedores CometAPI

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

Provedor	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 provedores de que precisa ou manter os quatro para rotear entre formatos usando referências provider/model.Substitua cada placeholder your-...-model-id por um model ID atual da página de modelos da CometAPI que corresponda ao bloco do provedor.

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 a mesma baseUrl (https://api.cometapi.com/v1); a única diferença é qual endpoint downstream o OpenClaw chama.

O arquivo auth-profiles.json não é obrigatório para esta configuração. As chaves do provedor são resolvidas a partir de models.providers.*.apiKey por meio da variável de ambiente $\{COMETAPI_KEY\}. auth-profiles.json só é necessário se você quiser rotação de credenciais por perfil entre várias chaves.

Verificação

Reinicie e verifique

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

openclaw gateway restart

Em seguida, execute os diagnósticos:

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

Uma configuração bem-sucedida fica assim:

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

OpenClaw models status mostrando providers CometAPI autenticados

Alternar modelos

# 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

Solução de problemas

Reinstalação limpa (opcional)

Se você estiver corrigindo uma configuração antiga com problemas, pare o gateway, remova ~/.openclaw e, em seguida, execute novamente o onboarding antes de aplicar a configuração do 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.

Visão Geral

Agentes de programação de IA

Agentes de IA

Clientes de chat de IA

Tradução e idioma

Plataformas de automação

Observabilidade e avaliação

Frameworks de IA

Pré-requisitos

Instalação

Configuração

Verificação

Alternar modelos

Solução de problemas

​Pré-requisitos

​Instalação

​Configuração

​Verificação

​Alternar modelos

​Solução de problemas

Pré-requisitos

Instalação

Configuração

Verificação

Alternar modelos

Solução de problemas