| name | agent-control |
| description | Manage OpenClaw isolated agents from chat with short commands. Use when the user asks to create/list/switch/bind/delete agents, route channels to a specific agent, or set an agent identity without manually typing full CLI syntax. |
Agent Control
Translate short chat commands into OpenClaw CLI agent operations.
Command grammar
Accept these commands (case-insensitive, trim extra spaces):
agent listagent create <name> [workspace=<path>] [model=<id>]agent switch <name> [channel=<channel[:accountId]>]agent bind <name> <channel[:accountId]>agent unbind <name> <channel[:accountId]>agent delete <name>agent identity <name> [display="..."] [emoji=🗡️] [avatar=<path>]
If input is ambiguous, ask one focused question.
Execution mapping
Run these exact command patterns:
- List:
- Create:
openclaw agents add <name> --workspace <path> --model <id>- Omit optional flags when missing.
- Default workspace when omitted:
~/clawd/agents/<name>.
- Switch (route this channel/account to an agent):
openclaw agents bind --agent <name> --bind <channel[:accountId]>- If channel is omitted, infer from current surface when possible (e.g.
webchat).
- Bind / unbind:
openclaw agents bind --agent <name> --bind <binding>openclaw agents unbind --agent <name> --bind <binding>
- Delete:
- Require explicit confirmation in the same turn for destructive action.
- Then run:
openclaw agents delete <name>
- Identity:
openclaw agents set-identity --agent <name> [--name <display>] [--emoji <emoji>] [--avatar <path>]
Response style
After each operation, return:
- A one-line result (success/failure)
- The next useful command for the user
Keep it brief and practical.
Safety rules
- Treat
agent delete as destructive: confirm before running.
- Never run unrelated shell commands.
- If a command fails, show the error and one concrete fix.
scripts/
Use scripts/example.py as a deterministic helper wrapper for command parsing/execution when needed.
