Open Claw安装过程指南

我的OpenClaw安装与配置实战

最近在折腾一个叫OpenClaw的工具，想把它的网关服务在Windows上跑起来。整个过程踩了不少坑，也总结了一些经验，今天就来和大家分享一下我的安装与配置全记录。

准备工作：安装Node.js和npm

这算是老生常谈了，OpenClaw是一个Node.js工具，所以第一步肯定是确保你的系统里已经装好了Node.js和npm。如果还没装，去官网下载安装包就行，这里我就不赘述了。

安装OpenClaw：从报错到成功

万事开头难，安装第一步就给了我一个下马威。我按照直觉，执行了官方的安装指令：

npm install -g openclaw@latest

结果立马就报错了，提示找不到这个包。我一看截图，问题出在包名的大小写上。

原来，包名应该是全小写的 openclaw，而不是 OpenClaw。修正指令后继续：

但新的问题又来了，这次是PowerShell的执行策略在“作祟”。为了省事，我直接切换到了传统的命令提示符（CMD）来执行，避开了这个限制。

最后一个拦路虎是网络。npm安装需要从GitHub拉取资源，如果你的网络环境访问GitHub不畅，这里肯定会卡住。我切换到了一个能稳定访问GitHub的网络，安装才得以顺利进行。

核心配置：安装守护进程

安装成功后，接下来就是配置核心的网关守护进程了。运行以下命令：

openclaw onboard --install-daemon

这个过程会引导你进行一些初始设置。我记得当时有一个步骤询问是否切换某些配置，我选择了“No”。

随后就是快速的安装过程。

为了验证安装是否成功，我先临时启动了一下Gateway服务：

openclaw gateway --port 18789

看到服务成功监听在18789端口，心里就踏实了。如果你是通过计划任务安装的守护进程，也可以手动触发它运行：

schtasks /run /tn "\OpenClaw Gateway"

关于API Key

配置过程中可能会需要API Key，我这里记录了一个示例（注意：此为示例，请使用你自己的有效Key）：

sk-V5Df636RfY13qalrQXpop4TYX3xwKDq0rcUuJujxMvPGCD2a

服务管理：启动、停止与重启

日常使用中，我们经常需要操作服务状态。OpenClaw提供了简洁的命令：

• 启动服务：openclaw gateway start
• 停止服务：openclaw gateway stop
• 重启服务：openclaw gateway restart

解决痛点：如何实现开机自启？

最开始，我每次重启电脑都要手动去启动Gateway，这太麻烦了。于是我研究了三种方案：

方案 1：设置为 Windows 服务（推荐）
这是最规范的方法。以管理员身份运行CMD，执行：

openclaw gateway install --port 18789

这会将Gateway注册为一个系统服务，并设置自动启动。

方案 2：添加到开机启动项
如果你不想动系统服务，可以把启动命令的快捷方式放到Windows的“启动”文件夹里。方法简单，但不够优雅。

方案 3：保持现状
如果你的服务器或电脑很少重启，继续手动启动也未尝不可。

我最终选择了方案一，一劳永逸。

灵活调整：如何取消开机自启？

有时候我们可能只需要临时使用，不希望它开机就运行。如果你已经设置了自启，可以按以下方法取消：

方法一：删除 Windows 计划任务

如果是通过计划任务实现的，直接删除它：

schtasks /delete /tn "\OpenClaw Gateway" /f

方法二：卸载 Windows 服务

如果安装成了服务，就用对应的命令卸载（需管理员权限）：

openclaw gateway uninstall

方法三：仅禁用服务（保留配置）

不想删除，只是暂时禁用自动启动可以这样做：

sc config "OpenClaw Gateway" start= disabled
net stop "OpenClaw Gateway"

操作完成后，最好验证一下：

# 查看计划任务
schtasks /query /tn "\OpenClaw Gateway"
# 查看服务状态
sc query "OpenClaw Gateway"

临时启动指南

取消自启后，当我们需要使用时，可以手动临时启动：

# 方式一：直接运行（前台进程）
openclaw gateway --port 18789
# 方式二：运行已注册的计划任务（如果未删除）
schtasks /run /tn "\OpenClaw Gateway"
# 方式三：使用服务管理命令（如果服务未卸载）
openclaw gateway start

命令速查手册

为了方便大家，我把所有常用的状态管理命令汇总在这里：

# 安装服务（开机自启）
openclaw gateway install --port 18789

# 卸载服务（取消自启）
openclaw gateway uninstall

# 启动
openclaw gateway start

# 停止
openclaw gateway stop

# 重启
openclaw gateway restart

# 查看状态
openclaw gateway status

# 临时运行（不安装服务）
openclaw gateway --port 18789

一个小技巧：--force 参数

在安装服务时，如果之前已经存在同名的服务或配置，可能会失败。这时可以尝试加上 --force 参数进行强制安装：

openclaw gateway install --port 18789 --force

这就是我配置OpenClaw Gateway的完整经历了。总的来说，虽然初期在安装和大小写上绕了点弯路，但一旦摸清了它的服务管理逻辑，部署和运维起来还是非常清晰的。希望我的这些经验能帮你少踩一些坑。