Saltar al contenido principal
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.
Panel de CometAPI que muestra el botón Add API Key
Detalles de la clave API de CometAPI con la URL base
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:
ProviderFormato de APIEndpoint llamadoURL base
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" }]
      }
    }
  }
}
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
Estado de modelos de OpenClaw que muestra los providers de CometAPI autenticados
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
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.