openclaw-channel-xiaozhu 1.0.0 → 2.1.0

package/README.md

@@ -1,106 +1,432 @@
 # openclaw-channel-xiaozhu
 
-小助 — OpenClaw 通用渠道插件，通过标准 HTTP/SSE 接口将任意客户端接入 OpenClaw 对话引擎。与钉钉（`openclaw-channel-dingtalk`）、飞书（`openclaw-channel-feishu`）并列，是面向自定义客户端的通用接入渠道。
+小助 — OpenClaw 通用渠道插件，通过标准 HTTP/SSE 接口将任意客户端接入 OpenClaw 对话引擎。与钉钉（`clawdbot-dingtalk`）、飞书等渠道并列，是面向自定义客户端的通用接入渠道。
 
 ## Features
 
-- 同步聊天 (`POST /api/chat`) 与 SSE 流式聊天 (`POST /api/chat/stream`)，流式响应支持文本合并
-- 滑动窗口限流 + 突发控制
+- 同步聊天 (`POST /api/chat`) 与 SSE 流式聊天 (`POST /api/chat/stream`)
+- SSE 心跳保活（防代理/LB 超时断连）
+- SSE typing 状态指示（thinking → generating）
+- 可配置文本合并缓冲（sizeThreshold / idleTimeoutMs）
+- 滑动窗口限流 + 突发控制 + Per-IP 独立限流
 - 消息去重（TTL 集合）
 - 发送者白名单 (`allowFrom`)
 - 群聊支持 (`chatType: "group"`)
 - 多媒体消息：图片、音频、文件（base64 / URL）
+- 文件上传端点 (`POST /api/upload`，支持 multipart 和 raw binary)
 - 媒体文件托管 (`GET /api/media/:id`)
 - 语音转文字 (`POST /api/stt`，基于 Whisper)
 - 文字转语音 (`POST /api/tts`，基于 edge-tts)
-- Webhook 外发消息 (`POST /api/webhook/register`)
+- Webhook 外发消息 + HMAC-SHA256 签名 + 指数退避重试
+- 会话管理 API (`GET /api/sessions`, `DELETE /api/sessions/:id`)
+- 聊天命令 (`/new`, `/help`, `/sessions`)
+- 多账号支持（单配置向后兼容）
+- 超长回复围栏感知分块（不在代码块内断开）
+- Request ID 追踪 + Access Log
+- 优雅关闭（排空活跃 SSE 连接）
 - 可配置 CORS 来源
 - 常量时间 Token 比较（防时序攻击）
+- SSRF 防护（Webhook/STT URL 校验，拦截内网地址含 IPv6）
+- Slowloris 防护（请求体读取 30s 超时）
+- 请求体大小预检（Content-Length 提前拒绝）
+- 云端中继模式（无公网 IP 时通过 WebSocket 反向连接）
+- **独立服务端**（脱离 OpenClaw 运行，多 Bot 路由 + Admin API）
+- **思维引擎**（Experimental）— AI 驱动的个人知识管理（想法捕获 → 结构化 → 关联发现 → 洞察 → 作品组装）
+- **客户端 SDK**（TypeScript，浏览器 + Node.js 兼容）
+- **Web Demo**（聊天界面 + 思维引擎界面）
+- 聊天记录导出/导入（纯客户端，服务器不存储）
 
-## Quick Start
+## 安装部署
 
-### Prerequisites
+### 前置条件
 
 - Node.js >= 20
-- OpenClaw >= 2026.1
+- OpenClaw >= 2026.1（已安装并运行）
+- C++ 编译工具链（可选，独立服务端的思维引擎需要 `better-sqlite3`，这是一个 native addon。不安装则思维引擎功能不可用，其他功能正常）
 
-### Install
+### 第一步：安装插件
 
 ```bash
-npm install openclaw-channel-xiaozhu
+npm install -g openclaw-channel-xiaozhu
 ```
 
-### Build
+> 如果你的 npm 默认源是淘宝镜像，新包同步可能有延迟，可指定官方源：
+> ```bash
+> npm install -g openclaw-channel-xiaozhu --registry=https://registry.npmjs.org/
+> ```
 
-```bash
-npm run build
-```
+### 第二步：配置渠道
 
-### Deploy
+编辑 `~/.openclaw/openclaw.json`，在 `channels` 中添加小助渠道配置：
 
-将构建产物部署到 OpenClaw 插件目录，或在 `openclaw.json` 中注册本渠道即可。
+**单账号模式（推荐）：**
 
-## Configuration
+```json
+{
+  "channels": {
+    "channel-xiaozhu": {
+      "enabled": true,
+      "port": 18800,
+      "token": "your-secret-token",
+      "allowFrom": ["*"],
+      "allowOrigins": ["*"]
+    }
+  }
+}
+```
 
-在 `openclaw.json` 的 `channels` 中添加：
+**多账号模式：**
 
 ```json
 {
-  "channels": [
-    {
-      "type": "channel-xiaozhu",
-      "config": {
-        "port": 3000,
-        "token": "your-secret-token",
-        "rateLimitWindowMs": 60000,
-        "rateLimitMax": 60,
-        "rateLimitBurst": 10,
-        "dedupTtlMs": 5000,
-        "allowFrom": ["*"],
-        "webhookUrl": "",
-        "allowOrigins": ["*"]
+  "channels": {
+    "channel-xiaozhu": {
+      "accounts": {
+        "bot-a": { "port": 18800, "token": "token-a" },
+        "bot-b": { "port": 18801, "token": "token-b" }
       }
     }
-  ]
+  }
 }
 ```
 
+**无公网 IP（云端中继模式）：**
+
+```json
+{
+  "channels": {
+    "channel-xiaozhu": {
+      "port": 18800,
+      "token": "your-secret-token",
+      "networkMode": "cloud"
+    }
+  }
+}
+```
+
+> 默认连接 `wss://relay.xiaozhu.ai/ws/bot`。也可以自建中继服务器：
+> ```json
+> {
+>   "networkMode": "cloud",
+>   "relayUrl": "wss://my-vps.com:8080/ws/bot",
+>   "relayToken": "my-relay-secret"
+> }
+> ```
+>
+> 自建中继：`npx xiaozhu-relay --port 8080 --token my-relay-secret`
+
+> 注意：与已有配置合并，不要覆盖其他渠道（如钉钉）的配置。
+
+### 第三步：重启 OpenClaw
+
+```bash
+systemctl --user restart openclaw-gateway.service
+```
+
+### 第四步：验证
+
+```bash
+# 健康检查（不需要鉴权）
+curl http://localhost:18800/api/health
+
+# 测试对话
+curl -X POST http://localhost:18800/api/chat \
+  -H "Authorization: Bearer your-secret-token" \
+  -H "Content-Type: application/json" \
+  -d '{"message": "你好", "session": "test-001"}'
+```
+
+### 第五步：防火墙放行（如需外部访问）
+
+```bash
+sudo firewall-cmd --permanent --add-port=18800/tcp
+sudo firewall-cmd --reload
+```
+
+## 配置项
+
 | 字段 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `port` | number | `3000` | HTTP 监听端口 |
+| `port` | number | `18800` | HTTP 监听端口 |
 | `token` | string | — | 鉴权 Token（必填） |
 | `rateLimitWindowMs` | number | `60000` | 限流滑动窗口（毫秒） |
-| `rateLimitMax` | number | `60` | 窗口内最大请求数 |
-| `rateLimitBurst` | number | `10` | 突发请求上限 |
-| `dedupTtlMs` | number | `5000` | 消息去重 TTL（毫秒） |
+| `rateLimitMax` | number | `20` | 窗口内最大请求数 |
+| `rateLimitBurst` | number | `5` | 突发请求上限 |
+| `dedupTtlMs` | number | `300000` | 消息去重 TTL（毫秒） |
 | `allowFrom` | string[] | `["*"]` | 允许的发送者 ID，`*` 表示全部 |
-| `webhookUrl` | string | `""` | Webhook 回调地址，为空则不启用 |
+| `webhookUrl` | string | `""` | Webhook 回调地址 |
+| `webhookSecret` | string | `""` | Webhook HMAC-SHA256 签名密钥 |
+| `webhookRetry` | object | — | `{ maxAttempts: 3, baseDelayMs: 1000 }` |
 | `allowOrigins` | string[] | `["*"]` | CORS 允许的来源 |
+| `heartbeatIntervalMs` | number | `15000` | SSE 心跳间隔，0 禁用 |
+| `textChunkLimit` | number | `4000` | 同步响应分块上限 |
+| `commandsEnabled` | boolean | `true` | 是否启用聊天命令 |
+| `coalesce` | object | — | `{ sizeThreshold: 200, idleTimeoutMs: 500 }` |
+| `perIpRateLimit` | object | — | `{ windowMs: 60000, max: 10 }` |
+| `networkMode` | string | — | 网络模式：`"webhook"`（有公网 IP）或 `"cloud"`（无公网 IP，走云端中继） |
+| `relayUrl` | string | `wss://relay.xiaozhu.ai/ws/bot` | 自定义中继服务器地址（cloud 模式） |
+| `relayToken` | string | — | 中继鉴权 token（不配则复用 token） |
 
-## API Overview
+## API
 
 | Method | Path | Auth | Description |
 |--------|------|------|-------------|
-| `POST` | `/api/chat` | Yes | 同步聊天 |
-| `POST` | `/api/chat/stream` | Yes | SSE 流式聊天 |
-| `GET` | `/api/media/:id` | Yes | 获取媒体文件 |
+| `POST` | `/api/chat` | Yes | 同步聊天，返回完整回复 |
+| `POST` | `/api/chat/stream` | Yes | SSE 流式聊天（含 typing + heartbeat） |
+| `POST` | `/api/upload` | Yes | 文件上传（multipart 或 raw binary） |
+| `GET` | `/api/media/:id` | No | 获取媒体文件 |
+| `GET` | `/api/sessions` | Yes | 列出活跃会话 |
+| `DELETE` | `/api/sessions/:id` | Yes | 删除会话 |
 | `POST` | `/api/stt` | Yes | 语音转文字 |
 | `POST` | `/api/tts` | Yes | 文字转语音 |
 | `POST` | `/api/webhook/register` | Yes | 注册 Webhook |
+| `DELETE` | `/api/webhook` | Yes | 注销 Webhook |
 | `GET` | `/api/health` | No | 健康检查 |
 
 完整 API 文档见 [docs/API.md](docs/API.md)。
 
-## Environment Variables
+## 独立服务端
+
+独立服务端可脱离 OpenClaw 运行，作为多 Bot 接入平台。客户端通过 HTTP/SSE 对话，Bot 通过 WebSocket 连接。服务器不存储任何聊天记录。
+
+```bash
+# 启动
+npx xiaozhu-server --port 9000 --admin-key my-secret
+
+# 或使用配置文件
+npx xiaozhu-server --config ~/.xiaozhu-server/config.json
+```
+
+**快速开始：**
+
+```bash
+# 1. 注册 Bot
+curl -X POST http://localhost:9000/admin/bots \
+  -H "Authorization: Bearer my-secret" \
+  -H "Content-Type: application/json" \
+  -d '{"name":"my-bot"}'
+
+# 2. 创建 API Key
+curl -X POST http://localhost:9000/admin/keys \
+  -H "Authorization: Bearer my-secret" \
+  -H "Content-Type: application/json" \
+  -d '{"label":"demo"}'
+
+# 3. Bot 通过 WebSocket 连接
+#    ws://localhost:9000/ws/bot?token=<bot-token>
+
+# 4. 客户端对话
+curl -X POST http://localhost:9000/api/chat \
+  -H "Authorization: Bearer <api-key>" \
+  -H "Content-Type: application/json" \
+  -d '{"message":"你好"}'
+```
+
+**独立服务端 API：**
+
+| Method | Path | Auth | Description |
+|--------|------|------|-------------|
+| `GET` | `/api/health` | No | 健康检查（含在线 Bot 列表） |
+| `POST` | `/api/chat` | API Key | 同步对话（支持 `botId` 指定目标 Bot） |
+| `POST` | `/api/chat/stream` | API Key | SSE 流式对话 |
+| `POST` | `/api/upload` | API Key | 文件上传 |
+| `GET` | `/api/media/:id` | No | 媒体访问 |
+| `GET` | `/api/bots` | API Key | 列出可用 Bot |
+| `POST` | `/api/stt` | API Key | 语音转文字（转发到 Bot） |
+| `POST` | `/api/tts` | API Key | 文字转语音（转发到 Bot） |
+| `POST` | `/admin/bots` | Admin | 注册 Bot |
+| `PUT` | `/admin/bots/:id` | Admin | 更新 Bot 配置 |
+| `DELETE` | `/admin/bots/:id` | Admin | 删除 Bot |
+| `GET` | `/admin/bots` | Admin | 列出 Bot（含在线状态） |
+| `POST` | `/admin/keys` | Admin | 创建 API Key |
+| `PUT` | `/admin/keys/:id` | Admin | 更新 API Key 配置 |
+| `DELETE` | `/admin/keys/:id` | Admin | 删除 API Key |
+| `GET` | `/admin/keys` | Admin | 列出 API Key |
+
+**配置文件格式：**
+
+```json
+{
+  "port": 9000,
+  "adminKey": "my-secret",
+  "dataDir": "~/.xiaozhu-server",
+  "corsOrigin": "*",
+  "nodeId": "node-1",
+  "peers": ["http://127.0.0.1:9001"]
+}
+```
+
+| 字段 | 必填 | 默认值 | 说明 |
+|------|------|--------|------|
+| `port` | 否 | `9000` | HTTP 监听端口 |
+| `adminKey` | 是 | — | Admin Key（同时可作为 API Key） |
+| `dataDir` | 否 | `~/.xiaozhu-server` | 数据存储目录 |
+| `corsOrigin` | 否 | `*` | CORS 允许的来源 |
+| `nodeId` | 否 | 随机生成 | 节点唯一标识（多节点部署时用于队列锁） |
+| `peers` | 否 | `[]` | 对等节点地址列表（多节点部署） |
+
+## 客户端 SDK
+
+TypeScript SDK，浏览器和 Node.js 兼容。聊天记录保存在客户端内存，支持导出/导入，服务器不存储。
+
+```typescript
+import { XiaozhuClient } from "openclaw-channel-xiaozhu/sdk";
+
+const client = new XiaozhuClient({
+  baseUrl: "http://localhost:9000",
+  apiKey: "xz_your-api-key",
+});
+
+// 同步对话
+const result = await client.chat({ message: "你好", session: "s1" });
+console.log(result.reply);
+
+// 流式对话
+const stream = client.chatStream({ message: "你好", session: "s1" }, {
+  onChunk: (text) => process.stdout.write(text),
+  onDone: (fullText) => console.log("\n完成"),
+});
+await stream.done;
+
+// 列出在线 Bot
+const bots = await client.listBots();
+
+// 文件上传
+const media = await client.upload(file);
+
+// 语音转文字 / 文字转语音
+const stt = await client.stt("data:audio/mp3;base64,...");
+const tts = await client.tts("你好");
+
+// 聊天记录导出（纯客户端，服务器不存储）
+const json = client.exportHistory("s1");
+
+// 聊天记录导入
+client.importHistory(json);
+
+// 获取会话记录
+const messages = client.getHistory("s1");
+
+// 清空记录
+client.clearHistory("s1");
+```
+
+## 思维引擎（Experimental）
+
+> ⚠️ 实验性功能，API 可能在后续版本中变更。
+
+独立服务端内置 AI 驱动的个人知识管理系统。用户随时记录想法碎片，系统自动完成结构化、关联发现、洞察生成和作品组装。数据使用 SQLite 存储（`better-sqlite3`），每用户独立数据库文件。
+
+```typescript
+import { XiaozhuClient } from "openclaw-channel-xiaozhu/sdk";
+
+const client = new XiaozhuClient({
+  baseUrl: "http://localhost:9000",
+  apiKey: "xz_your-api-key",
+});
+
+// "随便说"— 系统自动识别意图（捕获想法/搜索/创建项目/查看洞察）
+const result = await client.think({ input: "推荐系统可以用协同过滤", session: "s1" });
+console.log(result.message); // "已捕获想法，正在分析..."
+
+// 直接捕获想法
+await client.captureThought("用户画像需要考虑冷启动问题");
+
+// 列出想法（支持标签/概念/状态/搜索/分页/时间范围过滤）
+const { thoughts, total } = await client.listThoughts({ tag: "推荐系统", limit: 20 });
+
+// 查看想法关联
+const related = await client.getRelatedThoughts("thought-id");
+
+// 手动关联两个想法
+await client.connectThoughts("id-a", "id-b", { type: "continuation", reason: "后者是前者的延续" });
+
+// 创建项目（从想法碎片组装成作品）
+const { project } = await client.createProject("推荐系统方案", "plan", ["thought-1", "thought-2"]);
+
+// 触发 AI 组装（生成大纲 + 草稿）
+await client.generateProject(project.id);
+
+// 获取洞察（系统自动发现的模式和机会）
+const { insights } = await client.getInsights();
+
+// 时间线（想法 + 连接的时间视图）
+const timeline = await client.getTimeline({ limit: 50 });
+
+// 用户画像（统计 + 热门标签）
+const { profile } = await client.getProfile();
+```
+
+**思维引擎 API：**
+
+| Method | Path | Auth | Description |
+|--------|------|------|-------------|
+| `POST` | `/api/think` | API Key | "随便说"核心入口 |
+| `POST` | `/api/thoughts` | API Key | 捕获想法 |
+| `GET` | `/api/thoughts` | API Key | 列出想法 |
+| `GET` | `/api/thoughts/:id` | API Key | 想法详情 |
+| `DELETE` | `/api/thoughts/:id` | API Key | 删除想法 |
+| `GET` | `/api/thoughts/:id/related` | API Key | 关联想法 |
+| `POST` | `/api/thoughts/:id/connect` | API Key | 手动关联 |
+| `POST` | `/api/projects` | API Key | 创建项目 |
+| `GET` | `/api/projects` | API Key | 列出项目 |
+| `GET` | `/api/projects/:id` | API Key | 项目详情 |
+| `PUT` | `/api/projects/:id` | API Key | 更新项目 |
+| `DELETE` | `/api/projects/:id` | API Key | 删除项目 |
+| `POST` | `/api/projects/:id/generate` | API Key | AI 组装 |
+| `GET` | `/api/insights` | API Key | 获取洞察 |
+| `POST` | `/api/insights/:id/dismiss` | API Key | 标记已读 |
+| `GET` | `/api/timeline` | API Key | 时间线 |
+| `GET` | `/api/profile` | API Key | 用户画像 |
+
+完整 API 文档见 [docs/API.md](docs/API.md)。
+
+## Web Demo
+
+`demo/` 目录包含两个纯 HTML/CSS/JS 界面，无需构建，浏览器直接打开。
+
+**聊天界面** (`demo/index.html`)：
+- 聊天气泡 UI + 流式打字效果
+- typing 状态指示
+- 图片上传预览
+- 会话管理（新建会话）
+- 聊天记录导出/导入（JSON 文件，纯客户端）
+
+**思维引擎界面** (`demo/think.html`)：
+- 三栏布局：时间线 / 对话 / 上下文（关联 + 洞察 + 画像）
+- 想法搜索（关键词模糊匹配）
+- 项目管理（创建 / 查看 / AI 生成草稿 / 删除）
+- 洞察面板（查看 / 忽略）
+- 用户画像统计
+- 移动端适配（底部 Tab 切换）
+
+## 聊天命令
+
+| 命令 | 说明 |
+|------|------|
+| `/new` | 重置当前会话 |
+| `/help` | 显示可用命令 |
+| `/sessions` | 列出活跃会话 |
+
+## 环境变量（可选）
 
 | 变量 | 说明 |
 |------|------|
-| `WHISPER_BIN` | Whisper 可执行文件路径，留空则从 PATH 查找 |
-| `EDGE_TTS_BIN` | edge-tts 可执行文件路径，留空则从 PATH 查找 |
+| `WHISPER_BIN` | Whisper 可执行文件路径 |
+| `EDGE_TTS_BIN` | edge-tts 可执行文件路径 |
 
-可复制 `.env.example` 为 `.env` 进行配置。
+## 架构
 
-## Development
+本插件实现 OpenClaw 渠道接口的四个适配器：
+
+1. **Config** — 读取并校验渠道配置，支持单账号和多账号模式
+2. **Gateway** — 启动 HTTP 服务，处理入站消息，转发至 OpenClaw 对话引擎
+3. **Outbound** — 将引擎回复通过 Webhook 推送到外部系统（带重试和签名）
+4. **Status** — 暴露 `/api/health`，报告运行时间、请求统计、会话数、连接数
+
+消息流：`客户端 → Gateway → OpenClaw Engine → Outbound → Webhook`
+
+## 开发
 
 ```bash
 git clone https://github.com/openclaw/openclaw-channel-xiaozhu.git
@@ -109,35 +435,65 @@ npm install
 npm run build
 ```
 
-### Project Structure
+### 项目结构
 
 ```
 openclaw-channel-xiaozhu/
 ├── src/
-│   ├── index.ts          # 插件入口
-│   ├── channel.ts        # Channel 插件对象（四个适配器）
-│   ├── server.ts         # HTTP 服务器（全功能）
-│   ├── types.ts          # 类型定义
+│   ├── index.ts              # 插件入口
+│   ├── channel.ts            # Channel 插件对象（四个适配器）
+│   ├── server.ts             # HTTP 服务器（全功能）
+│   ├── types.ts              # 类型定义
+│   ├── standalone/
+│   │   ├── cli.ts            # 独立服务端 CLI 入口
+│   │   ├── app.ts            # HTTP + WebSocket 服务器
+│   │   ├── router.ts         # 智能路由引擎
+│   │   ├── auth.ts           # API Key 鉴权（timing-safe）
+│   │   ├── store.ts          # JSON 文件持久化
+│   │   ├── types.ts          # 独立服务端类型
+│   │   ├── thought-types.ts  # 思维引擎类型定义
+│   │   ├── thought-store.ts  # 思维引擎 JSON 存储
+│   │   ├── thought-db.ts     # 思维引擎 SQLite 存储
+│   │   ├── thought-processor.ts # 后台 AI 处理管线
+│   │   └── migrate-to-sqlite.ts # JSON → SQLite 迁移
+│   ├── sdk/
+│   │   ├── index.ts          # XiaozhuClient 类
+│   │   ├── types.ts          # SDK 公开类型
+│   │   └── sse.ts            # SSE 解析器
+│   ├── relay/
+│   │   ├── client.ts         # 云端中继客户端（连接中继服务器）
+│   │   ├── server.ts         # 中继服务器（部署在公网 VPS）
+│   │   ├── protocol.ts       # 中继协议类型定义
+│   │   └── cli.ts            # 中继服务器 CLI 入口
+│   ├── shared/
+│   │   ├── security.ts       # timing-safe 比较 + SSRF 防护
+│   │   ├── http-utils.ts     # 请求体读取（统一实现）
+│   │   └── inbound.ts        # 入站 ctx 构建 + 媒体文本拼接
 │   └── utils/
-│       ├── rate-limiter.ts  # 滑动窗口速率限制器
-│       ├── ttl-set.ts       # TTL 集合（消息去重）
-│       └── coalescer.ts     # SSE 文本合并缓冲
-├── openclaw.plugin.json  # 插件声明
+│       ├── rate-limiter.ts   # 滑动窗口速率限制器
+│       ├── ttl-set.ts        # TTL 集合（消息去重）
+│       ├── coalescer.ts      # SSE 文本合并缓冲
+│       ├── session-store.ts  # 会话追踪
+│       ├── text-chunker.ts   # 围栏感知文本分块
+│       └── webhook-sender.ts # Webhook 重试 + HMAC 签名
+├── demo/
+│   ├── index.html            # Web Demo 聊天界面
+│   ├── style.css             # 聊天界面样式
+│   ├── app.js                # 聊天界面逻辑
+│   ├── think.html            # 思维引擎 Demo
+│   ├── think.css             # 思维引擎样式
+│   └── think.js              # 思维引擎逻辑
+├── skills/
+│   ├── xiaozhu-send-media/   # 媒体发送 skill
+│   ├── xiaozhu-cron-job/     # 定时提醒 skill
+│   └── openclaw-browser-quality/ # 浏览器质量 skill
+├── docs/
+│   └── API.md                # 完整 API 文档
+├── openclaw.plugin.json      # 插件声明
 ├── tsconfig.json
 └── package.json
 ```
 
-## Architecture
-
-本插件实现 OpenClaw 渠道接口的四个适配器：
-
-1. **Config** — 读取并校验渠道配置，合并默认值
-2. **Gateway** — 启动 HTTP 服务，处理入站消息，转发至 OpenClaw 对话引擎
-3. **Outbound** — 将引擎回复通过 Webhook 推送到外部系统
-4. **Status** — 暴露 `/api/health`，报告运行时间、请求统计、限流状态
-
-消息流：`客户端 → Gateway → OpenClaw Engine → Outbound → Webhook`
-
 ## License
 
 [MIT](LICENSE)