@gguf/claw 2026.2.1 → 2026.2.3

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

@@ -0,0 +1,128 @@
+---
+read_when:
+  - 你想了解 `openclaw.ai/install.sh` 的工作机制
+  - 你想自动化安装（CI / 无头环境）
+  - 你想从 GitHub 检出安装
+summary: 安装器脚本的工作原理（install.sh + install-cli.sh）、参数和自动化
+title: 安装器内部机制
+x-i18n:
+  generated_at: "2026-02-01T21:07:55Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 9e0a19ecb5da0a395030e1ccf0d4bedf16b83946b3432c5399d448fe5d298391
+  source_path: install/installer.md
+  workflow: 14
+---
+
+# 安装器内部机制
+
+OpenClaw 提供两个安装器脚本（托管在 `openclaw.ai`）：
+
+- `https://openclaw.ai/install.sh` — "推荐"安装器（默认全局 npm 安装；也可从 GitHub 检出安装）
+- `https://openclaw.ai/install-cli.sh` — 无需 root 权限的 CLI 安装器（安装到带有独立 Node 的前缀目录）
+- `https://openclaw.ai/install.ps1` — Windows PowerShell 安装器（默认 npm；可选 git 安装）
+
+查看当前参数/行为，运行：
+
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
+```
+
+Windows (PowerShell) 帮助：
+
+```powershell
+& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -?
+```
+
+如果安装器完成但在新终端中找不到 `openclaw`，通常是 Node/npm PATH 问题。参见：[安装](/install#nodejs--npm-path-sanity)。
+
+## install.sh（推荐）
+
+功能概述：
+
+- 检测操作系统（macOS / Linux / WSL）。
+- 确保 Node.js **22+**（macOS 通过 Homebrew；Linux 通过 NodeSource）。
+- 选择安装方式：
+  - `npm`（默认）：`npm install -g openclaw@latest`
+  - `git`：克隆/构建源码检出并安装包装脚本
+- 在 Linux 上：必要时将 npm 前缀切换到 `~/.npm-global`，以避免全局 npm 权限错误。
+- 如果是升级现有安装：运行 `openclaw doctor --non-interactive`（尽力执行）。
+- 对于 git 安装：安装/更新后运行 `openclaw doctor --non-interactive`（尽力执行）。
+- 通过默认设置 `SHARP_IGNORE_GLOBAL_LIBVIPS=1` 来缓解 `sharp` 原生安装问题（避免使用系统 libvips 编译）。
+
+如果你*希望* `sharp` 链接到全局安装的 libvips（或你正在调试），请设置：
+
+```bash
+SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL https://openclaw.ai/install.sh | bash
+```
+
+### 可发现性 / "git 安装"提示
+
+如果你在**已有的 OpenClaw 源码检出目录中**运行安装器（通过 `package.json` + `pnpm-workspace.yaml` 检测），它会提示：
+
+- 更新并使用此检出（`git`）
+- 或迁移到全局 npm 安装（`npm`）
+
+在非交互式上下文中（无 TTY / `--no-prompt`），你必须传入 `--install-method git|npm`（或设置 `OPENCLAW_INSTALL_METHOD`），否则脚本将以退出码 `2` 退出。
+
+### 为什么需要 Git
+
+`--install-method git` 路径（克隆 / 拉取）需要 Git。
+
+对于 `npm` 安装，Git *通常*不是必需的，但某些环境仍然需要它（例如通过 git URL 获取软件包或依赖时）。安装器目前会确保 Git 存在，以避免在全新发行版上出现 `spawn git ENOENT` 错误。
+
+### 为什么在全新 Linux 上 npm 会报 `EACCES`
+
+在某些 Linux 设置中（尤其是通过系统包管理器或 NodeSource 安装 Node 后），npm 的全局前缀指向 root 拥有的位置。此时 `npm install -g ...` 会报 `EACCES` / `mkdir` 权限错误。
+
+`install.sh` 通过将前缀切换到以下位置来缓解此问题：
+
+- `~/.npm-global`（并在存在时将其添加到 `~/.bashrc` / `~/.zshrc` 的 `PATH` 中）
+
+## install-cli.sh（无需 root 权限的 CLI 安装器）
+
+此脚本将 `openclaw` 安装到前缀目录（默认：`~/.openclaw`），同时在该前缀下安装专用的 Node 运行时，因此可以在不想改动系统 Node/npm 的机器上使用。
+
+帮助：
+
+```bash
+curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --help
+```
+
+## install.ps1（Windows PowerShell）
+
+功能概述：
+
+- 确保 Node.js **22+**（winget/Chocolatey/Scoop 或手动安装）。
+- 选择安装方式：
+  - `npm`（默认）：`npm install -g openclaw@latest`
+  - `git`：克隆/构建源码检出并安装包装脚本
+- 在升级和 git 安装时运行 `openclaw doctor --non-interactive`（尽力执行）。
+
+示例：
+
+```powershell
+iwr -useb https://openclaw.ai/install.ps1 | iex
+```
+
+```powershell
+iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git
+```
+
+```powershell
+iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\\openclaw"
+```
+
+环境变量：
+
+- `OPENCLAW_INSTALL_METHOD=git|npm`
+- `OPENCLAW_GIT_DIR=...`
+
+Git 要求：
+
+如果你选择 `-InstallMethod git` 但未安装 Git，安装器会打印 Git for Windows 的链接（`https://git-scm.com/download/win`）并退出。
+
+常见 Windows 问题：
+
+- **npm error spawn git / ENOENT**：安装 Git for Windows 并重新打开 PowerShell，然后重新运行安装器。
+- **"openclaw" 不是可识别的命令**：你的 npm 全局 bin 文件夹不在 PATH 中。大多数系统使用 `%AppData%\\npm`。你也可以运行 `npm config get prefix` 并将 `\\bin` 添加到 PATH，然后重新打开 PowerShell。

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

@@ -0,0 +1,199 @@
+---
+read_when:
+  - 你正在将 OpenClaw 迁移到新的笔记本/服务器
+  - 你想保留会话、认证和渠道登录状态（WhatsApp 等）
+summary: 将 OpenClaw 安装从一台机器迁移到另一台
+title: 迁移指南
+x-i18n:
+  generated_at: "2026-02-01T21:08:21Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 604d862c4bf86e7924d09028db8cc2514ca6f1d64ebe8bb7d1e2dde57ef70caa
+  source_path: install/migrating.md
+  workflow: 14
+---
+
+# 将 OpenClaw 迁移到新机器
+
+本指南介绍如何将 OpenClaw Gateway网关从一台机器迁移到另一台，**无需重新进行新手引导**。
+
+迁移在概念上很简单：
+
+- 复制**状态目录**（`$OPENCLAW_STATE_DIR`，默认：`~/.openclaw/`）— 包含配置、认证、会话和渠道状态。
+- 复制你的**工作区**（默认 `~/.openclaw/workspace/`）— 包含你的智能体文件（记忆、提示词等）。
+
+但在**配置文件**、**权限**和**不完整复制**方面有一些常见的坑。
+
+## 开始之前（你要迁移什么）
+
+### 1) 确认你的状态目录
+
+大多数安装使用默认路径：
+
+- **状态目录：** `~/.openclaw/`
+
+但如果你使用了以下选项，路径可能不同：
+
+- `--profile <name>`（通常变为 `~/.openclaw-<profile>/`）
+- `OPENCLAW_STATE_DIR=/some/path`
+
+如果不确定，在**旧**机器上运行：
+
+```bash
+openclaw status
+```
+
+在输出中查找 `OPENCLAW_STATE_DIR` / profile 的相关信息。如果你运行了多个 Gateway网关，请对每个配置文件重复操作。
+
+### 2) 确认你的工作区
+
+常见默认路径：
+
+- `~/.openclaw/workspace/`（推荐工作区）
+- 你创建的自定义文件夹
+
+你的工作区是 `MEMORY.md`、`USER.md` 和 `memory/*.md` 等文件所在的位置。
+
+### 3) 了解你将保留什么
+
+如果你**同时**复制状态目录和工作区，你将保留：
+
+- Gateway网关配置（`openclaw.json`）
+- 认证配置 / API 密钥 / OAuth 令牌
+- 会话历史 + 智能体状态
+- 渠道状态（例如 WhatsApp 登录/会话）
+- 你的工作区文件（记忆、Skills 笔记等）
+
+如果你**只**复制工作区（例如通过 Git），你将**不会**保留：
+
+- 会话
+- 凭据
+- 渠道登录状态
+
+这些存储在 `$OPENCLAW_STATE_DIR` 下。
+
+## 迁移步骤（推荐）
+
+### 步骤 0 — 备份（旧机器）
+
+在**旧**机器上，先停止 Gateway网关以确保复制过程中文件不会变动：
+
+```bash
+openclaw gateway stop
+```
+
+（可选但推荐）归档状态目录和工作区：
+
+```bash
+# 如果使用了配置文件或自定义路径，请调整路径
+cd ~
+tar -czf openclaw-state.tgz .openclaw
+
+tar -czf openclaw-workspace.tgz .openclaw/workspace
+```
+
+如果你有多个配置文件/状态目录（例如 `~/.openclaw-main`、`~/.openclaw-work`），请分别归档。
+
+### 步骤 1 — 在新机器上安装 OpenClaw
+
+在**新**机器上安装 CLI（如有需要也安装 Node）：
+
+- 参见：[安装](/install)
+
+在此阶段，新手引导创建一个全新的 `~/.openclaw/` 是没问题的 — 你将在下一步覆盖它。
+
+### 步骤 2 — 将状态目录 + 工作区复制到新机器
+
+**同时**复制：
+
+- `$OPENCLAW_STATE_DIR`（默认 `~/.openclaw/`）
+- 你的工作区（默认 `~/.openclaw/workspace/`）
+
+常用方法：
+
+- 通过 `scp` 传输压缩包并解压
+- 通过 SSH 使用 `rsync -a`
+- 外部存储设备
+
+复制后确保：
+
+- 隐藏目录已包含在内（例如 `.openclaw/`）
+- 文件所有权对于运行 Gateway网关的用户是正确的
+
+### 步骤 3 — 运行 Doctor（迁移 + 服务修复）
+
+在**新**机器上：
+
+```bash
+openclaw doctor
+```
+
+Doctor 是"安全可靠"的命令。它会修复服务、应用配置迁移并警告不匹配的问题。
+
+然后：
+
+```bash
+openclaw gateway restart
+openclaw status
+```
+
+## 常见的坑（及如何避免）
+
+### 坑：配置文件 / 状态目录不匹配
+
+如果旧 Gateway网关使用了配置文件（或 `OPENCLAW_STATE_DIR`），而新 Gateway网关使用了不同的路径，你会看到以下症状：
+
+- 配置更改不生效
+- 渠道缺失 / 已登出
+- 会话历史为空
+
+修复：使用与迁移相同的配置文件/状态目录来运行 Gateway网关/服务，然后重新运行：
+
+```bash
+openclaw doctor
+```
+
+### 坑：只复制了 `openclaw.json`
+
+`openclaw.json` 是不够的。许多提供商将状态存储在：
+
+- `$OPENCLAW_STATE_DIR/credentials/`
+- `$OPENCLAW_STATE_DIR/agents/<agentId>/...`
+
+始终迁移整个 `$OPENCLAW_STATE_DIR` 文件夹。
+
+### 坑：权限 / 所有权
+
+如果你以 root 身份复制或更换了用户，Gateway网关可能无法读取凭据/会话。
+
+修复：确保状态目录 + 工作区的所有者是运行 Gateway网关的用户。
+
+### 坑：在远程/本地模式之间迁移
+
+- 如果你的界面（WebUI/TUI）指向**远程** Gateway网关，则远程主机拥有会话存储 + 工作区。
+- 迁移你的笔记本不会移动远程 Gateway网关的状态。
+
+如果你处于远程模式，请迁移 **Gateway网关主机**。
+
+### 坑：备份中的密钥
+
+`$OPENCLAW_STATE_DIR` 包含密钥（API 密钥、OAuth 令牌、WhatsApp 凭据）。请将备份视为生产密钥：
+
+- 加密存储
+- 避免通过不安全的渠道传输
+- 如果怀疑泄露，请轮换密钥
+
+## 验证清单
+
+在新机器上确认：
+
+- `openclaw status` 显示 Gateway网关正在运行
+- 你的渠道仍然处于连接状态（例如 WhatsApp 无需重新配对）
+- 仪表盘可以打开并显示现有会话
+- 你的工作区文件（记忆、配置）已存在
+
+## 相关内容
+
+- [Doctor](/gateway/doctor)
+- [Gateway网关故障排除](/gateway/troubleshooting)
+- [OpenClaw 将数据存储在哪里？](/help/faq#where-does-openclaw-store-its-data)

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

@@ -0,0 +1,103 @@
+---
+read_when:
+  - 你想要可复现、可回滚的安装方式
+  - 你已经在使用 Nix/NixOS/Home Manager
+  - 你想要一切固定且声明式管理
+summary: 使用 Nix 声明式安装 OpenClaw
+title: Nix
+x-i18n:
+  generated_at: "2026-02-01T21:08:16Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: f1452194cfdd74613b5b3ab90b0d506eaea2d16b147497987710d6ad658312ba
+  source_path: install/nix.md
+  workflow: 14
+---
+
+# Nix 安装
+
+使用 Nix 运行 OpenClaw 的推荐方式是通过 **[nix-openclaw](https://github.com/openclaw/nix-openclaw)** — 一个开箱即用的 Home Manager 模块。
+
+## 快速开始
+
+将以下内容粘贴给你的 AI 智能体（Claude、Cursor 等）：
+
+```text
+I want to set up nix-openclaw on my Mac.
+Repository: github:openclaw/nix-openclaw
+
+What I need you to do:
+1. Check if Determinate Nix is installed (if not, install it)
+2. Create a local flake at ~/code/openclaw-local using templates/agent-first/flake.nix
+3. Help me create a Telegram bot (@BotFather) and get my chat ID (@userinfobot)
+4. Set up secrets (bot token, Anthropic key) - plain files at ~/.secrets/ is fine
+5. Fill in the template placeholders and run home-manager switch
+6. Verify: launchd running, bot responds to messages
+
+Reference the nix-openclaw README for module options.
+```
+
+> **📦 完整指南：[github.com/openclaw/nix-openclaw](https://github.com/openclaw/nix-openclaw)**
+>
+> nix-openclaw 仓库是 Nix 安装的权威来源。本页仅为简要概览。
+
+## 你将获得
+
+- Gateway网关 + macOS 应用 + 工具（whisper、spotify、cameras）— 全部固定版本
+- 可在重启后保持运行的 Launchd 服务
+- 带声明式配置的插件系统
+- 即时回滚：`home-manager switch --rollback`
+
+---
+
+## Nix 模式运行时行为
+
+当设置了 `OPENCLAW_NIX_MODE=1` 时（nix-openclaw 会自动设置）：
+
+OpenClaw 支持 **Nix 模式**，使配置具有确定性并禁用自动安装流程。
+通过导出以下环境变量启用：
+
+```bash
+OPENCLAW_NIX_MODE=1
+```
+
+在 macOS 上，GUI 应用不会自动继承 shell 环境变量。你也可以
+通过 defaults 启用 Nix 模式：
+
+```bash
+defaults write bot.molt.mac openclaw.nixMode -bool true
+```
+
+### 配置 + 状态路径
+
+OpenClaw 从 `OPENCLAW_CONFIG_PATH` 读取 JSON5 配置，并将可变数据存储在 `OPENCLAW_STATE_DIR` 中。
+
+- `OPENCLAW_STATE_DIR`（默认：`~/.openclaw`）
+- `OPENCLAW_CONFIG_PATH`（默认：`$OPENCLAW_STATE_DIR/openclaw.json`）
+
+在 Nix 下运行时，请将这些路径显式设置为 Nix 管理的位置，以便运行时状态和配置
+不会进入不可变存储。
+
+### Nix 模式下的运行时行为
+
+- 自动安装和自我变更流程被禁用
+- 缺失依赖会显示 Nix 特定的修复建议
+- UI 在启用时会显示只读的 Nix 模式横幅
+
+## 打包说明（macOS）
+
+macOS 打包流程需要一个稳定的 Info.plist 模板，位于：
+
+```
+apps/macos/Sources/OpenClaw/Resources/Info.plist
+```
+
+[`scripts/package-mac-app.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/package-mac-app.sh) 将此模板复制到应用包中并修补动态字段
+（bundle ID、版本/构建号、Git SHA、Sparkle 密钥）。这使得 plist 对 SwiftPM
+打包和 Nix 构建保持确定性（它们不依赖完整的 Xcode 工具链）。
+
+## 相关内容
+
+- [nix-openclaw](https://github.com/openclaw/nix-openclaw) — 完整设置指南
+- [向导](/start/wizard) — 非 Nix 的 CLI 设置
+- [Docker](/install/docker) — 容器化设置

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

@@ -0,0 +1,85 @@
+---
+read_when:
+  - 你已安装 OpenClaw 但 `openclaw` 提示"command not found"
+  - 你正在新机器上配置 Node.js/npm
+  - npm install -g ... 因权限或 PATH 问题失败
+summary: Node.js + npm 安装完整性检查：版本、PATH 及全局安装
+title: Node.js + npm（PATH 安装完整性检查）
+x-i18n:
+  generated_at: "2026-02-01T21:16:20Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 9f6d83be362e3e148ddf07d47e57c51679c22687263d3b5131cccbef2e37c598
+  source_path: install/node.md
+  workflow: 15
+---
+
+# Node.js + npm（PATH 安装完整性检查）
+
+OpenClaw 的运行时基线要求为 **Node 22+**。
+
+如果你能运行 `npm install -g openclaw@latest`，但之后看到 `openclaw: command not found`，这几乎总是 **PATH** 问题：npm 存放全局二进制文件的目录不在你 shell 的 PATH 中。
+
+## 快速诊断
+
+运行：
+
+```bash
+node -v
+npm -v
+npm prefix -g
+echo "$PATH"
+```
+
+如果 `$(npm prefix -g)/bin`（macOS/Linux）或 `$(npm prefix -g)`（Windows）**未出现**在 `echo "$PATH"` 的输出中，你的 shell 就无法找到全局 npm 二进制文件（包括 `openclaw`）。
+
+## 修复：将 npm 的全局 bin 目录添加到 PATH
+
+1. 查找你的全局 npm 前缀：
+
+```bash
+npm prefix -g
+```
+
+2. 将全局 npm bin 目录添加到你的 shell 启动文件中：
+
+- zsh：`~/.zshrc`
+- bash：`~/.bashrc`
+
+示例（将路径替换为你的 `npm prefix -g` 输出）：
+
+```bash
+# macOS / Linux
+export PATH="/path/from/npm/prefix/bin:$PATH"
+```
+
+然后打开一个**新终端**（或在 zsh 中运行 `rehash` / 在 bash 中运行 `hash -r`）。
+
+在 Windows 上，将 `npm prefix -g` 的输出添加到你的 PATH 中。
+
+## 修复：避免 `sudo npm install -g` / 权限错误（Linux）
+
+如果 `npm install -g ...` 因 `EACCES` 失败，请将 npm 的全局前缀切换到用户可写的目录：
+
+```bash
+mkdir -p "$HOME/.npm-global"
+npm config set prefix "$HOME/.npm-global"
+export PATH="$HOME/.npm-global/bin:$PATH"
+```
+
+将 `export PATH=...` 这一行持久化到你的 shell 启动文件中。
+
+## 推荐的 Node 安装方式
+
+如果 Node/npm 的安装方式满足以下条件，你将遇到最少的问题：
+
+- 保持 Node 更新（22+）
+- 使全局 npm bin 目录稳定且在新 shell 中位于 PATH 中
+
+常见选择：
+
+- macOS：Homebrew（`brew install node`）或版本管理器
+- Linux：你偏好的版本管理器，或提供 Node 22+ 的发行版支持的安装方式
+- Windows：官方 Node 安装程序、`winget` 或 Windows Node 版本管理器
+
+如果你使用版本管理器（nvm/fnm/asdf 等），请确保它在你日常使用的 shell（zsh 或 bash）中已初始化，这样它设置的 PATH 在你运行安装程序时才会生效。

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

@@ -0,0 +1,135 @@
+---
+read_when:
+  - 你想从机器上移除 OpenClaw
+  - 卸载后 Gateway网关服务仍在运行
+summary: 完全卸载 OpenClaw（CLI、服务、状态、工作区）
+title: 卸载
+x-i18n:
+  generated_at: "2026-02-01T21:16:21Z"
+  model: claude-opus-4-5
+  provider: pi
+  source_hash: 6673a755c5e1f90a807dd8ac92a774cff6d1bc97d125c75e8bf72a40e952a777
+  source_path: install/uninstall.md
+  workflow: 15
+---
+
+# 卸载
+
+两种方式：
+
+- **简易方式**：`openclaw` 仍已安装时使用。
+- **手动移除服务**：CLI 已删除但服务仍在运行时使用。
+
+## 简易方式（CLI 仍已安装）
+
+推荐：使用内置卸载程序：
+
+```bash
+openclaw uninstall
+```
+
+非交互模式（自动化 / npx）：
+
+```bash
+openclaw uninstall --all --yes --non-interactive
+npx -y openclaw uninstall --all --yes --non-interactive
+```
+
+手动步骤（效果相同）：
+
+1. 停止 Gateway网关服务：
+
+```bash
+openclaw gateway stop
+```
+
+2. 卸载 Gateway网关服务（launchd/systemd/schtasks）：
+
+```bash
+openclaw gateway uninstall
+```
+
+3. 删除状态和配置：
+
+```bash
+rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
+```
+
+如果你将 `OPENCLAW_CONFIG_PATH` 设置为状态目录之外的自定义位置，请同时删除该文件。
+
+4. 删除工作区（可选，会移除智能体文件）：
+
+```bash
+rm -rf ~/.openclaw/workspace
+```
+
+5. 移除 CLI 安装（选择你使用的方式）：
+
+```bash
+npm rm -g openclaw
+pnpm remove -g openclaw
+bun remove -g openclaw
+```
+
+6. 如果你安装了 macOS 应用：
+
+```bash
+rm -rf /Applications/OpenClaw.app
+```
+
+注意事项：
+
+- 如果你使用了配置文件（`--profile` / `OPENCLAW_PROFILE`），请对每个状态目录重复步骤 3（默认为 `~/.openclaw-<profile>`）。
+- 在远程模式下，状态目录位于 **Gateway网关主机**上，因此也需要在那里执行步骤 1-4。
+
+## 手动移除服务（CLI 未安装）
+
+当 Gateway网关服务持续运行但 `openclaw` 已不存在时使用此方式。
+
+### macOS (launchd)
+
+默认标签为 `bot.molt.gateway`（或 `bot.molt.<profile>`；旧版 `com.openclaw.*` 可能仍然存在）：
+
+```bash
+launchctl bootout gui/$UID/bot.molt.gateway
+rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
+```
+
+如果你使用了配置文件，请将标签和 plist 名称替换为 `bot.molt.<profile>`。如存在旧版 `com.openclaw.*` plist 文件，请一并移除。
+
+### Linux（systemd 用户单元）
+
+默认单元名称为 `openclaw-gateway.service`（或 `openclaw-gateway-<profile>.service`）：
+
+```bash
+systemctl --user disable --now openclaw-gateway.service
+rm -f ~/.config/systemd/user/openclaw-gateway.service
+systemctl --user daemon-reload
+```
+
+### Windows（计划任务）
+
+默认任务名称为 `OpenClaw Gateway网关`（或 `OpenClaw Gateway网关 (<profile>)`）。
+任务脚本位于你的状态目录下。
+
+```powershell
+schtasks /Delete /F /TN "OpenClaw Gateway网关"
+Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
+```
+
+如果你使用了配置文件，请删除对应的任务名称和 `~\.openclaw-<profile>\gateway.cmd`。
+
+## 常规安装与源码检出
+
+### 常规安装（install.sh / npm / pnpm / bun）
+
+如果你使用了 `https://openclaw.ai/install.sh` 或 `install.ps1`，CLI 是通过 `npm install -g openclaw@latest` 安装的。
+使用 `npm rm -g openclaw` 移除（如果你使用的是其他方式，则用 `pnpm remove -g` / `bun remove -g`）。
+
+### 源码检出（git clone）
+
+如果你从仓库检出运行（`git clone` + `openclaw ...` / `bun run openclaw ...`）：
+
+1. 在删除仓库**之前**先卸载 Gateway网关服务（使用上述简易方式或手动移除服务）。
+2. 删除仓库目录。
+3. 按上述方式移除状态和工作区。