Guides the creation, import, and composition of agent teams with one Team Leader and multiple Workers. It explains member changes, delegation through the Leader, and where to manage each Worker's runtime settings and lifecycle.
Use when admin requests creating a team, importing a team, managing team composition, adding/removing workers from a team, or delegating tasks to a Team Leader.
Review the instructions the agent will receive before you install.
A Team consists of 1 Team Leader + N Workers. The Team Leader is a special Worker with management skills that handles task decomposition and assignment within the team. Manager delegates tasks to Team Leaders, not directly to team workers.
# 1. Create each Worker CR with worker-management, then reference them
agt create team \
--name <TEAM_NAME> \
--leader-name <LEADER_NAME> \
--workers <w1>,<w2>
# 2. @mention the Leader in Leader Room to assign task
The Team command fails if a referenced Worker does not exist. Configure model, runtime, image, resources, identity, skills, MCP, channel policy, and lifecycle on each Worker CR. After Team reconciliation, @mention the Leader in the Leader Room; the Leader will coordinate referenced workers in the Team Room.
Full workflow: read
references/create-team.md
If admin asks for CPU or memory requests/limits, update Worker.spec.resources. Changing resources recreates that Worker's container, so confirm it is not mid-task.
--team-admin not specified--delegated-to-team — so heartbeat knows to check with Leader, not workers| Admin wants to... | Read | Command |
|---|---|---|
| Create a new team | references/create-team.md | agt create team |
| Understand team lifecycle | references/team-lifecycle.md | — |
| Delegate task to team | references/team-task-delegation.md | — |
| Add/remove worker from team | references/team-lifecycle.md | agt get team |
| Stop/delete a member Worker | references/team-lifecycle.md | scripts/lifecycle-worker.sh (per worker) |
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Find worker agents in Nacos that match a task, recommend candidates, and import the administrator's chosen worker. It also supports importing a specified nacos package URI, with worker name confirmation and direct reporting of installation failures.
Prepare an existing OpenClaw setup for import as an AgentTeams managed Worker. Analyze tool dependencies, adapt role instructions and scheduled jobs, and build a ZIP package containing the configuration and custom image requirements.
Manage communication channels by identifying senders, maintaining trusted contacts, and setting the administrator's primary notification destination. It also covers first contact on a new channel and contacting the administrator across channels, with rules for handling unknown senders.
Prepare coding tasks for delegation to an authorized agent’s AI command-line tool. Set up and synchronize the workspace, write precise change requests, then review returned changes and run relevant checks before reporting completion.
Run AI coding command-line tools on behalf of worker agents using their prepared prompts and workspaces. Detect available tools, configure delegation, return results, and apply supported execution controls such as time budgets and permission settings.
Guide agent replies in Matrix chat rooms, including when to mention a coordinator, report completion, raise blockers, or answer questions. The rules limit repetitive acknowledgments and stop exchanges that add no new task, question, or decision.