OpenClaw (Clawdbot) — Configuração e integração da API

O que é o OpenClaw?

Um gateway de agentes que roda em sistemas operacionais comuns e pode ligar a canais como WhatsApp, Telegram, Discord, iMessage e outros. Envia uma mensagem e obtém respostas dos seus agentes em várias superfícies; canais extra podem ser adicionados com plugins.

Consulte o projeto oficial para recursos e documentação atualizados: OpenClaw.

1. Instalar o OpenClaw

Escolha o fluxo adequado ao seu SO.

Instalação por script (recomendada)

macOS / Linux

  1. Instalar
curl -fsSL https://openclaw.ai/install.sh | bash
  1. Verificar
openclaw --version

Windows (PowerShell)

Nota: O instalador do OpenClaw costuma ser executado no WSL2. No PowerShell, inicie o WSL e execute a instalação dentro do WSL.

iwr -useb https://openclaw.ai/install.ps1 | iex

Verificar:

openclaw --version

2. Inicializar o OpenClaw

Inicie o assistente interativo:

openclaw onboard

Fluxo típico (o texto pode variar conforme a versão):

  1. Escolha QuickStart
  2. Escolha Skip for now onde ainda não precisa de chaves de fornecedores
  3. Escolha All providers (ou a opção que corresponde ao seu plano)
  4. Escolha Keep current quando estiver em dúvida
  5. Pode Skip passos opcionais de ferramentas de chat ou skills e terminar o onboarding
  6. Ative opções de privacidade / gateway recomendadas, se o assistente sugerir

Ao terminar, o OpenClaw pode abrir a UI do gateway no navegador.

Se o gateway não estiver a correr:

openclaw gateway

2. Ligar o OpenClaw ao mixgateway.io

1. Obter uma chave de API do gateway

  1. Abra mixgateway.io e inicie sessão.
  2. Na [consola](/dashboard), abra API Keys (ou equivalente).
  3. Crie uma chave e copie-a — use-a como Authorization: Bearer … no gateway.

2. Editar openclaw.json

Após a instalação, o OpenClaw guarda a configuração no diretório de configuração (muitas vezes ~/.openclaw).

Abrir a pasta

open ~/.openclaw

Em Windows + WSL, a partir desse diretório pode abrir o Explorador com:

explorer.exe .

Edite openclaw.json. Una a ideia abaixo ao seu ficheiro existente: defina um fornecedor que aponte para o URL base compatível com OpenAI https://api.mixgateway.io/v1, e associe agents.defaults.model.primary a um id de modelo que use esse fornecedor.

Exemplo (ajuste nomes à sua versão do OpenClaw — estrutura inspirada em guias de terceiros como a documentação ApiSet para OpenClaw):

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "mixgateway/deepseek:deepseek-chat"
      },
      "models": {
        "mixgateway/deepseek:deepseek-chat": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "mixgateway": {
        "baseUrl": "https://api.mixgateway.io/v1",
        "apiKey": "PASTE_YOUR_GATEWAY_API_KEY_HERE",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek:deepseek-chat",
            "name": "deepseek-chat",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Notas:

  • Substitua PASTE_YOUR_GATEWAY_API_KEY_HERE pela chave real do painel.
  • Altere deepseek:deepseek-chat para qualquer modelo suportado pelo gateway (veja Modelos e encaminhamento).
  • mixgateway é apenas a chave do fornecedor neste exemplo — pode renomear, mas mantenha agents.defaults.model.primary alinhado (providerKey/modelId).

3. Reiniciar o gateway

openclaw gateway restart

A UI do gateway deve mostrar o novo fornecedor e modelo.


Ver também