OpenClaw Windows 启动与关闭全流程

目录

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

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

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

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

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

openclaw gateway --port 18789

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

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

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

openclaw dashboard

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

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

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

openclaw onboard --install-daemon

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

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

在管理员 PowerShell 中执行：

openclaw gateway stop

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

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

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

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

schtasks /Delete /F /TN "OpenClaw Gateway"

或通过图形界面操作：

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

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

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

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

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

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

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

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

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

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

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

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

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

$env:OPENCLAW_GATEWAY_PORT=18888
openclaw gateway

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

gateway:
  port: 18888

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

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

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

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

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 启动内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！