OpenClaw Windows 启动与关闭全流程

OpenClaw Windows 启动与关闭完全指南

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

1. 系统要求

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

2. 启动 OpenClaw

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

2.1 启动 Gateway 服务（核心）

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

openclaw gateway --port 18789

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

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

2.2 启动 Dashboard 操作面板

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

openclaw dashboard

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

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

2.3 设置开机自启动

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

openclaw onboard --install-daemon

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

2.4 其他常用命令

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

3. 关闭 OpenClaw

3.1 正常停止服务

在管理员 PowerShell 中执行：

openclaw gateway stop

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

3.2 强制终止进程

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

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

3.3 禁用开机自启动

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

schtasks /Delete /F /TN "OpenClaw Gateway"

或通过图形界面操作：

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

4. 彻底卸载 OpenClaw

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

4.1 使用官方卸载命令

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

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

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

4.2 通过控制面板卸载

1. 打开“控制面板” > “程序” > “程序和功能”。
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 清理注册表（可选）

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

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

5. 端口配置详解

5.1 指定端口的方法

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

• 命令行参数（优先级最高）
• openclaw gateway --port 18888
• 环境变量

$env:OPENCLAW_GATEWAY_PORT=18888
openclaw gateway

• 配置文件
• 在 OpenClaw 的配置文件（如 config.yaml）中设置：

gateway:
  port: 18888

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

5.2 端口优先级规则

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

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

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

6. 常见问题

Q1：启动 Gateway 时提示“端口已被占用”怎么办？
A：使用 netstat -ano | findstr :18789 查看占用端口的进程 PID，然后在任务管理器中结束该进程，或更换其他端口启动 OpenClaw。

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

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

Q4：开机自启动设置后未生效？
A：检查计划任务是否被安全软件禁用；可手动运行计划任务测试，或在任务计划程序中查看“触发条件”是否正确（应设置为“用户登录时”）。

© 2026 OpenClaw Windows 使用指南 | 更新日期：2026-03-19
如发现文档与您使用的 OpenClaw 版本存在差异，请以官方最新文档为准。

到此这篇关于OpenClaw Windows 启动与关闭全流程的文章就介绍到这了,更多相关OpenClaw Windows 启动内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论