Saltar al contenido 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.

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

​
Prerrequisitos

​
Instalación

1

Obtén tu API key de CometAPI

Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu clave <COMETAPI_KEY>.
Panel de CometAPI mostrando el botón Add API Key
Detalles de la API key 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 el onboarding, elige Skip en el paso Model/Auth si quieres configurar CometAPI manualmente. Después del onboarding, confirma que el gateway esté en ejecución:
openclaw gateway status
openclaw dashboard

​
Configuración

1

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' 'your-<COMETAPI_KEY>-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Si ya inyectas COMETAPI_KEY a través de tu shell, gestor de servicios o flujo de secretos, omite este paso: la configuración de abajo usa $\{COMETAPI_KEY\} sin importar cómo se establezca la variable.
2

Configura los proveedores de CometAPI

CometAPI admite cuatro formatos de API. Añade uno o más bloques de proveedor a ~/.openclaw/openclaw.json:
ProviderAPI FormatEndpoint calledBase 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" }]
      }
    }
  }
}
Puedes dejar solo los proveedores que necesites, o mantener los cuatro para enrutar entre formatos usando referencias provider/model.Sustituye cada marcador your-...-model-id por un model ID actual de la página de modelos de CometAPI que coincida con el bloque de proveedor.
Usa cometapi-openai-responses (api: "openai-responses") para los modelos que requieren la OpenAI Responses API. 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 proveedor 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 múltiples claves.

​
Verificación

1

Reinicia y verifica

Reinicia el gateway después de añadir .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 muestra 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

1

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

Si estás corrigiendo una configuración antigua dañada, detén el gateway, elimina ~/.openclaw y luego vuelve a ejecutar el onboarding 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.