OpenClaw Windows 启动与关闭完全指南

本文档旨在帮助您在 Windows 操作系统上正确启动、关闭以及卸载 OpenClaw，并详细说明端口配置等关键操作。无论您是初次使用还是需要彻底清理环境，均可参考本指南。

📋 目录

[1. 系统要求](#1. 系统要求)
[2. 启动 OpenClaw](#2. 启动 OpenClaw)
- [2.1 启动 Gateway 服务（核心）](#2.1 启动 Gateway 服务（核心）)
- [2.2 启动 Dashboard 操作面板](#2.2 启动 Dashboard 操作面板)
- [2.3 设置开机自启动](#2.3 设置开机自启动)
- [2.4 其他常用命令](#2.4 其他常用命令)
[3. 关闭 OpenClaw](#3. 关闭 OpenClaw)
- [3.1 正常停止服务](#3.1 正常停止服务)
- [3.2 强制终止进程](#3.2 强制终止进程)
- [3.3 禁用开机自启动](#3.3 禁用开机自启动)
[4. 彻底卸载 OpenClaw](#4. 彻底卸载 OpenClaw)
- [4.1 使用官方卸载命令](#4.1 使用官方卸载命令)
- [4.2 通过控制面板卸载](#4.2 通过控制面板卸载)
- [4.3 手动清理残留文件](#4.3 手动清理残留文件)
- [4.4 清理注册表（可选）](#4.4 清理注册表（可选）)
[5. 端口配置详解](#5. 端口配置详解)
- [5.1 指定端口的方法](#5.1 指定端口的方法)
- [5.2 端口优先级规则](#5.2 端口优先级规则)
[6. 常见问题](#6. 常见问题)

1. 系统要求

操作系统：Windows 10 或 Windows 11（64位）
权限：部分操作需要以管理员身份运行 PowerShell 或命令提示符
依赖：OpenClaw 已正确安装（可参考官方安装文档）

2. 启动 OpenClaw

OpenClaw 由两部分组成：后台核心服务 Gateway 和可视化操作面板 Dashboard。启动时需先启动 Gateway，再根据需要启动 Dashboard。

2.1 启动 Gateway 服务（核心）

打开 PowerShell 或 命令提示符（建议右键选择"以管理员身份运行"），执行以下命令：

powershell 复制代码

openclaw gateway --port 18789

--port 18789：指定服务监听的端口。如果省略此参数，将使用默认端口 18789。您也可以自定义其他端口（例如 --port 18888），但需确保端口未被占用。

命令执行后，终端将显示服务启动日志，如看到类似 Gateway is running on http://127.0.0.1:18789 的信息，说明启动成功。

2.2 启动 Dashboard 操作面板

保持 Gateway 服务运行，另开一个终端（无需管理员权限）执行：

powershell 复制代码

openclaw dashboard

该命令会自动在默认浏览器中打开 OpenClaw 的管理界面（通常为 http://127.0.0.1:18789）。您可以通过此界面配置代理、查看任务或与 AI 进行交互。

提示：如果您关闭了浏览器，可以手动访问上述地址重新打开面板。

2.3 设置开机自启动

若希望 OpenClaw 在每次登录 Windows 时自动运行，可安装守护服务（计划任务）：

powershell 复制代码

openclaw onboard --install-daemon

该命令会创建一个名为 OpenClaw Gateway 的计划任务，开机后自动启动 Gateway 服务（使用默认端口 18789）。如需修改自启动时的端口，可在安装前通过配置文件或环境变量设置。

2.4 其他常用命令

查看服务状态 ：openclaw gateway status
重启服务 ：openclaw gateway restart
查看帮助 ：openclaw --help

3. 关闭 OpenClaw

3.1 正常停止服务

在管理员 PowerShell 中执行：

powershell 复制代码

openclaw gateway stop

该命令会优雅地停止 Gateway 服务，释放占用的端口和资源。

3.2 强制终止进程

如果停止命令无响应，可手动结束进程：

打开任务管理器（Ctrl + Shift + Esc）。
在"进程"列表中找到 openclaw.exe 或 node.exe（与 OpenClaw 相关）。
选中进程，点击"结束任务"。

3.3 禁用开机自启动

如果您之前安装了开机自启动，现在想关闭它，请执行以下命令删除计划任务：

powershell 复制代码

schtasks /Delete /F /TN "OpenClaw Gateway"

或通过图形界面操作：

按 Win + R，输入 taskschd.msc 打开"任务计划程序"。
在左侧导航栏选择"任务计划程序库"。
找到 OpenClaw Gateway 任务，右键点击选择"禁用"或"删除"。

4. 彻底卸载 OpenClaw

如需从系统中完全移除 OpenClaw，请按顺序执行以下步骤。

4.1 使用官方卸载命令

在管理员 PowerShell 中执行以下命令（自动停止服务并清理组件）：

powershell 复制代码

openclaw uninstall --all --yes --non-interactive

--all：卸载所有组件
--yes：跳过确认提示
--non-interactive：非交互模式

4.2 通过控制面板卸载

打开"控制面板" > "程序" > "程序和功能"。
在列表中找到 OpenClaw，右键点击选择"卸载"。

4.3 手动清理残留文件

卸载后，建议手动删除以下可能残留的文件夹（将 <你的用户名> 替换为实际用户名）：

主程序安装目录
C:\Program Files\OpenClaw\
C:\Program Files (x86)\OpenClaw\
用户数据目录
C:\Users\<你的用户名>\AppData\Roaming\OpenClaw\
C:\Users\<你的用户名>\AppData\Local\OpenClaw\
启动脚本目录 （隐藏文件夹）
%USERPROFILE%\.openclaw\

可在文件资源管理器地址栏直接粘贴此路径访问。

4.4 清理注册表（可选）

⚠️ 注意：修改注册表有风险，操作前请务必备份注册表或创建系统还原点。

按 Win + R，输入 regedit 打开注册表编辑器。
按 Ctrl + F，搜索 OpenClaw。
找到相关的项（文件夹），右键点击选择"删除"。
按 F3 继续查找下一个，直至搜索完毕。

5. 端口配置详解

5.1 指定端口的方法

OpenClaw 的 Gateway 服务支持通过以下几种方式指定监听端口：

命令行参数 （优先级最高）
openclaw gateway --port 18888

环境变量

powershell 复制代码

$env:OPENCLAW_GATEWAY_PORT=18888
openclaw gateway

配置文件

在 OpenClaw 的配置文件（如 config.yaml）中设置：
yaml 复制代码
```
gateway:
  port: 18888
```
默认值

若以上均未指定，则使用 18789。

5.2 端口优先级规则

端口配置的优先级从高到低为：

命令行 --port 参数
环境变量 OPENCLAW_GATEWAY_PORT
配置文件中的 gateway.port
内置默认值 18789

建议：日常使用直接通过命令行指定端口最为直观；若需长期固定端口，可在环境变量或配置文件中设置。

6. 常见问题

Q1：启动 Gateway 时提示"端口已被占用"怎么办？

A：使用 netstat -ano | findstr :18789 查看占用端口的进程 PID，然后在任务管理器中结束该进程，或更换其他端口启动 OpenClaw。

Q2：Dashboard 无法打开网页？

A：确认 Gateway 已成功启动且端口正确；检查防火墙是否阻止了该端口，可尝试暂时关闭防火墙测试。

Q3：如何在不安装的情况下临时使用 OpenClaw？

A：OpenClaw 通常为免安装版本，直接解压后即可运行命令。确保已将 OpenClaw 所在目录添加到系统 PATH 环境变量，或直接在解压目录下打开终端执行命令。

Q4：开机自启动设置后未生效？

A：检查计划任务是否被安全软件禁用；可手动运行计划任务测试，或在任务计划程序中查看"触发条件"是否正确（应设置为"用户登录时"）。

如发现文档与您使用的 OpenClaw 版本存在差异，请以官方最新文档为准。