ai2saveai2save

Guía de configuración de OpenClaw

OpenClaw añade proveedores de modelos personalizados a través de models.providers. ai2save utiliza la interfaz OpenAI Compatible, y Base URL debe completarse con https://ai2save.com/v1.

1. Preparar OpenClaw y API Key

Si OpenClaw ya está instalado, se puede omitir la instalación:

npm install -g openclaw@latest
openclaw --version
  1. Abra https://ai2save.com/keys.
  2. Cree un API Key que pertenezca al grupo de modelos OpenAI / GPT.
  3. Copie la clave completa sk-....

2. Editar el archivo de configuración OpenClaw

El archivo de configuración predeterminado de OpenClaw es:

~/.openclaw/openclaw.json

Windows normalmente en %USERPROFILE%\.openclaw\openclaw.json. Los archivos admiten JSON5, y se pueden fusionar con la configuración existente según la siguiente estructura:

{
  env: {
    vars: {
      AI2SAVE_API_KEY: "sk-tu-api-key",
    },
  },
  agents: {
    defaults: {
      model: {
        primary: "ai2save/gpt-5.5",
      },
    },
  },
  models: {
    mode: "merge",
    providers: {
      ai2save: {
        baseUrl: "https://ai2save.com/v1",
        apiKey: "${AI2SAVE_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "gpt-5.5",
            name: "GPT 5.5",
            reasoning: true,
            input: ["text"],
            contextWindow: 200000,
          },
        ],
      },
    },
  },
}

Explicación de los campos clave:

  • models.providers.ai2save.baseUrl: Debe ir acompañado de /v1.
  • api: "openai-completions": Tipo de interfaz que OpenClaw utiliza como agente para OpenAI Compatible.
  • models[].id: Debe coincidir exactamente con el ID del modelo abierto en la consola ai2save.
  • agents.defaults.model.primary: El formato es id-del-proveedor/id-del-modelo.
  • apiKey se puede escribir directamente como "sk-..."; al usarlo mediante ${AI2SAVE_API_KEY}, debe definirse en env.vars.

Si deseas agregar varios modelos, continúa añadiéndolos en el array models y cambia primary al ai2save/model-id que quieras usar por defecto.

3. Aplicar y comprobar la configuración

OpenClaw Gateway escuchará los cambios en el archivo de configuración y se aplicará automáticamente. Si la configuración no surte efecto de inmediato, ejecuta:

openclaw gateway restart

Luego verifica si el modelo ya ha aparecido en OpenClaw:

openclaw models list --provider ai2save

Cambia el modelo predeterminado a ai2save:

openclaw models set ai2save/gpt-5.5

Si el modelo no aparece, ejecute el diagnóstico y verifique los errores de configuración:

openclaw doctor

4. Verificación de la solicitud

  1. Abra la interfaz de chat o WebChat de OpenClaw.
  2. Inicie una nueva conversación y envíe «Hola, por favor informe el nombre del modelo actual».
  3. Confirme que la ruta del modelo se muestra como ai2save/gpt-5.5.
  4. Primero verifique solo con tareas de texto. Una vez exitoso, abra herramientas más complejas como archivos, navegador o contexto largo.

OpenClaw realiza automáticamente la compatibilidad con proxies no oficiales de OpenAI, no es necesario activar manualmente developer role. Si encuentra errores al llamar herramientas, primero confirme que el ID del modelo admite el uso de herramientas y luego aumente el tiempo de espera.

5. Errores comunes

  • 401 / invalid_api_key: AI2SAVE_API_KEY no está definido, la clave no se copió completamente, o el grupo de la clave no coincide.
  • 404 / model not found: models[].id, primary o el nombre del modelo solicitado realmente no coinciden.
  • Conexión fallida / empty response: Verifique si baseUrl es https://ai2save.com/v1, no escriba la dirección raíz.
  • Lista de modelos vacía: Confirme models.mode: "merge" y asegúrese de que models.providers.ai2save.models[] contenga al menos un modelo.
  • Configuración guardada pero no aplicada: Ejecute nuevamente openclaw doctor y, si es necesario, reinicie OpenClaw Gateway.