@gguf/claw 2026.2.4 → 2026.2.5

package/docs/zh-CN/channels/feishu.md

@@ -109,17 +109,23 @@ Lark（国际版）请使用 https://open.larksuite.com/app，并在配置中设
       "application:application.app_message_stats.overview:readonly",
       "application:application:self_manage",
       "application:bot.menu:write",
+      "cardkit:card:write",
       "contact:user.employee_id:readonly",
       "corehr:file:download",
+      "docs:document.content:read",
       "event:ip_list",
+      "im:chat",
       "im:chat.access_event.bot_p2p_chat:read",
       "im:chat.members:bot_access",
       "im:message",
       "im:message.group_at_msg:readonly",
+      "im:message.group_msg",
       "im:message.p2p_msg:readonly",
       "im:message:readonly",
       "im:message:send_as_bot",
-      "im:resource"
+      "im:resource",
+      "sheets:spreadsheet",
+      "wiki:wiki:readonly"
     ],
     "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
   }
@@ -453,7 +459,116 @@ openclaw pairing list feishu
 
 ### 流式输出
 
-飞书目前不支持消息编辑，因此默认禁用流式输出（`blockStreaming: true`）。机器人会等待完整回复后一次性发送。
+飞书支持通过交互式卡片实现流式输出，机器人会实时更新卡片内容显示生成进度。默认配置：
+
+```json5
+{
+  channels: {
+    feishu: {
+      streaming: true, // 启用流式卡片输出（默认 true）
+      blockStreaming: true, // 启用块级流式（默认 true）
+    },
+  },
+}
+```
+
+如需禁用流式输出（等待完整回复后一次性发送），可设置 `streaming: false`。
+
+### 消息引用
+
+在群聊中，机器人的回复可以引用用户发送的原始消息，让对话上下文更加清晰。
+
+配置选项：
+
+```json5
+{
+  channels: {
+    feishu: {
+      // 账户级别配置（默认 "all"）
+      replyToMode: "all",
+      groups: {
+        oc_xxx: {
+          // 特定群组可以覆盖
+          replyToMode: "first",
+        },
+      },
+    },
+  },
+}
+```
+
+`replyToMode` 值说明：
+
+| 值        | 行为                               |
+| --------- | ---------------------------------- |
+| `"off"`   | 不引用原消息（私聊默认值）         |
+| `"first"` | 仅在第一条回复时引用原消息         |
+| `"all"`   | 所有回复都引用原消息（群聊默认值） |
+
+> 注意：消息引用功能与流式卡片输出（`streaming: true`）不能同时使用。当启用流式输出时，回复会以卡片形式呈现，不会显示引用。
+
+### 多 Agent 路由
+
+通过 `bindings` 配置，您可以用一个飞书机器人对接多个不同功能或性格的 Agent。系统会根据用户 ID 或群组 ID 自动将对话分发到对应的 Agent。
+
+配置示例：
+
+```json5
+{
+  agents: {
+    list: [
+      { id: "main" },
+      {
+        id: "clawd-fan",
+        workspace: "/home/user/clawd-fan",
+        agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",
+      },
+      {
+        id: "clawd-xi",
+        workspace: "/home/user/clawd-xi",
+        agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",
+      },
+    ],
+  },
+  bindings: [
+    {
+      // 用户 A 的私聊 → main agent
+      agentId: "main",
+      match: {
+        channel: "feishu",
+        peer: { kind: "dm", id: "ou_28b31a88..." },
+      },
+    },
+    {
+      // 用户 B 的私聊 → clawd-fan agent
+      agentId: "clawd-fan",
+      match: {
+        channel: "feishu",
+        peer: { kind: "dm", id: "ou_0fe6b1c9..." },
+      },
+    },
+    {
+      // 某个群组 → clawd-xi agent
+      agentId: "clawd-xi",
+      match: {
+        channel: "feishu",
+        peer: { kind: "group", id: "oc_xxx..." },
+      },
+    },
+  ],
+}
+```
+
+匹配规则说明：
+
+| 字段              | 说明                                          |
+| ----------------- | --------------------------------------------- |
+| `agentId`         | 目标 Agent 的 ID，需要在 `agents.list` 中定义 |
+| `match.channel`   | 渠道类型，这里固定为 `"feishu"`               |
+| `match.peer.kind` | 对话类型：`"dm"`（私聊）或 `"group"`（群组）  |
+| `match.peer.id`   | 用户 Open ID（`ou_xxx`）或群组 ID（`oc_xxx`） |
+
+> 获取 ID 的方法：参见上文 [获取群组/用户 ID](#获取群组用户-id) 章节。
 
 ---
 
@@ -478,7 +593,8 @@ openclaw pairing list feishu
 | `channels.feishu.groups.<chat_id>.enabled`        | 是否启用该群组                 | `true`    |
 | `channels.feishu.textChunkLimit`                  | 消息分块大小                   | `2000`    |
 | `channels.feishu.mediaMaxMb`                      | 媒体大小限制                   | `30`      |
-| `channels.feishu.blockStreaming`                  | 禁用流式输出                   | `true`    |
+| `channels.feishu.streaming`                       | 启用流式卡片输出               | `true`    |
+| `channels.feishu.blockStreaming`                  | 启用块级流式                   | `true`    |
 
 ---
 

package/docs/zh-CN/concepts/features.md

@@ -0,0 +1,59 @@
+---
+read_when:
+  - 你想了解 OpenClaw 支持的完整功能列表
+summary: OpenClaw 在渠道、路由、媒体和用户体验方面的功能。
+title: 功能
+x-i18n:
+  generated_at: "2026-02-04T17:53:22Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 1b6aee0bfda751824cb6b3a99080b4c80c00ffb355a96f9cff1b596d55d15ed4
+  source_path: concepts/features.md
+  workflow: 15
+---
+
+## 亮点
+
+<Columns>
+  <Card title="渠道" icon="message-square">
+    通过单个 Gateway 网关支持 WhatsApp、Telegram、Discord 和 iMessage。
+  </Card>
+  <Card title="插件" icon="plug">
+    通过扩展添加 Mattermost 等更多平台。
+  </Card>
+  <Card title="路由" icon="route">
+    多智能体路由，支持隔离会话。
+  </Card>
+  <Card title="媒体" icon="image">
+    支持图片、音频和文档的收发。
+  </Card>
+  <Card title="应用与界面" icon="monitor">
+    Web 控制界面和 macOS 配套应用。
+  </Card>
+  <Card title="移动节点" icon="smartphone">
+    iOS 和 Android 节点，支持 Canvas。
+  </Card>
+</Columns>
+
+## 完整列表
+
+- 通过 WhatsApp Web（Baileys）集成 WhatsApp
+- Telegram 机器人支持（grammY）
+- Discord 机器人支持（channels.discord.js）
+- Mattermost 机器人支持（插件）
+- 通过本地 imsg CLI 集成 iMessage（macOS）
+- Pi 的智能体桥接，支持 RPC 模式和工具流式传输
+- 长响应的流式传输和分块处理
+- 多智能体路由，按工作区或发送者隔离会话
+- 通过 OAuth 进行 Anthropic 和 OpenAI 的订阅认证
+- 会话：私信合并为共享的 `main`；群组相互隔离
+- 群聊支持，通过提及激活
+- 图片、音频和文档的媒体支持
+- 可选的语音消息转录钩子
+- WebChat 和 macOS 菜单栏应用
+- iOS 节点，支持配对和 Canvas 界面
+- Android 节点，支持配对、Canvas、聊天和相机
+
+<Note>
+旧版 Claude、Codex、Gemini 和 Opencode 路径已被移除。Pi 是唯一的编程智能体路径。
+</Note>

package/docs/zh-CN/gateway/network-model.md

@@ -0,0 +1,23 @@
+---
+read_when:
+  - 你想要简要了解 Gateway 网关的网络模型
+summary: Gateway 网关、节点和 canvas 主机如何连接。
+title: 网络模型
+x-i18n:
+  generated_at: "2026-02-04T17:53:21Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: e3508b884757ef19f425c82e891e2b07e7fd7d985413d569e55ae9b175c91f0f
+  source_path: gateway/network-model.md
+  workflow: 15
+---
+
+大多数操作通过 Gateway 网关（`openclaw gateway`）进行，它是一个长期运行的单一进程，负责管理渠道连接和 WebSocket 控制平面。
+
+## 核心规则
+
+- 建议每台主机运行一个 Gateway 网关。它是唯一允许拥有 WhatsApp Web 会话的进程。对于救援机器人或严格隔离的场景，可以使用隔离的配置文件和端口运行多个 Gateway 网关。参见[多 Gateway 网关](/gateway/multiple-gateways)。
+- 优先使用回环地址：Gateway 网关的 WS 默认为 `ws://127.0.0.1:18789`。即使是回环连接，向导也会默认生成 gateway token。若需通过 tailnet 访问，请运行 `openclaw gateway --bind tailnet --token ...`，因为非回环绑定必须使用 token。
+- 节点根据需要通过局域网、tailnet 或 SSH 连接到 Gateway 网关的 WS。旧版 TCP 桥接已弃用。
+- Canvas 主机是一个 HTTP 文件服务器，运行在 `canvasHost.port`（默认 `18793`）上，提供 `/__openclaw__/canvas/` 路径供节点 WebView 使用。参见 [Gateway 网关配置](/gateway/configuration)（`canvasHost`）。
+- 远程使用通常通过 SSH 隧道或 Tailscale VPN。参见[远程访问](/gateway/remote)和[设备发现](/gateway/discovery)。

package/docs/zh-CN/gateway/remote.md

@@ -35,7 +35,7 @@ x-i18n:
 
 - **最佳用户体验：** 保持 `gateway.bind: "loopback"` 并使用 **Tailscale Serve** 作为控制 UI。
 - **回退方案：** 保持 loopback + 从任何需要访问的机器建立 SSH 隧道。
-- **示例：** [exe.dev](/platforms/exe-dev)（简易 VM）或 [Hetzner](/platforms/hetzner)（生产 VPS）。
+- **示例：** [exe.dev](/install/exe-dev)（简易 VM）或 [Hetzner](/install/hetzner)（生产 VPS）。
 
 当你的笔记本电脑经常休眠但你希望智能体始终在线时，这是理想的选择。
 

package/docs/zh-CN/help/faq.md

@@ -572,7 +572,7 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
 
 任何 Linux VPS 都可以。在服务器上安装，然后使用 SSH/Tailscale 访问 Gateway 网关。
 
-指南：[exe.dev](/platforms/exe-dev)、[Hetzner](/platforms/hetzner)、[Fly.io](/platforms/fly)。
+指南：[exe.dev](/install/exe-dev)、[Hetzner](/install/hetzner)、[Fly.io](/install/fly)。
 远程访问：[Gateway 网关远程](/gateway/remote)。
 
 ### 云/VPS 安装指南在哪里
@@ -580,9 +580,9 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
 我们维护了一个**托管中心**，涵盖常见提供商。选择一个并按指南操作：
 
 - [VPS 托管](/vps)（所有提供商汇总）
-- [Fly.io](/platforms/fly)
-- [Hetzner](/platforms/hetzner)
-- [exe.dev](/platforms/exe-dev)
+- [Fly.io](/install/fly)
+- [Hetzner](/install/hetzner)
+- [exe.dev](/install/exe-dev)
 
 在云端的工作方式：**Gateway 网关运行在服务器上**，你通过控制 UI（或 Tailscale/SSH）从笔记本/手机访问。你的状态 + 工作区位于服务器上，因此将主机视为数据来源并做好备份。
 
@@ -863,7 +863,7 @@ OpenClaw 是轻量级的。对于基本的 Gateway 网关 + 一个聊天渠道
 - **操作系统：** Ubuntu LTS 或其他现代 Debian/Ubuntu。
 
 如果你使用 Windows，**WSL2 是最简单的虚拟机式设置**，具有最佳的工具兼容性。参阅 [Windows](/platforms/windows)、[VPS 托管](/vps)。
-如果你在虚拟机中运行 macOS，参阅 [macOS VM](/platforms/macos-vm)。
+如果你在虚拟机中运行 macOS，参阅 [macOS VM](/install/macos-vm)。
 
 ## 什么是 OpenClaw？
 

package/docs/zh-CN/index.md

@@ -1,21 +1,19 @@
 ---
 read_when:
   - 向新用户介绍 OpenClaw
-summary: OpenClaw 的顶层概述、功能和用途
+summary: OpenClaw 是一个多渠道 AI 智能体 Gateway 网关，可在任何操作系统上运行。
 title: OpenClaw
 x-i18n:
-  generated_at: "2026-02-03T10:07:04Z"
+  generated_at: "2026-02-04T17:53:40Z"
   model: claude-opus-4-5
   provider: pi
-  source_hash: 1e0923d87f184a7d8b16afa0d0d0214ce27aec0c3e6ffb359e6226f8e5f1a152
+  source_hash: fc8babf7885ef91d526795051376d928599c4cf8aff75400138a0d7d9fa3b75f
   source_path: index.md
   workflow: 15
 ---
 
 # OpenClaw 🦞
 
-> _"EXFOLIATE! EXFOLIATE!"_ — 大概是一只太空龙虾说的
-
 <p align="center">
     <img
         src="/assets/openclaw-logo-text-dark.png"
@@ -31,149 +29,104 @@ x-i18n:
     />
 </p>
 
-<p align="center">
-  <strong>适用于任何操作系统的 WhatsApp/Telegram/Discord/iMessage AI 智能体（Pi）Gateway 网关。</strong><br />
-  插件可添加 Mattermost 等更多渠道。
-  发送消息，获取智能体响应——尽在口袋中。
-</p>
+> _"去壳！去壳！"_ — 大概是一只太空龙虾说的
 
 <p align="center">
-  <a href="https://github.com/openclaw/openclaw">GitHub</a> ·
-  <a href="https://github.com/openclaw/openclaw/releases">发布版本</a> ·
-  <a href="/">文档</a> ·
-  <a href="/start/openclaw">OpenClaw 助手设置</a>
+  <strong>适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。</strong><br />
+  发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。
 </p>
 
-OpenClaw 将 WhatsApp（通过 WhatsApp Web / Baileys）、Telegram（Bot API / grammY）、Discord（Bot API / channels.discord.js）和 iMessage（imsg CLI）桥接到像 [Pi](https://github.com/badlogic/pi-mono) 这样的编程智能体。插件可添加 Mattermost（Bot API + WebSocket）等更多渠道。
-OpenClaw 也为 OpenClaw 助手提供支持。
-
-## 从这里开始
-
-- **从零开始新安装：** [入门指南](/start/getting-started)
-- **引导式设置（推荐）：** [向导](/start/wizard)（`openclaw onboard`）
-- **打开仪表板（本地 Gateway 网关）：** http://127.0.0.1:18789/（或 http://localhost:18789/）
-
-如果 Gateway 网关运行在同一台计算机上，该链接会立即打开浏览器控制 UI。
-如果失败，请先启动 Gateway 网关：`openclaw gateway`。
+<Columns>
+  <Card title="入门指南" href="/start/getting-started" icon="rocket">
+    安装 OpenClaw 并在几分钟内启动 Gateway 网关。
+  </Card>
+  <Card title="运行向导" href="/start/wizard" icon="sparkles">
+    通过 `openclaw onboard` 和配对流程进行引导式设置。
+  </Card>
+  <Card title="打开控制界面" href="/web/control-ui" icon="layout-dashboard">
+    启动浏览器仪表板，管理聊天、配置和会话。
+  </Card>
+</Columns>
 
-## 仪表板（浏览器控制 UI）
-
-仪表板是用于聊天、配置、节点、会话等的浏览器控制 UI。
-本地默认：http://127.0.0.1:18789/
-远程访问：[Web 界面](/web) 和 [Tailscale](/gateway/tailscale)
-
-<p align="center">
-  <img src="whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />
-</p>
+OpenClaw 通过单个 Gateway 网关进程将聊天应用连接到 Pi 等编程智能体。它为 OpenClaw 助手提供支持，并支持本地或远程部署。
 
 ## 工作原理
 
-```
-WhatsApp / Telegram / Discord / iMessage（+ 插件）
-        │
-        ▼
-  ┌───────────────────────────┐
-  │       Gateway 网关        │  ws://127.0.0.1:18789（仅 loopback）
-  │      （单一来源）          │
-  │                           │  http://<gateway-host>:18793
-  │                           │    /__openclaw__/canvas/（Canvas 主机）
-  └───────────┬───────────────┘
-              │
-              ├─ Pi 智能体（RPC）
-              ├─ CLI（openclaw …）
-              ├─ 聊天 UI（SwiftUI）
-              ├─ macOS 应用（OpenClaw.app）
-              ├─ iOS 节点，通过 Gateway WS + 配对
-              └─ Android 节点，通过 Gateway WS + 配对
+```mermaid
+flowchart LR
+  A["Chat apps + plugins"] --> B["Gateway"]
+  B --> C["Pi agent"]
+  B --> D["CLI"]
+  B --> E["Web Control UI"]
+  B --> F["macOS app"]
+  B --> G["iOS and Android nodes"]
 ```
 
-大多数操作通过 **Gateway 网关**（`openclaw gateway`）进行，这是一个长期运行的单一进程，拥有渠道连接和 WebSocket 控制平面。
-
-## 网络模型
-
-- **每台主机一个 Gateway 网关（推荐）**：它是唯一允许拥有 WhatsApp Web 会话的进程。如果你需要救援机器人或严格隔离，请使用隔离的配置文件和端口运行多个 Gateway 网关；参见[多 Gateway 网关](/gateway/multiple-gateways)。
-- **loopback 优先**：Gateway 网关 WS 默认为 `ws://127.0.0.1:18789`。
-  - 向导现在默认生成 Gateway 网关令牌（即使是 loopback）。
-  - 对于 Tailnet 访问，运行 `openclaw gateway --bind tailnet --token ...`（非 loopback 绑定需要令牌）。
-- **节点**：连接到 Gateway 网关 WebSocket（根据需要通过 LAN/tailnet/SSH）；旧版 TCP 桥接已弃用/移除。
-- **Canvas 主机**：在 `canvasHost.port`（默认 `18793`）上的 HTTP 文件服务器，为节点 WebView 提供 `/__openclaw__/canvas/`；参见 [Gateway 网关配置](/gateway/configuration)（`canvasHost`）。
-- **远程使用**：SSH 隧道或 tailnet/VPN；参见[远程访问](/gateway/remote)和[设备发现](/gateway/discovery)。
-
-## 功能（高级概述）
-
-- 📱 **WhatsApp 集成** — 使用 Baileys 实现 WhatsApp Web 协议
-- ✈️ **Telegram 机器人** — 通过 grammY 支持私信 + 群组
-- 🎮 **Discord 机器人** — 通过 channels.discord.js 支持私信 + 服务器频道
-- 🧩 **Mattermost 机器人（插件）** — 机器人令牌 + WebSocket 事件
-- 💬 **iMessage** — 本地 imsg CLI 集成（macOS）
-- 🤖 **智能体桥接** — Pi（RPC 模式）支持工具流式传输
-- ⏱️ **流式传输 + 分块** — 分块流式传输 + Telegram 草稿流式传输详情（[/concepts/streaming](/concepts/streaming)）
-- 🧠 **多智能体路由** — 将提供商账户/对等方路由到隔离的智能体（工作区 + 每智能体会话）
-- 🔐 **订阅认证** — 通过 OAuth 支持 Anthropic（Claude Pro/Max）+ OpenAI（ChatGPT/Codex）
-- 💬 **会话** — 私聊折叠到共享的 `main`（默认）；群组是隔离的
-- 👥 **群聊支持** — 默认基于提及；所有者可切换 `/activation always|mention`
-- 📎 **媒体支持** — 发送和接收图片、音频、文档
-- 🎤 **语音消息** — 可选的转录钩子
-- 🖥️ **WebChat + macOS 应用** — 本地 UI + 用于操作和语音唤醒的菜单栏配套应用
-- 📱 **iOS 节点** — 作为节点配对并暴露 Canvas 界面
-- 📱 **Android 节点** — 作为节点配对并暴露 Canvas + 聊天 + 相机
-
-注意：旧版 Claude/Codex/Gemini/Opencode 路径已移除；Pi 是唯一的编程智能体路径。
+Gateway 网关是会话、路由和渠道连接的唯一事实来源。
+
+## 核心功能
+
+<Columns>
+  <Card title="多渠道 Gateway 网关" icon="network">
+    通过单个 Gateway 网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。
+  </Card>
+  <Card title="插件渠道" icon="plug">
+    通过扩展包添加 Mattermost 等更多渠道。
+  </Card>
+  <Card title="多智能体路由" icon="route">
+    按智能体、工作区或发送者隔离会话。
+  </Card>
+  <Card title="媒体支持" icon="image">
+    发送和接收图片、音频和文档。
+  </Card>
+  <Card title="Web 控制界面" icon="monitor">
+    浏览器仪表板，用于聊天、配置、会话和节点管理。
+  </Card>
+  <Card title="移动节点" icon="smartphone">
+    配对 iOS 和 Android 节点，支持 Canvas。
+  </Card>
+</Columns>
 
 ## 快速开始
 
-运行时要求：**Node ≥ 22**。
-
-```bash
-# 推荐：全局安装（npm/pnpm）
-npm install -g openclaw@latest
-# 或：pnpm add -g openclaw@latest
-
-# 新手引导 + 安装服务（launchd/systemd 用户服务）
-openclaw onboard --install-daemon
+<Steps>
+  <Step title="安装 OpenClaw">
+    ```bash
+    npm install -g openclaw@latest
+    ```
+  </Step>
+  <Step title="新手引导并安装服务">
+    ```bash
+    openclaw onboard --install-daemon
+    ```
+  </Step>
+  <Step title="配对 WhatsApp 并启动 Gateway 网关">
+    ```bash
+    openclaw channels login
+    openclaw gateway --port 18789
+    ```
+  </Step>
+</Steps>
+
+需要完整的安装和开发环境设置？请参阅[快速开始](/start/quickstart)。
+
+## 仪表板
+
+Gateway 网关启动后，打开浏览器控制界面。
+
+- 本地默认地址：http://127.0.0.1:18789/
+- 远程访问：[Web 界面](/web)和 [Tailscale](/gateway/tailscale)
 
-# 配对 WhatsApp Web（显示二维码）
-openclaw channels login
-
-# 新手引导后 Gateway 网关通过服务运行；手动运行仍然可行：
-openclaw gateway --port 18789
-```
-
-之后在 npm 和 git 安装之间切换很简单：安装另一种方式并运行 `openclaw doctor` 来更新 Gateway 网关服务入口点。
-
-从源代码（开发）：
-
-```bash
-git clone https://github.com/openclaw/openclaw.git
-cd openclaw
-pnpm install
-pnpm ui:build # 首次运行时自动安装 UI 依赖
-pnpm build
-openclaw onboard --install-daemon
-```
-
-如果你还没有全局安装，请从仓库通过 `pnpm openclaw ...` 运行新手引导步骤。
-
-多实例快速开始（可选）：
-
-```bash
-OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
-OPENCLAW_STATE_DIR=~/.openclaw-a \
-openclaw gateway --port 19001
-```
-
-发送测试消息（需要运行中的 Gateway 网关）：
-
-```bash
-openclaw message send --target +15555550123 --message "Hello from OpenClaw"
-```
+<p align="center">
+  <img src="whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />
+</p>
 
 ## 配置（可选）
 
-配置位于 `~/.openclaw/openclaw.json`。
+配置文件位于 `~/.openclaw/openclaw.json`。
 
-- 如果你**什么都不做**，OpenClaw 会使用内置的 Pi 二进制文件以 RPC 模式运行，按发送者分会话。
-- 如果你想锁定它，从 `channels.whatsapp.allowFrom` 开始，以及（对于群组）提及规则。
+- 如果你**不做任何修改**，OpenClaw 将使用内置的 Pi 二进制文件以 RPC 模式运行，并按发送者创建独立会话。
+- 如果你想要限制访问，可以从 `channels.whatsapp.allowFrom` 和（针对群组的）提及规则开始配置。
 
 示例：
 
@@ -189,76 +142,45 @@ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
 }
 ```
 
-## 文档
-
-- 从这里开始：
-  - [文档中心（所有页面链接）](/start/hubs)
-  - [帮助](/help) ← _常见修复 + 故障排除_
-  - [配置](/gateway/configuration)
-  - [配置示例](/gateway/configuration-examples)
-  - [斜杠命令](/tools/slash-commands)
-  - [多智能体路由](/concepts/multi-agent)
-  - [更新/回滚](/install/updating)
-  - [配对（私信 + 节点）](/start/pairing)
-  - [Nix 模式](/install/nix)
-  - [OpenClaw 助手设置](/start/openclaw)
-  - [Skills](/tools/skills)
-  - [Skills 配置](/tools/skills-config)
-  - [工作区模板](/reference/templates/AGENTS)
-  - [RPC 适配器](/reference/rpc)
-  - [Gateway 网关运维手册](/gateway)
-  - [节点（iOS/Android）](/nodes)
-  - [Web 界面（控制 UI）](/web)
-  - [设备发现 + 传输协议](/gateway/discovery)
-  - [远程访问](/gateway/remote)
-- 提供商和用户体验：
-  - [WebChat](/web/webchat)
-  - [控制 UI（浏览器）](/web/control-ui)
-  - [Telegram](/channels/telegram)
-  - [Discord](/channels/discord)
-  - [Mattermost（插件）](/channels/mattermost)
-  - [iMessage](/channels/imessage)
-  - [群组](/concepts/groups)
-  - [WhatsApp 群组消息](/concepts/group-messages)
-  - [媒体：图片](/nodes/images)
-  - [媒体：音频](/nodes/audio)
-- 配套应用：
-  - [macOS 应用](/platforms/macos)
-  - [iOS 应用](/platforms/ios)
-  - [Android 应用](/platforms/android)
-  - [Windows（WSL2）](/platforms/windows)
-  - [Linux 应用](/platforms/linux)
-- 运维和安全：
-  - [会话](/concepts/session)
-  - [定时任务](/automation/cron-jobs)
-  - [Webhooks](/automation/webhook)
-  - [Gmail 钩子（Pub/Sub）](/automation/gmail-pubsub)
-  - [安全性](/gateway/security)
-  - [故障排除](/gateway/troubleshooting)
-
-## 名称由来
-
-**OpenClaw = CLAW + TARDIS** — 因为每只太空龙虾都需要一台时空机器。
-
----
-
-_"我们都只是在玩弄自己的提示词。"_ — 一个 AI，可能正处于 token 兴奋状态
-
-## 致谢
-
-- **Peter Steinberger**（[@steipete](https://x.com/steipete)）— 创建者，龙虾低语者
-- **Mario Zechner**（[@badlogicc](https://x.com/badlogicgames)）— Pi 创建者，安全渗透测试员
-- **Clawd** — 那只要求更好名字的太空龙虾
-
-## 核心贡献者
-
-- **Maxim Vovshin**（@Hyaxia, 36747317+Hyaxia@users.noreply.github.com）— Blogwatcher skill
-- **Nacho Iacovino**（@nachoiacovino, nacho.iacovino@gmail.com）— 位置解析（Telegram + WhatsApp）
-
-## 许可证
-
-MIT — 像海洋中的龙虾一样自由 🦞
-
----
+## 从这里开始
 
-_"我们都只是在玩弄自己的提示词。"_ — 一个 AI，可能正处于 token 兴奋状态
+<Columns>
+  <Card title="文档中心" href="/start/hubs" icon="book-open">
+    所有文档和指南，按用例分类。
+  </Card>
+  <Card title="配置" href="/gateway/configuration" icon="settings">
+    核心 Gateway 网关设置、令牌和提供商配置。
+  </Card>
+  <Card title="远程访问" href="/gateway/remote" icon="globe">
+    SSH 和 tailnet 访问模式。
+  </Card>
+  <Card title="渠道" href="/channels/telegram" icon="message-square">
+    WhatsApp、Telegram、Discord 等渠道的具体设置。
+  </Card>
+  <Card title="节点" href="/nodes" icon="smartphone">
+    iOS 和 Android 节点的配对与 Canvas 功能。
+  </Card>
+  <Card title="帮助" href="/help" icon="life-buoy">
+    常见修复方法和故障排除入口。
+  </Card>
+</Columns>
+
+## 了解更多
+
+<Columns>
+  <Card title="完整功能列表" href="/concepts/features" icon="list">
+    全部渠道、路由和媒体功能。
+  </Card>
+  <Card title="多智能体路由" href="/concepts/multi-agent" icon="route">
+    工作区隔离和按智能体的会话管理。
+  </Card>
+  <Card title="安全" href="/gateway/security" icon="shield">
+    令牌、白名单和安全控制。
+  </Card>
+  <Card title="故障排除" href="/gateway/troubleshooting" icon="wrench">
+    Gateway 网关诊断和常见错误。
+  </Card>
+  <Card title="关于与致谢" href="/reference/credits" icon="info">
+    项目起源、贡献者和许可证。
+  </Card>
+</Columns>

package/docs/zh-CN/install/docker.md

@@ -70,7 +70,7 @@ Docker 是**可选的**。仅当你想要容器化的 Gateway 网关或验证 Do
 - `~/.openclaw/`
 - `~/.openclaw/workspace`
 
-在 VPS 上运行？参阅 [Hetzner（Docker VPS）](/platforms/hetzner)。
+在 VPS 上运行？参阅 [Hetzner（Docker VPS）](/install/hetzner)。
 
 ### 手动流程（compose）