openclaw-rocketchat 是专为中国大陆用户设计的 Rocket.Chat 频道插件，让你通过自托管 Rocket.Chat 服务器与 OpenClaw AI 助手对话，解决海外平台不可用问题。提供独立对话空间、数据完全自控、无需 VPN，支持多 Agent 和团队协作。本文详解项目定位、安装步骤、使用方法和核心特性。
openclaw-rocketchat 是一个 Rocket.Chat 频道插件，专为中国大陆用户设计，通过自托管 Rocket.Chat 服务器提供独立的 OpenClaw AI 对话空间，确保数据隐私、免 VPN 使用，并支持多 Agent 与团队协作。
openclaw-rocketchat 是 OpenClaw 生态的官方 Rocket.Chat 频道插件，作为连接 OpenClaw AI 与 Rocket.Chat 即时通讯平台的桥梁。其核心定位是为中国大陆用户提供一种可私有化部署、免翻墙、数据自主的 AI 对话方案。用户通过 Rocket.Chat 移动端或桌面客户端即可与绑定的 OpenClaw Agent 进行私聊或群组交互，适用于需要将 AI 助手融入日常工作流、且对数据隐私和通知独立性有较高要求的个人开发者、技术团队或组织。
项目主要解决两大痛点：一是海外主流 AI 对话渠道（Telegram、WhatsApp、Discord）在中国大陆不可用或使用门槛高，飞书则配置繁琐且需企业账号；二是即使可用，AI 回复也容易被社交消息淹没，缺乏独立通知空间。本插件通过自托管 Rocket.Chat 服务器，提供专属的 AI 对话频道，确保消息隔离、推送独立，且所有通信数据不经过第三方，从根本上实现了可用性、隐私性和专注度的提升。
典型场景包括：中国大陆个人用户通过 Rocket.Chat App 与 OpenClaw 进行私聊获取编程、写作等协助；技术团队在私有群组中共享同一 AI 机器人进行代码评审、方案讨论；需要将 AI 对话与日常社交/工作聊天完全分离的用户；对数据主权有严格要求、希望所有消息留存于自有服务器的企业或机构；以及需要多 Agent 并行（如不同角色机器人）并灵活分配权限的协作环境。
安装过程完全脚本化，分为三步：首先执行 `curl -fsSL https://raw.githubusercontent.com/Kxiandaoyan/openclaw-rocketchat/master/install-rc.sh | bash` 一键部署 Rocket.Chat 服务器（自动配置 Docker、免费域名与 HTTPS 证书）；其次通过 OpenClaw 命令行运行 `openclaw plugins install openclaw-rocketchat` 安装插件，并执行 `openclaw rocketchat setup` 进行交互式连接配置与管理员账号创建；最后使用 `openclaw rocketchat add-bot` 添加机器人并绑定到指定 Agent。若在同一台机器部署，脚本会自动读取安装信息以简化流程。
部署完成后，在手机端下载 Rocket.Chat App（App Store 或 Google Play），输入服务器地址并使用配置的账号登录。在私聊或群组中 @机器人即可开始对话。支持使用 `!` 前缀的命令进行高级操作，如 `!clear` 清空上下文、`!model` 切换模型、`!tools` 管理工具等。管理员可通过 `openclaw rocketchat add-group` 创建多机器人群组、`openclaw rocketchat add-user` 添加成员、`openclaw rocketchat invite` 管理权限，并可使用 `openclaw rocketchat status` 查看状态、`upgrade` 一键升级插件。
技术实现上，插件采用 TypeScript 编写，通过 WebSocket 与 Rocket.Chat 实时通信，支持线程回复、正在输入指示、群组历史上下文传递等细节优化。架构支持同机部署（所有组件单服务器）与分离部署（Rocket.Chat 公网 VPS，OpenClaw 内网）两种模式。安全方面，安装脚本自动生成强随机管理员密码，凭据以加密形式存储，并兼容旧版 authToken 格式以实现平滑升级。所有消息数据仅存在于用户控制的 MongoDB 中，无第三方中转，符合 MIT 开源协议。
Rocket.Chat 可私有化部署，中国区 App Store 直接下载无需 VPN，且提供独立的 AI 对话空间，避免社交消息干扰；而 Telegram 需翻墙、飞书配置复杂且数据经过第三方服务器。
所有消息数据仅存储在你自己的服务器 MongoDB 中，不经过任何第三方平台，确保完全自控。插件本身不收集用户对话内容。
支持。每个 Agent 可绑定一个独立的 Rocket.Chat 机器人，团队可在同一私有群组中共享 AI 进行协作讨论，管理员可设置全功能或只读权限。
不会。使用 `openclaw rocketchat upgrade` 命令可一键升级，脚本会自动备份现有配置、安装新版并恢复配置，确保平滑过渡。
同机部署无需公网 IP；若分离部署，Rocket.Chat 服务器需公网 VPS。安装脚本会自动获取免费域名（如 sslip.io）并配置 HTTPS 证书，无需手动申请。