OpenCode ClawMessenger

接入 IM 消息到 OpenCode AI 会话，安装后即用。

核心特性

• AI 自动回复：聊天消息自动转发给 OpenCode 处理，AI 响应实时推回
• 自动注册：首次运行生成二维码，App 扫码绑定
• 流式消息：SSE 流式响应，AI 回答实时到达
• 消息已读回执：单聊和群聊均兼容
• 设备管理：远程状态查询、启动/停止/重启等 P2P 命令
• 无感运行：opencode serve 时桥接服务自动跟随启停

安装

npm install -g @quukk/opencode-clawmessenger@latest
opencode-clawmessenger setup

setup 会自动判断当前平台并完成配置：

1. Linux：检测发行版、安装系统依赖，其余同下
2. Windows / macOS：配置桥接服务的自动启停
3. 终端打印二维码 → App 扫码绑定

Linux 安装系统依赖需要 sudo 权限。如果只想注册节点：

opencode-clawmessenger setup --no-install

Linux / macOS 完成后重新加载 shell 配置：

source ~/.bashrc   # 或 source ~/.zshrc

Windows 重启终端后生效。

之后正常使用 opencode 即可：

opencode serve

其他选项

| 选项 | 说明 | |------|------| | --no-install | 跳过环境安装，仅注册节点和生成二维码 | | --install-service | 同时安装 systemd 服务，实现开机自启（需 root） |

sudo opencode-clawmessenger setup --install-service

独立 CLI 运行

如果希望手动管理桥接进程：

npm install -g @quukk/opencode-clawmessenger@latest
opencode-clawmessenger setup --no-install
opencode-clawmessenger start --daemon

Docker 运行

docker build -t opencode-clawmessenger .
docker run -d \
  --name clawmessenger \
  -v ~/.config/opencode:/root/.config/opencode \
  -e CLAW_OPENCODE_URL=http://host.docker.internal:19876 \
  opencode-clawmessenger

本地开发

从源码运行：

npm run install:local

构建项目并注册到本地，之后 opencode 即可加载最新代码。

CLI 命令

# 一键初始化
opencode-clawmessenger setup

# 跳过环境安装，仅注册节点
opencode-clawmessenger setup --no-install

# 同时安装 systemd 服务
sudo opencode-clawmessenger setup --install-service

# 启动服务（前台）
opencode-clawmessenger start

# 后台守护进程
opencode-clawmessenger start --daemon

# 查看状态
opencode-clawmessenger status

# 查看日志
opencode-clawmessenger logs -n 100

# 停止服务
opencode-clawmessenger stop

# 卸载恢复（npm uninstall 前必须先运行）
opencode-clawmessenger uninstall

# systemd 服务管理（若已安装）
sudo systemctl start opencode-clawmessenger
sudo systemctl status opencode-clawmessenger
sudo systemctl stop opencode-clawmessenger

环境变量

| 变量名 | 说明 | 默认值 | |--------|------|--------| | CLAW_TOKEN | 融云 Token | 自动注册生成 | | CLAW_ACCOUNT_ID | 节点 ID | 自动注册生成 | | DM_SERVER_URL | 注册服务器地址 | https://newsradar.dreamdt.cn/im | | CLAW_OPENCODE_URL | OpenCode 服务器地址 | http://127.0.0.1:19876 | | CLAW_OPENCODE_DIR | OpenCode 工作目录 | process.cwd() | | OPENCODE_SERVER_PASSWORD | OpenCode Basic Auth 密码 | - | | CLAW_LOG_LEVEL | 日志级别 | info | | DEBUG | 遗留调试开关 | - |

卸载

卸载前必须先运行 uninstall 命令恢复原始 opencode，否则 opencode 命令会找不到可执行文件：

opencode-clawmessenger uninstall
npm uninstall -g @quukk/opencode-clawmessenger

uninstall 会自动完成：

• Windows：将 opencode-original.exe 重命名回 opencode.exe，删除包装器 .cmd
• Linux / macOS：删除 npm bin 目录中的包装器脚本

许可证

MIT © quukk