| name | channel_message |
| description | Use this skill to proactively send a one-way message to a user/session/channel, usually only when the user explicitly asks to send to a channel/session or when proactive notification is needed. First query sessions with copaw chats list, then push with copaw channels send. | 当需要主动向用户/会话/频道单向推送消息时使用，通常仅在用户明确要求发往某个 channel / 会话，或需要主动通知时使用；先用 copaw chats list 查 session，再用 copaw channels send 推送 |
| metadata | {"builtin_skill_version":"1.1","copaw":{"emoji":"📤"}} |
Channel Message（频道消息推送）
什么时候用
通常只有在用户明确要求向某个 channel / 会话发送消息，或你需要主动推送通知（如任务完成、提醒、告警）时，使用本 skill。
这是单向发送，不会返回回复。
应该使用
- 用户明确要求发往某个 channel / 会话
- 任务完成后主动通知用户
- 定时提醒、告警、状态更新
- 将异步结果推送回某个已有会话
- 用户明确要求"处理完后通知我"
不应使用
- 如果只是当前会话中的正常回复，不要使用
copaw channels send
- 需要和用户进行双向对话并立即等待回复
- 还不知道目标 session 是哪个
- 想当然猜测
target-user 或 target-session
决策规则
- 通常只有在用户明确要求发往某个 channel / 会话，或需要主动通知时才使用
- 发送前必须先查 session
- 不要猜
target-user 和 target-session
- 如果查到多个 session，优先使用最近活跃的
channel send 是单向推送，不会返回用户回复
最常用命令
1) 先查询可用 sessions
copaw chats list --agent-id <your_agent> --channel <channel>
也可以按用户筛选：
copaw chats list --agent-id <your_agent> --user-id <user_id>
2) 发送消息
copaw channels send \
--agent-id <your_agent> \
--channel <channel> \
--target-user <user_id> \
--target-session <session_id> \
--text "..."
最小工作流
1. 判断：是否为用户明确要求发送，或是否需要主动通知
2. copaw chats list 查询目标 session
3. 从结果中获取 user_id 和 session_id
4. 若有多个 session，优先选最近活跃的
5. copaw channels send 发送消息
6. 结束（无回复）
关键规则
必填参数
copaw channels send 必须同时提供：
--agent-id--channel--target-user--target-session--text
必须先查询
发送前先执行：
copaw chats list --agent-id <your_agent> --channel <channel>
从结果中获取：
user_id → --target-usersession_id → --target-session
如果有多个候选 session，优先选择 updated_at 最近的会话。
单向推送
copaw channels send 只负责发送，不等待回复。
简短示例
用户明确要求发往某个 channel
copaw chats list --agent-id notify_bot --channel feishu
copaw channels send \
--agent-id notify_bot \
--channel feishu \
--target-user manager_id \
--target-session manager_session \
--text "周报已生成，请查收"
任务完成通知
copaw chats list --agent-id task_bot --channel console
copaw channels send \
--agent-id task_bot \
--channel console \
--target-user alice \
--target-session alice_console_001 \
--text "✅ 任务已完成"
异步结果回推
copaw chats list --agent-id analyst_bot --user-id alice
copaw channels send \
--agent-id analyst_bot \
--channel console \
--target-user alice \
--target-session alice_console_001 \
--text "数据分析已完成，结果已保存到 report.pdf"
常见错误
错误 1：把正常回复当成 channel send
如果你正在当前会话里直接回复用户，不要使用 copaw channels send。
错误 2：没查 session 就直接发
不要猜 target-user 或 target-session，先执行：
copaw chats list --agent-id <your_agent> --channel <channel>
错误 3：缺少必填参数
--agent-id、--channel、--target-user、--target-session、--text 五个都必填。
错误 4：以为 send 会拿到回复
不会。它只是推送消息。
错误 5：用户有多个 session 时随便选一个
应优先选择最近活跃的 session。
可选命令
查看所有会话
copaw chats list --agent-id <your_agent>
查看某个用户的会话
copaw chats list --agent-id <your_agent> --user-id <user_id>
查看可用频道
copaw channels list --agent-id <your_agent>
与 Agent Chat 的区别
- copaw agents chat：发给其他 agent，双向，有回复
- copaw channels send：发给用户/会话/频道，单向，无回复
选择原则：
- 要找其他 agent 协作 →
copaw agents chat
- 要主动给用户推送消息 →
copaw channels send
完整参数说明
copaw chats list
必填参数：
可选参数：
--channel：按频道筛选--user-id：按用户筛选--base-url：覆盖API地址
copaw channels send
必填参数（5个）：
--agent-id：发送方agent ID--channel：目标频道（console/dingtalk/feishu/discord/imessage/qq/...）--target-user：目标用户ID（从 copaw chats list 获取）--target-session：目标会话ID（从 copaw chats list 获取）--text：消息内容
可选参数：
帮助信息
随时使用 -h 查看详细帮助：
copaw channels -h
copaw channels send -h
copaw chats -h
copaw chats list -h
