2026-01-15 06:12:54 +00:00
|
|
|
---
|
2026-01-27 12:19:58 +00:00
|
|
|
summary: "CLI reference for `moltbot agent` (send one agent turn via the Gateway)"
|
2026-01-15 06:12:54 +00:00
|
|
|
read_when:
|
|
|
|
|
- You want to run one agent turn from scripts (optionally deliver reply)
|
|
|
|
|
---
|
|
|
|
|
|
2026-01-27 12:19:58 +00:00
|
|
|
# `moltbot agent`
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
Run an agent turn via the Gateway (use `--local` for embedded).
|
2026-01-18 22:49:55 +00:00
|
|
|
Use `--agent <id>` to target a configured agent directly.
|
2026-01-15 06:12:54 +00:00
|
|
|
|
|
|
|
|
Related:
|
|
|
|
|
- Agent send tool: [Agent send](/tools/agent-send)
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-01-27 12:19:58 +00:00
|
|
|
moltbot agent --to +15555550123 --message "status update" --deliver
|
|
|
|
|
moltbot agent --agent ops --message "Summarize logs"
|
|
|
|
|
moltbot agent --session-id 1234 --message "Summarize inbox" --thinking medium
|
|
|
|
|
moltbot agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
|
2026-01-15 06:12:54 +00:00
|
|
|
```
|
