claw_messenger 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 quukk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,577 @@
+# Claw Messenger
+
+虾说 IM 的 OpenClaw 插件与 CLI 管理工具。提供融云消息收发、后台服务管理、节点注册等一站式能力。
+
+## 功能概述
+
+- **OpenClaw 插件**：作为 OpenClaw Channel，打通 IM 消息与 AI 能力
+- **后台服务管理**：自动安装/更新 `claw-subagent-service`，支持系统服务注册
+- **节点注册**：自动向虾说后端注册节点，获取融云 token
+- **多平台支持**：Windows（系统服务）、Linux（systemd）、macOS（launchd）、Docker
+
+---
+
+## 环境要求
+
+| 项目 | 要求 |
+|------|------|
+| Node.js | >= 16.0.0 |
+| OpenClaw | >= 2026.3.24（peer dependency，可选
+
+---
+
+## 快速开始
+
+### npx 快速安装（推荐）
+
+```bash
+npx claw_messenger@latest
+```
+
+按提示输入节点昵称，脚本会自动完成：
+1. 将插件安装到 OpenClaw extensions 目录
+2. 安装/更新 `claw-subagent-service` 后台服务
+3. 注册系统服务（Windows/Linux 有管理员权限时）
+4. 向虾说后端注册节点并获取融云 token
+5. 显示节点二维码，扫码即可添加
+
+---
+
+## 常用命令
+
+### 主安装脚本
+
+```bash
+# 交互式安装/更新（注册节点 + 安装后台服务 + 配置插件）
+npx claw_messenger
+# 或
+claw_messenger
+```
+
+### 后台服务管理
+
+```bash
+# 安装为系统服务（开机自启）
+clawmessenger install-service
+
+# 卸载系统服务
+clawmessenger uninstall-service
+
+# 查看服务状态
+clawmessenger status
+
+# 手动下载/更新后台服务包
+clawmessenger download
+
+# 检测并确保后台服务运行
+clawmessenger ensure
+```
+
+### OpenClaw 桥接
+
+```bash
+# 启动交互式桥接（直接向 OpenClaw 发送消息并获取回复）
+claw-bridge
+
+# 重新配置节点昵称（重新注册节点）
+claw-bridge-setup
+```
+
+---
+
+## 平台部署指南
+
+### Windows
+
+#### 环境准备
+
+- 安装 Node.js（建议 v20 LTS）
+- 安装 OpenClaw（如需插件模式）
+
+#### 安装
+
+以**管理员身份**运行 PowerShell：
+
+```powershell
+npx claw_messenger@latest
+```
+
+安装完成后会自动注册 Windows 系统服务并开机自启。
+
+#### 常用管理命令
+
+```powershell
+# 查看服务状态
+clawmessenger status
+
+# 手动安装/刷新系统服务
+clawmessenger install-service
+
+# 卸载系统服务
+clawmessenger uninstall-service
+
+# 停止服务
+sc.exe stop claw-subagent-service
+
+# 启动服务
+sc.exe start claw-subagent-service
+
+# 查看服务详情
+sc.exe query claw-subagent-service
+sc.exe qc claw-subagent-service
+```
+
+#### 注意事项
+
+- **必须以管理员身份运行**，否则无法注册系统服务
+- 如果 `npm update -g` 报 `EBUSY: resource busy or locked`，说明旧服务进程仍在运行：
+  ```powershell
+  net stop "claw-subagent-service" 2>$null
+  sc.exe delete "claw-subagent-service" 2>$null
+  taskkill /f /im "clawsubagentservice.exe" 2>$null
+  npm install -g claw_messenger@latest
+  ```
+
+---
+
+### Linux（systemd）
+
+#### 环境准备
+
+- Node.js >= 16
+- `systemctl` 可用（大多数现代 Linux 发行版）
+
+#### 安装
+
+```bash
+npx claw_messenger@latest
+```
+
+如果提示权限不足，使用 sudo：
+
+```bash
+sudo npx claw_messenger@latest
+```
+
+#### 常用管理命令
+
+```bash
+# 查看服务状态
+sudo systemctl status claw-subagent-service
+
+# 启动/停止/重启
+sudo systemctl start claw-subagent-service
+sudo systemctl stop claw-subagent-service
+sudo systemctl restart claw-subagent-service
+
+# 设置/取消开机自启
+sudo systemctl enable claw-subagent-service
+sudo systemctl disable claw-subagent-service
+
+# 查看日志
+sudo journalctl -u claw-subagent-service -f
+```
+
+#### 故障排查
+
+**203/EXEC 错误（Node 路径问题）**
+
+使用 nvm 时，systemd 服务文件中的 Node 路径可能不正确：
+
+```bash
+# 1. 确认实际 node 路径
+which node
+
+# 2. 修正服务文件
+sudo sed -i "s|ExecStart=.*|ExecStart=$(which node) $(npm root -g)/claw-subagent-service/service/daemon.js|" /etc/systemd/system/claw-subagent-service.service
+
+# 3. 重载并启动
+sudo systemctl daemon-reload
+sudo systemctl start claw-subagent-service
+```
+
+---
+
+### Linux（无 systemd / Docker）
+
+#### 直接运行
+
+```bash
+npm install -g claw_messenger@latest
+
+# 前台运行（调试用）
+clawmessenger ensure
+# 或
+claw-subagent-service --run
+
+# 后台运行
+nohup claw-subagent-service --run > /dev/null 2>&1 &
+```
+
+#### Docker 部署
+
+```dockerfile
+FROM node:20-alpine
+
+# 安装必要工具
+RUN apk add --no-cache lsof curl
+
+# 安装 claw_messenger（会自动安装后台服务）
+RUN npm install -g claw_messenger@latest
+
+# 暴露健康检查端口
+EXPOSE 28765
+
+# 环境变量
+ENV SILENT_SERVICE_HOST=0.0.0.0
+ENV SILENT_SERVICE_PORT=28765
+
+# 前台运行
+CMD ["claw-subagent-service", "--run"]
+```
+
+构建并运行：
+
+```bash
+docker build -t claw-messenger:latest .
+
+docker run -d --name claw-messenger \
+  -p 28765:28765 \
+  --restart unless-stopped \
+  -e SILENT_SERVICE_HOST=0.0.0.0 \
+  claw-messenger:latest
+
+# 查看日志
+docker logs -f claw-messenger
+
+# 健康检查
+curl http://localhost:28765/health
+```
+
+**Docker 注意事项**：
+
+- 必须设置 `SILENT_SERVICE_HOST=0.0.0.0`，否则外部无法访问健康检查端口
+- 精简镜像（Alpine）建议安装 `lsof`，否则端口冲突时无法自动释放
+- Docker 内无需 systemd，直接使用 `--run` 前台运行
+
+---
+
+### macOS
+
+```bash
+npx claw_messenger@latest
+```
+
+macOS 会尝试使用 `launchd` 注册系统服务，或使用用户级守护进程作为兜底。
+
+---
+
+## 配置说明
+
+### 环境变量
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `DM_APP_KEY` | `bmdehs6pbyyks` | 融云应用 Key |
+| `DM_SERVER_URL` | `https://newsradar.dreamdt.cn/im` | 虾说后端服务地址 |
+| `SILENT_SERVICE_HOST` | `127.0.0.1` | 后台服务 HTTP 监听地址（Docker 需改为 `0.0.0.0`） |
+| `SILENT_SERVICE_PORT` | `28765` | 后台服务 HTTP 监听端口 |
+| `OPENCLAW_PROFILE` | - | OpenClaw 配置文件后缀（多环境时使用） |
+
+### 配置文件位置
+
+- **节点配置**：`~/.claw-bridge/openclaw/config.json`
+- **OpenClaw 插件目录**：`~/.openclaw/extensions/claw_messenger/`
+- **后台服务数据**：`~/.clawmessenger/`
+
+---
+
+## 健康检查
+
+### HTTP 接口
+
+```bash
+# 健康检查
+curl http://127.0.0.1:28765/health
+# 预期返回: alive
+
+# 查看版本
+curl http://127.0.0.1:28765/version
+
+# 查看融云连接状态
+curl http://127.0.0.1:28765/rongcloud/status
+```
+
+### CLI 状态检查
+
+```bash
+clawmessenger status
+```
+
+---
+
+## 日志查看
+
+### 日志文件位置
+
+后台服务（`claw-subagent-service`）将日志写入安装目录下的 `logs/` 文件夹中：
+
+| 平台 | 日志目录 |
+|------|----------|
+| npm 全局安装（Linux/macOS） | `$(npm root -g)/claw-subagent-service/logs/` |
+| npm 全局安装（Windows） | `%APPDATA%\npm\node_modules\claw-subagent-service\logs\` |
+| 用户级安装（无管理员权限） | `~/claw-subagent-service/logs/` |
+| 本地源码运行 | `./silent-service/logs/` |
+
+日志文件按日期和组件分类：
+- `worker-YYYY-MM-DD.log` — Worker 进程日志（融云消息收发、OpenClaw 调用）
+- `daemon-YYYY-MM-DD.log` — Daemon 进程日志（服务生命周期管理）
+- `updater-YYYY-MM-DD.log` — 自动更新日志
+
+### 快速查看命令
+
+#### Linux / macOS / Docker
+
+```bash
+# 1. 确定安装路径
+INSTALL_DIR=$(npm root -g)/claw-subagent-service
+# 如果是本地源码运行
+# INSTALL_DIR=/data/node_cli
+
+# 2. 查看当天 worker 日志（实时跟踪）
+tail -f $INSTALL_DIR/logs/worker-$(date +%Y-%m-%d).log
+
+# 3. 查看当天 worker 日志（最后 100 行）
+tail -n 100 $INSTALL_DIR/logs/worker-$(date +%Y-%m-%d).log
+
+# 4. 查看 daemon 日志
+tail -f $INSTALL_DIR/logs/daemon-$(date +%Y-%m-%d).log
+
+# 5. 查看所有日志文件列表
+ls -la $INSTALL_DIR/logs/
+
+# 6. 搜索特定关键词（如错误、SSE、融云）
+grep -i "error\|sse\|融云\|rongcloud" $INSTALL_DIR/logs/worker-$(date +%Y-%m-%d).log
+
+# 7. 查看最近 1 小时内的日志
+grep "$(date -d '1 hour ago' +%H)" $INSTALL_DIR/logs/worker-$(date +%Y-%m-%d).log
+
+# 8. 合并查看 worker + daemon 日志（按时间排序）
+cat $INSTALL_DIR/logs/worker-$(date +%Y-%m-%d).log $INSTALL_DIR/logs/daemon-$(date +%Y-%m-%d).log | sort
+```
+
+#### Docker 专用命令
+
+```bash
+# 查看容器内日志文件（进入容器后执行）
+docker exec -it <容器名> sh -c "tail -f \$(npm root -g)/claw-subagent-service/logs/worker-\$(date +%Y-%m-%d).log"
+
+# 直接在宿主机查看（如果日志挂载到卷）
+docker exec <容器名> cat /usr/lib/node_modules/claw-subagent-service/logs/worker-$(date +%Y-%m-%d).log
+
+# 查看容器标准输出
+docker logs -f <容器名> --tail 200
+```
+
+#### Windows
+
+```powershell
+# 查看当天 worker 日志
+Get-Content "$((npm root -g)\claw-subagent-service\logs\worker-$(Get-Date -Format yyyy-MM-dd).log)" -Tail 100
+
+# 查看 daemon 日志
+Get-Content "$((npm root -g)\claw-subagent-service\logs\daemon-$(Get-Date -Format yyyy-MM-dd).log)" -Tail 100
+
+# 搜索错误
+Select-String -Path "$((npm root -g)\claw-subagent-service\logs\*.log)" -Pattern "ERROR|error|失败"
+
+# wrapper 日志（node-windows 生成）
+Get-Content "$env:APPDATA\npm\node_modules\claw-subagent-service\service\daemon\clawsubagentservice.wrapper.log" -Tail 50
+```
+
+### 按运行模式查看日志
+
+#### systemd 模式
+
+```bash
+# 查看 systemd 管理的日志
+sudo journalctl -u claw-subagent-service -f
+
+# 查看最近 50 条日志
+sudo journalctl -u claw-subagent-service -n 50
+
+# 查看今天所有日志
+sudo journalctl -u claw-subagent-service --since today
+```
+
+#### 用户级守护进程模式（无 systemd）
+
+```bash
+# 查找日志目录（可能在多个位置）
+find / -name "worker-*.log" -path "*/claw-subagent-service/logs/*" 2>/dev/null
+
+# 常见路径
+# /usr/lib/node_modules/claw-subagent-service/logs/
+# /root/.clawmessenger/logs/
+# ~/claw-subagent-service/logs/
+
+# 实时监控
+LOG_DIR=$(find /usr -name "claw-subagent-service" -path "*/node_modules/*" 2>/dev/null | head -1)/logs
+tail -f $LOG_DIR/worker-$(date +%Y-%m-%d).log
+```
+
+#### 前台运行模式（调试）
+
+```bash
+# 直接运行，日志输出到终端
+claw-subagent-service --run
+
+# 后台运行并保存到文件
+nohup claw-subagent-service --run > /tmp/claw-subagent.log 2>&1 &
+tail -f /tmp/claw-subagent.log
+```
+
+### Linux
+
+```bash
+# systemd 日志
+sudo journalctl -u claw-subagent-service -f
+
+# 日志文件
+tail -f ~/claw-subagent-service/logs/worker-$(date +%Y-%m-%d).log
+tail -f ~/claw-subagent-service/logs/daemon-$(date +%Y-%m-%d).log
+```
+
+### Docker
+
+```bash
+docker logs -f claw-messenger --tail 100
+```
+
+---
+
+## 故障排查
+
+### 安装失败 / 服务未注册
+
+**Windows**：
+
+```powershell
+# 检查服务是否已注册
+sc.exe query claw-subagent-service
+
+# 手动注册
+clawmessenger install-service
+
+# 如果仍失败，检查 wrapper 日志
+Get-Content "$env:APPDATA\npm\node_modules\claw-subagent-service\service\daemon\clawsubagentservice.wrapper.log" -Tail 30
+```
+
+**Linux**：
+
+```bash
+# 检查服务文件是否存在
+ls -la /etc/systemd/system/claw-subagent-service.service
+
+# 手动注册
+sudo claw-subagent-service --install
+
+# 检查状态
+sudo systemctl status claw-subagent-service
+```
+
+### 端口 28765 被占用
+
+**Docker / 精简系统**：
+
+缺少 `lsof` 会导致服务无法释放被占用的端口：
+
+```bash
+# 安装 lsof
+apk add lsof          # Alpine
+apt-get install lsof  # Debian/Ubuntu
+
+# 检查是否有多个实例
+ps aux | grep node
+
+# 杀掉占用进程后重启
+kill -9 <PID>
+claw-subagent-service --run
+```
+
+### 融云连接失败
+
+1. 检查节点是否已注册：`cat ~/.claw-bridge/openclaw/config.json`
+2. 检查 token 是否有效
+3. 检查网络是否可以访问融云服务器
+
+### 插件未加载
+
+1. 确认插件已安装到 OpenClaw extensions 目录：`ls ~/.openclaw/extensions/claw_messenger/`
+2. 重启 OpenClaw
+3. 检查 OpenClaw 日志中的插件加载信息
+
+---
+
+## 卸载
+
+### Windows
+
+```powershell
+# 方式一：npm 卸载（自动清理服务）
+npm uninstall -g claw_messenger
+
+# 方式二：手动彻底清理
+net stop "claw-subagent-service" 2>$null
+sc.exe delete "claw-subagent-service" 2>$null
+taskkill /f /im "clawsubagentservice.exe" 2>$null
+npm uninstall -g claw_messenger claw-subagent-service
+Remove-Item -Recurse -Force "$env:USERPROFILE\claw-subagent-service" -ErrorAction SilentlyContinue
+Remove-Item -Recurse -Force "$env:USERPROFILE\.claw-bridge\openclaw" -ErrorAction SilentlyContinue
+Remove-Item -Recurse -Force "$env:USERPROFILE\.clawmessenger" -ErrorAction SilentlyContinue
+```
+
+### Linux
+
+```bash
+# 停止并禁用服务
+sudo systemctl stop claw-subagent-service
+sudo systemctl disable claw-subagent-service
+
+# 卸载
+sudo claw-subagent-service --uninstall
+npm uninstall -g claw_messenger claw-subagent-service
+
+# 手动清理残留
+sudo rm -f /etc/systemd/system/claw-subagent-service.service
+sudo systemctl daemon-reload
+rm -rf ~/claw-subagent-service
+rm -rf ~/.claw-bridge/openclaw
+rm -rf ~/.clawmessenger
+rm -f /tmp/.claw-subagent-service.pid
+```
+
+### Docker
+
+```bash
+docker stop claw-messenger
+docker rm claw-messenger
+```
+
+---
+
+## 开发
+
+```bash
+git clone <repository-url>
+cd clawmessenger
+npm install
+npm run build
+npm test
+```
+
+---
+
+## License
+
+MIT

package/bin/auto-init.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+
+/**
+ * claw_messenger - 自动初始化
+ * 无需用户交互，自动生成配置
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import * as os from 'os';
+import axios from 'axios';
+
+const SERVER_URL = process.env.DM_SERVER_URL || 'https://newsradar.dreamdt.cn/im';
+const CONFIG_DIR = path.join(os.homedir(), '.claw-bridge', 'openclaw');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const LEGACY_CONFIG_FILE = path.join(os.homedir(), '.claw-bridge', 'config.json');
+
+function generateNodeId() {
+  const random = crypto.randomBytes(3).toString('hex');
+  return `claw_${random}`;
+}
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+      return JSON.parse(content);
+    }
+    // 兼容旧路径
+    if (fs.existsSync(LEGACY_CONFIG_FILE)) {
+      const content = fs.readFileSync(LEGACY_CONFIG_FILE, 'utf-8');
+      return JSON.parse(content);
+    }
+  } catch {}
+  return null;
+}
+
+function saveConfig(config) {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+async function registerNode(nodeName) {
+  const nodeId = generateNodeId();
+
+  try {
+    const resp = await axios.post(`${SERVER_URL}/api/claw/register`, {
+      node_id: nodeId,
+      name: nodeName,
+    }, { timeout: 10000 });
+
+    if (resp.data?.code === 200 || resp.data?.code === 409) {
+      const tokenResp = await axios.get(`${SERVER_URL}/api/claw/token/${nodeId}`, { timeout: 10000 });
+      
+      if (tokenResp.data?.code === 200) {
+        return {
+          nodeId,
+          token: tokenResp.data.data.token,
+        };
+      }
+    }
+    
+    return null;
+  } catch (err) {
+    return null;
+  }
+}
+
+async function main() {
+  // 检查已有配置
+  let config = loadConfig();
+
+  if (config) {
+    // 已有配置，跳过
+    return;
+  }
+
+  // 自动生成节点名
+  const nodeName = `OpenClaw-${crypto.randomBytes(2).toString('hex')}`;
+  
+  // 注册节点
+  const result = await registerNode(nodeName);
+
+  if (!result) {
+    throw new Error('自动注册失败');
+  }
+
+  config = {
+    nodeId: result.nodeId,
+    nodeName: nodeName,
+    token: result.token,
+    createdAt: new Date().toISOString(),
+  };
+
+  saveConfig(config);
+}
+
+main().catch(err => {
+  // 静默失败，不影响安装
+  process.exit(0);
+});

package/bin/cli.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/cli.js').catch((err) => {
+  console.error('[clawmessenger] 启动失败:', err.message)
+  process.exit(1)
+})