Saltar al contenido principal
Un asistente de IA personal de código abierto y autoalojado. Sitio: https://openclaw.ai (documentación: https://docs.openclaw.ai, repositorio: https://github.com/openclaw/openclaw).
Protocolo: compatible con OpenAI
  • URL base: https://api.orcarouter.ai/v1 (debe incluir /v1)

Instalación

Requiere Node 22+. Instala el comando openclaw:
npm install -g openclaw
O en macOS/Linux:
curl -fsSL https://openclaw.ai/install.sh | bash

Configuración

Edita ~/.openclaw/openclaw.json:
{
  "models": {
    "mode": "merge",
    "providers": {
      "orcarouter": {
        "baseUrl": "https://api.orcarouter.ai/v1",
        "apiKey": "sk-orca-...",
        "api": "openai-completions",
        "models": [ { "id": "orcarouter/auto", "name": "OrcaRouter Auto" } ]
      }
    }
  },
  "agents": { "defaults": { "model": { "primary": "orcarouter/orcarouter/auto" } } },
  "gateway": { "mode": "local" }
}

Ejecución

openclaw agent --local --agent main --session-id s1 -m "Reply with exactly: OK"
Espera la respuesta OK.

Notas

  • baseUrl debe vivir bajo models.providers.<name>, no dentro de cada entrada de modelo. Ponerlo en un modelo da Unrecognized key: "baseUrl".
  • La URL base conserva el /v1 final. Las referencias de modelo usan provider/model, así que el enrutador automático es orcarouter/orcarouter/auto.
  • El nombre del agente por defecto es main (no default). Para ejecuciones no interactivas usa --local con un --session-id.
  • Los nombres de modelo usan el formato vendor/model. Cambia orcarouter/auto por un modelo específico como anthropic/claude-opus-4.8 o google/gemini-2.5-flash (y actualiza la referencia primary en consecuencia).

Pensamiento / razonamiento

OpenClaw se comunica con OrcaRouter a través de la API estándar compatible con OpenAI (api: "openai-completions"), así que el razonamiento sigue el comportamiento propio del modelo — elige un modelo con capacidad de razonamiento (p. ej. un modelo de razonamiento anthropic/claude-*) y piensa según se configure en el upstream.