Usa OpenClaw con CometAPI

Usa CometAPI como proveedor de modelos para OpenClaw: más de 500 modelos en una sola API.

Requisitos previos

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

Instalación

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 API de CometAPI.

Panel de CometAPI mostrando el botón Add API Key

Detalles de la clave API de CometAPI con la URL base

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

Configuración

Guarda tu clave de CometAPI

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

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

Si ya inyectas COMETAPI_KEY a través de tu shell, gestor de servicios o un flujo de secrets, omite este paso: la configuración de abajo usa $\{COMETAPI_KEY\} independientemente de cómo se establezca la variable.

Configura los providers de CometAPI

CometAPI admite cuatro formatos de API. Agrega 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 mantener solo los providers que necesites, o conservar los cuatro para enrutar entre formatos usando referencias provider/model.Reemplaza cada marcador your-...-model-id con un model ID actual de la página de modelos de CometAPI que coincida con el bloque de provider.

Usa cometapi-openai-responses (api: "openai-responses") para los modelos que requieren la API de OpenAI Responses. Usa cometapi-openai (api: "openai-completions") para los 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 se necesita si quieres rotación de credenciales por perfil entre múltiples claves.

Verificación

Reinicia y verifica

Reinicia el gateway después de agregar .env o cambiar la configuración del proveedor:

openclaw gateway restart

Luego ejecuta los 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 proveedores de CometAPI
openclaw models list --provider cometapi-claude enumera tus modelos configurados
openclaw doctor no informa errores de configuración ni de autenticación para los proveedores de CometAPI

Estado de modelos de OpenClaw mostrando proveedores de CometAPI autenticados

Cambiar 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

Solución de problemas

Reinstalación limpia (opcional)

Si estás corrigiendo una configuración anterior dañada, 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 espacios de trabajo. Luego sigue nuevamente los pasos 3–5.

Resumen general

Agentes de codificación de IA

Agentes de IA

Clientes de chat de IA

Traducción e idioma

Plataformas de automatización

Observabilidad y evaluación

Frameworks de IA

Requisitos previos

Instalación

Configuración

Verificación

Cambiar modelos

Solución de problemas

​Requisitos previos

​Instalación

​Configuración

​Verificación

​Cambiar modelos

​Solución de problemas

Requisitos previos

Instalación

Configuración

Verificación

Cambiar modelos

Solución de problemas