OpenClaw
OpenClaw (formerly Clawdbot / Moltbot) is an open-source agent platform for messaging channels such as Telegram, Discord, Slack, Signal, iMessage, and WhatsApp. Route agent inference through ApiGo by registering a custom provider.
Install
macOS / Linux:
curl -fsSL https://openclaw.bot/install.sh | bash
Windows:
iwr -useb https://openclaw.ai/install.ps1 | iex
Existing installs should update with the same installer before configuring.
Recommended: onboarding wizard
openclaw onboard
When the wizard asks for a provider, choose a custom / OpenAI-compatible (or Anthropic-compatible) endpoint and enter:
| Field | Value |
|---|---|
| Base URL (OpenAI path) | https://api.apigo.ai/v1 |
| Base URL (Anthropic path) | https://api.apigo.ai |
| API key | your sk-apigo-... key |
| Model | slug from Models |
You can also finish the same fields later with openclaw configure or the Control UI.
Manual configuration
Edit ~/.openclaw/openclaw.json (JSON5 accepted by OpenClaw). Example using the OpenAI-compatible path:
{
"env": {
"APIGO_API_KEY": "sk-apigo-..."
},
"models": {
"providers": {
"apigo": {
"baseUrl": "https://api.apigo.ai/v1",
"apiKey": "${APIGO_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "qwen3.8-max",
"name": "Qwen 3.8 Max",
"input": ["text"]
},
{
"id": "gpt-5.6-sol",
"name": "GPT-5.6 Sol",
"input": ["text"]
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "apigo/gpt-5.6-sol"
},
"models": {
"apigo/qwen3.8-max": {},
"apigo/gpt-5.6-sol": {}
}
}
}
}
Anthropic-compatible path
If you prefer Claude-native Messages:
{
"models": {
"providers": {
"apigo": {
"baseUrl": "https://api.apigo.ai",
"apiKey": "sk-apigo-...",
"api": "anthropic-messages",
"models": [
{
"id": "claude-sonnet-5",
"name": "Claude Sonnet 5"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "apigo/claude-sonnet-5"
}
}
}
}
Exact api enum values can vary by OpenClaw version — use the options shown in openclaw configure / the Control UI if the snippet above is rejected.
Control UI
- Start the gateway:
openclaw gateway run
- Open
http://127.0.0.1:18789. - Open Config → models, add or edit the ApiGo provider, save, then Update.
Test
openclaw tui
If a conversation starts, the provider is wired correctly. Confirm requests in Call Logs.
Model format
OpenClaw references models as provider/model-id. With the examples above that is apigo/<model-slug>.
Troubleshooting
| Symptom | Fix |
|---|---|
| Auth errors | Check apiKey / APIGO_API_KEY and key status in Workspace |
| Model missing from picker | Add the model under models.providers.apigo.models[] and restart the gateway |
| Wrong protocol errors | Match baseUrl + api (OpenAI /v1 vs Anthropic root) |
