@dhfpub/clawpool 0.1.2 → 0.2.0

package/skills/message-send/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: message-send
+description: 发送私信消息。支持当前会话回复和跨会话私信。使用场景：(1) 需要给 owner/特定用户发送私信通知 (2) 跨会话发送消息 (3) 主动推送消息给指定目标。触发词：发私信、私信、发送消息、send message、notify。
+---
+
+# 消息发送技能
+
+这个技能用于通过 OpenClaw 的 `message` 工具发送消息。
+
+---
+
+## 两种发送模式
+
+### 1. 当前会话回复
+
+在当前聊天上下文中回复消息，不需要额外参数。
+
+**参数**：
+- `action`: "send"
+- `channel`: 当前渠道（如 "clawpool"）
+- `accountId`: 当前账号 ID
+- `message`: 消息内容
+
+**使用场景**：
+- 在当前对话中回复用户
+- 当前会话内的正常消息发送
+
+### 2. 跨会话私信
+
+脱离当前聊天上下文，给其他会话发送私信。
+
+**参数**：
+- `action`: "send"
+- `channel`: "clawpool"
+- `accountId`: 发送账号 ID（如 "{accountId}"）
+- `target`: 目标会话标识（格式见下文）
+- `message`: 消息内容
+
+**使用场景**：
+- 给 owner 发送通知/审批请求
+- 跨会话发送消息
+- 主动推送消息给指定目标
+
+---
+
+## Target 格式说明
+
+### Clawpool 私信格式
+
+```
+target=agent:{agentId}:clawpool:direct:{sessionId}
+```
+
+**参数说明**：
+- `{agentId}`: 当前 agent 的 ID（如 "clawpool-developer"）
+- `{sessionId}`: 目标私聊会话的 session ID（UUID 格式）
+
+**示例**：
+```
+target=agent:clawpool-developer:clawpool:direct:e72ce987-2d2e-40ed-bcc9-b336b4974512
+```
+
+### 如何获取 sessionId
+
+1. **从 inbound context 获取**：当 owner 给你发私信时，inbound meta 中的 `chat_id` 包含 session ID
+2. **从 MEMORY.md 获取**：如果 workspace 的 MEMORY.md 记录了 owner 的会话 ID，直接使用
+3. **从会话列表获取**：通过 `sessions_list` 工具查找目标会话
+
+---
+
+## 实际调用示例
+
+### 示例 1：当前会话回复
+
+```json
+{
+  "action": "send",
+  "channel": "clawpool",
+  "accountId": "{accountId}",
+  "message": "收到，正在处理中..."
+}
+```
+
+### 示例 2：给 owner 发私信
+
+```json
+{
+  "action": "send",
+  "channel": "clawpool",
+  "accountId": "{accountId}",
+  "target": "agent:{agentId}:clawpool:direct:{ownerSessionId}",
+  "message": "需要您确认一个开发决策：..."
+}
+```
+
+### 示例 3：发送到群组
+
+```json
+{
+  "action": "send",
+  "channel": "clawpool",
+  "accountId": "{accountId}",
+  "target": "{groupId}",
+  "message": "任务已完成，请查看结果"
+}
+```
+
+---
+
+## 关键参数说明
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `action` | ✅ | 固定值 "send" |
+| `channel` | ✅ | 渠道类型，如 "clawpool" |
+| `accountId` | ✅ | 发送账号 ID |
+| `message` | ✅ | 消息内容 |
+| `target` | 私信必填 | 目标会话标识（私信/群组） |
+
+---
+
+## 注意事项
+
+1. **区分 `target` 和 `to`**：Clawpool 使用 `target` 参数，不是 `to`
+2. **sessionId 是 UUID**：不要混淆用户 ID 和会话 ID
+3. **权限检查**：确保有目标会话的发送权限
+4. **消息格式**：支持纯文本和 markdown
+
+---
+
+## 错误处理
+
+常见错误及处理方式：
+
+- **target 不存在**：确认 session ID 是否正确
+- **权限不足**：检查 accountId 是否有目标会话的发送权限
+- **参数缺失**：确保必填参数都已提供
+- **格式错误**：检查 target 格式是否符合要求
+
+---
+
+## 最佳实践
+
+1. **记录 owner sessionId**：在 workspace 的 MEMORY.md 中记录 owner 的会话 ID，方便后续调用
+2. **使用变量**：在代码中使用 `{agentId}`、`{accountId}` 等变量，而不是硬编码
+3. **简洁明了**：私信消息应简洁，突出重点
+4. **适当使用**：不要滥用私信功能，避免打扰 owner

package/skills/message-unsend/SKILL.md

@@ -0,0 +1,221 @@
+---
+name: message-unsend
+description: 回撤/撤回已发送的消息。支持当前会话回撤和跨会话回撤。使用场景：(1) 用户要求撤回/删除某条消息 (2) 需要删除错误发送的内容 (3) 跨渠道或跨会话回撤消息 (4) 清理不需要的消息记录。触发词：撤回、回撤、删除消息、unsend、recall。
+---
+
+# 消息回撤技能
+
+这个技能用于通过 OpenClaw 的 `message` 工具回撤已发送的消息。
+
+---
+
+## ⚠️ 权限控制（严格）
+
+**只有郭同学（sender_id: 2030840865701756928）要求撤回消息时，才能执行此技能。**
+
+### ✅ 允许执行的情况
+- 郭同学在**私聊**中说"撤回/回撤/删除消息"
+- 郭同学在**群聊**中说"撤回/回撤/删除消息"
+- 郭同学引用消息要求撤回
+
+### ❌ 禁止执行的情况
+- 其他用户要求撤回（无论私聊还是群聊）
+- 郭同学之外任何人发出撤回指令
+
+### 🔇 对其他人撤回请求的处理
+**完全忽略，不回复，不执行**
+- ❌ 不要说"需要郭同学确认"
+- ❌ 不要解释为什么不能撤回
+- ❌ 不要回复任何内容
+- ✅ 直接返回 `NO_REPLY` 或完全忽略
+
+---
+
+## 🎯 核心行为：完全静默 + 双重撤回（最高优先级）
+
+**撤回操作的黄金法则**：让一切就像从未发生过一样。
+
+### 执行流程（必须严格遵守）
+
+当郭同学发送撤回指令时，**必须按顺序执行三步**：
+
+1. **撤回目标消息**（郭同学指定的消息）
+2. **撤回指令消息**（郭同学发出的"撤回"指令本身）
+3. **返回 NO_REPLY**（不发出任何回复）
+
+### ⚠️ 绝对禁止
+
+- ❌ 不要发送"已撤回"确认消息
+- ❌ 不要发送"撤回成功"
+- ❌ 不要发送任何内容
+- ❌ 不要留下任何"尾巴"
+
+### 📋 实际示例
+
+```
+场景：郭同学引用消息 A，发送"撤回"（消息 B）
+
+正确执行：
+Step 1: unsend(messageId=A)        // 撤回目标消息
+Step 2: unsend(messageId=B)        // 撤回指令消息
+Step 3: 返回 NO_REPLY               // 完全静默
+
+最终效果：
+- 消息 A 被删除 ✓
+- 消息 B 被删除 ✓
+- 没有任何新消息产生 ✓
+- 就像什么都没发生过 ✓
+```
+
+### 🔑 关键要点
+
+**双重撤回的目的**：避免留下"撤回"指令这条消息，让整个操作完全隐形。
+
+**静默模式的目的**：不产生任何新消息，保持对话历史的干净。
+
+**最终效果**：目标消息没了，指令消息也没了，就像它们从未存在过。
+
+---
+
+## 两种回撤模式
+
+### 1. 当前会话回撤
+
+在当前聊天上下文中回撤消息，只需要 `messageId`。
+
+**参数**：
+- `action`: "unsend"
+- `messageId`: 要回撤的消息 ID（字符串）
+
+**示例**：
+```
+action=unsend
+params={ "messageId": "18889990099" }
+```
+
+**使用场景**：
+- 用户在当前对话中说"把刚才那条撤回"
+- 你发送了错误内容需要立即回撤
+- 当前会话内的消息管理
+
+### 2. 跨会话回撤
+
+脱离当前聊天上下文，回撤其他会话中的消息，需要 `messageId` + `sessionId`。
+
+**参数**：
+- `action`: "unsend"
+- `messageId`: 要回撤的消息 ID（字符串）
+- `sessionId`: 目标会话 ID（字符串）
+
+**示例**：
+```
+action=unsend
+params={ 
+  "messageId": "18889990099", 
+  "sessionId": "u_1001_u_2001" 
+}
+```
+
+**使用场景**：
+- 回撤在其他渠道（Discord、Telegram、Signal 等）发送的消息
+- 回撤在其他私聊或群组中的消息
+- 跨会话管理消息
+
+## 实际调用示例
+
+### 示例 1：当前会话回撤
+
+```json
+{
+  "action": "unsend",
+  "messageId": "2033329436849868800"
+}
+```
+
+### 示例 2：跨会话回撤
+
+```json
+{
+  "action": "unsend",
+  "messageId": "18889990099",
+  "sessionId": "telegram:session:123456789"
+}
+```
+
+## 重要说明
+
+1. **只能回撤自己发送的消息**：无法回撤其他用户的消息
+2. **时间限制**：某些渠道（如 Telegram）有回撤时间窗口限制
+3. **权限要求**：需要确保有目标会话的操作权限
+4. **messageId 获取**：
+   - 从 inbound context 中的 `message_id` 字段获取
+   - 从之前发送消息的返回结果中获取
+   - 从会话历史记录中查找
+
+## 错误处理
+
+常见错误及处理方式：
+
+- **messageId 不存在**：确认消息 ID 是否正确
+- **权限不足**：检查是否有目标会话的操作权限
+- **超时限制**：告知用户该渠道的回撤时间限制
+- **消息已删除**：消息可能已被其他方式删除
+
+## Clawpool 实测结果（2026-03-16 更新）
+
+**状态**：✅ 可用
+
+在 Clawpool 渠道测试成功，可以撤回 agent 和用户发送的消息。
+
+**必填参数**（完整参数）：
+```
+action=unsend
+channel=clawpool
+accountId=default
+topic=<session-id>  // 不要加 clawpool: 前缀
+messageId=<message-id>
+```
+
+**测试记录**：
+```json
+// 撤回 agent 发送的消息
+{
+  "action": "unsend",
+  "channel": "clawpool",
+  "accountId": "default",
+  "topic": "5c495569-ba1b-46ac-8070-5a1193a3f950",
+  "messageId": "2033371385615093760"
+}
+// 返回：
+{
+  "ok": true,
+  "deleted": true,
+  "unsent": true,
+  "messageId": "2033371385615093760",
+  "sessionId": "5c495569-ba1b-46ac-8070-5a1193a3f950"
+}
+
+// 撤回用户发送的消息（sender_id: 2030840865701756928）
+{
+  "action": "unsend",
+  "channel": "clawpool",
+  "accountId": "default",
+  "topic": "5c495569-ba1b-46ac-8070-5a1193a3f950",
+  "messageId": "2033474284277993472"
+}
+// 返回：
+{
+  "ok": true,
+  "deleted": true,
+  "unsent": true,
+  "messageId": "2033474284277993472",
+  "sessionId": "5c495569-ba1b-46ac-8070-5a1193a3f950"
+}
+```
+
+**重要说明**：
+- ⚠️ 必须使用完整参数（channel, accountId, topic, messageId），只传 messageId 会失败
+- topic 参数不要加 `clawpool:` 前缀，直接使用 session ID
+- 返回结果包含 `deleted` 和 `unsent` 状态确认
+- ✅ **可以撤回 agent 和用户发送的消息**（Clawpool 特殊能力）
+- ⚠️ 但权限控制仍然有效：只允许郭同学（sender_id: 2030840865701756928）要求撤回

package/skills/message-unsend/flowchart.mermaid

@@ -0,0 +1,113 @@
+```mermaid
+flowchart TD
+    Start([用户发送撤回请求]) --> CheckSender{检查发送者身份}
+    
+    CheckSender -->|sender_id = 2030840865701756928| CheckChatType{检查会话类型}
+    CheckSender -->|其他用户| RejectOther[拒绝请求]
+    RejectOther --> ReplyOther[回复: 需要郭同学确认]
+    ReplyOther --> End1([结束])
+    
+    CheckChatType -->|chat_type = direct| ExtractMsgId{提取 messageId}
+    CheckChatType -->|group| CheckGroupPermission{群聊权限检查}
+    
+    CheckGroupPermission -->|有权限| ExtractMsgId
+    CheckGroupPermission -->|无权限| RejectGroup[拒绝群聊撤回]
+    RejectGroup --> ReplyGroup[回复: 请私聊确认]
+    ReplyGroup --> End2([结束])
+    
+    ExtractMsgId -->|明确指定| ValidateMsgId{验证 messageId}
+    ExtractMsgId -->|模糊引用<br/>如'刚才那条'| SearchRecent[搜索最近消息]
+    
+    SearchRecent --> FoundRecent{找到消息?}
+    FoundRecent -->|是| ValidateMsgId
+    FoundRecent -->|否| AskUser[询问具体消息]
+    AskUser --> UserInput[等待用户输入]
+    UserInput --> ExtractMsgId
+    
+    ValidateMsgId -->|有效| CheckMsgOwnership{验证消息归属}
+    ValidateMsgId -->|无效| ErrorInvalid[错误: 无效的消息ID]
+    ErrorInvalid --> AskRetry[询问是否重试]
+    AskRetry -->|是| ExtractMsgId
+    AskRetry -->|否| End3([结束])
+    
+    CheckMsgOwnership -->|agent 发送| CheckTimeWindow{检查时间窗口}
+    CheckMsgOwnership -->|其他用户发送| RejectOwnership[拒绝: 不能撤回他人消息]
+    RejectOwnership --> ReplyOwnership[回复: 只能撤回自己的消息]
+    ReplyOwnership --> End4([结束])
+    
+    CheckTimeWindow -->|在限制内| CheckChannel{检查渠道}
+    CheckTimeWindow -->|超时| ErrorTimeout[错误: 超过时间限制]
+    ErrorTimeout --> ReplyTimeout[回复: 该渠道撤回时限已过]
+    ReplyTimeout --> End5([结束])
+    
+    CheckChannel -->|Clawpool| PrepareClawpool[准备完整参数<br/>channel=clawpool<br/>accountId=default<br/>topic=sessionId<br/>messageId]
+    CheckChannel -->|Telegram| CheckTelegramLimit{Telegram 48h限制}
+    CheckChannel -->|Discord| CheckDiscordLimit{Discord 权限检查}
+    CheckChannel -->|其他渠道| PrepareBasic[准备基本参数<br/>messageId]
+    
+    CheckTelegramLimit -->|未超时| PrepareBasic
+    CheckTelegramLimit -->|超时| ErrorTelegram[错误: 超过48h]
+    ErrorTelegram --> ReplyTelegram[回复: Telegram撤回时限48小时]
+    ReplyTelegram --> End6([结束])
+    
+    CheckDiscordLimit -->|有权限| PrepareBasic
+    CheckDiscordLimit -->|无权限| ErrorDiscord[错误: 权限不足]
+    ErrorDiscord --> ReplyDiscord[回复: 需要管理员权限]
+    ReplyDiscord --> End7([结束])
+    
+    PrepareClawpool --> ExecuteUnsend[执行撤回操作]
+    PrepareBasic --> ExecuteUnsend
+    
+    ExecuteUnsend --> CheckResult{检查返回结果}
+    
+    CheckResult -->|成功| LogSuccess[记录撤回日志]
+    CheckResult -->|失败| ParseError{解析错误类型}
+    
+    ParseError -->|权限错误| HandlePermission[处理权限错误]
+    ParseError -->|消息不存在| HandleNotFound[处理消息不存在]
+    ParseError -->|网络错误| HandleNetwork[处理网络错误]
+    ParseError -->|未知错误| HandleUnknown[处理未知错误]
+    
+    HandlePermission --> RetryPermission{是否重试?}
+    HandleNotFound --> NotifyNotFound[通知: 消息已删除]
+    HandleNetwork --> RetryNetwork{重试网络?}
+    HandleUnknown --> LogError[记录错误详情]
+    
+    RetryPermission -->|是| ExecuteUnsend
+    RetryPermission -->|否| NotifyPermission[通知: 权限问题]
+    
+    RetryNetwork -->|是| ExecuteUnsend
+    RetryNetwork -->|否| NotifyNetwork[通知: 网络问题]
+    
+    LogSuccess --> ConfirmUser[确认撤回成功]
+    NotifyNotFound --> End8([结束])
+    NotifyPermission --> End9([结束])
+    NotifyNetwork --> End10([结束])
+    LogError --> NotifyUnknown[通知: 未知错误]
+    ConfirmUser --> CleanupTemp[清理临时数据]
+    NotifyUnknown --> End11([结束])
+    
+    CleanupTemp --> End12([结束])
+    
+    style Start fill:#e1f5e1
+    style End1 fill:#ffe1e1
+    style End2 fill:#ffe1e1
+    style End3 fill:#ffe1e1
+    style End4 fill:#ffe1e1
+    style End5 fill:#ffe1e1
+    style End6 fill:#ffe1e1
+    style End7 fill:#ffe1e1
+    style End8 fill:#ffe1e1
+    style End9 fill:#ffe1e1
+    style End10 fill:#ffe1e1
+    style End11 fill:#ffe1e1
+    style End12 fill:#e1f5e1
+    style CheckSender fill:#fff4e1
+    style CheckChatType fill:#fff4e1
+    style CheckMsgOwnership fill:#fff4e1
+    style CheckTimeWindow fill:#fff4e1
+    style CheckChannel fill:#fff4e1
+    style ExecuteUnsend fill:#e1f0ff
+    style LogSuccess fill:#e1f5e1
+    style ParseError fill:#ffe1e1
+```