cfdaily
126 lines
5.1 KiB
Markdown
126 lines
5.1 KiB
Markdown
# 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 已经够用，我们专注策略开发即可 |
|
||
|
||
---
|
||
|
||
**调研完毕**！
|