# RivonClaw：将 OpenClaw 封装为个人数字管家的桌面级解决方案

> 本文介绍 RivonClaw 项目，这是一个基于 OpenClaw 的桌面应用层，通过自然语言规则、可视化配置和零重启热更新，让非技术用户也能轻松拥有和训练个人 AI 助手。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-03-29T07:45:51.000Z
- 最近活动: 2026-03-29T07:54:39.288Z
- 热度: 148.8
- 关键词: OpenClaw, AI Agent, Desktop App, Electron, Personal Assistant, Privacy, Local-First
- 页面链接: https://www.zingnex.cn/forum/thread/rivonclaw-openclaw
- Canonical: https://www.zingnex.cn/forum/thread/rivonclaw-openclaw
- Markdown 来源: ingested_event

---

# RivonClaw：将 OpenClaw 封装为个人数字管家的桌面级解决方案\n\nOpenClaw 是一个强大的 AI Agent 运行时，但它面向的是工程师群体——需要编辑配置文件、管理进程、在终端里处理 API 密钥。对于设计师、运营人员、小企业主等非技术用户来说，这个门槛太高了。RivonClaw 的出现正是为了解决这一痛点，它将 OpenClaw 包装成一个任何人都能使用的桌面应用：安装、从系统托盘启动、通过本地 Web 面板管理一切。\n\n## 项目定位：OpenClaw 的驾驶舱\n\nRivonClaw 的核心理念可以用一句话概括：**OpenClaw 是引擎，RivonClaw 是驾驶舱**。\n\n它不是一个替代方案，而是一个易用层（Easy-mode Layer）。用户无需编写代码，只需用自然语言书写规则，通过几次点击配置 LLM 提供商和消息通道，就能让 Agent 随着时间推移学习用户偏好、不断进化。不需要终端，不需要重启，一切配置都能热更新生效。\n\n## 核心功能特性\n\n### 自然语言规则系统\n\nRivonClaw 最大的创新之一是**自然语言规则**。用户可以用 plain language 编写规则，这些规则会被自动编译成 Policy、Guards 或 Skills，并立即生效——无需重启服务。\n\n例如，用户可以写：\n- "每天早上8点提醒我查看邮件"\n- "当我提到'紧急'时，优先使用更快的模型"\n- "不要在没有我确认的情况下发送任何消息"\n\n这些规则会被解析并转化为 OpenClaw 可执行的策略，让非技术用户也能精细控制 Agent 的行为。\n\n### 多提供商 LLM 支持\n\nRivonClaw 支持超过 20 家 LLM 提供商，包括：\n\n- **国际主流**：OpenAI、Anthropic、Google Gemini、DeepSeek、Mistral、xAI、Groq\n- **中国本土**：智谱/Z.ai、Moonshot/Kimi、通义千问、MiniMax、火山引擎/豆包、小米/MiMo\n- **聚合平台**：OpenRouter\n- **云服务**：Amazon Bedrock、NVIDIA NIM\n- **本地部署**：Ollama\n\n此外还支持订阅计划（如 Claude、Gemini、智谱 Coding、Kimi Code 等）和编码专用模型，满足不同场景的需求。\n\n### OAuth 与免密钥登录\n\n对于不想处理 API 密钥的用户，RivonClaw 提供了 OAuth 登录选项：\n- 使用 Google 账号登录即可获得免费层级的 Gemini 访问\n- 连接 Claude/Anthropic 订阅无需手动配置 API 密钥\n- 自动检测或安装 CLI 凭证\n\n这种设计大幅降低了初次使用的门槛。\n\n### 按提供商代理配置\n\n针对网络受限地区的用户，RivonClaw 支持为每个 LLM 提供商单独配置 HTTP/SOCKS5 代理，并支持：\n- 自动路由到对应代理\n- 热重载配置，无需重启\n- 按域名智能分流\n\n### 多账号消息通道\n\nRivonClaw 支持配置多种消息平台，包括：\n\n- **国际**：Telegram、WhatsApp、Discord、Slack、Google Chat、Signal、iMessage、Matrix、Mattermost、Microsoft Teams\n- **中国**：飞书/Lark、LINE\n\n所有通道配置都通过 UI 完成，敏感信息（API 密钥、OAuth Token）使用系统级安全存储（macOS Keychain / Windows DPAPI），永不以明文形式存储。\n\n### Token 使用追踪\n\n实时统计各模型和提供商的 Token 消耗，数据自动从 OpenClaw 会话文件刷新，帮助用户监控成本和资源使用。\n\n### 语音识别（STT）\n\n支持语音消息转文字，针对不同地区提供不同后端：\n- 国际用户：Groq\n- 中国用户：火山引擎\n\n### 可视化权限控制\n\n通过 UI 控制 Agent 的文件读写权限，增强安全性。RivonClaw 通过 OpenClaw 插件在工具调用执行前进行拦截和验证，覆盖约 85-90% 的文件访问场景。\n\n### 零重启更新\n\nAPI 密钥、代理、通道配置的变更通过热重载立即生效，无需重启 Gateway。这一特性对于长期运行的个人 Agent 尤为重要。\n\n### 本地优先与隐私保护\n\n所有数据保存在本地机器，敏感信息使用系统级加密存储。可选的匿名遥测（不含任何 PII）帮助项目改进，但完全可以关闭。\n\n### Agent 聊天界面\n\n提供实时 WebSocket 聊天功能：\n- Markdown 渲染\n- 表情选择器\n- 图片附件支持\n- 模型切换\n- 持久化对话历史\n\n### Skills 市场\n\n内置 Skills 市场，用户可以浏览、搜索、安装社区 Skills，一键管理已安装的 Skills。\n\n## 技术架构\n\nRivonClaw 采用 monorepo 架构，使用 pnpm workspaces 和 Turbo 构建编排：\n\n```\nrivonclaw/\n├── apps/\n│   ├── desktop/     # Electron 托盘应用（主进程）\n│   └── panel/       # React 管理界面（由 desktop 提供服务）\n├── packages/\n│   ├── core/        # 共享类型与 Zod 校验\n│   ├── gateway/     # Gateway 生命周期、配置写入、密钥注入\n│   ├── rules/       # 规则编译与 Skill 文件写入\n│   ├── storage/     # SQLite 持久化\n│   ├── secrets/     # 系统密钥链存储\n│   ├── stt/         # 语音识别抽象\n│   ├── proxy-router/# HTTP CONNECT 代理多路复用\n│   └── ...          # 其他功能包\n├── extensions/\n│   ├── rivonclaw-policy/      # 策略注入插件\n│   ├── rivonclaw-file-permissions/  # 文件权限控制插件\n│   └── ...          # 其他插件\n└── vendor/\n    └── openclaw/    #  vendored OpenClaw（gitignored）\n```\n\n### Desktop 应用架构\n\nDesktop 应用是一个仅托盘运行的应用（macOS 上隐藏 Dock 图标）：\n\n1. **GatewayLauncher**：从 vendor/openclaw/ 启动 OpenClaw Gateway\n2. **Panel HTTP Server**：在 localhost:3210 提供管理界面和 REST API\n3. **SQLite Storage**：本地数据库存储配置和状态\n4. **Auth Profile Sync**：同步 OAuth 认证信息\n5. **Auto-Updater**：自动检查并安装更新\n\n### REST API 端点\n\nPanel 服务器暴露以下主要端点：\n\n- `/api/rules` - 规则的增删改查\n- `/api/channels` - 通道管理\n- `/api/permissions` - 权限管理\n- `/api/providers` - 可用 LLM 提供商列表\n- `/api/provider-keys` - API 密钥和 OAuth 凭证管理\n- `/api/oauth` - Gemini CLI OAuth 流程\n- `/api/skills` - Skills 市场和已安装 Skills\n- `/api/usage` - Token 使用统计\n- `/api/stt` - 语音识别配置\n- `/api/status` - 系统状态（规则数、Gateway 状态）\n\n### 数据存储位置\n\n- `~/.rivonclaw/rivonclaw.db` - SQLite 数据库\n- `~/.rivonclaw/logs/` - 应用日志\n- `~/.openclaw/gateway/config.yml` - Gateway 配置\n- `~/.openclaw/skills/` - 自动生成的 Skill 文件\n\n## 文件权限安全机制\n\nRivonClaw 通过 OpenClaw 插件在工具调用执行前进行拦截验证：\n\n- **完全保护**：read、write、edit、image、apply-patch 等文件访问工具的路径会验证是否符合配置的权限\n- **部分保护**：exec、process 的工作目录会被验证，但命令字符串内部的路径（如 `cat /etc/passwd`）无法检查\n- **覆盖范围**：约 85-90% 的文件访问场景\n\n技术实现上使用 OpenClaw 的 `before_tool_call` Hook，无需修改 OpenClaw 源码，可以干净地拉取上游更新。\n\n## 构建与部署\n\n### 开发环境要求\n\n- Git\n- Node.js >= 24\n- pnpm 10.6.2\n\n### 快速开始\n\n```bash\n# 1. 克隆仓库\ngit clone https://github.com/nicepkg/rivonclaw.git\ncd rivonclaw\n\n# 2. 克隆并构建 vendored OpenClaw\n./scripts/setup-vendor.sh\n\n# 3. 安装依赖并构建\npnpm install\npnpm build\n\n# 4. 启动开发模式\npnpm --filter @rivonclaw/desktop dev\n```\n\n这会启动 Electron 托盘应用，自动启动 OpenClaw Gateway，并在 http://localhost:3210 提供管理面板。\n\n### 打包发布\n\n**macOS（通用二进制）**：\n```bash\npnpm build\npnpm --filter @rivonclaw/desktop dist:mac\n# 输出：apps/desktop/release/RivonClaw-<version>-universal.dmg\n```\n\n**Windows**：\n```bash\npnpm build\npnpm --filter @rivonclaw/desktop dist:win\n# 输出：RivonClaw.Setup.<version>.exe\n#       RivonClaw-<version>-portable.exe\n```\n\n支持从 macOS 交叉编译 Windows 版本（NSIS 不需要 Wine）。\n\n## 与 OpenClaw 的关系\n\nRivonClaw 与 OpenClaw 的关系类似于"发行版与内核"：\n\n| 层级 | 组件 | 作用 |\n|------|------|------|\n| 底层 | OpenClaw | Agent 运行时、工具执行、LLM 调用 |\n| 上层 | RivonClaw | 桌面 UI、配置管理、自然语言规则、权限控制 |\n\nRivonClaw 通过以下方式与 OpenClaw 集成：\n\n1. **Vendor 管理**：使用 `setup-vendor.sh` 克隆 OpenClaw 并应用补丁\n2. **配置注入**：通过 `gateway` 包将用户配置写入 `~/.openclaw/gateway/config.yml`\n3. **密钥注入**：运行时从系统密钥链读取密钥并注入环境变量\n4. **插件机制**：通过 `extensions/` 下的 OpenClaw 插件扩展功能\n5. **Skill 热重载**：规则变更时自动生成 Skill 文件到 `~/.openclaw/skills/`\n\n这种设计确保 RivonClaw 可以跟随 OpenClaw 上游更新，同时提供额外的易用层。\n\n## 应用场景\n\nRivonClaw 适合以下用户群体：\n\n1. **非技术用户**：想要个人 AI 助手但不想学习配置文件和命令行\n2. **隐私敏感用户**：希望数据完全本地存储，不信任云端服务\n3. **多平台用户**：需要同时在多个消息平台（Telegram、微信、飞书等）与 Agent 交互\n4. **长期使用者**：希望 Agent 能持续学习、积累对自己偏好的理解\n5. **企业用户**：需要在受控环境中部署 AI Agent，有严格的权限和审计要求\n\n## 局限与注意事项\n\n1. **Node.js 版本要求**：需要 Node.js >= 24，旧版本可能不兼容\n2. **原生模块重建**：better-sqlite3 需要在 Node.js 和 Electron 两种运行时中重建\n3. **文件权限覆盖**：exec 工具的路径检查有局限，敏感操作建议通过 Rules 禁用\n4. **OAuth 依赖**：部分功能依赖 Google/Anthropic 的 OAuth 服务，网络受限地区需要代理\n\n## 总结\n\nRivonClaw 代表了 AI Agent 应用的一个重要方向：**降低使用门槛，同时保持底层能力**。它让 OpenClaw 这样强大的工具能够被更广泛的非技术用户所接受，同时通过自然语言规则、可视化配置和热更新机制，让个人 Agent 真正成为"数字管家"——持续学习、不断进化、越用越懂主人。\n\n对于想要拥有个人 AI 助手但又不想折腾配置文件的普通用户来说，RivonClaw 提供了一个值得尝试的入口。