@gguf/claw 2026.2.1 → 2026.2.2

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

@@ -0,0 +1,147 @@
+---
+read_when:
+  - 为 OpenClaw 设置 Zalo Personal
+  - 调试 Zalo Personal 登录或消息流
+summary: 通过 zca-cli（二维码登录）支持 Zalo 个人账号，功能与配置说明
+title: Zalo Personal
+x-i18n:
+  generated_at: "2026-02-01T19:58:27Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2a249728d556e5cc52274627bdaf390fa10e815afa04f4497feb57a2a0cb9261
+  source_path: channels/zalouser.md
+  workflow: 14
+---
+
+# Zalo Personal（非官方）
+
+状态：实验性。此集成通过 `zca-cli` 自动化操作一个**个人 Zalo 账号**。
+
+> **警告：** 这是一个非官方集成，可能导致账号被暂停或封禁。使用风险自负。
+
+## 需要安装插件
+
+Zalo Personal 以插件形式提供，不包含在核心安装包中。
+
+- 通过 CLI 安装：`openclaw plugins install @openclaw/zalouser`
+- 或从源码检出安装：`openclaw plugins install ./extensions/zalouser`
+- 详情：[插件](/plugin)
+
+## 前置条件：zca-cli
+
+Gateway网关所在机器必须在 `PATH` 中包含 `zca` 可执行文件。
+
+- 验证：`zca --version`
+- 如果缺失，请安装 zca-cli（参见 `extensions/zalouser/README.md` 或上游 zca-cli 文档）。
+
+## 快速设置（入门）
+
+1. 安装插件（见上文）。
+2. 登录（二维码方式，在 Gateway网关机器上操作）：
+   - `openclaw channels login --channel zalouser`
+   - 使用 Zalo 手机应用扫描终端中的二维码。
+3. 启用渠道：
+
+```json5
+{
+  channels: {
+    zalouser: {
+      enabled: true,
+      dmPolicy: "pairing",
+    },
+  },
+}
+```
+
+4. 重启 Gateway网关（或完成新手引导）。
+5. 私信访问默认为配对模式；首次联系时需批准配对码。
+
+## 功能说明
+
+- 使用 `zca listen` 接收入站消息。
+- 使用 `zca msg ...` 发送回复（文本/媒体/链接）。
+- 专为 Zalo Bot API 不可用时的"个人账号"使用场景设计。
+
+## 命名说明
+
+渠道 ID 为 `zalouser`，以明确表示这是对**个人 Zalo 用户账号**的自动化操作（非官方）。我们将 `zalo` 保留给未来可能的官方 Zalo API 集成。
+
+## 查找 ID（通讯录）
+
+使用通讯录 CLI 发现联系人/群组及其 ID：
+
+```bash
+openclaw directory self --channel zalouser
+openclaw directory peers list --channel zalouser --query "name"
+openclaw directory groups list --channel zalouser --query "work"
+```
+
+## 限制
+
+- 出站文本按约 2000 字符分块（Zalo 客户端限制）。
+- 流式传输默认被禁用。
+
+## 访问控制（私信）
+
+`channels.zalouser.dmPolicy` 支持：`pairing | allowlist | open | disabled`（默认：`pairing`）。
+`channels.zalouser.allowFrom` 接受用户 ID 或名称。向导在可用时通过 `zca friend find` 将名称解析为 ID。
+
+通过以下方式批准：
+
+- `openclaw pairing list zalouser`
+- `openclaw pairing approve zalouser <code>`
+
+## 群组访问（可选）
+
+- 默认：`channels.zalouser.groupPolicy = "open"`（允许群组）。未设置时使用 `channels.defaults.groupPolicy` 覆盖默认值。
+- 通过允许列表进行限制：
+  - `channels.zalouser.groupPolicy = "allowlist"`
+  - `channels.zalouser.groups`（键为群组 ID 或名称）
+- 禁止所有群组：`channels.zalouser.groupPolicy = "disabled"`。
+- 配置向导可以提示设置群组允许列表。
+- 启动时，OpenClaw 会将允许列表中的群组/用户名称解析为 ID 并记录映射关系；未解析的条目保持原样。
+
+示例：
+
+```json5
+{
+  channels: {
+    zalouser: {
+      groupPolicy: "allowlist",
+      groups: {
+        "123456789": { allow: true },
+        "Work Chat": { allow: true },
+      },
+    },
+  },
+}
+```
+
+## 多账号
+
+账号映射到 zca 配置文件。示例：
+
+```json5
+{
+  channels: {
+    zalouser: {
+      enabled: true,
+      defaultAccount: "default",
+      accounts: {
+        work: { enabled: true, profile: "work" },
+      },
+    },
+  },
+}
+```
+
+## 故障排除
+
+**找不到 `zca`：**
+
+- 安装 zca-cli 并确保 Gateway网关进程的 `PATH` 中包含该命令。
+
+**登录状态无法保持：**
+
+- `openclaw channels status --probe`
+- 重新登录：`openclaw channels logout --channel zalouser && openclaw channels login --channel zalouser`

package/docs/zh-CN/cli/acp.md

@@ -0,0 +1,173 @@
+---
+read_when:
+  - 设置基于 ACP 的 IDE 集成
+  - 调试 ACP 会话到 Gateway网关的路由
+summary: 运行用于 IDE 集成的 ACP 桥接
+title: acp
+x-i18n:
+  generated_at: "2026-02-01T19:58:33Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 0c09844297da250bc1a558423e7e534d6b6be9045de12d797c07ecd64a0c63ed
+  source_path: cli/acp.md
+  workflow: 14
+---
+
+# acp
+
+运行与 OpenClaw Gateway网关通信的 ACP（Agent Client Protocol）桥接。
+
+此命令通过 stdio 使用 ACP 协议与 IDE 通信，并通过 WebSocket 将提示转发到 Gateway网关。它将 ACP 会话映射到 Gateway网关会话密钥。
+
+## 用法
+
+```bash
+openclaw acp
+
+# 远程 Gateway网关
+openclaw acp --url wss://gateway-host:18789 --token <token>
+
+# 附加到现有会话密钥
+openclaw acp --session agent:main:main
+
+# 通过标签附加（必须已存在）
+openclaw acp --session-label "support inbox"
+
+# 在第一个提示之前重置会话密钥
+openclaw acp --session agent:main:main --reset-session
+```
+
+## ACP 客户端（调试）
+
+使用内置 ACP 客户端在无需 IDE 的情况下对桥接进行安装完整性检查。
+它会启动 ACP 桥接并允许你交互式地输入提示。
+
+```bash
+openclaw acp client
+
+# 将启动的桥接指向远程 Gateway网关
+openclaw acp client --server-args --url wss://gateway-host:18789 --token <token>
+
+# 覆盖服务器命令（默认：openclaw）
+openclaw acp client --server "node" --server-args openclaw.mjs acp --url ws://127.0.0.1:19001
+```
+
+## 如何使用
+
+当 IDE（或其他客户端）使用 Agent Client Protocol 并且你希望它驱动 OpenClaw Gateway网关会话时，请使用 ACP。
+
+1. 确保 Gateway网关正在运行（本地或远程）。
+2. 配置 Gateway网关目标（通过配置文件或标志）。
+3. 将你的 IDE 配置为通过 stdio 运行 `openclaw acp`。
+
+示例配置（持久化）：
+
+```bash
+openclaw config set gateway.remote.url wss://gateway-host:18789
+openclaw config set gateway.remote.token <token>
+```
+
+示例直接运行（不写入配置）：
+
+```bash
+openclaw acp --url wss://gateway-host:18789 --token <token>
+```
+
+## 选择智能体
+
+ACP 不直接选择智能体。它通过 Gateway网关会话密钥进行路由。
+
+使用智能体作用域的会话密钥来指定特定智能体：
+
+```bash
+openclaw acp --session agent:main:main
+openclaw acp --session agent:design:main
+openclaw acp --session agent:qa:bug-123
+```
+
+每个 ACP 会话映射到单个 Gateway网关会话密钥。一个智能体可以有多个会话；除非你覆盖密钥或标签，否则 ACP 默认使用隔离的 `acp:<uuid>` 会话。
+
+## Zed 编辑器设置
+
+在 `~/.config/zed/settings.json` 中添加自定义 ACP 智能体（或使用 Zed 的设置界面）：
+
+```json
+{
+  "agent_servers": {
+    "OpenClaw ACP": {
+      "type": "custom",
+      "command": "openclaw",
+      "args": ["acp"],
+      "env": {}
+    }
+  }
+}
+```
+
+要指定特定的 Gateway网关或智能体：
+
+```json
+{
+  "agent_servers": {
+    "OpenClaw ACP": {
+      "type": "custom",
+      "command": "openclaw",
+      "args": [
+        "acp",
+        "--url",
+        "wss://gateway-host:18789",
+        "--token",
+        "<token>",
+        "--session",
+        "agent:design:main"
+      ],
+      "env": {}
+    }
+  }
+}
+```
+
+在 Zed 中，打开 Agent 面板并选择 "OpenClaw ACP" 来开始一个对话线程。
+
+## 会话映射
+
+默认情况下，ACP 会话会获得一个带有 `acp:` 前缀的隔离 Gateway网关会话密钥。
+要复用已知会话，请传递会话密钥或标签：
+
+- `--session <key>`：使用特定的 Gateway网关会话密钥。
+- `--session-label <label>`：通过标签解析现有会话。
+- `--reset-session`：为该密钥生成新的会话 ID（相同密钥，新的对话记录）。
+
+如果你的 ACP 客户端支持元数据，你可以按会话进行覆盖：
+
+```json
+{
+  "_meta": {
+    "sessionKey": "agent:main:main",
+    "sessionLabel": "support inbox",
+    "resetSession": true
+  }
+}
+```
+
+了解更多关于会话密钥的信息，请参阅 [/concepts/session](/concepts/session)。
+
+## 选项
+
+- `--url <url>`：Gateway网关 WebSocket URL（配置后默认使用 gateway.remote.url）。
+- `--token <token>`：Gateway网关认证令牌。
+- `--password <password>`：Gateway网关认证密码。
+- `--session <key>`：默认会话密钥。
+- `--session-label <label>`：要解析的默认会话标签。
+- `--require-existing`：如果会话密钥/标签不存在则失败。
+- `--reset-session`：在首次使用前重置会话密钥。
+- `--no-prefix-cwd`：不在提示前添加工作目录前缀。
+- `--verbose, -v`：将详细日志输出到 stderr。
+
+### `acp client` 选项
+
+- `--cwd <dir>`：ACP 会话的工作目录。
+- `--server <command>`：ACP 服务器命令（默认：`openclaw`）。
+- `--server-args <args...>`：传递给 ACP 服务器的额外参数。
+- `--server-verbose`：启用 ACP 服务器的详细日志。
+- `--verbose, -v`：详细客户端日志。

package/docs/zh-CN/cli/agent.md

@@ -0,0 +1,31 @@
+---
+read_when:
+  - 你想从脚本中运行一次智能体轮次（可选择投递回复）
+summary: "`openclaw agent` 的 CLI 参考（通过 Gateway网关发送一次智能体轮次）"
+title: agent
+x-i18n:
+  generated_at: "2026-02-01T19:58:31Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: dcf12fb94e207c68645f58235792596d65afecf8216b8f9ab3acb01e03b50a33
+  source_path: cli/agent.md
+  workflow: 14
+---
+
+# `openclaw agent`
+
+通过 Gateway网关运行一次智能体轮次（使用 `--local` 进行嵌入式运行）。
+使用 `--agent <id>` 直接指定一个已配置的智能体。
+
+相关内容：
+
+- 智能体发送工具：[智能体发送](/tools/agent-send)
+
+## 示例
+
+```bash
+openclaw agent --to +15555550123 --message "status update" --deliver
+openclaw agent --agent ops --message "Summarize logs"
+openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
+openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
+```

package/docs/zh-CN/cli/agents.md

@@ -0,0 +1,82 @@
+---
+read_when:
+  - 你需要多个隔离的智能体（工作区 + 路由 + 认证）
+summary: "`openclaw agents` 的 CLI 参考（列出/添加/删除/设置身份）"
+title: agents
+x-i18n:
+  generated_at: "2026-02-01T19:58:38Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 30556d81636a9ad8972573cc6b498e620fd266e1dfb16eef3f61096ea62f9896
+  source_path: cli/agents.md
+  workflow: 14
+---
+
+# `openclaw agents`
+
+管理隔离的智能体（工作区 + 认证 + 路由）。
+
+相关内容：
+
+- 多智能体路由：[多智能体路由](/concepts/multi-agent)
+- 智能体工作区：[智能体工作区](/concepts/agent-workspace)
+
+## 示例
+
+```bash
+openclaw agents list
+openclaw agents add work --workspace ~/.openclaw/workspace-work
+openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
+openclaw agents set-identity --agent main --avatar avatars/openclaw.png
+openclaw agents delete work
+```
+
+## 身份文件
+
+每个智能体工作区可以在工作区根目录包含一个 `IDENTITY.md`：
+
+- 示例路径：`~/.openclaw/workspace/IDENTITY.md`
+- `set-identity --from-identity` 从工作区根目录读取（或从显式指定的 `--identity-file` 读取）
+
+头像路径相对于工作区根目录解析。
+
+## 设置身份
+
+`set-identity` 将字段写入 `agents.list[].identity`：
+
+- `name`
+- `theme`
+- `emoji`
+- `avatar`（工作区相对路径、http(s) URL 或 data URI）
+
+从 `IDENTITY.md` 加载：
+
+```bash
+openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
+```
+
+显式覆盖字段：
+
+```bash
+openclaw agents set-identity --agent main --name "OpenClaw" --emoji "🦞" --avatar avatars/openclaw.png
+```
+
+配置示例：
+
+```json5
+{
+  agents: {
+    list: [
+      {
+        id: "main",
+        identity: {
+          name: "OpenClaw",
+          theme: "space lobster",
+          emoji: "🦞",
+          avatar: "avatars/openclaw.png",
+        },
+      },
+    ],
+  },
+}
+```

package/docs/zh-CN/cli/approvals.md

@@ -0,0 +1,57 @@
+---
+read_when:
+  - 你想通过 CLI 编辑执行审批
+  - 你需要管理 Gateway网关或节点主机上的允许列表
+summary: "`openclaw approvals` 的 CLI 参考（用于 Gateway网关或节点主机的执行审批）"
+title: approvals
+x-i18n:
+  generated_at: "2026-02-01T19:58:39Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 4329cdaaec2c5f5d619415b6431196512d4834dc1ccd7363576f03dd9b845130
+  source_path: cli/approvals.md
+  workflow: 14
+---
+
+# `openclaw approvals`
+
+管理**本地主机**、**Gateway网关主机**或**节点主机**的执行审批。
+默认情况下，命令针对磁盘上的本地审批文件。使用 `--gateway` 针对 Gateway网关，或使用 `--node` 针对特定节点。
+
+相关内容：
+
+- 执行审批：[执行审批](/tools/exec-approvals)
+- 节点：[节点](/nodes)
+
+## 常用命令
+
+```bash
+openclaw approvals get
+openclaw approvals get --node <id|name|ip>
+openclaw approvals get --gateway
+```
+
+## 从文件替换审批
+
+```bash
+openclaw approvals set --file ./exec-approvals.json
+openclaw approvals set --node <id|name|ip> --file ./exec-approvals.json
+openclaw approvals set --gateway --file ./exec-approvals.json
+```
+
+## 允许列表辅助命令
+
+```bash
+openclaw approvals allowlist add "~/Projects/**/bin/rg"
+openclaw approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
+openclaw approvals allowlist add --agent "*" "/usr/bin/uname"
+
+openclaw approvals allowlist remove "~/Projects/**/bin/rg"
+```
+
+## 注意事项
+
+- `--node` 使用与 `openclaw nodes` 相同的解析器（id、名称、ip 或 id 前缀）。
+- `--agent` 默认为 `"*"`，即适用于所有智能体。
+- 节点主机必须公布 `system.execApprovals.get/set`（macOS 应用或无头节点主机）。
+- 审批文件按主机存储在 `~/.openclaw/exec-approvals.json`。

package/docs/zh-CN/cli/browser.md

@@ -0,0 +1,114 @@
+---
+read_when:
+  - 使用 `openclaw browser` 并需要常见任务的示例
+  - 想要通过节点主机控制运行在另一台机器上的浏览器
+  - 想要使用 Chrome 扩展中继（通过工具栏按钮附加/分离）
+summary: "`openclaw browser` 的 CLI 参考（配置文件、标签页、操作、扩展中继）"
+title: browser
+x-i18n:
+  generated_at: "2026-02-01T19:58:45Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: af35adfd68726fd519c704d046451effd330458c2b8305e713137fb07b2571fd
+  source_path: cli/browser.md
+  workflow: 14
+---
+
+# `openclaw browser`
+
+管理 OpenClaw 的浏览器控制服务器并执行浏览器操作（标签页、快照、截图、导航、点击、输入）。
+
+相关内容：
+
+- 浏览器工具 + API：[浏览器工具](/tools/browser)
+- Chrome 扩展中继：[Chrome 扩展](/tools/chrome-extension)
+
+## 常用标志
+
+- `--url <gatewayWsUrl>`：Gateway网关 WebSocket URL（默认使用配置值）。
+- `--token <token>`：Gateway网关令牌（如需要）。
+- `--timeout <ms>`：请求超时时间（毫秒）。
+- `--browser-profile <name>`：选择浏览器配置文件（默认使用配置值）。
+- `--json`：机器可读输出（在支持的情况下）。
+
+## 快速开始（本地）
+
+```bash
+openclaw browser --browser-profile chrome tabs
+openclaw browser --browser-profile openclaw start
+openclaw browser --browser-profile openclaw open https://example.com
+openclaw browser --browser-profile openclaw snapshot
+```
+
+## 配置文件
+
+配置文件是命名的浏览器路由配置。实际使用中：
+
+- `openclaw`：启动/附加到一个专用的 OpenClaw 管理的 Chrome 实例（隔离的用户数据目录）。
+- `chrome`：通过 Chrome 扩展中继控制你现有的 Chrome 标签页。
+
+```bash
+openclaw browser profiles
+openclaw browser create-profile --name work --color "#FF5A36"
+openclaw browser delete-profile --name work
+```
+
+使用特定配置文件：
+
+```bash
+openclaw browser --browser-profile work tabs
+```
+
+## 标签页
+
+```bash
+openclaw browser tabs
+openclaw browser open https://docs.openclaw.ai
+openclaw browser focus <targetId>
+openclaw browser close <targetId>
+```
+
+## 快照 / 截图 / 操作
+
+快照：
+
+```bash
+openclaw browser snapshot
+```
+
+截图：
+
+```bash
+openclaw browser screenshot
+```
+
+导航/点击/输入（基于引用的 UI 自动化）：
+
+```bash
+openclaw browser navigate https://example.com
+openclaw browser click <ref>
+openclaw browser type <ref> "hello"
+```
+
+## Chrome 扩展中继（通过工具栏按钮附加）
+
+此模式允许智能体控制你手动附加的现有 Chrome 标签页（不会自动附加）。
+
+将未打包的扩展安装到稳定路径：
+
+```bash
+openclaw browser extension install
+openclaw browser extension path
+```
+
+然后在 Chrome 中 → `chrome://extensions` → 启用"开发者模式" → "加载已解压的扩展程序" → 选择打印出的文件夹。
+
+完整指南：[Chrome 扩展](/tools/chrome-extension)
+
+## 远程浏览器控制（节点主机代理）
+
+如果 Gateway网关与浏览器运行在不同的机器上，请在安装了 Chrome/Brave/Edge/Chromium 的机器上运行**节点主机**。Gateway网关会将浏览器操作代理到该节点（无需单独的浏览器控制服务器）。
+
+使用 `gateway.nodes.browser.mode` 控制自动路由，使用 `gateway.nodes.browser.node` 在多个节点连接时固定到特定节点。
+
+安全性 + 远程设置：[浏览器工具](/tools/browser)、[远程访问](/gateway/remote)、[Tailscale](/gateway/tailscale)、[安全](/gateway/security)

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

@@ -0,0 +1,86 @@
+---
+read_when:
+  - 你想添加/移除渠道账号（WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost（插件）/Signal/iMessage）
+  - 你想检查渠道状态或查看渠道日志
+summary: "`openclaw channels` 的 CLI 参考（账号、状态、登录/登出、日志）"
+title: channels
+x-i18n:
+  generated_at: "2026-02-01T19:58:48Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 16ab1642f247bfa96e8e08dfeb1eedfccb148f40d91099f5423f971df2b54e20
+  source_path: cli/channels.md
+  workflow: 14
+---
+
+# `openclaw channels`
+
+管理 Gateway网关上的聊天渠道账号及其运行时状态。
+
+相关文档：
+
+- 渠道指南：[渠道](/channels/index)
+- Gateway网关配置：[配置](/gateway/configuration)
+
+## 常用命令
+
+```bash
+openclaw channels list
+openclaw channels status
+openclaw channels capabilities
+openclaw channels capabilities --channel discord --target channel:123
+openclaw channels resolve --channel slack "#general" "@jane"
+openclaw channels logs --channel all
+```
+
+## 添加/移除账号
+
+```bash
+openclaw channels add --channel telegram --token <bot-token>
+openclaw channels remove --channel telegram --delete
+```
+
+提示：`openclaw channels add --help` 可查看各渠道的专用参数（token、app token、signal-cli 路径等）。
+
+## 登录/登出（交互式）
+
+```bash
+openclaw channels login --channel whatsapp
+openclaw channels logout --channel whatsapp
+```
+
+## 故障排除
+
+- 运行 `openclaw status --deep` 进行全面探测。
+- 使用 `openclaw doctor` 获取引导式修复。
+- `openclaw channels list` 输出 `Claude: HTTP 403 ... user:profile` → 用量快照需要 `user:profile` 权限范围。使用 `--no-usage`，或提供 claude.ai 会话密钥（`CLAUDE_WEB_SESSION_KEY` / `CLAUDE_WEB_COOKIE`），或通过 Claude Code CLI 重新认证。
+
+## 能力探测
+
+获取提供商能力提示（可用的 intents/scopes）以及静态功能支持：
+
+```bash
+openclaw channels capabilities
+openclaw channels capabilities --channel discord --target channel:123
+```
+
+说明：
+
+- `--channel` 是可选的；省略时将列出所有渠道（包括扩展）。
+- `--target` 接受 `channel:<id>` 或原始数字频道 ID，仅适用于 Discord。
+- 探测因提供商而异：Discord intents + 可选的频道权限；Slack bot + 用户权限范围；Telegram bot 标志 + webhook；Signal 守护进程版本；MS Teams 应用令牌 + Graph 角色/权限范围（已知的会标注）。无探测功能的渠道会报告 `Probe: unavailable`。
+
+## 将名称解析为 ID
+
+使用提供商目录将渠道/用户名称解析为 ID：
+
+```bash
+openclaw channels resolve --channel slack "#general" "@jane"
+openclaw channels resolve --channel discord "My Server/#support" "@someone"
+openclaw channels resolve --channel matrix "Project Room"
+```
+
+说明：
+
+- 使用 `--kind user|group|auto` 强制指定目标类型。
+- 当多个条目共享相同名称时，解析优先选择活跃的匹配项。