| name | hiclaw-find-worker |
| description | Use when discovering available workers or checking if a suitable worker exists for a task. |
Find Worker
Discover and inspect available Workers for task assignment.
Commands
agenthub worker list --workspace <id>
agenthub worker get <name> --workspace <id>
agenthub worker status --id <worker-id>
Selection Criteria
When finding a worker for a task, consider:
- Capability tags: Does the worker have relevant skills?
- Worker runtime base: Is it openclaw, opencode, claude-code, codex, or gemini?
- Current state: Is the worker idle, busy, or sleeping?
- Model: Is the worker's model suitable for the task complexity?
Rules
- Always prefer existing suitable workers before creating new ones.
- If no suitable worker exists, propose creating one to the human admin.
- Sleeping workers can be woken:
agenthub worker wake --id <id>.
Decision Pattern
- Read workers-registry.json and the current room/task context.
- Match capability tags, runtime base, model binding, skills, and current state.
- Prefer a ready/listening Worker already in the room.
- If no suitable Worker exists, propose an explicit member spec to the human.
- Never silently create a Worker with a guessed runtime or model.