zeroclaw/docs/config-reference.md

1.9 KiB

ZeroClaw Config Reference (Operator-Oriented)

This is a high-signal reference for common config sections and defaults.

Last verified: February 18, 2026.

Config file path:

  • ~/.zeroclaw/config.toml

Core Keys

Key Default Notes
default_provider openrouter provider ID or alias
default_model anthropic/claude-sonnet-4 model routed through selected provider
default_temperature 0.7 model temperature

[gateway]

Key Default Purpose
host 127.0.0.1 bind address
port 3000 gateway listen port
require_pairing true require pairing before bearer auth
allow_public_bind false block accidental public exposure

[memory]

Key Default Purpose
backend sqlite sqlite, lucid, markdown, none
auto_save true automatic persistence
embedding_provider none none, openai, or custom endpoint
vector_weight 0.7 hybrid ranking vector weight
keyword_weight 0.3 hybrid ranking keyword weight

[channels_config]

Top-level channel options are configured under channels_config.

Examples:

  • [channels_config.telegram]
  • [channels_config.discord]
  • [channels_config.whatsapp]
  • [channels_config.email]

See detailed channel matrix and allowlist behavior in channels-reference.md.

Security-Relevant Defaults

  • deny-by-default channel allowlists ([] means deny all)
  • pairing required on gateway by default
  • public bind disabled by default

Validation Commands

After editing config:

zeroclaw status
zeroclaw doctor
zeroclaw channel doctor