【Code With SOLO】Rapoo — 基于 OpenClaw 二次开发的国产化 AI Agent 平台
1. 摘要
用 TRAE SOLO 在 OpenClaw 开源项目基础上，完成了从品牌重塑、国产大模型接入（DeepSeek / 通义千问 / 智谱GLM）、企业微信通道开发到可视化工作流引擎的完整二次开发。项目从零环境搭建到全功能可运行，覆盖 CLI、Web 管理后台、工作流编排、按量计费等模块。
2. 背景
我是一名产品/技术从业者，目前关注 AI Agent 在国产环境下的落地可行性。OpenClaw 是 GitHub 上一个优秀的开源多通道 AI Gateway，但其默认面向海外市场（WhatsApp / Telegram / Discord），缺乏对中国用户常用模型和消息通道的支持。
于是决定基于 OpenClaw 做深度二次开发，目标：
- 支持国产大模型（DeepSeek、通义千问、智谱GLM）
- 接入企业微信通道
- 全中文化 UI，降低使用门槛
- 加入工作流引擎和按量计费
- 保持项目可私有化部署
3. 实践过程
3.1 任务拆解
整个二次开发分为六个阶段，按依赖关系依次推进：
- 环境搭建 + 构建通过
- 品牌重塑（OpenClaw → WeAgent → Rapoo）
- 三大国产模型 Provider 开发
- 企业微信通道模块
- Web 管理后台美化 + 模型配置页面
- 工作流引擎 + 计费系统
3.2 SOLO 能力使用
在整个开发过程中深度使用了 TRAE SOLO 的核心能力：
代码生成与重构
大规模代码生成场景：
- 新建
src/agents/deepseek-models.ts等 3 个模型目录文件 - 新建
src/wecom/企业微信完整模块（types / client / webhook） - 新建
src/workflow/工作流引擎（types / executor / store） - 新建
src/billing/计费系统（types / calculator / store） - 新建
ui/src/ui/views/models.ts模型配置交互页面 - 新建
ui/src/ui/views/workflows.ts工作流列表页 - 新建
ui/src/ui/views/workflow-editor.tsSVG 画布编辑器
关键重构场景：
ui/src/styles/base.css完整主题翻新（暗/亮双主题，蓝紫渐变配色）ui/src/ui/app-render.ts注册 3 个新 Tab（models / workflows / billing）src/config/types.channels.ts注册企业微信通道类型
代码理解与修改
在已有大型项目（327 个构建产物，100+ 源文件）中精准定位修改点：
- 理解 OpenClaw 的 Provider 注册机制（
models-config.providers.ts+model-auth.ts） - 遵循现有模式新增 Provider 构建函数和隐式发现注册
- 遵循 Lit 框架模式新增 UI 渲染函数和导航注册
问题排查
tags.map is not a function— 自定义模型 tags 字段类型与内置模型不一致- 跨模块 import 限制（UI 不能直接引用 src/）— 内联类型定义
- 浏览器缓存旧 JS — 清理 dist 产物重建
- Gateway 配置迁移（
agent.model→agents.defaults.model.primary）
3.3 典型工作流
一个模型 Provider 从零到可用的完整流程：
- 创建模型目录文件
deepseek-models.ts（模型常量 + 构建函数） - 在
models-config.providers.ts注册 import + build 函数 + 隐式发现 - 在
model-auth.ts添加DEEPSEEK_API_KEY环境变量映射 - 在 UI 导航注册
modelsTab + 中文翻译 - 创建
models.ts交互页面（API Key 输入 + 自定义模型 + 配置生成） - 构建验证 → 启动 Gateway → 对话测试
4. 成果展示
4.1 项目全貌
打招呼功能：
操作电脑：
写诗：
写代码：
4.2 功能模块
| 模块 | 技术栈 | 说明 |
|---|---|---|
| CLI | TypeScript + tsdown | 命令行入口，品牌 Banner |
| Gateway | WebSocket (ws) | 实时消息网关 |
| Web 管理后台 | Lit 3.3 + Vite 7.3 | SPA，16 个功能页面 |
| 模型引擎 | OpenAI 兼容协议 | DeepSeek/Qwen/GLM Provider |
| 企业微信 | REST API + AES | 消息收发 + Webhook |
| 工作流引擎 | 自研 DAG | 8 种节点，SVG 画布 |
| 计费系统 | JSONL 存储 | Token 追踪 + 账单 |
4.3 对话验证
$ pnpm openclaw agent --agent main --message "你好" --thinking off
⚡ Rapoo 1.0.0 — Your AI, Your Rules.
│
◇ Hi! 有什么需要帮忙的吗？
4.4 成果展示
CLI 启动 & 对话
Web 管理后台
模型配置
工作流编辑器
5. 效果与总结
提效成果
- 从 0 到完整可运行项目，累计开发时间集中在需求分析和架构设计
- SOOLO 承担了大量代码生成和调试工作，尤其在跨文件一致性和类型检查场景
- 问题定位效率提升显著：浏览器报错 → SOLO 搜索定位 → 精准修复 → 构建验证，形成闭环
可复用方法
- 先理解再动手：大型开源项目的二次开发，先探索现有架构和模式，再对齐新增
- 渐进式构建：每个 Phase 构建验证通过后再进入下一个
- 类型驱动：TypeScript 类型检查作为质量门禁
- 品牌独立策略：用户可见层改动，底层基础设施保持兼容
对 AI 工作方式的思考
开发过程中最大的感受是：AI 不是替代开发者，而是让人从繁琐的代码细节中抽离出来，聚焦在架构决策和用户体验上。
建立规范、明确边界后，AI 是效率放大器——在这个项目中，它承担了 80% 以上的代码量，让我能把精力集中在产品形态和功能设计上。
Rapoo — Your AI, Your Rules.
基于 OpenClaw 二次开发，遵循原始项目开源协议。