Relay Gateway HTTP API 是为 Clawline Gateway 新增的 HTTP 直连接口，允许外部系统通过标准 HTTP 请求与 Agent 对话。
核心功能
- POST /api/chat — 发送消息并同步等待 AI 回复
- 支持
meta.source='api'标识，贯穿全链路（持久化 + 前端展示） agentId为必传参数，防止脏数据产生- 后端通过创建虚拟连接注入 channel 插件实现
API 端点
| 端点 | 方法 | 说明 |
|---|---|---|
/api/chat | POST | 发送消息并等待回复 |
/api/messages/sync | GET | 查询历史消息 |
实现细节
- Gateway 端新增约 169 行代码，包含虚拟连接创建和
closeSocket null guard - Client Web 端约 100 行改动跨 5 个文件
- 支持消息持久化和前端 API badge 渲染
- WS broadcast 确保实时同步
相关页面
- clawline — Gateway 核心实现
- clawline — Web 客户端适配
- clawline-thread-support — 线程支持限制