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
- Instalar
curl -fsSL https://openclaw.ai/install.sh | bash
- 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):
- Escolha QuickStart
- Escolha Skip for now onde ainda não precisa de chaves de fornecedores
- Escolha All providers (ou a opção que corresponde ao seu plano)
- Escolha Keep current quando estiver em dúvida
- Pode Skip passos opcionais de ferramentas de chat ou skills e terminar o onboarding
- 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
- Abra mixgateway.io e inicie sessão.
- Na [consola](/dashboard), abra API Keys (ou equivalente).
- 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_HEREpela chave real do painel. - Altere
deepseek:deepseek-chatpara 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
- Visão geral do OpenClaw — Porquê usar o OpenClaw com mixgateway.io.
- Início rápido — Chamar
https://api.mixgateway.io/v1/chat/completionsdiretamente.