OpenClaw

Conecta OpenClaw a CometAPI: instala con curl o npm, guarda tu clave en ~/.openclaw/.env, configura los proveedores OpenAI/Anthropic/Google y ejecuta más de 500 modelos.

Usa CometAPI como proveedor de modelos para OpenClaw: más de 500 modelos en una sola API. Esta guía cubre el flujo de incorporación actual (2026.3.8+).

​

Requisitos previos

• Node.js ≥ 22 — recomendado mediante nvm
• Una cuenta de CometAPI con una clave API activa — obtén la tuya aquí

1. Obtén tu clave API de CometAPI

   Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu clave sk-xxxxx.

   

   
2. Instala o actualiza OpenClaw

   Recomendado — usa el instalador oficial:

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

   O instálalo mediante npm:

   npm install -g openclaw@latest
   

   Luego ejecuta el asistente de configuración una vez:

   openclaw onboard --install-daemon
   

   Durante la incorporación, elige Skip en el paso Model/Auth si quieres configurar CometAPI manualmente. Después de la incorporación, confirma que el gateway esté en ejecución:

   openclaw gateway status
   openclaw dashboard
   
3. Guarda tu clave de CometAPI

   Escribe tu clave en ~/.openclaw/.env para que esté disponible para el daemon sin codificarla directamente en los archivos de configuración:

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

   Si ya inyectas COMETAPI_KEY mediante tu shell, gestor de servicios o un flujo de secretos, omite este paso — la configuración de abajo usa $\{COMETAPI_KEY\} independientemente de cómo se establezca la variable.

4. Configura los providers de CometAPI

   CometAPI admite cuatro formatos de API. Añade uno o más bloques de provider a ~/.openclaw/openclaw.json:

   Provider	Formato de API	Endpoint llamado	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" }]
         }
       }
     }
   }
   

   Puedes conservar solo los providers que necesites, o mantener los cuatro para enrutar entre formatos usando referencias provider/model.

   Sustituye cada marcador your-...-model-id por un ID de modelo actual de la página de modelos de CometAPI que coincida con el bloque de provider.

   Usa cometapi-openai-responses (api: "openai-responses") para modelos que requieren la API OpenAI Responses. Usa cometapi-openai (api: "openai-completions") para modelos en la ruta clásica de Chat Completions. Ambos comparten el mismo baseUrl (https://api.cometapi.com/v1); la única diferencia es qué endpoint downstream llama OpenClaw.

   El archivo auth-profiles.json no es obligatorio para esta configuración. Las claves de provider se resuelven desde models.providers.*.apiKey mediante la variable de entorno $\{COMETAPI_KEY\}. auth-profiles.json solo es necesario si quieres rotación de credenciales por perfil entre varias claves.

5. Reinicia y verifica

   Reinicia el gateway después de añadir .env o cambiar la configuración del provider:

   openclaw gateway restart
   

   Luego ejecuta diagnósticos:

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

   Una configuración correcta se ve así:

   • openclaw models status resuelve el modelo principal a cometapi-claude/your-claude-model-id sin advertencias de autenticación faltante para los providers de CometAPI
   • openclaw models list --provider cometapi-claude muestra tus modelos configurados
   • openclaw doctor no informa errores de configuración ni autenticación para los providers de CometAPI

   
6. Cambia 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
   

Reinstalación limpia (opcional)

Si estás corrigiendo una configuración antigua que no funciona, detén el gateway, elimina ~/.openclaw y luego vuelve a ejecutar la incorporación antes de aplicar la configuración de CometAPI:

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

Esto elimina toda la configuración local, sesiones, registros, estado de autenticación y workspaces. Luego sigue de nuevo los pasos 3–5.