agentscope-ai Channel Management
Manages communication channels, admin identity recognition, trusted contacts, and primary channel configuration.
Gotchas
- Primary channel cannot be set to "matrix" — Matrix DM is the default fallback. Use
--action resetto revert to it - Unknown senders in group rooms must be silently ignored — no response at all, until admin explicitly approves them as trusted contacts
- Trusted contacts must never receive sensitive info — no API keys, tokens, passwords, Worker credentials, or internal config. No management operations either
- When calling
messagetool from a Matrix session, you MUST explicitly setchannelandtarget— otherwise the message goes to the current Matrix room instead of the primary channel tofield in primary-channel.json maps totargetparameter inmessagetool — pass the value directly, no transformation needed- First-contact protocol: always ask in admin's language — match the language they used in their message
- Task dispatch must go to Worker Room, not admin DM — when assigning tasks to Workers, use the task-management skill's send protocol (runtime-aware:
agt get managers -o jsonfor runtime, then message tool orcopaw channels sendper finite/infinite references). Never embed @worker task assignments in admin DM replies.
Operation Reference
Read the relevant doc before executing. Do not load all of them.
| Situation | Read |
|---|---|
| Need to identify who sent a message (admin, worker, trusted contact, unknown) | references/identity-and-contacts.md |
| Add/remove trusted contacts | references/identity-and-contacts.md |
| Configure primary channel, send notifications, first-contact protocol, cross-channel escalation | references/primary-channel.md |