> ## 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 OpenClaw con CometAPI
> Usa esta guía para configurar OpenClaw con CometAPI estableciendo la URL base, la clave API y las opciones de model o provider.
Usa [CometAPI](https://www.cometapi.com) como proveedor de modelos para [OpenClaw](https://openclaw.ai): más de 500 modelos en una sola API.
## Requisitos previos
* Node.js ≥ 22 — recomendado a través de [nvm](https://github.com/nvm-sh/nvm)
* Una cuenta de CometAPI con una clave API activa — [obtén la tuya aquí](https://www.cometapi.com/console/token)
## Instalación
Inicia sesión en la [consola de CometAPI](https://www.cometapi.com/console/token). Haz clic en **Add API Key** y copia tu clave API de CometAPI.
**Recomendado** — usa el instalador oficial:
```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```
O instálalo mediante npm:
```bash theme={null}
npm install -g openclaw@latest
```
Luego ejecuta el asistente de configuración una vez:
```bash theme={null}
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:
```bash theme={null}
openclaw gateway status
openclaw dashboard
```
## Configuración
Escribe tu clave en `~/.openclaw/.env` para que esté disponible para el daemon sin dejarla codificada directamente en los archivos de configuración:
```bash theme={null}
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.
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` |
```json theme={null}
{
"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](https://www.cometapi.com/models/) 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 el gateway después de agregar `.env` o cambiar la configuración del proveedor:
```bash theme={null}
openclaw gateway restart
```
Luego ejecuta los diagnósticos:
```bash theme={null}
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
## Cambiar modelos
```bash theme={null}
# 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 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:
```bash theme={null}
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.