OpenClaw/ClawBot 接入可行性调研报告
日期:2026-06-25 | 调研人:CodeArts Agent
一、调研结论
| 项目 | 结论 | 依据 |
|------|------|------|
| OpenClaw CLI 公开可用 | ✅ 可行 | npm包 @tencent-weixin/openclaw-weixin-cli@2.1.4 已发布,MIT协议 |
| OpenClaw 核心包公开可用 | ✅ 可行 | npm包 openclaw@2026.6.10 已发布,MIT协议,225个版本 |
| ClawBot 插件对第三方开放 | ✅ 可行 | 安装器文档明确说明"引导扫码连接微信",无门槛限制 |
| iLink 协议接入 | ⚠️ 待定 | 需安装OpenClaw Gateway后通过插件自动配置 |
总体结论:OpenClaw + ClawBot 接入方案可行,推荐作为微信通道首选方案。
二、技术方案
方案A:OpenClaw + ClawBot(推荐)
安装步骤:
- 安装OpenClaw Gateway:
pnpm add openclaw - 安装微信插件:
npx -y @tencent-weixin/openclaw-weixin-cli install - 插件自动完成:检测OpenClaw版本 → 安装兼容插件版本 → 引导扫码连接微信 → 重启Gateway
- BossAgents后端通过OpenClaw Gateway的API发送/接收微信消息
兼容矩阵:
| openclaw-weixin | 支持的 OpenClaw | dist-tag | 说明 |
|-----------------|----------------|----------|------|
| 1.0.x | >=2026.3.0 <2026.3.22 | compat-host-gte2026.3.0-lt2026.3.22 | 兼容旧版 |
| v2 主线 | >=2026.3.22 | latest | 当前推荐 |
优势:
- 一行命令安装,零配置
- MIT开源协议
- 自动版本兼容检测
- 与BossAgents现有OpenClaw架构天然集成
风险:
- OpenClaw Gateway需要独立运行(额外进程/端口)
- 微信扫码配对需要用户手动操作
- 插件版本与OpenClaw版本需保持兼容
工作量: 1-2天
方案B:企业微信自建应用(备选)
实现步骤:
- 在企业微信管理后台创建自建应用
- 配置回调URL指向BossAgents服务器
- 实现消息加解密(AES)
- 消息转发至CapabilityDispatcher
优势:
- 完全可控,不依赖第三方Gateway
- 企业微信API成熟稳定
- 支持更多消息类型(卡片、审批等)
风险:
- 需要企业微信管理员权限
- 需要公网可访问的回调URL
- 消息加解密实现复杂度较高
工作量: 2-3天
方案C:小程序内嵌对话(最快)
实现步骤:
- 已有bossagents-miniapp + ai-chat页面
- 小程序内直接调用BossAgents API
- 无需额外通道
优势:
- 零额外开发
- 已有完整实现
风险:
- 非微信原生入口,需打开小程序
- 无法接收微信消息推送
工作量: 0天(已实现)
三、推荐方案
推荐:方案A(OpenClaw + ClawBot)为主,方案C(小程序)为辅
理由:
- OpenClaw是BossAgents已采用的架构,ClawBot插件是官方微信通道方案
- MIT开源、一行命令安装、自动版本兼容
- 小程序作为补充入口,覆盖不需要微信原生消息的场景
实施路径:
Step 1: pnpm add openclaw(安装OpenClaw Gateway)
Step 2: npx -y @tencent-weixin/openclaw-weixin-cli install(安装微信插件)
Step 3: 扫码配对微信
Step 4: BossAgents后端通过OpenClaw Gateway API收发微信消息
Step 5: CapabilityDispatcher添加wechat source路由
四、下一步行动
- [ ] 安装OpenClaw Gateway并验证启动
- [ ] 安装微信插件并完成扫码配对
- [ ] 实现BossAgents与OpenClaw Gateway的消息桥接
- [ ] CapabilityDispatcher添加wechat通道支持
- [ ] 端到端测试:微信发消息→数字员工执行→结果回微信
BossAgents