QuantClaw 项目调研分析
调研日期: 2026-03-29
调研人: 翼德 (张飞)
一、项目基本信息
项目地址: https://github.com/QuantClaw/QuantClaw
一句话定位: C++ 实现的 OpenClaw AI Agent 网关 —— 追求极致性能和低内存占用,完全兼容 OpenClaw 生态(workspace 文件、技能、插件协议)。
⚠️ 重要澄清:这不是量化交易项目,是通用 AI Agent 运行框架,和我们
sanguo_quant_live量化交易策略研究项目是互补关系。
二、完整业务场景和功能列表
核心功能
| 模块 | 功能 | 完成状态 |
|---|---|---|
| 智能对话 | 多轮对话上下文管理,自动压缩裁剪token,thinking mode 扩展推理,持久化会话 | ✅ 完成 |
| 持久化内存系统 | 四种内存(用户/Agent/工作区/文件),BM25 搜索,自动裁剪淘汰 | ✅ 完成 |
| 浏览器控制 | Chrome DevTools Protocol 集成,支持导航/点击/JS执行/截图 | ✅ 完成 |
| 系统集成 | Bash 命令执行,文件操作,环境配置读写 | ✅ 完成 |
| 插件生态 | Node.js sidecar 插件体系,完全兼容 OpenClaw 插件格式 | ✅ 完成 |
| 多LLM提供商 | OpenAI 兼容 + Anthropic 原生,自动failover | ✅ 完成 |
| 企业安全 | RBAC 权限,工具权限规则,审计日志,进程沙箱隔离 | ✅ 完成 |
| 用量统计 | Token/延迟/错误率监控,CLI 查询 | ✅ 完成 |
| 多渠道接入 | Discord/Telegram/Web 仪表盘 | ✅ 完成 |
| 定时任务 | Cron 作业,生命周期钩子回调 | ✅ 完成 |
| 性能优化 | C++17 原生编译,低内存 footprint,多线程并发 | ✅ 完成 |
三、Web 界面情况
QuantClaw 自带开箱即用的 Web 控制仪表盘:
- 访问地址:
http://localhost:18801(端口可配置,和 OpenClaw 不冲突) - 认证方式: Token 认证(存储在浏览器 localStorage),可关闭认证
- 功能点:
- Gateway 状态监控(健康检查/活跃会话数/Token 用量统计)
- 在线对话界面(直接和 Agent 交互)
- 可视化配置编辑器
- 会话管理(列表/历史/删除)
- 插件状态查看
技术架构: 前端静态资源编译后打包,后端 C++ 直接提供 HTTP 服务,开箱即用。
四、和我们「三国之量化交易项目」比对
| 维度 | sanguo_quant_live | QuantClaw | 结论 |
|---|---|---|---|
| 定位 | A股量化交易策略研究框架 | 通用 AI Agent 网关框架 | 完全互补,不冲突 |
| 主要语言 | Python(策略) | C++ 全框架 | QuantClaw 更底层 |
| Web UI | 需要我们自己开发回测展示/交易控制界面 | 已经有完整的控制仪表盘 | 架构可以借鉴 |
| 插件生态 | 策略插件机制 | 兼容 OpenClaw 技能/插件格式 | 我们可以直接复用技能格式 |
| 适用场景 | 策略开发 ←→ 回测 ←→ 实盘交易 | AI Agent 网关服务,供前端/客户端连接 | 分工清晰,我们做策略,它做网关 |
五、对我们开发量化 Web 页面的借鉴
1. 架构借鉴
- 前后端分离: QuantClaw 把 C++ 后端和静态 WebUI 分开编译,后端提供 REST API + WebSocket,前端静态文件直接由后端 HTTP 服务托管。这个架构简单清晰,我们直接用。
2. 端口规划借鉴
18789: OpenClaw original (WebSocket + HTTP)
18800: QuantClaw WebSocket RPC
18801: QuantClaw HTTP/Dashboard
18802: 我们量化 Web 服务 ← 放这里,互不冲突
3. 认证方式借鉴
- 简单 Token 认证,存在浏览器 localStorage,不需要复杂 session,适合内部系统,我们直接用这个方案。
4. REST API 设计借鉴
QuantClaw 的 API 分层清晰:
/api/health 健康检查
/api/status 网关状态
/api/agent/request 发消息给 Agent
/api/sessions 会话管理
/api/plugins/* 插件 API
我们开发量化 API 可以参考这个分层:
/api/health 健康检查
/api/status 系统状态
/api/backtest/run 发起回测
/api/backtest/list 回测列表
/api/backtest/result 回测结果
/api/strategy/list 策略列表
/api/strategy/config 策略配置
5. Docker 化借鉴
QuantClaw 做了多阶段构建:
- 第一阶段: 编译 C++
- 第二阶段: 编译 Node.js sidecar
- 第三阶段: 只复制最终产物到运行时镜像
- 非 root 用户运行
- 镜像体积小
这个写法我们直接抄就行,适合生产环境部署。
六、总结
| 问题 | 答案 |
|---|---|
| 这是量化交易项目吗? | ❌ 不是,是 AI Agent 网关框架,和我们量化项目互补 |
| 有没有 Web 界面? | ✅ 有,内置控制仪表盘,完整前后端分离 |
| 对我们开发量化 Web 有帮助吗? | ✅ 有,架构设计 / API 设计 / Docker 化都值得直接借鉴 |
| 需要我们集成 QuantClaw 吗? | 不需要。我们项目是策略层,它是网关层,OpenClaw 已经够用,我们专注策略开发即可 |
调研完毕!