服务器 API
CLI-JAW 提供 141 个 HTTP API 端点，分布在 15 个路由模块中。所有变更路由均需要身份验证。
基础 URL
http://localhost:3457 # Single instance (jaw serve)
http://localhost:24576 # Dashboard (jaw dashboard)
身份验证
回环请求（127.0.0.1、localhost、::1）会自动完成身份验证。远程请求需要通过 GET /api/auth/token 获取 Bearer 令牌。
路由模块
| 模块 | 路由数 | 描述 |
|---|
| server.ts | 14 | 引导启动、健康检查、WebSocket |
| settings.ts | 18 | 设置、提示词、心跳、MCP、CLI 注册 |
| memory.ts | 13 | 内存运行时 + KV + 文件 |
| browser.ts | 41 | CDP、web-ai、标签页、调试 |
| jaw-memory.ts | 11 | Jaw 记忆搜索/读取/保存 |
| orchestrate.ts | 11 | PABCD 状态、工作线程、调度 |
| goal.ts | 3 | 目标增删改查 |
| goal-run.ts | 3 | 有界目标执行 |
| messaging.ts | 6 | 上传、语音、频道发送 |
| employees.ts | 5 | 员工增删改查 |
| skills.ts | 5 | 技能列表/启用/禁用 |
| avatar.ts | 4 | 头像图片 |
| traces.ts | 3 | 追踪记录读取 |
| heartbeat.ts | 2 | 心跳配置 |
| i18n.ts | 2 | 语言/区域设置 |
主要端点
聊天
| 方法 | 路径 | 描述 |
|---|
| POST | /api/chat | 发送消息（流式 NDJSON 响应） |
| GET | /api/chat/history | 获取聊天历史 |
| POST | /api/chat/stop | 停止生成 |
目标
| 方法 | 路径 | 描述 |
|---|
| GET | /api/goal | 获取当前活跃目标 |
| POST | /api/goal | 设置/更新/完成/取消目标 |
| GET | /api/goal/history | 目标历史 |
编排
| 方法 | 路径 | 描述 |
|---|
| GET | /api/orchestrate/state | 当前 PABCD 状态 |
| PUT | /api/orchestrate/state | 状态转换 |
| POST | /api/orchestrate/reset | 重置为 IDLE |
| POST | /api/orchestrate/dispatch | 调度工作线程 |
设置
| 方法 | 路径 | 描述 |
|---|
| GET | /api/settings | 获取设置 |
| PATCH | /api/settings | 更新设置 |
| GET | /api/settings/prompt | 获取系统提示词 |