🚀 Integrando OpenClaw / Clawdbot com Modelos Personalizados CodingPlanX

Este tutorial irá guiá-lo através da instalação do Clawdbot (OpenClaw) e da configuração de um proxy de API personalizado, permitindo que você chame modelos como GPT-4o, Claude 3.5 e Gemini de forma flexível.

🛠️ Passo 1: Preparação do Ambiente e Inicialização

Antes de começar, certifique-se de que o Node.js está instalado no seu sistema.

1. Instalar o Clawdbot Globalmente

Abra o seu terminal (CMD ou PowerShell) e execute o seguinte comando:

npm i -g clawdbot

2. Executar o Guia de Inicialização

Execute o assistente de configuração para concluir a configuração básica. Siga as instruções na tela:

clawdbot onboard

[!IMPORTANT] Nota para Usuários Windows: Em um ambiente nativo do Windows, se o sistema informar que openclaw não é reconhecido como um comando interno, certifique-se de usar o comando clawdbot em vez disso.

⚙️ Passo 2: Modificar o Arquivo de Configuração Principal `clawdbot.json`

Neste passo, modificaremos o arquivo de configuração principal para definir o endereço da API do proxy e os mapeamentos dos modelos.

Caminho do Arquivo: C:\Users\seu-nome-de-usuario\.clawdbot\clawdbot.json (Nota: O tutorial original usava 'Administrator'. Por favor, altere isso para o seu nome de usuário real no sistema)

Modifique as seções agents, auth e models no arquivo com base na seguinte referência:

{
  "agents": {
    "defaults": {
      "workspace": "C:\\Users\\seu-nome-de-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 }
        ]
      }
    }
  }
}

🔑 Passo 3: Configurar o Arquivo de Autenticação `auth-profiles.json`

Neste passo, você precisa inserir as Chaves de API (API Keys) reais obtidas na plataforma de proxy.

Caminho do Arquivo: C:\Users\seu-nome-de-usuario\.clawdbot\agents\main\agent\auth-profiles.json

Atualize os campos key com suas próprias credenciais de API:

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

🚦 Passo 4: Verificar e Iniciar o Serviço

Depois de configurado, verifique e execute o serviço usando as etapas a seguir.

1. Executar uma Verificação de Integridade (Health Check)

Verifique se a sintaxe da sua configuração e a conectividade de rede estão funcionando corretamente:

clawdbot doctor

2. Iniciar o Serviço de Gateway

Execute o serviço de gateway para habilitar o proxy de IA:

clawdbot gateway

3. Acessar o Console da Web

Abra o seu navegador e vá para: http://127.0.0.1:18789/
Credenciais de Login: Use o Token exibido no final do passo clawdbot onboard para fazer o login.
Agora você está pronto para personalizar e usar o seu Agente de IA!

💡 Dica: Se você trocar de provedor de proxy em algum momento, basta atualizar a baseUrl no clawdbot.json e a key no auth-profiles.json.