- 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:
- openclaw agents 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 deleteas 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.