Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Use o CometAPI como provedor de modelos para o OpenClaw — mais de 500 modelos 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

1

Obtenha sua chave de API do CometAPI

Faça login no console do CometAPI. Clique em Add API Key e copie sua chave <COMETAPI_KEY>.
Painel do CometAPI mostrando o botão Add API Key
Detalhes da chave de API do CometAPI com URL base
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
Em seguida, execute o assistente de configuração uma vez:
openclaw onboard --install-daemon
Durante o onboarding, escolha Skip na etapa Model/Auth se quiser configurar o CometAPI manualmente. Após o onboarding, confirme que o gateway está em execução:
openclaw gateway status
openclaw dashboard

​
Configuração

1

Armazene sua chave CometAPI

Grave sua chave em ~/.openclaw/.env para que fique disponível ao daemon sem ser codificada nos arquivos de configuração:
printf 'COMETAPI_KEY=%s\n' 'your-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Se você já injeta COMETAPI_KEY através do seu shell, gerenciador de serviços ou workflow de segredos, pule esta etapa — a configuração abaixo usa $\{COMETAPI_KEY\} independentemente de como a variável é definida.
2

Configure os provedores CometAPI

O CometAPI suporta quatro formatos de API. Adicione um ou mais blocos de provedor ao ~/.openclaw/openclaw.json:
ProvedorFormato da APIEndpoint chamadoBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /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 necessários ou manter todos os quatro para alternar entre formatos usando referências provider/model.Substitua cada placeholder your-...-model-id por um ID de modelo atual da página de Modelos do CometAPI que corresponda ao bloco do provedor.
Use cometapi-openai-responses (api: "openai-responses") para modelos que requerem a OpenAI Responses API. Use cometapi-openai (api: "openai-completions") para modelos no caminho clássico do 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 é necessário para esta configuração. As chaves dos provedores são resolvidas a partir de models.providers.*.apiKey via a variável de ambiente $\{COMETAPI_KEY\}. auth-profiles.json só é necessário se você quiser rotação de credenciais por perfil entre múltiplas chaves.

​
Verificação

1

Reiniciar e verificar

Reinicie o gateway após adicionar .env ou alterar a configuração do provedor:
openclaw gateway restart
Em seguida, execute o diagnóstico:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Uma configuração bem-sucedida apresenta:
  • openclaw models status resolve o modelo primário para cometapi-claude/your-claude-model-id sem avisos de autenticação ausente para provedores CometAPI
  • openclaw models list --provider cometapi-claude lista os modelos configurados
  • openclaw doctor não reporta erros de configuração ou autenticação para provedores CometAPI
Status dos modelos OpenClaw mostrando provedores CometAPI autenticados

​
Alternar modelos

1

Alternar modelos

# Definir o modelo padrão na configuração
openclaw models set cometapi-claude/your-claude-model-id

# Alternar para a sessão de chat atual
/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

Se você está corrigindo uma configuração antiga com problemas, pare o gateway, remova ~/.openclaw e execute o onboarding novamente antes de aplicar a configuração CometAPI:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Isso remove todas as configurações locais, sessões, logs, estado de autenticação e workspaces. Em seguida, siga as Etapas 3–5 novamente.