@quantumclaw/quantumclaw 2026.3.22

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

@@ -0,0 +1,164 @@
+---
+read_when:
+  - 你想通过引导式设置来配置 Gateway 网关、工作区、身份验证、渠道和 Skills
+summary: "`quantumclaw onboard` 的 CLI 参考（交互式新手引导）"
+title: onboard
+x-i18n:
+  generated_at: "2026-03-16T06:21:32Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: 04d7747342c582abcfcafff28847b4297f65ada665157d9cfbe3dbb258ee31d9
+  source_path: cli/onboard.md
+  workflow: 15
+---
+
+# `quantumclaw onboard`
+
+交互式新手引导（本地或远程 Gateway 网关设置）。
+
+## 相关指南
+
+- CLI 新手引导中心：[CLI 新手引导](/start/wizard)
+- 新手引导概览：[新手引导概览](/start/onboarding-overview)
+- CLI 新手引导参考：[CLI 设置参考](/start/wizard-cli-reference)
+- CLI 自动化：[CLI 自动化](/start/wizard-cli-automation)
+- macOS 新手引导：[新手引导（macOS 应用）](/start/onboarding)
+
+## 示例
+
+```bash
+quantumclaw onboard
+quantumclaw onboard --flow quickstart
+quantumclaw onboard --flow manual
+quantumclaw onboard --mode remote --remote-url wss://gateway-host:18789
+```
+
+对于明文私有网络 `ws://` 目标（仅限受信任网络），请在新手引导进程环境中设置
+`QUANTUMCLAW_ALLOW_INSECURE_PRIVATE_WS=1`。
+
+非交互式自定义提供商：
+
+```bash
+quantumclaw onboard --non-interactive \
+  --auth-choice custom-api-key \
+  --custom-base-url "https://llm.example.com/v1" \
+  --custom-model-id "foo-large" \
+  --custom-api-key "$CUSTOM_API_KEY" \
+  --secret-input-mode plaintext \
+  --custom-compatibility openai
+```
+
+在非交互式模式下，`--custom-api-key` 是可选的。如果省略，新手引导会检查 `CUSTOM_API_KEY`。
+
+非交互式 Ollama：
+
+```bash
+quantumclaw onboard --non-interactive \
+  --auth-choice ollama \
+  --custom-base-url "http://ollama-host:11434" \
+  --custom-model-id "qwen3.5:27b" \
+  --accept-risk
+```
+
+`--custom-base-url` 默认为 `http://127.0.0.1:11434`。`--custom-model-id` 是可选的；如果省略，新手引导会使用 Ollama 建议的默认值。像 `kimi-k2.5:cloud` 这样的云端模型 ID 在这里也可用。
+
+将提供商密钥存储为引用而不是明文：
+
+```bash
+quantumclaw onboard --non-interactive \
+  --auth-choice openai-api-key \
+  --secret-input-mode ref \
+  --accept-risk
+```
+
+使用 `--secret-input-mode ref` 时，新手引导会写入由环境变量支持的引用，而不是明文密钥值。
+对于由 auth-profile 支持的提供商，这会写入 `keyRef` 条目；对于自定义提供商，这会将 `models.providers.<id>.apiKey` 写为环境变量引用（例如 `{ source: "env", provider: "default", id: "CUSTOM_API_KEY" }`）。
+
+非交互式 `ref` 模式约定：
+
+- 在新手引导进程环境中设置提供商环境变量（例如 `OPENAI_API_KEY`）。
+- 不要传递内联密钥标志（例如 `--openai-api-key`），除非该环境变量也已设置。
+- 如果传递了内联密钥标志但未设置所需环境变量，新手引导会快速失败并提供指引。
+
+非交互式模式中的 Gateway 网关令牌选项：
+
+- `--gateway-auth token --gateway-token <token>` 存储明文令牌。
+- `--gateway-auth token --gateway-token-ref-env <name>` 将 `gateway.auth.token` 存储为环境变量 SecretRef。
+- `--gateway-token` 和 `--gateway-token-ref-env` 互斥。
+- `--gateway-token-ref-env` 要求在新手引导进程环境中存在一个非空环境变量。
+- 使用 `--install-daemon` 时，当令牌身份验证需要令牌时，由 SecretRef 管理的 Gateway 网关令牌会被验证，但不会以已解析的明文形式持久化到 supervisor 服务环境元数据中。
+- 使用 `--install-daemon` 时，如果令牌模式需要令牌，而配置的令牌 SecretRef 未解析，新手引导会以封闭失败方式终止，并提供修复指引。
+- 使用 `--install-daemon` 时，如果同时配置了 `gateway.auth.token` 和 `gateway.auth.password`，且 `gateway.auth.mode` 未设置，新手引导会阻止安装，直到显式设置 mode。
+
+示例：
+
+```bash
+export QUANTUMCLAW_GATEWAY_TOKEN="your-token"
+quantumclaw onboard --non-interactive \
+  --mode local \
+  --auth-choice skip \
+  --gateway-auth token \
+  --gateway-token-ref-env QUANTUMCLAW_GATEWAY_TOKEN \
+  --accept-risk
+```
+
+非交互式本地 Gateway 网关健康检查：
+
+- 除非你传递 `--skip-health`，否则新手引导会等待本地 Gateway 网关可访问后才成功退出。
+- `--install-daemon` 会先启动受管 Gateway 网关安装路径。不使用它时，你必须已经有一个正在运行的本地 Gateway 网关，例如 `quantumclaw gateway run`。
+- 如果你只想在自动化中写入配置/工作区/bootstrap，请使用 `--skip-health`。
+- 在原生 Windows 上，`--install-daemon` 会先尝试 Scheduled Tasks；如果任务创建被拒绝，则回退到每用户 Startup 文件夹登录项。
+
+带引用模式的交互式新手引导行为：
+
+- 出现提示时，选择**使用密钥引用**。
+- 然后选择以下之一：
+  - 环境变量
+  - 已配置的密钥提供商（`file` 或 `exec`）
+- 新手引导会在保存引用前执行快速预检验证。
+  - 如果验证失败，新手引导会显示错误并让你重试。
+
+非交互式 Z.AI 端点选择：
+
+注意：`--auth-choice zai-api-key` 现在会为你的密钥自动检测最佳 Z.AI 端点（优先使用通用 API 搭配 `zai/glm-5`）。
+如果你明确想使用 GLM Coding Plan 端点，请选择 `zai-coding-global` 或 `zai-coding-cn`。
+
+```bash
+# 无提示端点选择
+quantumclaw onboard --non-interactive \
+  --auth-choice zai-coding-global \
+  --zai-api-key "$ZAI_API_KEY"
+
+# 其他 Z.AI 端点选择：
+# --auth-choice zai-coding-cn
+# --auth-choice zai-global
+# --auth-choice zai-cn
+```
+
+非交互式 Mistral 示例：
+
+```bash
+quantumclaw onboard --non-interactive \
+  --auth-choice mistral-api-key \
+  --mistral-api-key "$MISTRAL_API_KEY"
+```
+
+流程说明：
+
+- `quickstart`：最少提示，自动生成 Gateway 网关令牌。
+- `manual`：提供端口/绑定/身份验证的完整提示（`advanced` 的别名）。
+- 本地新手引导私信范围行为：[CLI 设置参考](/start/wizard-cli-reference#outputs-and-internals)。
+- 最快开始第一次聊天：`quantumclaw dashboard`（控制 UI，无需设置渠道）。
+- 自定义提供商：连接任何兼容 OpenAI 或 Anthropic 的端点，
+  包括未列出的托管提供商。使用 Unknown 进行自动检测。
+
+## 常见后续命令
+
+```bash
+quantumclaw configure
+quantumclaw agents add <name>
+```
+
+<Note>
+`--json` 不代表非交互式模式。脚本请使用 `--non-interactive`。
+</Note>

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

@@ -0,0 +1,28 @@
+---
+read_when:
+  - 你正在使用配对模式私信并需要批准发送者
+summary: "`quantumclaw pairing` 的 CLI 参考（批准/列出配对请求）"
+title: pairing
+x-i18n:
+  generated_at: "2026-02-03T07:45:02Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: e0bc9707294463c95d13e0deb67d834cfad6a105ab44baf4c25592e5de65ddf5
+  source_path: cli/pairing.md
+  workflow: 15
+---
+
+# `quantumclaw pairing`
+
+批准或检查私信配对请求（适用于支持配对的渠道）。
+
+相关内容：
+
+- 配对流程：[配对](/channels/pairing)
+
+## 命令
+
+```bash
+quantumclaw pairing list whatsapp
+quantumclaw pairing approve whatsapp <code> --notify
+```

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

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

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

@@ -0,0 +1,24 @@
+---
+read_when:
+  - 你想在保留 CLI 安装的同时清除本地状态
+  - 你想预览哪些内容会被移除
+summary: "`quantumclaw 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
+---
+
+# `quantumclaw reset`
+
+重置本地配置/状态（保留 CLI 安装）。
+
+```bash
+quantumclaw reset
+quantumclaw reset --dry-run
+quantumclaw reset --scope config+creds+sessions --yes --non-interactive
+```

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

@@ -0,0 +1,158 @@
+---
+read_when: You are managing sandbox containers or debugging sandbox/tool-policy behavior.
+status: active
+summary: 管理沙箱容器并检查生效的沙箱策略
+title: 沙箱 CLI
+x-i18n:
+  generated_at: "2026-02-03T07:45:18Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 6e1186f26c77e188206ce5e198ab624d6b38bc7bb7c06e4d2281b6935c39e347
+  source_path: cli/sandbox.md
+  workflow: 15
+---
+
+# 沙箱 CLI
+
+管理基于 Docker 的沙箱容器，用于隔离智能体执行。
+
+## 概述
+
+QuantumClaw 可以在隔离的 Docker 容器中运行智能体以确保安全。`sandbox` 命令帮助你管理这些容器，特别是在更新或配置更改后。
+
+## 命令
+
+### `quantumclaw sandbox explain`
+
+检查**生效的**沙箱模式/作用域/工作区访问权限、沙箱工具策略和提权门控（附带修复配置的键路径）。
+
+```bash
+quantumclaw sandbox explain
+quantumclaw sandbox explain --session agent:main:main
+quantumclaw sandbox explain --agent work
+quantumclaw sandbox explain --json
+```
+
+### `quantumclaw sandbox list`
+
+列出所有沙箱容器及其状态和配置。
+
+```bash
+quantumclaw sandbox list
+quantumclaw sandbox list --browser  # List only browser containers
+quantumclaw sandbox list --json     # JSON output
+```
+
+**输出包括：**
+
+- 容器名称和状态（运行中/已停止）
+- Docker 镜像及其是否与配置匹配
+- 创建时间
+- 空闲时间（自上次使用以来的时间）
+- 关联的会话/智能体
+
+### `quantumclaw sandbox recreate`
+
+移除沙箱容器以强制使用更新的镜像/配置重新创建。
+
+```bash
+quantumclaw sandbox recreate --all                # Recreate all containers
+quantumclaw sandbox recreate --session main       # Specific session
+quantumclaw sandbox recreate --agent mybot        # Specific agent
+quantumclaw sandbox recreate --browser            # Only browser containers
+quantumclaw sandbox recreate --all --force        # Skip confirmation
+```
+
+**选项：**
+
+- `--all`：重新创建所有沙箱容器
+- `--session <key>`：重新创建特定会话的容器
+- `--agent <id>`：重新创建特定智能体的容器
+- `--browser`：仅重新创建浏览器容器
+- `--force`：跳过确认提示
+
+**重要：** 容器会在智能体下次使用时自动重新创建。
+
+## 使用场景
+
+### 更新 Docker 镜像后
+
+```bash
+# Pull new image
+docker pull quantumclaw-sandbox:latest
+docker tag quantumclaw-sandbox:latest quantumclaw-sandbox:bookworm-slim
+
+# Update config to use new image
+# Edit config: agents.defaults.sandbox.docker.image (or agents.list[].sandbox.docker.image)
+
+# Recreate containers
+quantumclaw sandbox recreate --all
+```
+
+### 更改沙箱配置后
+
+```bash
+# Edit config: agents.defaults.sandbox.* (or agents.list[].sandbox.*)
+
+# Recreate to apply new config
+quantumclaw sandbox recreate --all
+```
+
+### 更改 setupCommand 后
+
+```bash
+quantumclaw sandbox recreate --all
+# or just one agent:
+quantumclaw sandbox recreate --agent family
+```
+
+### 仅针对特定智能体
+
+```bash
+# Update only one agent's containers
+quantumclaw sandbox recreate --agent alfred
+```
+
+## 为什么需要这个？
+
+**问题：** 当你更新沙箱 Docker 镜像或配置时：
+
+- 现有容器继续使用旧设置运行
+- 容器仅在空闲 24 小时后才被清理
+- 经常使用的智能体会无限期保持旧容器运行
+
+**解决方案：** 使用 `quantumclaw sandbox recreate` 强制移除旧容器。它们会在下次需要时自动使用当前设置重新创建。
+
+提示：优先使用 `quantumclaw sandbox recreate` 而不是手动 `docker rm`。它使用 Gateway 网关的容器命名规则，避免在作用域/会话键更改时出现不匹配。
+
+## 配置
+
+沙箱设置位于 `~/.quantumclaw/quantumclaw.json` 的 `agents.defaults.sandbox` 下（每个智能体的覆盖设置在 `agents.list[].sandbox` 中）：
+
+```jsonc
+{
+  "agents": {
+    "defaults": {
+      "sandbox": {
+        "mode": "all", // off, non-main, all
+        "scope": "agent", // session, agent, shared
+        "docker": {
+          "image": "quantumclaw-sandbox:bookworm-slim",
+          "containerPrefix": "quantumclaw-sbx-",
+          // ... more Docker options
+        },
+        "prune": {
+          "idleHours": 24, // Auto-prune after 24h idle
+          "maxAgeDays": 7, // Auto-prune after 7 days
+        },
+      },
+    },
+  },
+}
+```
+
+## 另请参阅
+
+- [沙箱文档](/gateway/sandboxing)
+- [智能体配置](/concepts/agent-workspace)
+- [Doctor 命令](/gateway/doctor) - 检查沙箱设置

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

@@ -0,0 +1,33 @@
+---
+read_when:
+  - 你想对配置/状态运行快速安全审计
+  - 你想应用安全的"修复"建议（chmod、收紧默认值）
+summary: "`quantumclaw security` 的 CLI 参考（审计和修复常见安全隐患）"
+title: security
+x-i18n:
+  generated_at: "2026-02-03T07:45:13Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 19705b0fff848fa6f302b4ed09b7660c64e09048dba517c7f6a833d2db40bebf
+  source_path: cli/security.md
+  workflow: 15
+---
+
+# `quantumclaw security`
+
+安全工具（审计 + 可选修复）。
+
+相关：
+
+- 安全指南：[安全](/gateway/security)
+
+## 审计
+
+```bash
+quantumclaw security audit
+quantumclaw security audit --deep
+quantumclaw 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: "`quantumclaw 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
+---
+
+# `quantumclaw sessions`
+
+列出已存储的对话会话。
+
+```bash
+quantumclaw sessions
+quantumclaw sessions --active 120
+quantumclaw sessions --json
+```

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

@@ -0,0 +1,36 @@
+---
+read_when:
+  - 你正在进行首次运行设置，但不使用完整的 CLI 新手引导
+  - 你想设置默认工作区路径
+summary: "`quantumclaw setup` 的 CLI 参考（初始化配置 + 工作区）"
+title: setup
+x-i18n:
+  generated_at: "2026-03-16T06:21:20Z"
+  model: gpt-5.4
+  provider: openai
+  source_hash: b6d6fef6642a4fdf9880ea4f752981b5ed0404289274ee3429ee31702873e3ea
+  source_path: cli/setup.md
+  workflow: 15
+---
+
+# `quantumclaw setup`
+
+初始化 `~/.quantumclaw/quantumclaw.json` 和智能体工作区。
+
+相关内容：
+
+- 入门指南：[入门指南](/start/getting-started)
+- CLI 新手引导：[CLI 新手引导](/start/wizard)
+
+## 示例
+
+```bash
+quantumclaw setup
+quantumclaw setup --workspace ~/.quantumclaw/workspace
+```
+
+通过 setup 运行新手引导：
+
+```bash
+quantumclaw setup --wizard
+```

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

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

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

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

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

@@ -0,0 +1,63 @@
+---
+read_when:
+  - 你想在不创建 cron 作业的情况下入队系统事件
+  - 你需要启用或禁用心跳
+  - 你想检查系统在线状态条目
+summary: "`quantumclaw system` 的 CLI 参考（系统事件、心跳、在线状态）"
+title: system
+x-i18n:
+  generated_at: "2026-02-03T07:45:23Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 36ae5dbdec327f5a32f7ef44bdc1f161bad69868de62f5071bb4d25a71bfdfe9
+  source_path: cli/system.md
+  workflow: 15
+---
+
+# `quantumclaw system`
+
+Gateway 网关的系统级辅助工具：入队系统事件、控制心跳和查看在线状态。
+
+## 常用命令
+
+```bash
+quantumclaw system event --text "Check for urgent follow-ups" --mode now
+quantumclaw system heartbeat enable
+quantumclaw system heartbeat last
+quantumclaw 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: "`quantumclaw tui` 的 CLI 参考（连接到 Gateway 网关的终端 UI）"
+title: tui
+x-i18n:
+  generated_at: "2026-02-03T07:45:20Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: f0a97d92e08746a9d6a4f31d361ccad9aea4c3dc61cfafb310d88715f61cfb64
+  source_path: cli/tui.md
+  workflow: 15
+---
+
+# `quantumclaw tui`
+
+打开连接到 Gateway 网关的终端 UI。
+
+相关：
+
+- TUI 指南：[TUI](/web/tui)
+
+## 示例
+
+```bash
+quantumclaw tui
+quantumclaw tui --url ws://127.0.0.1:18789 --token <token>
+quantumclaw tui --session main --deliver
+```