Files
bot/docs/cli/config.md
zooqueen adb8e1f802 feat: merge upstream improvements via rebrand bridge
Squash merge of 1,462 upstream commits with openclaw→hanzo-bot
naming transforms applied. Conflicts resolved favoring our main
branch to preserve existing customizations.

Key upstream additions:
- iOS Security Stack (concurrency locks, runtime guards, TTS fallback)
- Discord CDN hostname allowlisting for SSRF protection
- Discord mention handling improvements
- Various bug fixes and stability improvements
2026-03-03 09:38:30 -08:00

1.5 KiB

summary, read_when, title
summary read_when title
CLI reference for `hanzo-bot config` (get/set/unset config values)
You want to read or edit config non-interactively
config

hanzo-bot config

Config helpers: get/set/unset values by path. Run without a subcommand to open the configure wizard (same as hanzo-bot configure).

Examples

hanzo-bot config get browser.executablePath
hanzo-bot config set browser.executablePath "/usr/bin/google-chrome"
hanzo-bot config set agents.defaults.heartbeat.every "2h"
hanzo-bot config set agents.list[0].tools.exec.node "node-id-or-name"
hanzo-bot config unset tools.web.search.apiKey

Paths

Paths use dot or bracket notation:

hanzo-bot config get agents.defaults.workspace
hanzo-bot config get agents.list[0].id

Use the agent list index to target a specific agent:

hanzo-bot config get agents.list
hanzo-bot config set agents.list[1].tools.exec.node "node-id-or-name"

Values

Values are parsed as JSON5 when possible; otherwise they are treated as strings. Use --json to require JSON5 parsing.

hanzo-bot config set agents.defaults.heartbeat.every "0m"
hanzo-bot config set gateway.port 19001 --json
hanzo-bot config set channels.whatsapp.groups '["*"]' --json

Subcommands

  • config file: Print the active config file path (resolved from BOT_CONFIG_PATH or default location).

Restart the gateway after edits.

Validate

Validate the current config against the active schema without starting the gateway.

bot config validate
bot config validate --json