OpenClaw com APIMaster.ai
Instale o OpenClaw no Windows ou macOS, conecte o APIMaster via openclaw onboard Custom Provider e converse no painel web.
OpenClaw é uma plataforma local de agente de IA com uma interface de chat web. Conecte APIMaster.ai (compatível com OpenAI) através do openclaw onboard → Custom Provider.
Primeiro, obtenha uma chave de API. Use o placeholder
your_apimaster_keyabaixo.
Pré-requisitos
- Windows, macOS ou Linux
- Node.js 22.19+ (recomendado Node 24; o instalador faz upgrade se necessário)
- Chave de API APIMaster pronta
Passo 1 — Instalação
Após a instalação, geralmente você verá Starting setup… (onboard). Para instalar apenas e configurar depois, veja Instalar sem onboard abaixo.
Windows (PowerShell)
powershell -c "irm https://openclaw.ai/install.ps1 | iex"

macOS (Terminal)
- Abra o Terminal.app (ou iTerm).
- Execute o instalador oficial (documentação do OpenClaw):
curl -fsSL https://openclaw.ai/install.sh | bash
No macOS, o script irá:
- Detectar Apple Silicon vs Intel
- Instalar Homebrew se ausente (requer uma conta de Administrador)
- Instalar Node 24 (ou outra versão ≥ 22.19) via Homebrew quando necessário
- Instalar a CLI
openclawe geralmente iniciar o onboard
Verifique o Node primeiro (opcional):
node --version # precisa de v22.19+, v24.x recomendado
Instalar sem onboard:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Depois execute openclaw onboard quando estiver pronto.
Caminhos de configuração no macOS:
| Item | Caminho |
|---|---|
| Configuração | ~/.openclaw/openclaw.json |
| Workspace | ~/.openclaw/workspace |
| Sessões | ~/.openclaw/agents/main/sessions |
As capturas de tela abaixo são do Windows, mas o fluxo do CLI onboard é o mesmo no macOS (Custom Provider, Base URL, Skip channel, etc.).
Linux / WSL2
Mesmo que no macOS:
curl -fsSL https://openclaw.ai/install.sh | bash
Gateway em segundo plano opcional:
openclaw onboard --install-daemon
(macOS: LaunchAgent · Linux: serviço de usuário systemd)
Passo 2 — openclaw onboard
Execute a qualquer momento para (re)configurar:
openclaw onboard
No macOS, use a mesma sessão do Terminal. Para um Gateway persistente:
openclaw onboard --install-daemon
- Aviso de segurança → Sim
- Provedor de modelo/auth → Custom Provider (endpoint compatível com OpenAI ou Anthropic)

- Preencha:
| Campo | Valor |
|---|---|
| API Base URL | https://apimaster.ai/v1 |
| Chave da API | Cole a chave APIMaster |
| Compatibilidade do endpoint | Compatível com OpenAI |
| ID do modelo | Ex.: gpt-5.5 |

ID do modelo: qualquer ID de modelo de chat no marketplace (gpt-5.4, claude-sonnet-4-6, …). Pule modelos de imagem como gpt-image-2.
- Etapas opcionais: Pular canal, pesquisa na web, habilidades, hooks.

Passo 3 — Chat web
Se o navegador não abrir:
openclaw dashboard
Se a página não carregar, execute openclaw dashboard novamente ou reexecute openclaw onboard.
Passo 4 — Teste
Selecione o modelo abaixo do campo de entrada (ex.: gpt-5.5 (Custom Provider)), envie hello e confirme a resposta.

Solução de problemas
| Problema | Ação |
|---|---|
| Configuração inválida | openclaw onboard |
| Página não abre | openclaw dashboard |
| Erro 401 / erro de modelo | Verifique URL, chave, ID do modelo; teste de conectividade |
macOS
| Problema | Ação |
|---|---|
openclaw: comando não encontrado |
Adicione ao ~/.zshrc: export PATH="$(npm prefix -g)/bin:$PATH", reabra o Terminal |
| Versão do Node ainda incorreta com nvm | nvm install 24 && nvm use 24 && nvm alias default 24, execute o instalador novamente |
| Falha na instalação do Homebrew | Use uma conta de Administrador, ou instale o Homebrew primeiro |
| Gateway não está em execução | openclaw gateway status; tente openclaw onboard --install-daemon |
Lista de verificação
- Custom Provider +
https://apimaster.ai/v1+ chave - ID do modelo de chat (não imagem)
-
openclaw dashboardfunciona - Mensagem de teste bem-sucedida