OpenAlice

定位#

OpenAlice 是一个完全本地自托管的全生命周期 AI 交易代理，覆盖从宏观研究、数据分析到建仓、持仓管理及平仓的完整交易闭环。支持股票、加密货币、大宗商品、外汇和宏观研究。

核心能力#

交易执行#

• UTA (Unified Trading Account)：将 Alpaca、IBKR 及 CCXT 加密交易所整合为统一工作空间，AI 仅与 UTA 交互，实现底层券商解耦。
• Trading-as-Git (TaG)：订单需经过暂存→提交→推送的显式审批流程，执行后生成 8 字符 commit hash，支持 git log / git show 式完整历史回溯。
• Guard Pipeline：执行前安全检查（最大仓位、冷却时间、标的白名单），每个账户独立配置，充当"交易版 ESLint"。
• Account Snapshots：定期与事件驱动的账户状态快照，附带权益曲线可视化。

研究与分析#

• Market Data：基于 TypeScript 原生 OpenBB 引擎（TypeBB），覆盖权益、加密、大宗商品、货币和宏观数据，提供统一跨资产标的搜索与技术指标计算器。
• Fundamental Research：公司概况、财务报表、比率、分析师预测、财报日历、内幕交易、市场异动（目前权益类最深，其他资产类别扩展中）。
• News：后台 RSS 采集 + 归档搜索。

自动化与监控#

• Event Log：追加式类型化事件日志为核心，所有系统活动汇入，支持实时订阅。
• Cron Scheduling：支持 cron 表达式 / 间隔 / 一次性时间戳触发，AI 处理后回复到用户最后使用的渠道。
• Heartbeat：定期审查市场条件，仅在必要时（持仓过夜监控、宏观事件）主动通知用户，无变化时保持静默。

交互与接口#

• Web UI：SSE 流式聊天、子频道、带权益曲线的投资组合仪表盘、全配置管理。
• Telegram：移动端交易面板。
• MCP Server：为外部 Agent 暴露工具接口。

AI 与记忆#

• Multi-provider AI：支持 Claude（Agent SDK，OAuth 或 API Key）或 Vercel AI SDK（Anthropic / OpenAI / Google），运行时可动态切换。
• Brain：跨对话持久记忆 + 情感追踪。
• Evolution Mode：权限升级模式，给予 Alice 完整项目访问权限（含 Bash），支持自我修改。

架构设计#

项目采用严格的四层架构，每层仅与上下相邻层通信：

• Interface 层：外部表面（Web UI / Telegram / MCP），ConnectorCenter 追踪用户最后使用的渠道。
• Core 层：AgentCenter 路由所有 AI 调用至 ProviderRouter；ToolCenter 作为共享注册中心；EventLog 充当中央事件总线。
• Domain 层：核心业务逻辑，包含 UTA、Market Data、Analysis、News、Brain 等模块，通过工具注册暴露给 AI。
• Automation 层：EventLog 总线上的监听器，包含 Cron 调度器与 Heartbeat。

工程化方面采用 pnpm monorepo + Turborepo 构建编排，测试框架为 vitest。IBKR 集成通过 TWS/Gateway 实现，IbkrBroker 将回调式 SDK 桥接到 Promise 式接口。

配置体系#

所有配置位于 data/config/ 目录，JSON 格式 + Zod 校验，缺失文件回退到默认值，支持 Web UI 或手动编辑。涵盖 engine、agent、ai-provider、accounts、connectors、telegram、tools、market-data、news、snapshot、compaction、heartbeat 等配置文件。Persona 与 Heartbeat 提示词采用默认（Git 追踪）+ 用户覆盖（Git 忽略）模式。

部署要求#

• Node.js 22+、pnpm 10+、已安装并认证 Claude Code CLI
• 默认使用本地 Claude Code 登录（需 Claude Pro/Max 订阅），无需额外配置 API Key
• 启动后访问 localhost:3002

待确认事项#

• 是否有正式学术论文（目前未发现）
• v1 正式发布日期（无具体时间线）
• Webhooks 功能上线时间（标注为 planned）
• 非 US 资产类别基本面研究覆盖深度
• TypeBB 是否为自建项目（疑似自研封装，无独立仓库链接）