🚀 Integrando OpenClaw / Clawdbot con modelos personalizados de CodingPlanX

Este tutorial te guiará a través de la instalación de Clawdbot (OpenClaw) y la configuración de un proxy API personalizado, permitiéndote llamar de manera flexible a modelos como GPT-4o, Claude 3.5 y Gemini.

---

🛠️ Paso 1: Preparación del entorno e inicialización

Antes de comenzar, asegúrate de que Node.js esté instalado en tu sistema.

1. Instalar Clawdbot globalmente

Abre tu terminal (CMD o PowerShell) y ejecuta el siguiente comando:

npm i -g clawdbot

2. Ejecutar la guía de inicialización

Ejecuta el asistente de configuración para completar la configuración básica. Sigue las indicaciones en pantalla:

clawdbot onboard

[!IMPORTANT] Nota para usuarios de Windows: En un entorno Windows nativo, si el sistema indica que openclaw no se reconoce como un comando interno, asegúrate de usar el comando clawdbot en su lugar.

---

⚙️ Paso 2: Modificar el archivo de configuración principal clawdbot.json

En este paso, modificaremos el archivo de configuración principal para definir la dirección de la API del proxy y las asignaciones de modelos.

Ruta del archivo: C:\Users\tu-usuario\.clawdbot\clawdbot.json (Nota: El tutorial original usó 'Administrator'. Cambia esto a tu nombre de usuario del sistema real)

Modifica las secciones agents, auth y models en el archivo según la siguiente referencia:

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\tu-usuario\\clawd",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://api.codingplanx.ai/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://api.codingplanx.ai",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://api.codingplanx.ai/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

---

🔑 Paso 3: Configurar el archivo de autenticación auth-profiles.json

En este paso, debes ingresar las Claves API reales obtenidas de la plataforma proxy.

Ruta del archivo: C:\Users\tu-usuario\.clawdbot\agents\main\agent\auth-profiles.json

Actualiza los campos key con tus propias credenciales de API:

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-tu-clave-gpt-real"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-tu-clave-claude-real"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-tu-clave-google-real"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

---

🚦 Paso 4: Verificar e iniciar el servicio

Una vez configurado, verifica y ejecuta el servicio siguiendo estos pasos.

1. Ejecutar una verificación de estado

Verifica si la sintaxis de tu configuración y la conectividad de red funcionan correctamente:

clawdbot doctor

2. Iniciar el servicio de puerta de enlace

Ejecuta el servicio de puerta de enlace (gateway) para habilitar el proxy de IA:

clawdbot gateway

3. Acceder a la consola web

1. Abre tu navegador y navega a: http://127.0.0.1:18789/
2. Credenciales de inicio de sesión: Usa el Token generado al final del paso clawdbot onboard para iniciar sesión.
3. ¡Ahora estás listo para personalizar y usar tu Agente de IA!

---

💡 Consejo: Si alguna vez cambias de proveedor de proxy, simplemente actualiza la baseUrl en clawdbot.json y la key en auth-profiles.json.