形态状态
X86 为现役；ARM 与 Cloud 仍在规划，未对外交付。页面中的形态描述是目标能力，不是现货承诺。
功能与参数
jAgent，参数。
只写能被验证的数字与边界。现役形态、规划形态、硬件要求、电话套件与安全约束，都在这一页。
Core
核心
一套可私有部署的 AI 个人助理：运行时、能力网关、通道、推送与运维面。以下数字对应当前 X86 生产环境。
- 产品形态
- X86 现役；ARM、Cloud 规划中
- Agent 运行时
- OpenClaw，多角色、独立会话、独立工具面
- 能力网关
- cap-hub（ContextForge）统一注册、路由、授权、审计与降级
- 能力规模
- 19 个 MCP 模块 + 2 个内置工具 · 197 个工具按必选 / 按需 / 单独安装 / 自建对接四层组织
- 人机通道
- 微信、钉钉、jPhone、Web 控制台
- 电话能力
- 默认安装组件：EG25 + FreeSWITCH + Pipecat + 模型需 EG25 + SIM 启用；缺失时电话/短信自动裁剪，其他能力不受影响
- 推送
- push-hub + notify 统一收口；jPhone 使用零内容 APNs 唤醒
- 数据与审计
- 通话记录、短信、事件游标、能力调用审计录音与敏感数据默认留在本地或 NAS；OSS 为可选存储
- 部署
- Linux systemd；macOS 本地能力端；Docker（Cloud 规划）
- 更新与回滚
- 检查更新、一键更新、失败回滚（按形态与版本提供）
- 备份与迁移
- 控制台导出 / 导入（按版本可用）
Telephony Kit
电话套件
默认安装的电话/短信组件，但不是核心硬依赖。套件 = 电话腿（EG25 + 载体）+ FreeSWITCH（通话大脑）+ jPhone（人）。没有 EG25 + SIM 时，电话/短信自动裁剪，其他能力照常。
- 模块
- Quectel EG25-G GGB（VoLTE 变体）
- 固件基线
- EG25GGBR07A08M2G已在现役电话腿上验证 UAC 音频与 VoLTE 通话
- 网络
- LTE / VoLTE；标准 SIM 卡槽实际频段与运营商兼容性以模块型号和当地网络为准
- 语音
- 来电 RING / ATA，外呼 ATD / ATH；通话状态机在 FreeSWITCH
- 音频
- USB UAC，8 kHz / 16-bit / mono，双向连续定速流；上行先开流，再建立通话
- 接口
- USB 2.0（VID:PID 2C7C:0125）
- 供电
- 5V，约 2A 突发电流必须使用独立供电 Hub；禁止用 Mac USB 口直供
- 短信
- 收发、白名单、事件唤醒；短信到达可触发 Agent
- 交换与状态机
- FreeSWITCH：代接、待转、咨询转、盲转、反复切、录音
- 终端
- jPhone：SIP 账号 + APNs 零内容推送
- 可选性
- 无套件时核心正常启动，电话工具自动裁剪，控制台电话页自适应隐藏
- 载体
- PVE VM（现役）、ARM 单板（R2S / R4S）、Mac（开发/临时）
电话套件是默认安装组件，但不是核心硬依赖。通话进行中，链路不依赖能力网关；网关不可用时电话仍可接通。
Forms
三种形态
三种形态不是同一套代码缩放：能力中枢随本体部署，本地能力按 cap-hub 上游标准跨网接入。
| 项目 | X86（现役） | ARM（规划） | Cloud（规划） |
|---|---|---|---|
| 部署方式 | PVE 多 VM + 本地能力端 | ARM 单机（树莓派 / 小主机） | Docker / Kubernetes |
| agent-core | 全量 | 全量 | 全量（容器化） |
| phone-system | 全量（EG25 + FS + Pipecat） | 核心子集（可选 EG25） | 默认不适用；可选远端腿 |
| mcp-gateway | 全量（cap-hub + 19 模块） | 精简（核心 MCP） | 全量（容器化，cap-hub 为入口） |
| push-services | 全量 | 全量 | 全量 |
| operations | 全量（控制台 + 看门狗） | 精简控制台 | 全量 |
| bridges | HomeKit + 查询路由 | 视硬件 | 视需求 |
| hardware | EG25 驱动 | 精简（SMS / 4G） | 不适用 |
| cap-hub | 常驻 VM | 随 ARM 部署 | 容器化 |
| 适合 | 多用户家庭、完整电话与 HomeKit | 一台盒子搞定核心代理 | 无本地硬件、能力上云 |
ARM 与 Cloud 为规划形态，尚未对外交付。表中“全量 / 精简”描述目标能力面，最终以对应版本的交付清单为准。
Environment
环境要求
核心以 Python 与 Node.js 为主，电话桥使用 Go。以下为开发与部署基线。
- Python
- 3.13 及以上
- Node.js
- 20 及以上
- Go
- 1.22 及以上（SIP 桥，可选）
- 操作系统
- Linux（systemd）；macOS（本地能力端）；Docker（Cloud）
- 网络
- 局域网可用；外网访问需 WireGuard 或端口映射 + TLS 证书
- 浏览器
- 现代浏览器（控制台）；jPhone 需 iOS
- 存储
- 按通话录音、附件与备份容量规划；支持 OSS / NAS / 本地盘
- 电话硬件
- EG25-G 模块 + 独立供电 Hub + 标准 SIM（可选）
- 域名与证书
- 自定义域名 + ACME 自动续期；支持 OSS / 反向代理
Security
安全与治理
默认不信任外部服务，默认限制模型权限，默认保留可回溯的记录。
- 凭据
- 仓库只保留
.example模板；活凭据不进 git，部署时注入 - 权限
- 角色级 token 与工具面；写操作默认不进入电话查询链路
- 审计
- 能力调用、通话、短信与关键写操作均有记录
- 传输
- HTTPS / TLS；jPhone 直连盒子或自有云，不引入第三方中转
- 推送
- 零内容载荷：只唤醒，不携带短信或通话内容
- 数据
- 录音等敏感数据仅本地或 NAS 保留；OSS 可选；备份落点由用户自控
- 一致性
- 自动化检查覆盖能力面、运行位与发布语义，避免“配置改了但没生效”
- 降级
- 组件缺失时 fail-soft：工具面裁剪、页面自适应，不阻塞核心
Limits
边界与已知限制
把不能做的事写清楚，比把能做的事说得更大声更重要。
电话质量
通话质量取决于运营商网络、SIM 与模块固件。EG25 对供电敏感，必须使用独立供电 Hub。
第三方能力
高德、滴滴、麦当劳、COROS 等模块需要各自账号与授权，接口与配额可能随供应商调整。
jPhone
目前为 TestFlight 内测，未上架 App Store。内测名额、系统版本与可用功能以邀请说明为准。
授权数据
经营数据等模块仅对授权账号开放；不同角色的工具面由管理员配置，默认最小化。
数量口径
197 个工具为 2026-10-20 的注册表快照（195 个挂载 + 2 个内置），会随版本增减。
必须上云吗？
不。核心与数据可落本地或 NAS；OSS 只是可选存储。高德、滴滴、麦当劳等第三方能力按需调用，不改变数据主权的默认落点。