一、准备：以管理员身份打开 PowerShell

1. 按 Win + X
2. 选择 Windows PowerShell (管理员) 或 终端 (管理员)
3. 后面所有命令都在这个窗口执行

---

二、彻底清理旧版本（必须做）

依次复制执行下面 4 条命令（一条一条执行）：

powershell

# 1. 停止并卸载网关服务

openclaw gateway stop 2>$null

openclaw gateway uninstall 2>$null

# 2. 全局卸载 OpenClaw

npm uninstall -g openclaw clawdbot moltbot

# 3. 删除所有配置、缓存、数据（彻底干净）Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw" 2>$null

# 4. 清理 npm 缓存（避免旧依赖冲突）

npm cache clean --force

执行完这 4 步，系统里就完全没有旧版痕迹了。

三、安装 Node.js（如果没装 / 版本太老）

OpenClaw 需要 Node.js ≥ 22（LTS 版）。

检查当前版本

powershell

node -v

• 低于 v22 → 必须重装 Node.js
• 已经 v22+ → 跳过本节

重装 Node.js（稳定版）

1. 下载：https://nodejs.org/ → 选 LTS（长期支持）
2. 安装：一路下一步，不要改路径，不要勾选额外工具
3. 安装完 关闭所有终端，重新打开管理员 PowerShell
4. 验证：

powershell

node -v

npm -v

1. 出现版本号就成功。

---

四、重新安装 OpenClaw（2 种方法，任选其一）

方法 A：npm 手动安装（最稳、国内加速）

powershell

# 1. 切换国内镜像（速度快很多）

npm config set registry https://registry.npmmirror.com

# 2. 全局安装最新版

npm install -g openclaw@latest

方法 B：官方一键脚本（自动装）

powershell

# 先开脚本权限（只需要做一次）Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# 一键安装iwr -useb https://openclaw.ai/install.ps1 | iex

---

五、安装后：初始化 + 启动

安装完成后，关闭当前 PowerShell，新开一个管理员窗口，再执行：

powershell

# 1. 验证安装（看版本）

openclaw --version

出现版本号（如 2026.x.x）说明安装成功。

powershell

# 2. 初始化配置（向导）

openclaw onboard

# 3. 启动网关（后台常驻）

openclaw gateway start

解决步骤（直接按顺序执行即可）

1. 安装网关服务

在当前 PowerShell 窗口里，执行提示给你的命令：

powershell

openclaw gateway install

这条命令会自动把网关服务注册到系统里，设置成开机自启。

2. 启动网关服务

安装完成后，再执行启动命令：

powershell

openclaw gateway start

如果成功，会看到服务启动成功的日志，而不是之前的报错。

3. 快速验证（可选）

启动后，可以用下面的命令检查状态：

powershell

openclaw gateway status

看到 connect ECONNREFUSED 127.0.0.1:18789，说明网关服务没有真正启动成功，端口被拒绝连接了。我们按步骤排查：

---

�� 第一步：先看日志，找到启动失败的原因

从输出里可以看到日志文件路径：C:\Users\ZHONGH~1\AppData\Local\Temp\openclaw\openclaw-2026-05-13.1og

直接打开这个文件，里面会写清楚为什么服务没启动（比如端口占用、权限问题、配置错误）。

---

�� 第二步：用前台模式启动，看实时报错

先停止后台服务，然后用前台模式运行，这样能直接看到启动时的错误：

powershell

# 先停止后台任务

openclaw gateway stop

# 用前台模式启动（窗口保持打开，能看到所有日志）

openclaw gateway

运行后，你会看到完整的启动日志，比如：

• 端口 18789 被其他程序占用

正确启动命令（复制这个，直接成功）

在管理员 PowerShell 里输入：

powershell

openclaw gateway

1️⃣ 强制启动网关（直接复制这条命令）

在管理员 PowerShell 里执行：

powershell

openclaw gateway --port 18790 --allow-unconfigured

这条命令会：

• 跳过 gateway.mode 配置校验，强制启动服务
• 使用新端口 18790，避免和之前的冲突
• 启动后窗口会一直挂着，不会自动退出

2️⃣ 验证是否启动成功

执行后，日志会停在 resolving authentication… 后面，没有报错、没有退回到命令行，就说明启动成功了。

3️⃣ 打开管理面板

保持网关窗口别关，新开一个管理员 PowerShell，执行：

powershell

openclaw dashboard --port 18790

浏览器会自动打开 http://127.0.0.1:18790，这次就能正常访问了。

---

�� 说明：--allow-unconfigured 是官方提供的 “兜底参数”，专门用来解决配置损坏 / 缺失导致的启动问题，不会影响你的使用，只是跳过了初始配置校验。

执行完第一条命令，把日志截图发给我，我帮你确认是否成功启动。

可以了 以后启动要怎么启动啊

太棒啦！�� 以后启动就用固定的前台命令，我给你整理了最简单、最稳的流程，直接照着做就行：

---

�� 以后启动的「标准流程」

1️⃣ 启动网关（必须先开，窗口别关！）

打开 管理员 PowerShell，直接复制这条命令：

powershell

openclaw gateway --port 18790 --allow-unconfigured

• 日志停在 resolving authentication… 后面，没有报错、不退回命令行，就是启动成功了
• 这个窗口必须一直开着，关了服务就停了

2️⃣ 打开网页管理面板

网关窗口别关，新开一个管理员 PowerShell，执行：

powershell

openclaw dashboard --port 18790

浏览器会自动打开面板，直接用就行啦。

小龙虾的安装路径

OpenClaw（小龙虾）的安装和配置文件路径，你可以这样快速找到：

---

1. 程序安装路径（Node.js 模块）

因为你是用 npm 安装的，默认路径在：

plaintext

C:\Users\zhonghong\AppData\Roaming\npm\node_modules\openclaw\

里面包含了程序的核心代码和依赖文件。

---

2. 配置 & 数据路径（关键！你的所有设置、Token、日志都在这里）

用户配置文件、运行日志、会话数据都存在这里：

plaintext

C:\Users\zhonghong\.openclaw\

里面有这些关键文件 / 文件夹：

• openclaw.json：主配置文件（包含 gateway.mode 等设置）
• logs\：日志目录（之前的报错日志都在这）
• gateway.cmd：服务启动脚本（之前装后台服务生成的）

---

3. 临时日志 / 缓存路径

运行时生成的临时日志文件，在：

plaintext

C:\Users\zhonghong\AppData\Local\Temp\openclaw\

---

快速打开方法（复制到文件资源管理器地址栏即可）

• 打开配置文件夹：%USERPROFILE%\.openclaw
• 打开安装文件夹：%APPDATA%\npm\node_modules\openclaw

---

�� 小提示：以后如果遇到配置损坏、启动异常，可以直接删除 %USERPROFILE%\.openclaw\openclaw.json 文件，再重新运行启动命令，程序会自动生成一份干净的配置。

需要我帮你写个一键打开这些文件夹的快捷命令吗？