@gguf/claw 2026.2.1 → 2026.2.3

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

@@ -0,0 +1,66 @@
+---
+read_when:
+  - 你想安装或管理进程内 Gateway网关插件
+  - 你想调试插件加载失败问题
+summary: "`openclaw plugins` 的 CLI 参考（list、install、enable/disable、doctor）"
+title: plugins
+x-i18n:
+  generated_at: "2026-02-01T20:21:23Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: c6bf76b1e766b912ec30a0101d455151c88f1a778bffa121cdd1d0b4fbe73e1c
+  source_path: cli/plugins.md
+  workflow: 14
+---
+
+# `openclaw plugins`
+
+管理 Gateway网关插件/扩展（进程内加载）。
+
+相关内容：
+
+- 插件系统：[插件](/plugin)
+- 插件清单 + schema：[插件清单](/plugins/manifest)
+- 安全加固：[安全](/gateway/security)
+
+## 命令
+
+```bash
+openclaw plugins list
+openclaw plugins info <id>
+openclaw plugins enable <id>
+openclaw plugins disable <id>
+openclaw plugins doctor
+openclaw plugins update <id>
+openclaw plugins update --all
+```
+
+内置插件随 OpenClaw 一起分发，但默认处于禁用状态。使用 `plugins enable` 来激活它们。
+
+所有插件必须附带一个 `openclaw.plugin.json` 文件，其中包含内联 JSON Schema（`configSchema`，即使为空也需要）。缺失或无效的清单或 schema 会导致插件无法加载，并使配置验证失败。
+
+### 安装
+
+```bash
+openclaw plugins install <path-or-spec>
+```
+
+安全提示：安装插件等同于运行代码，请优先使用固定版本。
+
+支持的归档格式：`.zip`、`.tgz`、`.tar.gz`、`.tar`。
+
+使用 `--link` 可避免复制本地目录（会添加到 `plugins.load.paths`）：
+
+```bash
+openclaw plugins install -l ./my-plugin
+```
+
+### 更新
+
+```bash
+openclaw plugins update <id>
+openclaw plugins update --all
+openclaw plugins update <id> --dry-run
+```
+
+更新仅适用于从 npm 安装的插件（在 `plugins.installs` 中跟踪）。

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

@@ -0,0 +1,24 @@
+---
+read_when:
+  - 你想在保留 CLI 安装的同时清除本地状态
+  - 你想预览哪些内容会被移除
+summary: "`openclaw reset`（重置本地状态/配置）的 CLI 参考"
+title: reset
+x-i18n:
+  generated_at: "2026-02-01T20:21:22Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 08afed5830f892e07d6e2e167f09aaf2d79fd5b2ba2a26a65dca857ebdbf873c
+  source_path: cli/reset.md
+  workflow: 14
+---
+
+# `openclaw reset`
+
+重置本地配置/状态（保留 CLI 安装）。
+
+```bash
+openclaw reset
+openclaw reset --dry-run
+openclaw reset --scope config+creds+sessions --yes --non-interactive
+```

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

@@ -0,0 +1,158 @@
+---
+read_when: 你正在管理沙箱容器或调试沙箱/工具策略行为。
+status: active
+summary: 管理沙箱容器并检查生效的沙箱策略
+title: Sandbox CLI
+x-i18n:
+  generated_at: "2026-02-01T20:21:35Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 6e1186f26c77e188206ce5e198ab624d6b38bc7bb7c06e4d2281b6935c39e347
+  source_path: cli/sandbox.md
+  workflow: 14
+---
+
+# Sandbox CLI
+
+管理基于 Docker 的沙箱容器，用于隔离智能体执行。
+
+## 概述
+
+OpenClaw 可以在隔离的 Docker 容器中运行智能体以确保安全性。`sandbox` 命令帮助你管理这些容器，尤其是在更新或配置变更之后。
+
+## 命令
+
+### `openclaw sandbox explain`
+
+检查**生效的**沙箱模式/作用域/工作区访问权限、沙箱工具策略以及提权门控（附带修复建议的配置键路径）。
+
+```bash
+openclaw sandbox explain
+openclaw sandbox explain --session agent:main:main
+openclaw sandbox explain --agent work
+openclaw sandbox explain --json
+```
+
+### `openclaw sandbox list`
+
+列出所有沙箱容器及其状态和配置。
+
+```bash
+openclaw sandbox list
+openclaw sandbox list --browser  # 仅列出浏览器容器
+openclaw sandbox list --json     # JSON 输出
+```
+
+**输出包括：**
+
+- 容器名称和状态（运行中/已停止）
+- Docker 镜像及其是否与配置匹配
+- 存在时间（自创建以来的时长）
+- 空闲时间（自上次使用以来的时长）
+- 关联的会话/智能体
+
+### `openclaw sandbox recreate`
+
+移除沙箱容器，以便使用更新的镜像/配置强制重新创建。
+
+```bash
+openclaw sandbox recreate --all                # 重新创建所有容器
+openclaw sandbox recreate --session main       # 指定会话
+openclaw sandbox recreate --agent mybot        # 指定智能体
+openclaw sandbox recreate --browser            # 仅浏览器容器
+openclaw sandbox recreate --all --force        # 跳过确认提示
+```
+
+**选项：**
+
+- `--all`：重新创建所有沙箱容器
+- `--session <key>`：重新创建指定会话的容器
+- `--agent <id>`：重新创建指定智能体的容器
+- `--browser`：仅重新创建浏览器容器
+- `--force`：跳过确认提示
+
+**重要提示：** 容器会在智能体下次使用时自动重新创建。
+
+## 使用场景
+
+### 更新 Docker 镜像后
+
+```bash
+# 拉取新镜像
+docker pull openclaw-sandbox:latest
+docker tag openclaw-sandbox:latest openclaw-sandbox:bookworm-slim
+
+# 更新配置以使用新镜像
+# 编辑配置：agents.defaults.sandbox.docker.image（或 agents.list[].sandbox.docker.image）
+
+# 重新创建容器
+openclaw sandbox recreate --all
+```
+
+### 更改沙箱配置后
+
+```bash
+# 编辑配置：agents.defaults.sandbox.*（或 agents.list[].sandbox.*）
+
+# 重新创建以应用新配置
+openclaw sandbox recreate --all
+```
+
+### 更改 setupCommand 后
+
+```bash
+openclaw sandbox recreate --all
+# 或仅针对某个智能体：
+openclaw sandbox recreate --agent family
+```
+
+### 仅针对特定智能体
+
+```bash
+# 仅更新某个智能体的容器
+openclaw sandbox recreate --agent alfred
+```
+
+## 为什么需要这样做？
+
+**问题：** 当你更新沙箱 Docker 镜像或配置时：
+
+- 现有容器会继续使用旧设置运行
+- 容器仅在空闲 24 小时后才会被清理
+- 经常使用的智能体会无限期地保持旧容器运行
+
+**解决方案：** 使用 `openclaw sandbox recreate` 强制移除旧容器。它们会在下次需要时自动使用当前设置重新创建。
+
+提示：建议使用 `openclaw sandbox recreate` 而非手动执行 `docker rm`。它使用 Gateway网关的容器命名规则，避免在作用域/会话键发生变化时出现不匹配问题。
+
+## 配置
+
+沙箱设置位于 `~/.openclaw/openclaw.json` 中的 `agents.defaults.sandbox` 下（按智能体覆盖的配置放在 `agents.list[].sandbox` 中）：
+
+```jsonc
+{
+  "agents": {
+    "defaults": {
+      "sandbox": {
+        "mode": "all", // off, non-main, all
+        "scope": "agent", // session, agent, shared
+        "docker": {
+          "image": "openclaw-sandbox:bookworm-slim",
+          "containerPrefix": "openclaw-sbx-",
+          // ... 更多 Docker 选项
+        },
+        "prune": {
+          "idleHours": 24, // 空闲 24 小时后自动清理
+          "maxAgeDays": 7, // 7 天后自动清理
+        },
+      },
+    },
+  },
+}
+```
+
+## 另请参阅
+
+- [沙箱文档](/gateway/sandboxing)
+- [智能体配置](/concepts/agent-workspace)
+- [Doctor 命令](/gateway/doctor) - 检查沙箱设置

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

@@ -0,0 +1,33 @@
+---
+read_when:
+  - 想要对配置/状态进行快速安全审计
+  - 想要应用安全的"修复"建议（chmod、收紧默认值）
+summary: 审计和修复常见安全隐患的 `openclaw security` CLI 参考
+title: security
+x-i18n:
+  generated_at: "2026-02-01T20:21:24Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 19705b0fff848fa6f302b4ed09b7660c64e09048dba517c7f6a833d2db40bebf
+  source_path: cli/security.md
+  workflow: 14
+---
+
+# `openclaw security`
+
+安全工具（审计 + 可选修复）。
+
+相关内容：
+
+- 安全指南：[安全](/gateway/security)
+
+## 审计
+
+```bash
+openclaw security audit
+openclaw security audit --deep
+openclaw security audit --fix
+```
+
+当多个私信发送者共享主会话时，审计会发出警告，并建议共享收件箱使用 `session.dmScope="per-channel-peer"`（多账户渠道则使用 `per-account-channel-peer`）。
+审计还会在小模型（`<=300B`）未启用沙箱且启用了 web/browser 工具时发出警告。

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

@@ -0,0 +1,23 @@
+---
+read_when:
+  - 你想列出已存储的会话并查看近期活动
+summary: "`openclaw sessions`（列出已存储的会话及使用情况）的 CLI 参考"
+title: sessions
+x-i18n:
+  generated_at: "2026-02-01T20:21:25Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: d8866ef166c0dea5e8d691bb62171298694935ae0771a46fada537774dadfb32
+  source_path: cli/sessions.md
+  workflow: 14
+---
+
+# `openclaw sessions`
+
+列出已存储的对话会话。
+
+```bash
+openclaw sessions
+openclaw sessions --active 120
+openclaw sessions --json
+```

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

@@ -0,0 +1,36 @@
+---
+read_when:
+  - 你在不使用完整新手引导向导的情况下进行首次设置
+  - 你想设置默认工作区路径
+summary: "`openclaw setup` 的 CLI 参考（初始化配置 + 工作区）"
+title: setup
+x-i18n:
+  generated_at: "2026-02-01T20:21:26Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 7f3fc8b246924edf48501785be2c0d356bd31bfbb133e75a139a5ee41dbf57f4
+  source_path: cli/setup.md
+  workflow: 14
+---
+
+# `openclaw setup`
+
+初始化 `~/.openclaw/openclaw.json` 和智能体工作区。
+
+相关内容：
+
+- 快速开始：[快速开始](/start/getting-started)
+- 向导：[新手引导](/start/onboarding)
+
+## 示例
+
+```bash
+openclaw setup
+openclaw setup --workspace ~/.openclaw/workspace
+```
+
+通过 setup 运行向导：
+
+```bash
+openclaw setup --wizard
+```

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

@@ -0,0 +1,33 @@
+---
+read_when:
+  - 想要查看哪些 Skills 可用且可以运行
+  - 想要调试 Skills 缺失的二进制文件/环境变量/配置
+summary: Skills 列表/信息/检查及 Skills 资格的 `openclaw skills` CLI 参考
+title: skills
+x-i18n:
+  generated_at: "2026-02-01T20:21:28Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 7878442c88a27ec8033f3125c319e9a6a85a1c497a404a06112ad45185c261b0
+  source_path: cli/skills.md
+  workflow: 14
+---
+
+# `openclaw skills`
+
+检查 Skills（内置 + 工作区 + 托管覆盖），查看哪些符合条件以及哪些缺少依赖。
+
+相关内容：
+
+- Skills 系统：[Skills](/tools/skills)
+- Skills配置：[Skills配置](/tools/skills-config)
+- ClawHub 安装：[ClawHub](/tools/clawhub)
+
+## 命令
+
+```bash
+openclaw skills list
+openclaw skills list --eligible
+openclaw skills info <name>
+openclaw skills check
+```

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

@@ -0,0 +1,33 @@
+---
+read_when:
+  - 你想快速诊断渠道健康状况及近期会话接收者
+  - 你想获取可粘贴的完整状态信息用于调试
+summary: "`openclaw status`（诊断、探测、使用情况快照）的 CLI 参考"
+title: status
+x-i18n:
+  generated_at: "2026-02-01T20:21:30Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 2bbf5579c48034fc15c2cbd5506c50456230b17e4a74c06318968c590d8f1501
+  source_path: cli/status.md
+  workflow: 14
+---
+
+# `openclaw status`
+
+渠道和会话的诊断信息。
+
+```bash
+openclaw status
+openclaw status --all
+openclaw status --deep
+openclaw status --usage
+```
+
+说明：
+
+- `--deep` 会运行实时探测（WhatsApp Web + Telegram + Discord + Google Chat + Slack + Signal）。
+- 当配置了多个智能体时，输出包含每个智能体的会话存储。
+- 概览包含 Gateway网关和节点主机服务的安装/运行状态（如可用）。
+- 概览包含更新渠道和 git SHA（适用于源码检出）。
+- 更新信息会显示在概览中；如果有可用更新，状态会提示运行 `openclaw update`（参见[更新](/install/updating)）。

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

@@ -0,0 +1,63 @@
+---
+read_when:
+  - 你想在不创建 cron 任务的情况下将系统事件加入队列
+  - 你需要启用或禁用心跳
+  - 你想检查系统存在状态条目
+summary: "`openclaw system` 的 CLI 参考（系统事件、心跳、存在状态）"
+title: system
+x-i18n:
+  generated_at: "2026-02-01T20:21:34Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 36ae5dbdec327f5a32f7ef44bdc1f161bad69868de62f5071bb4d25a71bfdfe9
+  source_path: cli/system.md
+  workflow: 14
+---
+
+# `openclaw system`
+
+Gateway网关的系统级辅助工具：将系统事件加入队列、控制心跳以及查看存在状态。
+
+## 常用命令
+
+```bash
+openclaw system event --text "Check for urgent follow-ups" --mode now
+openclaw system heartbeat enable
+openclaw system heartbeat last
+openclaw system presence
+```
+
+## `system event`
+
+在**主**会话上将系统事件加入队列。下一次心跳会将其作为 `System:` 行注入到提示中。使用 `--mode now` 可立即触发心跳；`next-heartbeat` 则等待下一次计划的心跳周期。
+
+标志：
+
+- `--text <text>`：必需的系统事件文本。
+- `--mode <mode>`：`now` 或 `next-heartbeat`（默认）。
+- `--json`：机器可读输出。
+
+## `system heartbeat last|enable|disable`
+
+心跳控制：
+
+- `last`：显示上一次心跳事件。
+- `enable`：重新开启心跳（如果之前被禁用，请使用此命令）。
+- `disable`：暂停心跳。
+
+标志：
+
+- `--json`：机器可读输出。
+
+## `system presence`
+
+列出 Gateway网关已知的当前系统存在状态条目（节点、实例及类似状态行）。
+
+标志：
+
+- `--json`：机器可读输出。
+
+## 注意事项
+
+- 需要当前配置（本地或远程）可访问的运行中 Gateway网关。
+- 系统事件是临时的，不会在重启后持久化。

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

@@ -0,0 +1,30 @@
+---
+read_when:
+  - 想要使用 Gateway网关的终端 UI（支持远程）
+  - 想要从脚本传递 url/token/session
+summary: 连接到 Gateway网关的终端 UI 的 `openclaw tui` CLI 参考
+title: tui
+x-i18n:
+  generated_at: "2026-02-01T20:21:31Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: f0a97d92e08746a9d6a4f31d361ccad9aea4c3dc61cfafb310d88715f61cfb64
+  source_path: cli/tui.md
+  workflow: 14
+---
+
+# `openclaw tui`
+
+打开连接到 Gateway网关的终端 UI。
+
+相关内容：
+
+- TUI 指南：[TUI](/tui)
+
+## 示例
+
+```bash
+openclaw tui
+openclaw tui --url ws://127.0.0.1:18789 --token <token>
+openclaw tui --session main --deliver
+```

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

@@ -0,0 +1,24 @@
+---
+read_when:
+  - 你想移除 Gateway网关服务和/或本地状态
+  - 你想先进行试运行
+summary: "`openclaw uninstall`（移除 Gateway网关服务 + 本地数据）的 CLI 参考"
+title: uninstall
+x-i18n:
+  generated_at: "2026-02-01T20:21:33Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 8d6c3890923f18f95c12b76443d649a6b404934ebd054fb86a9fa1abae843fe4
+  source_path: cli/uninstall.md
+  workflow: 14
+---
+
+# `openclaw uninstall`
+
+卸载 Gateway网关服务 + 本地数据（CLI 保留）。
+
+```bash
+openclaw uninstall
+openclaw uninstall --all --yes
+openclaw uninstall --dry-run
+```

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

@@ -0,0 +1,101 @@
+---
+read_when:
+  - 你想安全地更新源码检出
+  - 你需要了解 `--update` 简写行为
+summary: "`openclaw update`（安全的源码更新 + Gateway网关自动重启）的 CLI 参考"
+title: update
+x-i18n:
+  generated_at: "2026-02-01T20:21:45Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 3a08e8ac797612c498eef54ecb83e61c9a1ee5de09162a01dbb4b3bd72897206
+  source_path: cli/update.md
+  workflow: 14
+---
+
+# `openclaw update`
+
+安全更新 OpenClaw 并在 stable/beta/dev 渠道之间切换。
+
+如果你通过 **npm/pnpm** 安装（全局安装，无 git 元数据），更新将通过[更新](/install/updating)中的包管理器流程进行。
+
+## 用法
+
+```bash
+openclaw update
+openclaw update status
+openclaw update wizard
+openclaw update --channel beta
+openclaw update --channel dev
+openclaw update --tag beta
+openclaw update --no-restart
+openclaw update --json
+openclaw --update
+```
+
+## 选项
+
+- `--no-restart`：成功更新后跳过重启 Gateway网关服务。
+- `--channel <stable|beta|dev>`：设置更新渠道（git + npm；持久化到配置中）。
+- `--tag <dist-tag|version>`：仅为本次更新覆盖 npm dist-tag 或版本。
+- `--json`：输出机器可读的 `UpdateRunResult` JSON。
+- `--timeout <seconds>`：每步超时时间（默认为 1200 秒）。
+
+注意：降级需要确认，因为旧版本可能会破坏配置。
+
+## `update status`
+
+显示当前活跃的更新渠道 + git 标签/分支/SHA（适用于源码检出），以及更新可用性。
+
+```bash
+openclaw update status
+openclaw update status --json
+openclaw update status --timeout 10
+```
+
+选项：
+
+- `--json`：输出机器可读的状态 JSON。
+- `--timeout <seconds>`：检查超时时间（默认为 3 秒）。
+
+## `update wizard`
+
+交互式流程，用于选择更新渠道并确认更新后是否重启 Gateway网关（默认重启）。如果你选择 `dev` 但没有 git 检出，它会提供创建一个的选项。
+
+## 工作原理
+
+当你显式切换渠道（`--channel ...`）时，OpenClaw 也会保持安装方式一致：
+
+- `dev` → 确保存在 git 检出（默认：`~/openclaw`，可通过 `OPENCLAW_GIT_DIR` 覆盖），更新它，并从该检出安装全局 CLI。
+- `stable`/`beta` → 使用匹配的 dist-tag 从 npm 安装。
+
+## Git 检出流程
+
+渠道：
+
+- `stable`：检出最新的非 beta 标签，然后构建 + doctor。
+- `beta`：检出最新的 `-beta` 标签，然后构建 + doctor。
+- `dev`：检出 `main`，然后 fetch + rebase。
+
+概要流程：
+
+1. 要求工作树干净（无未提交的更改）。
+2. 切换到所选渠道（标签或分支）。
+3. 拉取上游（仅 dev）。
+4. 仅 dev：在临时工作树中进行预检 lint + TypeScript 构建；如果最新提交失败，会向前回溯最多 10 个提交以找到最新的可成功构建的提交。
+5. Rebase 到所选提交（仅 dev）。
+6. 安装依赖（优先使用 pnpm；回退到 npm）。
+7. 构建项目 + 构建控制台 UI。
+8. 运行 `openclaw doctor` 作为最终的"安全更新"检查。
+9. 将插件同步到活跃渠道（dev 使用内置扩展；stable/beta 使用 npm）并更新通过 npm 安装的插件。
+
+## `--update` 简写
+
+`openclaw --update` 会重写为 `openclaw update`（便于在 shell 和启动脚本中使用）。
+
+## 另请参阅
+
+- `openclaw doctor`（在 git 检出上会提供先运行更新的选项）
+- [开发渠道](/install/development-channels)
+- [更新](/install/updating)
+- [CLI 参考](/cli)

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

@@ -0,0 +1,41 @@
+---
+read_when:
+  - 使用语音通话插件并想了解 CLI 入口
+  - 想要 `voicecall call|continue|status|tail|expose` 的快速示例
+summary: 语音通话插件命令的 `openclaw voicecall` CLI 参考
+title: voicecall
+x-i18n:
+  generated_at: "2026-02-01T20:21:37Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: d93aaee6f6f5c9ac468d8d2905cb23f0f2db75809408cb305c055505be9936f2
+  source_path: cli/voicecall.md
+  workflow: 14
+---
+
+# `openclaw voicecall`
+
+`voicecall` 是一个由插件提供的命令。只有在安装并启用了语音通话插件时才会出现。
+
+主要文档：
+
+- 语音通话插件：[语音通话](/plugins/voice-call)
+
+## 常用命令
+
+```bash
+openclaw voicecall status --call-id <id>
+openclaw voicecall call --to "+15555550123" --message "Hello" --mode notify
+openclaw voicecall continue --call-id <id> --message "Any questions?"
+openclaw voicecall end --call-id <id>
+```
+
+## 暴露 Webhook（Tailscale）
+
+```bash
+openclaw voicecall expose --mode serve
+openclaw voicecall expose --mode funnel
+openclaw voicecall unexpose
+```
+
+安全提示：仅将 webhook 端点暴露给你信任的网络。尽可能优先使用 Tailscale Serve 而非 Funnel。