@creatoraris/openclaw-wecom 0.3.0 → 0.4.0

package/README.md

@@ -5,300 +5,131 @@
 [![npm version](https://img.shields.io/npm/v/@creatoraris/openclaw-wecom.svg)](https://www.npmjs.com/package/@creatoraris/openclaw-wecom)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## ✨ 特性
+## 特性
 
-- ✅ 支持流式回复（分段发送，体验更流畅）
-- ✅ 支持消息加密（符合企微安全规范）
-- ✅ 支持单聊和群聊
-- ✅ 自动消息去重
-- ✅ 生产环境验证
+- 支持流式回复（分段发送，体验更流畅）
+- 支持消息加密（符合企微安全规范）
+- 支持单聊和群聊
+- 支持图片消息（自动解密 WeCom 加密图片）
+- 支持上下文重置（发送 `/reset` 或 `/重置`）
+- 自动消息去重
+- 作为 OpenClaw 插件运行，随 OpenClaw Gateway 自动启停
 
-## 📋 前置条件
+## 前置条件
 
 - OpenClaw 已安装并运行
 - Node.js >= 18.0.0
 - 企业微信账号（个人也可注册企业版，1-9 人免费）
-- 一台可部署 Webhook 服务的机器（或使用 ngrok 本地开发）
+- 一台可部署 Webhook 服务的机器（或使用 ngrok / Tailscale 进行内网穿透）
 
-## 🚀 快速开始
+## 快速开始
 
-### 总耗时：约 20 分钟
-
-### 步骤 1：安装插件（2 分钟）
+### 步骤 1：安装插件
 
 ```bash
 openclaw plugins install @creatoraris/openclaw-wecom
 ```
 
-### 步骤 2：申请企微机器人（10 分钟）
-
-#### 2.1 注册企业微信
-
-如果还没有企业微信账号：
-
-1. 访问 [企业微信官网](https://work.weixin.qq.com/)
-2. 点击「注册企业」
-3. 填写信息（可以用个人身份注册）
-4. 验证手机号
-
-#### 2.2 创建智能助手机器人
+### 步骤 2：创建企微智能助手机器人
 
 1. 登录 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/)
-2. 左侧菜单：「应用管理」→「应用」
+2. 左侧菜单：「应用管理」 -> 「应用」
 3. 找到「智能助手」，点击进入
-4. 点击「创建智能助手」
-5. 填写名称（如：OpenClaw AI 助手）
-6. 点击「创建」
-
-#### 2.3 配置回调
-
-1. 在智能助手详情页，点击「接收消息」标签
-2. 设置回调 URL：
-   ```
-   https://your-domain.com/wecom/callback
-   ```
-   > 💡 本地开发可以用 [ngrok](https://ngrok.com/)：`https://xxx.ngrok.io/wecom/callback`
-
-3. 点击「生成 Token 和 EncodingAESKey」
-4. **保存这三个值**（下一步要用）：
-   - Token: `abc123...`
-   - EncodingAESKey: `xyz789...`
-   - Webhook URL: `https://your-domain.com/wecom/callback`
-
-5. 点击「保存」
+4. 点击「创建智能助手」，填写名称（如：OpenClaw AI 助手）
+5. 在智能助手详情页，点击「接收消息」标签
+6. 设置回调 URL：`https://your-domain.com/callback`
+7. 点击「生成 Token 和 EncodingAESKey」
+8. 记录 Token 和 EncodingAESKey（下一步配置要用）
+9. 点击「保存」
 
-✅ 机器人申请完成！
+> 本地开发可以用 ngrok：`ngrok http 8788`，将生成的 URL 填入回调
 
-### 步骤 3：配置 OpenClaw（5 分钟）
+### 步骤 3：配置插件
 
-#### 3.1 编辑配置文件
-
-编辑 `~/.openclaw/openclaw.json`：
+编辑 `~/.openclaw/openclaw.json`，在 `plugins.entries` 中添加：
 
 ```json
 {
-  "channels": {
-    "wecom": {
-      "enabled": true,
-      "webhookUrl": "https://your-domain.com/wecom/callback",
-      "token": "你的 Token",
-      "encodingAESKey": "你的 EncodingAESKey",
-      "port": 8788
+  "plugins": {
+    "entries": {
+      "openclaw-wecom": {
+        "enabled": true,
+        "config": {
+          "token": "你的 Token",
+          "encodingAESKey": "你的 EncodingAESKey",
+          "corpId": "你的企业 ID",
+          "port": 8788
+        }
+      }
     }
   }
 }
 ```
 
-#### 3.2 配置环境变量
+企业 ID (corpId) 可在企业微信管理后台「我的企业」页面底部找到。
 
-创建 `.env` 文件（或直接在启动脚本中设置）：
+### 步骤 4：重启 OpenClaw
 
 ```bash
-WECOM_TOKEN=你的Token
-WECOM_ENCODING_AES_KEY=你的EncodingAESKey
-OPENCLAW_API=http://localhost:18789/v1/chat/completions
-OPENCLAW_TOKEN=你的OpenClaw_Gateway_Token
-PORT=8788
+systemctl --user restart openclaw-gateway
 ```
 
-#### 3.3 部署 Webhook 服务
+### 步骤 5：测试
 
-**方式 A：使用 systemd（推荐）**
+在企业微信中找到你创建的智能助手机器人，发送消息，应该会收到 AI 回复。
 
-创建 `/etc/systemd/system/wecom-bridge.service`：
+## 配置说明
 
-```ini
-[Unit]
-Description=OpenClaw WeCom Bridge
-After=network.target
+| 参数 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `token` | 是 | - | 企微回调 Token |
+| `encodingAESKey` | 是 | - | 企微回调 EncodingAESKey |
+| `corpId` | 否 | `""` | 企业 ID，图片功能需要 |
+| `corpSecret` | 否 | `""` | 应用 Secret（智能助手机器人通常不需要） |
+| `port` | 否 | `8788` | 本地监听端口 |
 
-[Service]
-Type=simple
-User=your-user
-WorkingDirectory=/path/to/openclaw-wecom-plugin
-EnvironmentFile=/path/to/.env
-ExecStart=/usr/bin/node index.js
-Restart=always
-RestartSec=10
+## 内置命令
 
-[Install]
-WantedBy=multi-user.target
-```
+在企微聊天窗口中发送以下命令：
 
-启动服务：
+| 命令 | 说明 |
+|------|------|
+| `/reset` | 重置当前对话上下文 |
+| `/重置` | 同上（中文别名） |
 
-```bash
-sudo systemctl daemon-reload
-sudo systemctl enable wecom-bridge
-sudo systemctl start wecom-bridge
-sudo systemctl status wecom-bridge
-```
+上下文被污染或需要开始新话题时，发送重置命令即可清除历史对话。
 
-**方式 B：使用 PM2**
+## 架构说明
 
-```bash
-pm2 start index.js --name wecom-bridge
-pm2 save
-pm2 startup
 ```
-
-**方式 C：本地开发（ngrok）**
-
-```bash
-# 终端 1：启动 webhook 服务
-node index.js
-
-# 终端 2：启动 ngrok
-ngrok http 8788
-# 复制 ngrok 生成的 https URL，配置到企微回调中
+企微客户端 -> 企微服务器 -> 本插件 (HTTP Server) -> OpenClaw Gateway -> AI 模型
+                              |
+                       加密/解密、去重、流式处理、图片解密
 ```
 
-### 步骤 4：测试（1 分钟）
-
-1. 在企业微信中找到你创建的机器人
-2. 发送消息：`你好`
-3. 应该会收到 AI 回复
-
-🎉 恭喜！配置完成！
+本插件作为 OpenClaw 的内置服务运行，随 OpenClaw Gateway 自动启停，无需单独部署。
 
-## 📖 配置说明
+## 安全性
 
-### 完整配置选项
+- 使用 AES-256-CBC 加密通信
+- 消息签名验证
+- 自动消息去重（防止重放攻击）
+- 敏感信息通过 OpenClaw 配置文件管理，不使用环境变量
 
-```json
-{
-  "channels": {
-    "wecom": {
-      "enabled": true,              // 是否启用
-      "webhookUrl": "https://...",  // 回调 URL（必填）
-      "token": "...",               // Token（必填）
-      "encodingAESKey": "...",      // EncodingAESKey（必填）
-      "port": 8788,                 // 监听端口（可选，默认 8788）
-      "streamDelay": 2000           // 流式回复延迟（毫秒，可选）
-    }
-  }
-}
-```
+## 故障排查
 
-### OpenClaw Gateway 配置
-
-确保 OpenClaw Gateway 配置了正确的认证：
-
-```json
-{
-  "gateway": {
-    "auth": {
-      "mode": "token",
-      "token": "your-gateway-token"
-    }
-  }
-}
-```
+查看日志：
 
-## 🔧 故障排查
-
-### 问题：消息发送后没有回复
-
-**检查清单：**
-
-1. Webhook 服务器是否正常运行？
-   ```bash
-   curl http://localhost:8788/health
-   ```
-
-2. 查看日志：
-   ```bash
-   # systemd
-   sudo journalctl -u wecom-bridge -f
-   
-   # pm2
-   pm2 logs wecom-bridge
-   ```
-
-3. 验证 OpenClaw Gateway 连接：
-   ```bash
-   curl http://localhost:18789/v1/status \
-     -H "Authorization: Bearer your-token"
-   ```
-
-### 问题：消息乱码
-
-检查 `encodingAESKey` 是否正确配置。
-
-### 问题：回复速度慢
-
-流式回复会分段发送。可以调整 `streamDelay` 参数：
-
-```json
-{
-  "wecom": {
-    "streamDelay": 1000  // 减小延迟（毫秒）
-  }
-}
-```
-
-### 问题：Webhook 服务启动失败
-
-1. 检查端口是否被占用：
-   ```bash
-   lsof -i :8788
-   ```
-
-2. 检查环境变量是否正确：
-   ```bash
-   echo $WECOM_TOKEN
-   echo $WECOM_ENCODING_AES_KEY
-   ```
-
-## 🏗️ 架构说明
-
-```
-企微客户端 → 企微服务器 → Webhook 服务器 → OpenClaw Gateway → AI 模型
-                           ↓
-                    加密/解密、去重、流式处理
+```bash
+journalctl --user -u openclaw-gateway -f
 ```
 
-### 消息流程
-
-1. 用户在企微发送消息
-2. 企微服务器加密后推送到 Webhook
-3. Webhook 服务解密、验证、去重
-4. 转发到 OpenClaw Gateway
-5. AI 生成回复（流式）
-6. Webhook 服务分段加密发送到企微
-7. 用户收到 AI 回复
-
-## 🔒 安全性
-
-- ✅ 使用 AES-256-CBC 加密
-- ✅ 消息签名验证
-- ✅ 自动消息去重（防止重放攻击）
-- ✅ 环境变量存储敏感信息
+常见问题：
 
-## 🤝 贡献
+- **端口被占用**：检查 `lsof -i :8788`，修改配置中的 port 或停止冲突进程
+- **消息无回复**：确认 OpenClaw Gateway 正常运行，检查日志中的错误信息
+- **回调验证失败**：确认 token 和 encodingAESKey 与企微后台一致
 
-欢迎贡献代码、报告问题或提出建议！
-
-1. Fork 本仓库
-2. 创建特性分支：`git checkout -b feature/amazing-feature`
-3. 提交更改：`git commit -m 'Add amazing feature'`
-4. 推送分支：`git push origin feature/amazing-feature`
-5. 提交 Pull Request
-
-## 📄 License
+## License
 
 MIT License - 详见 [LICENSE](LICENSE) 文件
-
-## 🙏 致谢
-
-- [OpenClaw](https://openclaw.ai) - 强大的 AI 助手框架
-- [企业微信](https://work.weixin.qq.com/) - 提供企业级通讯平台
-
-## 📞 支持
-
-- 提交 Issue：[GitHub Issues](https://github.com/CreatorAris/openclaw-wecom-plugin/issues)
-- 查看文档：[OpenClaw 文档](https://docs.openclaw.ai)
-
----
-
-**注意：** 本项目为 beta 版本，欢迎反馈和建议！

package/index.js

@@ -28,6 +28,11 @@ const plugin = {
     const botCrypto = new WeComCrypto(token, encodingAESKey, corpId);
     const log = api.logger;
 
+    // ── Sessions directory (for context reset) ──
+    const openclawDir = path.dirname(api.config?.agents?.defaults?.workspace || path.join(process.env.HOME, '.openclaw', 'workspace'));
+    const sessionsDir = path.join(openclawDir, 'agents', 'main', 'sessions');
+    const RESET_COMMANDS = ['/reset', '/重置'];
+
     // ── Stream state management ──
     const streams = new Map();
 
@@ -129,18 +134,41 @@ const plugin = {
       }
     }
 
+    function decryptImageIfNeeded(buf) {
+      // Check if already a known image format
+      if ((buf[0] === 0xff && buf[1] === 0xd8) || (buf[0] === 0x89 && buf[1] === 0x50)) return buf;
+      // Try AES-256-CBC decryption with WeCom encodingAESKey
+      if (buf.length % 16 !== 0) return buf;
+      try {
+        const decipher = crypto.createDecipheriv('aes-256-cbc', botCrypto.aesKey, botCrypto.iv);
+        decipher.setAutoPadding(false);
+        let decrypted = Buffer.concat([decipher.update(buf), decipher.final()]);
+        // Remove PKCS7 padding
+        const pad = decrypted[decrypted.length - 1];
+        if (pad > 0 && pad <= 32) decrypted = decrypted.subarray(0, decrypted.length - pad);
+        // Verify it's a real image now
+        if ((decrypted[0] === 0xff && decrypted[1] === 0xd8) || (decrypted[0] === 0x89 && decrypted[1] === 0x50)) {
+          log.info('[Image] decrypted successfully');
+          return decrypted;
+        }
+        return buf;
+      } catch { return buf; }
+    }
+
     async function downloadImage(imageUrl) {
       try {
         log.info(`[Image] downloading ${imageUrl.slice(0, 100)}`);
         const response = await fetch(imageUrl);
         if (!response.ok) return null;
-        const buffer = await response.arrayBuffer();
+        let buffer = Buffer.from(await response.arrayBuffer());
         if (buffer.byteLength > 10 * 1024 * 1024) return null;
+        buffer = decryptImageIfNeeded(buffer);
         await fs.mkdir(IMAGE_CACHE_DIR, { recursive: true });
-        const ext = path.extname(new URL(imageUrl).pathname) || '.jpg';
+        // Detect actual format from magic bytes
+        const ext = (buffer[0] === 0x89 && buffer[1] === 0x50) ? '.png' : '.jpg';
         const filename = `${Date.now()}-${crypto.randomBytes(4).toString('hex')}${ext}`;
         const filepath = path.join(IMAGE_CACHE_DIR, filename);
-        await fs.writeFile(filepath, Buffer.from(buffer));
+        await fs.writeFile(filepath, buffer);
         log.info(`[Image] saved ${filename} (${(buffer.byteLength / 1024 / 1024).toFixed(2)}MB)`);
         return filepath;
       } catch (err) {
@@ -150,6 +178,7 @@ const plugin = {
     }
 
     async function resolveImage(imageObj) {
+      log.info(`[Image] raw fields: ${JSON.stringify(imageObj)}`);
       const mediaId = imageObj?.media_id;
       const imageUrl = imageObj?.url || imageObj?.pic_url;
       let localPath = null;
@@ -405,6 +434,43 @@ const plugin = {
             return;
           }
 
+          // ── Context reset command ──
+          if (RESET_COMMANDS.includes(text.trim().toLowerCase())) {
+            const sessionId = chattype === 'group' ? `wecom_group_${chatid}` : `wecom_bot_${from?.userid}`;
+            const sessionKey = `agent:main:openresponses-user:${sessionId}`;
+            let resetMsg = '上下文已重置，开始新的对话。';
+
+            try {
+              const sessionsFile = path.join(sessionsDir, 'sessions.json');
+              const sessionsData = JSON.parse(await fs.readFile(sessionsFile, 'utf8'));
+              const session = sessionsData[sessionKey];
+              if (session?.sessionId) {
+                const sessionFile = path.join(sessionsDir, `${session.sessionId}.jsonl`);
+                await fs.rename(sessionFile, `${sessionFile}.reset.${Date.now()}`).catch(() => {});
+                delete sessionsData[sessionKey];
+                await fs.writeFile(sessionsFile, JSON.stringify(sessionsData, null, 2));
+                log.info(`[Reset] session ${sessionKey} cleared`);
+              } else {
+                log.info(`[Reset] no session found for ${sessionKey}`);
+                resetMsg = '当前没有活跃的对话上下文。';
+              }
+            } catch (err) {
+              log.error(`[Reset] error: ${err.message}`);
+              resetMsg = '重置失败，请稍后重试。';
+            }
+
+            const resetStreamId = makeStreamId();
+            streams.set(resetStreamId, { content: resetMsg, finished: true, createdAt: Date.now() });
+            const replyObj = {
+              msgtype: 'stream',
+              stream: { id: resetStreamId, finish: true, content: resetMsg },
+            };
+            const encrypted = encryptReply(replyObj, nonce);
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(encrypted);
+            return;
+          }
+
           // Create stream state and start OpenClaw request
           const streamId = makeStreamId();
           const sessionId = chattype === 'group' ? `wecom_group_${chatid}` : `wecom_bot_${from?.userid}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creatoraris/openclaw-wecom",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Enterprise WeChat (WeCom) channel plugin for OpenClaw - 企业微信智能助手机器人桥接",
   "main": "index.js",
   "type": "module",