🦞 openclaw-rocketchat

让中国用户也能优雅地使用 OpenClaw

English | 中文

通过 Rocket.Chat App 与你的 OpenClaw AI 助手对话 独立空间 · 独立通知 · 数据自控 · 无需 VPN

📖 文档导航： 使用指南 · 常见问题 · 配置参数 · 架构与对比 · 安全与凭据 · 多 Agent · 多渠道 · 命令

痛点

OpenClaw 是一个强大的 AI 助手平台，海外用户可以通过 WhatsApp、Telegram、Discord 等随手对话。

但中国大陆用户呢？

• Telegram —— 需要 VPN，随时可能被封
• WhatsApp —— 需要外国手机号，使用不便
• Discord —— 被墙，完全无法使用
• 飞书 —— 配置复杂，需要企业账号，步骤繁琐

更大的问题是：即使能用这些平台，AI 对话和社交消息混在一起，重要的 AI 通知被淹没在社交噪音中。

解决方案

什么是 Rocket.Chat？ Rocket.Chat 是全球最大的开源企业级即时通讯平台，被全球 1200 万+ 用户使用，支持私有化部署。简单来说，它就是一个可以装在你自己服务器上的"企业微信/Slack"——界面成熟、功能完善、支持手机/电脑/网页多端，中国区 App Store 可直接下载。

本插件让你通过 Rocket.Chat App 与 OpenClaw 对话。一条命令部署，三步开始使用。你的 AI 数据不经过任何第三方。

十大优势

• 🏠 独立的 AI 对话空间 — 打开 Rocket.Chat 看到的全是你的 AI 助手，没有社交噪音
• 🔔 独立的推送通知 — AI 消息不会被淹没在其他 App 的通知里
• 🔐 数据完全自控 — 消息只在你的服务器上，不经过第三方
• 🇨🇳 中国大陆完美可用 — App Store 直接下载，无需 VPN，自动免费域名 + HTTPS 证书
• ⚡ 一条命令部署 — 交互式向导，从 Docker 到账号到配置一气呵成
• 🤖 多 Agent、多机器人 — 每个 Agent 对应一个独立的 Rocket.Chat 机器人
• 👥 团队协作 — 多人共享 AI，同一个群里和 AI 讨论，一套部署全员使用
• 🔒 精细权限管理 — 全功能 / 只读两种权限，适配不同角色
• 📱 全平台覆盖 — iOS、Android、macOS、Windows、Linux、Web，多端消息实时同步
• 🆓 完全免费开源 — MIT 协议，无订阅费，无消息限制，无厂商锁定

技术特性（v0.7.1）

| 特性 | 说明 | |------|------| | 正在输入指示器 | Agent 思考时手机端显示 "正在输入..."，不再等得心慌 | | 线程回复 | Agent 回复自动关联到对应的消息线程 | | 群组历史上下文 | @机器人时，Agent 能看到群里最近的对话，不再"失忆" | | 发送者身份识别 | 群聊中 Agent 能区分是谁在说话 | | 媒体文件上传 | Agent 发送的图片/文件会真正上传到 Rocket.Chat，而非仅发链接 | | @提及状态 | 正确传递 WasMentioned 字段，与官方频道行为一致 | | authToken 兼容 | 自动兼容旧版凭据格式，升级无需重新添加机器人 | | 一键升级 | openclaw rocketchat upgrade 自动备份配置、安装新版、恢复配置 | | 安全加固 | 安装脚本自动生成强随机管理员密码，消除 admin/admin 弱口令风险 | | 安装信息持久化 | 安装信息保存到 .rc-info，setup 自动读取，免手动输入 |

和其他方案的对比

| | 飞书 | Telegram | WhatsApp | 本插件 | |---|---|---|---|---| | 中国区可用 | ✅ | ❌ 需VPN | ❌ 需外国号 | ✅ | | 配置复杂度 | 🔴 高 | 🔴 高 | 🔴 高 | 🟢 一条命令 | | 数据隐私 | 🟡 经第三方 | 🟡 经第三方 | 🟡 经第三方 | 🟢 完全本地 | | 多人团队 | 需企业版 | ❌ | ❌ | ✅ 一套服务全员用 | | 免费开源 | ❌ | ❌ | ❌ | ✅ MIT |

完整对比表请参阅 docs/ARCHITECTURE.md

快速上手（三步走）

完整步骤（含终端输出示例）请参阅 使用指南

第一步：部署 Rocket.Chat

curl -fsSL https://raw.githubusercontent.com/Kxiandaoyan/openclaw-rocketchat/master/install-rc.sh | bash

脚本自动完成 Docker 部署、免费域名、HTTPS 证书获取。

第二步：安装插件 + 配置

openclaw plugins install openclaw-rocketchat
openclaw rocketchat setup

交互式向导引导你完成连接和账号创建。如果在同一台机器上，会自动读取安装信息。

第三步：添加 AI 机器人

openclaw rocketchat add-bot

输入机器人名字，选一个 Agent，就完事了。

第四步：手机下载 Rocket.Chat，开聊

1. App Store / Google Play 搜索 "Rocket.Chat" 下载
2. 打开 App，服务器填脚本输出的地址（如 https://123-45-67-89.sslip.io）
3. 用第二步设置的用户名密码登录
4. 找到机器人，开聊！

📱 手机端截图

| 步骤 | 截图 | |------|------| | 打开 App，输入服务器地址 | | | 点击 Connect 进入登录页 | | | 登录后看到会话列表 | | | 和 AI 机器人聊天 | |

亮点：AI 回复中的代码块在 Rocket.Chat App 里会自动语法高亮、格式化展示，不像微信/钉钉等 App 把代码挤成一团。技术人员的使用体验远超其他聊天工具。

命令一览

| 命令 | 说明 | |---|---| | openclaw rocketchat setup | 连接 Rocket.Chat + 创建管理员 + 创建手机账号 | | openclaw rocketchat add-bot | 添加机器人 + 绑定 Agent + 建立私聊 | | openclaw rocketchat add-group | 创建私有频道（多机器人群组） | | openclaw rocketchat add-user | 添加手机登录用户 | | openclaw rocketchat remove-user | 删除手机登录用户 | | openclaw rocketchat invite | 群组成员管理（邀请/移除/设管理员） | | openclaw rocketchat status | 查看运行状态 | | openclaw rocketchat upgrade | 一键升级（自动备份/恢复配置） | | openclaw rocketchat uninstall | 卸载 |

所有命令都是交互式的——不需要记参数，按提示输入即可。

文档

| 文档 | 内容 | |------|------| | 使用指南 | 完整步骤详解、终端输出示例、远程部署、群组管理、用户管理 | | 常见问题 | 注册禁用、升级、重置、Docker 命令、证书问题、推送通知等 | | 配置参数 | 完整参数表、JSON 示例、手动修改、完全重置 | | 架构与对比 | 完整对比表、架构图、技术栈 | | 安全与凭据 | 密码安全策略、凭据存储架构、备份恢复机制 |

贡献

欢迎贡献！无论是 Bug 报告、功能建议还是代码贡献：

1. Fork 这个仓库
2. 创建你的分支 (git checkout -b feature/amazing)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到远程 (git push origin feature/amazing)
5. 创建 Pull Request

许可证

MIT — 自由使用，自由修改。

如果这个插件对你有帮助，请给个 Star ⭐

每一个 Star 都是对中国开发者的支持 🇨🇳

让每一个中国用户都能轻松使用 AI 助手