Handle standalone administration tasks on a Tuwunel Matrix server, including registering users, creating rooms, managing membership, and uploading files. It also covers sending files to an administrator and identifies mention and room-joining requirements that affect Workers.
Use for standalone Matrix admin requests (register users, create rooms, manage membership, upload files). Also use when you need to send a file to the admin via Matrix media upload. Do NOT use for Worker/project creation — those handle Matrix operations internally.
Review the instructions the agent will receive before you install.
Manage the Tuwunel Matrix Homeserver at ${AGENTTEAMS_MATRIX_URL}. User ID format: @<username>:${AGENTTEAMS_MATRIX_DOMAIN}.
m.mentions — they have requireMention: true. You MUST include m.mentions.user_ids with the full Matrix user ID for Workers to process the message (MSC3952)m.mentions.user_ids must match exactly — partial or mismatched IDs cause silent failurestrusted_private_chat only invites members — you must ensure each invited user accepts with POST /join; Controller-managed Worker and Team flows do this on the user's behalfcreate-worker.sh and create-project.sh handle Matrix operations internally| Situation | Read |
|---|---|
| Any Matrix API call (register, login, rooms, messages, mentions, file upload) | references/api-reference.md |
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.