mirror of
https://github.com/hanzoai/bot.git
synced 2026-10-30 17:24:26 +00:00
Comprehensive rename of all openclaw references to hanzo-bot equivalents: - Package: openclaw → @hanzo/bot - Binary: openclaw → hanzo-bot - Types: OpenClaw* → Bot* - Env vars: OPENCLAW_* → BOT_* - Android: ai.openclaw.android → ai.hanzo.bot.android - iOS/macOS: ai.openclaw.* → ai.hanzo.* - Swift modules: OpenClaw* → Bot* - Plugins: openclaw.plugin.json → bot.plugin.json - Paths: .openclaw/ → .hanzo/bot/ - URLs: github.com/openclaw → github.com/hanzoai
2.3 KiB
2.3 KiB
summary, read_when, title
| summary | read_when | title | |
|---|---|---|---|
| Direct `hanzo-bot agent` CLI runs (with optional delivery) |
|
Agent Send |
hanzo-bot agent (direct agent runs)
hanzo-bot agent runs a single agent turn without needing an inbound chat message.
By default it goes through the Gateway; add --local to force the embedded
runtime on the current machine.
Behavior
- Required:
--message <text> - Session selection:
--to <dest>derives the session key (group/channel targets preserve isolation; direct chats collapse tomain), or--session-id <id>reuses an existing session by id, or--agent <id>targets a configured agent directly (uses that agent'smainsession key)
- Runs the same embedded agent runtime as normal inbound replies.
- Thinking/verbose flags persist into the session store.
- Output:
- default: prints reply text (plus
MEDIA:<url>lines) --json: prints structured payload + metadata
- default: prints reply text (plus
- Optional delivery back to a channel with
--deliver+--channel(target formats matchhanzo-bot message --target). - Use
--reply-channel/--reply-to/--reply-accountto override delivery without changing the session.
If the Gateway is unreachable, the CLI falls back to the embedded local run.
Examples
hanzo-bot agent --to +15555550123 --message "status update"
hanzo-bot agent --agent ops --message "Summarize logs"
hanzo-bot agent --session-id 1234 --message "Summarize inbox" --thinking medium
hanzo-bot agent --to +15555550123 --message "Trace logs" --verbose on --json
hanzo-bot agent --to +15555550123 --message "Summon reply" --deliver
hanzo-bot agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
Flags
--local: run locally (requires model provider API keys in your shell)--deliver: send the reply to the chosen channel--channel: delivery channel (whatsapp|telegram|discord|googlechat|slack|signal|imessage, default:whatsapp)--reply-to: delivery target override--reply-channel: delivery channel override--reply-account: delivery account id override--thinking <off|minimal|low|medium|high|xhigh>: persist thinking level (GPT-5.2 + Codex models only)--verbose <on|full|off>: persist verbose level--timeout <seconds>: override agent timeout--json: output structured JSON