channel-message

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 qwenpaw chats list, then push with qwenpaw channels send.
metadata	{"builtin_skill_version":"1.3","qwenpaw":{"emoji":"📤"}}

Channel Message

When to Use

Use this skill only when the user explicitly asks you to send a message to a channel/session, or when you need to proactively push a notification (e.g., task completion, reminders, alerts). This is a one-way send — no reply is returned.

Should Use

• The user explicitly asks to send to a specific channel/session
• Proactively notifying the user after a task completes
• Scheduled reminders, alerts, or status updates
• Pushing async results back to an existing session
• The user explicitly says "notify me when done"

Should Not Use

• If you are simply replying in the current session, do not use qwenpaw channels send
• You need a two-way conversation and expect an immediate reply
• You do not know which target session to use
• You are guessing target-user or target-session

Decision Rules

1. Only use this when the user explicitly asks to send to a channel/session, or proactive notification is needed
2. You must query sessions before sending
3. Do not guess target-user or target-session
4. If multiple sessions are found, prefer the most recently active one
5. channel send is a one-way push — no user reply is returned

---

Most Common Commands

1) Query available sessions first

qwenpaw chats list --agent-id <your_agent> --channel <channel>

You can also filter by user:

qwenpaw chats list --agent-id <your_agent> --user-id <user_id>

2) Send a message

qwenpaw channels send \
  --agent-id <your_agent> \
  --channel <channel> \
  --target-user <user_id> \
  --target-session <session_id> \
  --text "..."

---

Minimal Workflow

1. Determine: is the user explicitly requesting a send, or is proactive notification needed?
2. qwenpaw chats list — query the target session
3. Extract user_id and session_id from the results
4. If multiple sessions exist, prefer the most recently active one
5. qwenpaw channels send — send the message
6. Done (no reply)

---

Key Rules

Required Parameters

qwenpaw channels send requires all of the following:

• --agent-id
• --channel
• --target-user
• --target-session
• --text

Must Query First

Before sending, run:

qwenpaw chats list --agent-id <your_agent> --channel <channel>

Extract from the results:

• user_id → --target-user
• session_id → --target-session

If there are multiple candidate sessions, prefer the one with the most recent updated_at.

One-Way Push

qwenpaw channels send only sends — it does not wait for a reply.

---

Brief Examples

User explicitly asks to send to a channel

qwenpaw chats list --agent-id notify_bot --channel feishu

qwenpaw channels send \
  --agent-id notify_bot \
  --channel feishu \
  --target-user manager_id \
  --target-session manager_session \
  --text "Weekly report is ready, please review"

Task completion notification

qwenpaw chats list --agent-id task_bot --channel console

qwenpaw channels send \
  --agent-id task_bot \
  --channel console \
  --target-user alice \
  --target-session alice_console_001 \
  --text "Task completed"

Async result push-back

qwenpaw chats list --agent-id analyst_bot --user-id alice

qwenpaw channels send \
  --agent-id analyst_bot \
  --channel console \
  --target-user alice \
  --target-session alice_console_001 \
  --text "Data analysis is complete. Results saved to report.pdf"

---

Common Mistakes

Mistake 1: Using channel send for a normal reply

If you are replying to the user in the current session, do not use qwenpaw channels send.

Mistake 2: Sending without querying sessions first

Do not guess target-user or target-session. First run:

qwenpaw chats list --agent-id <your_agent> --channel <channel>

Mistake 3: Missing required parameters

All five are required: --agent-id, --channel, --target-user, --target-session, --text.

Mistake 4: Expecting a reply from send

There is no reply. It only pushes the message.

Mistake 5: Picking an arbitrary session when the user has multiple

Prefer the most recently active session.

---

Optional Commands

List all sessions

qwenpaw chats list --agent-id <your_agent>

List sessions for a specific user

qwenpaw chats list --agent-id <your_agent> --user-id <user_id>

List available channels

qwenpaw channels list --agent-id <your_agent>

---

Difference from Agent Chat

• qwenpaw agents chat: sends to another agent, two-way, returns a reply
• qwenpaw channels send: sends to a user/session/channel, one-way, no reply

Selection principle:

• Need to collaborate with another agent → qwenpaw agents chat
• Need to proactively push a message to a user → qwenpaw channels send

---

Full Parameter Reference

qwenpaw chats list

Required parameters:

• --agent-id: Agent ID

Optional parameters:

• --channel: filter by channel
• --user-id: filter by user
• --base-url: override API address

qwenpaw channels send

Required parameters (5):

• --agent-id: sender agent ID
• --channel: target channel (console/dingtalk/feishu/discord/imessage/qq/...)
• --target-user: target user ID (obtained from qwenpaw chats list)
• --target-session: target session ID (obtained from qwenpaw chats list)
• --text: message content

Optional parameters:

• --base-url: override API address

---

Help

Use -h at any time to view detailed help:

qwenpaw channels -h
qwenpaw channels send -h
qwenpaw chats -h
qwenpaw chats list -h