名册
交易大厅上的十二位船员
每个代理在统一清单中都有明确的职责。规划者读取它,调度者执行它,你则在交易大厅上观察它们工作。
↳ 点击任一位船员,查看它的具体工作
能力
这套框架究竟做了什么
代理
十二位专家,一个大厅
每个代理都有明确的职责、声明的输入输出,并在仪表盘交易大厅上拥有一位对应的船员 — 他们会呼吸、眨眼,每种物种还有独特的空闲动画。
路由
多提供商 LLM 路由
Anthropic、OpenAI、Google Gemini 和本地 Ollama — 只需修改配置就能切换提供商,无需改代码。通过 Node.js sidecar 走 OAuth,Claude Code / Codex / Gemini CLI 登录开箱即用。
资金安全
纸面交易优先
像「go make me cash」这样的宽泛目标会被编译成以纸面交易为先的状态机。只有通过持出法验证后才能进入纸面阶段,触及回撤阈值即暂停 — 不会因为任意循环次数而结束。
代码安全
沙盒化因子执行
LLM 生成的因子和训练代码在子进程隔离的沙盒中运行,包含 AST 强制的导入白名单、dunder 访问拦截、环境变量剥离与资源上限。
数据
20 种内置数据源
十二种免费源(Yahoo Finance、FRED、SEC EDGAR、世界银行、IMF、BLS、美国财政部、ECB、BIS、CFTC、OpenInsider、Stooq),外加八种 API key 源(Alpha Vantage、Finnhub、FMP、SimFin、Tiingo、Twelve Data、Nasdaq、EIA)。共享一套区间感知的 parquet 缓存。
探索
纸面阶段的影子搜索
当一个策略在纸面运行时,发现流水线每隔 N 个循环继续在后台工作。分配器在每次再平衡时仲裁在位者与挑战者 — 你永远不会停止寻找更好的 alpha。
可观测性
类型化事件总线与成本追踪
每个代理动作都是一个类型化事件。路由器按调用、代理、模型追踪 LLM token — 在超过阈值时触发 cost.budget_warning,按紧急程度路由到 Telegram / Discord / Slack。
持久化
带压缩的只追加内存
Playbook 是所有代理写入的 JSONL 日志。压缩只保留每个键的最新快照,并把历史尾部归档为 gzip — 无论活动跑多久,重启都很快。
架构
八层协同
LLM 只是系统里的一个工具。围绕它的一切才是 harness。
任务
CampaignManager 把宽泛目标编译为阶段状态机
编排
OODA + Planner + Dispatcher + LLMRouter + OAuth sidecar
代理
清单中声明的十二位专家
执行
LLM 代码沙盒、精简 Strategy 契约、纸面执行器
组合
DeploymentAllocator 管理 活跃 / 观察 / 退役 三档
记忆
只追加的 Playbook JSONL + 可查询的 SQLite 状态数据库
可观测性
类型化事件、按紧急程度路由的 Telegram / Discord / Slack 通道
界面
Next.js 仪表盘 — 交易大厅、计划审批、停止按钮
开始使用
从 npm install 到 “go make me cash”
安装
npm install -g quantclaw;quantclaw start 会在你本机启动后端、sidecar 和 Next.js 仪表盘。
认证
通过 Claude Code / Codex / Gemini CLI OAuth 登录,或填入 API key。也支持本地 Ollama 模型 — 离线可用。
设定目标
自然对话即可。像「go make me cash」或「find alpha」这样的宽泛目标会被编译为持续运行的盈利活动。
观察交易大厅
十二位船员在交易大厅实时工作。审批计划、按下停止、调整风险上限 — 你始终是 CEO。
先纸面,后实盘
活动默认纸面优先。回撤破限或执行器连续失败会自动暂停。你决定何时上实盘。
技术栈
技术栈
引擎
机器学习
界面
Sidecar