Files
sanguo_quant_live/pangtong-value/research/task-20260329-quantclaw-analysis/zhangfei
2026-04-02 08:55:07 +08:00
..
2026-04-02 08:55:07 +08:00

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 控制仪表盘:

  1. 访问地址: http://localhost:18801(端口可配置,和 OpenClaw 不冲突)
  2. 认证方式: Token 认证(存储在浏览器 localStorage),可关闭认证
  3. 功能点:
    • 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 已经够用,我们专注策略开发即可

调研完毕