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 9+ 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 |
| Custom | custom |
OpenAI-compatible or Anthropic-compatible custom endpoints |
ZeroClaw supports 17+ messaging platforms:
| Channel | Config Value | Notes |
|---|---|---|
| CLI | cli |
Direct command-line interface (built-in) |
| Telegram | telegram |
Bot API with operator-approval flow |
| Discord | discord |
User ID allowlists |
| Slack | slack |
Member ID allowlists |
| Mattermost | mattermost |
API v4, user ID allowlists |
| iMessage | imessage |
Native macOS integration |
| Matrix | matrix |
E2EE support available |
| Signal | signal |
Encrypted messaging |
whatsapp |
Web mode + Business Cloud API mode | |
email |
SMTP/IMAP integration | |
| IRC | irc |
Classic chat protocol |
| Lark | lark |
Enterprise messaging |
| DingTalk | dingtalk |
Alibaba enterprise messaging |
qq |
Tencent messaging platform | |
| Nostr | nostr |
NIP-04 and NIP-17 DMs support |
| Webhook | webhook |
HTTP webhook endpoint |
| Linq | linq |
Integration platform |
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)Any questions?
Feel free to contact us. Find all contact information on our contact page.