ZeroClaw is configured via a TOML configuration file, command-line flags, or environment variables. The application stores configuration in ~/.zeroclaw/ by default.
~/.zeroclaw/config.toml~/.zeroclaw/.secret_key (encrypted API keys)~/.zeroclaw/ (workspace and memory)api_key = 'sk-your-openai-key'
provider = 'openai' # Supports: openai, anthropic, ollama, openrouter, llama.cpp, vllm, osaurus, codex
channels = ['telegram', 'discord', 'slack']
workspace_only = true
log_level = 'info'
| Flag | Purpose |
|---|---|
--help |
Display help |
--version |
Show version |
--sandbox |
Activate seccomp-bpf sandboxing (Linux only, +1-2 ms startup) |
--metrics-port 9090 |
Expose Prometheus metrics endpoint |
onboard --config ~/.zeroclaw/config.toml |
Initialize with config file |
test --config new.toml |
Test configuration |
ZeroClaw supports 20+ AI providers with swappable architecture:
| Provider | Config Value | Notes |
|---|---|---|
| OpenAI | openai |
GPT-4, GPT-3.5-turbo, OpenAI-compatible endpoints |
| Anthropic | anthropic |
Claude models, supports OAuth and API key auth |
| OpenRouter | openrouter |
Multi-provider aggregator (default in examples) |
| Ollama | ollama |
Local and remote endpoints |
| llama.cpp | llama.cpp |
llama-server endpoint (http://localhost:8080/v1) |
| vLLM | vllm |
vLLM server endpoint (http://localhost:8000/v1) |
| Osaurus | osaurus |
Unified AI edge runtime for macOS (http://localhost:1337/v1) |
| OpenAI Codex | codex |
ChatGPT subscription OAuth |
| Gemini | gemini |
Google AI models |
| Novita AI | novita |
AI model provider |
| Custom | custom |
OpenAI-compatible or Anthropic-compatible custom endpoints |
ZeroClaw supports 25+ messaging platforms. Of these, 4 are built-in (WhatsApp, Telegram, Discord, HTTP webhook); the remainder are available through community plugins.
| Channel | Config Value | Notes |
|---|---|---|
| CLI | cli |
Direct command-line interface (built-in) |
| Telegram | telegram |
Bot API with operator-approval flow (built-in) |
| Discord | discord |
User ID allowlists (built-in) |
| Slack | slack |
Member ID allowlists (community plugin) |
| Mattermost | mattermost |
API v4, user ID allowlists (community plugin) |
| iMessage | imessage |
Native macOS integration (community plugin) |
| Matrix | matrix |
E2EE support available (community plugin) |
| Signal | signal |
Encrypted messaging (community plugin) |
whatsapp |
Web mode + Business Cloud API mode (built-in) | |
email |
SMTP/IMAP integration (community plugin) | |
| IRC | irc |
Classic chat protocol (community plugin) |
| Lark | lark |
Enterprise messaging (community plugin) |
| DingTalk | dingtalk |
Alibaba enterprise messaging (community plugin) |
qq |
Tencent messaging platform (community plugin) | |
| Nostr | nostr |
NIP-04 and NIP-17 DMs support (community plugin) |
| Webhook | webhook |
HTTP webhook endpoint (built-in) |
| Bluesky | bluesky |
Decentralized social platform (community plugin) |
| MQTT | mqtt |
IoT messaging protocol (community plugin) |
reddit |
Social platform (community plugin) | |
linkedin |
Professional network (community plugin) | |
| Twitter/X | twitter |
Social media platform (community plugin) |
| WeChat Work | wecom |
Enterprise messaging (community plugin) |
70+ integrations available via plugin system across 9 categories.
~/.zeroclaw/.secret_key)workspace_only = true for security (default)Use the built-in test command to validate your configuration:
zeroclaw test --config ~/.zeroclaw/config.toml
Back up the ZeroClaw configuration directory:
cp -r ~/.zeroclaw ~/zeroclaw-backup-$(date +%Y%m%d)
Restore from backup:
rm -rf ~/.zeroclaw && cp -r ~/zeroclaw-backup-YYYYMMDD ~/.zeroclaw
workspace_only = true)Squeezing every bit of performance from your Zeroclaw installation? Our experts help with:
Optimize your setup: office@linux-server-admin.com | Contact Us