Usa OpenClaw con CometAPI

Usa esta guía para conectar OpenClaw a CometAPI. Elige un formato de API y un ID de modelo para la primera configuración.

OpenClaw v2026.8.1 también se conoce como OpenClaw 2.0. El paquete no utiliza un 2.x número de versión. Consulta el anuncio de OpenClaw 2.0 y las notas de la versión v2026.8.1.

Referencias oficiales de OpenClaw:

Requisitos previos

Node.js 22.22.3+, 24.15+ o 25.9+. Se recomienda Node 26. Node 23 no es compatible.
Una cuenta de CometAPI con una clave de API activa del panel.
Un ID de modelo de la página de modelos de CometAPI.

Instalación y actualizaciones

Primera instalación
Actualizar una instalación

El instalador oficial puede instalar la CLI sin iniciar la incorporación. Esto mantiene la configuración del modelo como un paso independiente.

macOS / Linux / WSL2
Windows PowerShell

El siguiente comando ejecuta el instalador oficial:

curl -fsSL https://openclaw.ai/install.sh \
  | bash -s -- --no-onboard

El siguiente comando ejecuta el instalador oficial de PowerShell:

& ([scriptblock]::Create(
  (iwr -useb https://openclaw.ai/install.ps1)
)) -NoOnboard

Si administras Node.js y npm por tu cuenta, npm 11.16+ y npm 12 aceptan la --allow-scripts opción. El siguiente comando instala OpenClaw sin iniciar la incorporación:

npm install -g openclaw@latest --allow-scripts=openclaw

En npm 11.15 y versiones anteriores, omite --allow-scripts=openclaw porque esa versión de npm no reconoce la opción.Confirma que la CLI instalada cumple la versión mínima para esta guía:

openclaw --version

Continúa con Configurar CometAPI. No realices primero la incorporación estándar, porque el flujo guiado no expone todos los adaptadores de API personalizados. adaptadores.

Crea y verifica una copia de seguridad antes de una actualización importante. El archivo puede contener claves de API, estado de canales y datos de autenticación, así que protégelo como proteges el directorio de estado de OpenClaw.Los siguientes comandos crean la copia de seguridad y actualizan OpenClaw:

mkdir -p ~/Backups/openclaw
openclaw backup create --output ~/Backups/openclaw --verify
openclaw update

Después de la actualización, repara las migraciones compatibles y comprueba el estado de Gateway:

openclaw doctor --fix
openclaw gateway restart
openclaw health

Una actualización conserva la ruta de modelo configurada. No repitas la incorporación a menos que quieras cambiar el proveedor del modelo o su autenticación.

Configurar CometAPI

Usar la incorporación clásica

La incorporación clásica es la vía preferida para la primera instalación de Chat Completions, Responses y Anthropic Messages. El siguiente comando abre la incorporación clásica e instala el servicio en segundo plano servicio:

openclaw onboard --classic --install-daemon

En Model/Auth, elija Custom Provider. A continuación, introduzca los valores de una de estas opciones de compatibilidad:

Formato de API	ID del proveedor	Opción de compatibilidad	URL base
Chat Completions	`cometapi-openai`	Compatible con OpenAI	`https://api.cometapi.com/v1`
Responses	`cometapi-openai-responses`	Compatible con OpenAI Responses	`https://api.cometapi.com/v1`
Anthropic Messages	`cometapi-claude`	Compatible con Anthropic	`https://api.cometapi.com`

Introduzca el ID de proveedor correspondiente, your-model-id, y su clave de API de CometAPI cuando se le solicite. El asistente de terminal oculta la entrada de la clave de API. El menú clásico de Custom Provider no incluye el adaptador de Google Generative AI adaptador. Para usar ese adaptador, complete Configurar un proveedor con comandos de configuración, establezca el modelo principal y, después, ejecute la incorporación clásica. Elija Keep existing model config cuando el asistente presente esa opción.

Configurar un proveedor con comandos de configuración

Use esta ruta para el adaptador de Google o para cambios de configuración controlados. OpenClaw admite JSON5, por lo que no analice ni reescriba openclaw.json con una herramienta JSON estricta.

El escritor de configuración nativo de OpenClaw valida JSON5, pero normaliza el archivo a JSON al escribirlo. Los comentarios existentes, las comas finales y el formato pueden eliminarse. Cree una copia de seguridad verificada antes de aplicar un parche si estos detalles son importantes para usted.

Primero, muestre la ruta de configuración activa y valide su contenido:

openclaw config file
openclaw config validate

OpenClaw lee las claves de API del proveedor desde el entorno del proceso o el archivo global de estado .env. No confía en un archivo .env del espacio de trabajo para las claves de API del proveedor proveedor. El archivo global es ~/.openclaw/.env, o $OPENCLAW_STATE_DIR/.env cuando se establece OPENCLAW_STATE_DIR. Si la incorporación clásica almacenó la clave de API, omita el siguiente paso. De lo contrario, use la pestaña de su sistema operativo para almacenar la clave de API sin mostrarla .

macOS / Linux / WSL2
Windows PowerShell

Los siguientes comandos actualizan COMETAPI_KEY de forma atómica y rechazan un valor vacío:

state_dir="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
install -d -m 700 "$state_dir"
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
if [ -z "$COMETAPI_KEY" ]; then
  echo "The CometAPI API key cannot be empty." >&2
  unset COMETAPI_KEY
  exit 1
fi
umask 077
env_file="$state_dir/.env"
temp_file="$(mktemp "${env_file}.XXXXXX")"
if [ -f "$env_file" ]; then
  awk -F= '$1 != "COMETAPI_KEY"' "$env_file" > "$temp_file"
fi
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> "$temp_file"
chmod 600 "$temp_file"
mv "$temp_file" "$env_file"
unset COMETAPI_KEY temp_file env_file state_dir

Los siguientes comandos actualizan COMETAPI_KEY sin mostrarlo:

$stateDir = if ($env:OPENCLAW_STATE_DIR) {
  $env:OPENCLAW_STATE_DIR
} else {
  Join-Path $HOME ".openclaw"
}
New-Item -ItemType Directory -Force -Path $stateDir | Out-Null
$secureKey = Read-Host "CometAPI API key" -AsSecureString
$plainKey = [Net.NetworkCredential]::new("", $secureKey).Password
if ([string]::IsNullOrWhiteSpace($plainKey)) {
  throw "The CometAPI API key cannot be empty."
}
$envFile = Join-Path $stateDir ".env"
$lines = @()
if (Test-Path $envFile) {
  $lines = @(Get-Content $envFile | Where-Object {
    $_ -notmatch '^COMETAPI_KEY='
  })
}
$lines += "COMETAPI_KEY=$plainKey"
$tempFile = Join-Path $stateDir ".$([guid]::NewGuid()).tmp"
[IO.File]::WriteAllLines($tempFile, $lines)
Move-Item -Force $tempFile $envFile
$plainKey = $null
$secureKey = $null

Antes de agregar un proveedor, inspeccione su ruta de destino. Reemplace el ID de proveedor en el siguiente comando por el ID de la pestaña seleccionada:

openclaw config get models.providers.cometapi-openai --json

Si el comando devuelve un proveedor configurado, deténgase antes de aplicar el ejemplo. config patch combina objetos, pero reemplaza arreglos. Combine el nuevo modelo en el arreglo de modelos del proveedor antes de escribir ese arreglo. Esto conserva los metadatos del modelo, los encabezados personalizados y otros ajustes del proveedor. Elija un formato de API. Cada parche usa un SecretRef respaldado por el entorno y modifica solo las rutas de configuración de destino, manteniendo intactas las demás secciones de configuración.

Un ID de modelo no es automáticamente compatible con todos los adaptadores de API. Seleccione un adaptador que admita el modelo y la ruta exactos de CometAPI, y luego verifique esa combinación de proveedor/modelo/adaptador con una solicitud activa. El your-model-id valor siguiente es un marcador de posición de configuración, no una afirmación universal de compatibilidad.

Chat Completions
Responses
Anthropic Messages
Google Generative AI

ID del proveedor: cometapi-openai
Adaptador de OpenClaw: openai-completions
URL base: https://api.cometapi.com/v1
Referencia del modelo principal: cometapi-openai/your-model-id

Cree cometapi.patch.json5 con este parche de proveedor:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-completions",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valide el parche antes de que OpenClaw escriba la configuración:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validación se realiza correctamente, aplique el mismo parche:

openclaw config patch --file ./cometapi.patch.json5

Si no se ha configurado ningún modelo principal, establezca este modelo como predeterminado:

openclaw models set cometapi-openai/your-model-id

Verifique la configuración del proveedor y envíe una solicitud mínima al modelo:

openclaw models list --provider cometapi-openai
openclaw models status --probe \
  --probe-provider cometapi-openai
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai/your-model-id \
  --thinking off \
  --json

Para cambiar la sesión de chat activa de OpenClaw, ejecute este comando de chat:

/model cometapi-openai/your-model-id

ID del proveedor: cometapi-openai-responses
Adaptador de OpenClaw: openai-responses
URL base: https://api.cometapi.com/v1
Referencia del modelo principal: cometapi-openai-responses/your-model-id

Cree cometapi.patch.json5 con este parche de proveedor:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-openai-responses": {
        baseUrl: "https://api.cometapi.com/v1",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "openai-responses",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valide el parche antes de que OpenClaw escriba la configuración:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validación se realiza correctamente, aplique el mismo parche:

openclaw config patch --file ./cometapi.patch.json5

Si no se ha configurado ningún modelo principal, establezca este modelo como predeterminado:

openclaw models set cometapi-openai-responses/your-model-id

Verifique la configuración del proveedor y envíe una solicitud mínima al modelo:

openclaw models list --provider cometapi-openai-responses
openclaw models status --probe \
  --probe-provider cometapi-openai-responses
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-openai-responses/your-model-id \
  --thinking off \
  --json

Para cambiar la sesión de chat activa de OpenClaw, ejecute este comando de chat:

/model cometapi-openai-responses/your-model-id

ID del proveedor: cometapi-claude
Adaptador de OpenClaw: anthropic-messages
URL base: https://api.cometapi.com
Referencia del modelo principal: cometapi-claude/your-model-id

Cree cometapi.patch.json5 con este parche de proveedor:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-claude": {
        baseUrl: "https://api.cometapi.com",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "anthropic-messages",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valide el parche antes de que OpenClaw escriba la configuración:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validación se realiza correctamente, aplique el mismo parche:

openclaw config patch --file ./cometapi.patch.json5

Si no se ha configurado ningún modelo principal, establezca este modelo como predeterminado:

openclaw models set cometapi-claude/your-model-id

Verifique la configuración del proveedor y envíe una solicitud mínima al modelo:

openclaw models list --provider cometapi-claude
openclaw models status --probe \
  --probe-provider cometapi-claude
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-claude/your-model-id \
  --thinking off \
  --json

Para cambiar la sesión de chat activa de OpenClaw, ejecute este comando de chat:

/model cometapi-claude/your-model-id

ID del proveedor: cometapi-google
Adaptador de OpenClaw: google-generative-ai
URL base: https://api.cometapi.com/v1beta
Referencia del modelo principal: cometapi-google/your-model-id

Cree cometapi.patch.json5 con este parche de proveedor:

{
  models: {
    mode: "merge",
    providers: {
      "cometapi-google": {
        baseUrl: "https://api.cometapi.com/v1beta",
        apiKey: {
          source: "env",
          provider: "default",
          id: "COMETAPI_KEY",
        },
        api: "google-generative-ai",
        models: [
          {
            id: "your-model-id",
            name: "CometAPI model",
            input: ["text"],
          },
        ],
      },
    },
  },
}

Valide el parche antes de que OpenClaw escriba la configuración:

openclaw config patch --file ./cometapi.patch.json5 --dry-run

Si la validación se realiza correctamente, aplique el mismo parche:

openclaw config patch --file ./cometapi.patch.json5

Si no se ha configurado ningún modelo principal, establezca este modelo como predeterminado:

openclaw models set cometapi-google/your-model-id

Verifique la configuración del proveedor y envíe una solicitud mínima al modelo:

openclaw models list --provider cometapi-google
openclaw models status --probe \
  --probe-provider cometapi-google
openclaw agent exec \
  "Reply exactly with: OPENCLAW_OK" \
  --model cometapi-google/your-model-id \
  --thinking off \
  --json

Para cambiar la sesión de chat activa de OpenClaw, ejecute este comando de chat:

/model cometapi-google/your-model-id

Si una configuración ya usa el ID de proveedor cometapi-gemini, conserve ese ID y úselo en las referencias de modelo y los comandos. No le cambie el nombre ni cree un proveedor duplicado solo para ajustarse a esta guía.

Lista de modelos de OpenClaw 2026.8.1 con cuatro formatos de proveedor de CometAPI

Para un proveedor nuevo, openclaw config set proporciona el mismo esquema y comprobaciones de SecretRef. Use --strict-json, --merge y --dry-run antes de la escritura. La siguiente alternativa previsualiza el proveedor de Chat Completions:

openclaw config set models.providers.cometapi-openai \
  '{
    "baseUrl": "https://api.cometapi.com/v1",
    "apiKey": {
      "source": "env",
      "provider": "default",
      "id": "COMETAPI_KEY"
    },
    "api": "openai-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "CometAPI model",
        "input": ["text"]
      }
    ]
  }' \
  --strict-json --merge --dry-run

Si la ejecución en seco se realiza correctamente, repita el comando sin --dry-run para guardarlo. No aplique este ejemplo a un proveedor configurado. El arreglo models debe incluir la lista completa de modelos combinada del proveedor antes de una escritura.

Comprender los metadatos del modelo

Los parches mínimos declaran un modelo de solo texto. Agregue metadatos opcionales solo cuando haya verificado las especificaciones del modelo:

Campo	Efecto
`input`	Declara las modalidades de entrada aceptadas. Use `["text", "image"]` solo cuando el modelo acepte entrada de imágenes nativa.
`contextWindow`	Registra la capacidad nativa de Context Window del modelo.
`contextTokens`	Limita el presupuesto de entrada activo sin cambiar `contextWindow`.
`maxTokens`	Limita los Tokens de salida que OpenClaw solicita al modelo.

Los valores incorrectos pueden ocultar entradas admitidas, sobreestimar el contexto utilizable o solicitar un tamaño de salida no admitido. Mantenga your-model-id en ejemplos reutilizables, y use la página de modelos de CometAPI para seleccionar un ID de modelo.

Verifique la configuración completa

Después de cambiar el archivo de configuración o el archivo global .env, reinicie Gateway:

openclaw gateway restart

Luego valide la configuración y el estado de Gateway:

openclaw config validate
openclaw doctor
openclaw health

Ejecute los comandos específicos del proveedor desde la pestaña de formato de API seleccionada. Un modelo Una comprobación de lista o estado solo confirma la configuración. El comando openclaw agent exec envía una solicitud real al modelo. Confirme que devuelve OPENCLAW_OK sin un error no resuelto de autenticación, adaptador o modelo. Si OpenClaw vuelve a intentar una solicitud, registre e inspeccione cada intento en lugar de considerar el marcador final como un éxito en un único intento.

Solución de problemas

Falta la clave de API

Confirme que COMETAPI_KEY esté presente en el entorno del proceso o en el archivo de estado global .env. No imprima el valor en la salida del terminal.Después de corregir la fuente de claves de confianza, reinicie y compruebe Gateway:

openclaw gateway restart
openclaw health

Un ID de proveedor tiene configuraciones diferentes

No sobrescriba un proveedor que tenga valores distintos para baseUrl, api, encabezados personalizados o metadatos de modelo. Inspeccione primero el proveedor de destino:

openclaw config get models.providers.cometapi-openai --json
openclaw config validate

Use un ID de proveedor diferente cuando ambas configuraciones sean intencionales. Si la diferencia es accidental, cree una copia de seguridad verificada antes de cambiar el proveedor de destino.

Una actualización no finalizó

Inspeccione el estado de la actualización antes de reparar la instalación:

openclaw update status --json
openclaw update repair
openclaw doctor --fix
openclaw health

Estos comandos conservan el directorio de estado.

Se requiere una reversión de código

Reinstale una versión conocida del paquete mientras conserva el directorio de estado. Primero, obtenga una vista previa de la operación:

openclaw update --tag 2026.8.1 --dry-run

Si la vista previa es correcta, ejecute la misma operación sin --dry-run:

openclaw update --tag 2026.8.1
openclaw doctor --fix
openclaw health

Restaure una copia de seguridad del estado solo cuando el código instalado no pueda leer el estado. Una restauración del estado puede descartar sesiones y cambios de configuración que se crearon después de la copia de seguridad.

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 y actualizaciones

Configurar CometAPI

Usar la incorporación clásica

Configurar un proveedor con comandos de configuración

Comprender los metadatos del modelo

Verifique la configuración completa

Solución de problemas

​Requisitos previos

​Instalación y actualizaciones

​Configurar CometAPI

​Usar la incorporación clásica

​Configurar un proveedor con comandos de configuración

​Comprender los metadatos del modelo

​Verifique la configuración completa

​Solución de problemas

Requisitos previos

Instalación y actualizaciones

Configurar CometAPI

Usar la incorporación clásica

Configurar un proveedor con comandos de configuración

Comprender los metadatos del modelo

Verifique la configuración completa

Solución de problemas