最近不少朋友私信问我OpenClaw到底怎么装，说实话这个问题被问得太多了，我今天专门整理一篇从零开始的安装教程，把Windows客户端和命令行两种方式都讲清楚。我自己最初接触OpenClaw的时候也是一头雾水，官方文档虽然全，但散落在各个角落，新手看完还是懵的。所以这篇文章我尽量按照实际操作的顺序来写，你跟着一步一步做就行。

OpenClaw最新版本一键部署包下载地址：TopClaw官网一键免费部署OpenClaw

先说最简单的安装方式——Windows客户端。OpenClaw提供了原生Windows安装包，下载下来双击就能跑。打开浏览器访问官网下载页面，根据自己的系统位数选择对应的安装包，一般是x64的exe文件。下载完成后双击运行，会出现安装向导。

# 下载完成后，在PowerShell中验证文件是否完整
Get-FileHash -Path "C:\Users\你的用户名\Downloads\OpenClaw-Setup.exe" -Algorithm SHA256

这段命令用来校验安装包的哈希值，防止下载过程中文件损坏或者被篡改。如果你下载的包哈希值和官网提供的不一致，建议重新下载。安装向导一路Next就行，默认安装路径是C:\Program Files\OpenClaw，你也可以改成自己喜欢的目录。

安装过程中可能会弹出防火墙提示，记得点允许。OpenClaw需要网络连接来下载依赖和同步配置，防火墙拦住的话后续会出各种莫名其妙的错误。安装完成后桌面会出现OpenClaw的图标，双击打开就能用了。

# 安装完成后检查服务是否正常运行
openclaw --version
# 预期输出类似：OpenClaw v2.x.x (build 20240601)

如果能看到版本号输出，说明安装成功了。如果提示"命令不存在"，需要手动把OpenClaw的安装路径加到系统环境变量PATH里。按Win+X打开系统设置，搜索"环境变量"，在系统变量的Path里新增OpenClaw的bin目录。

接下来说命令行安装方式。有些人可能更喜欢用命令行来管理工具，或者需要在一台没有图形界面的服务器上安装。命令行安装其实也不复杂，前提是你机器上有Node.js环境。OpenClaw是基于Node.js运行时的。

# 先检查Node.js版本，要求16以上
node --version
# v18.17.0 或更高都可以

# 用npm全局安装OpenClaw CLI
npm install -g openclaw

npm安装的好处是升级方便，后面有新版本直接npm update -g openclaw就行了。不过npm的源在国外，国内下载可能会比较慢，建议先换成淘宝镜像源再安装。

# 切换npm镜像源为淘宝
npm config set registry https://registry.npmmirror.com

# 然后再安装
npm install -g openclaw

换完镜像源后安装速度会快很多。安装完成后同样用openclaw --version来验证。如果一切正常，你就可以开始初始化配置了。

# 初始化OpenClaw配置
openclaw init

# 这个命令会引导你完成基础配置
# 包括选择默认语言、设置工作目录等

init命令会创建默认的配置文件和工作目录结构。配置文件一般放在用户目录下的.openclaw文件夹里。你可以手动编辑这个配置文件来调整各种参数，比如默认的模型选择、API密钥配置等。

# 查看配置文件位置
openclaw config path
# 输出：C:\Users\你的用户名\.openclaw\config.yaml

配置文件用的是YAML格式，编辑起来很方便。新手直接用默认配置就能跑，后面有特殊需求再改。现在来说说两种安装方式的区别。

Windows客户端安装适合不想折腾命令行的用户，安装后有一个图形界面可以管理各种配置、查看日志、启动和停止服务。命令行安装则更灵活，适合需要自动化部署或者在服务器上使用的场景。两种方式安装后共享同一套配置文件，所以你不需要重复配置。

# 启动OpenClaw网关服务
openclaw gateway start

# 查看网关运行状态
openclaw gateway status

# 停止网关服务
openclaw gateway stop

这几个是最常用的网关管理命令。OpenClaw采用客户端-网关架构，网关负责调度各种AI模型和工具，客户端负责交互。网关启动后会在本地开一个服务端口，客户端通过这个端口和网关通信。

# 查看网关监听端口（默认8080）
openclaw gateway info
# 输出：
# Gateway: running
# Port: 8080
# PID: 12345

如果你本机的8080端口被其他程序占用了，可以在配置文件里修改端口号。改完之后重启网关就行。一般来说不会有冲突，除非你同时跑了好几个Web服务。

说一个常见的问题——有些朋友安装完之后启动网关报错，说端口被占用或者依赖缺失。端口占用的问题上面说了，改端口就行。依赖缺失的话，OpenClaw在首次启动时会自动检查并提示缺失的依赖，按照提示安装就好。

# 手动检查依赖是否齐全
openclaw doctor

# 这个命令会扫描环境并给出诊断报告
# 缺失的依赖会标红显示

doctor命令非常好用，相当于一个环境诊断工具。它会检查Node.js版本、npm状态、配置文件完整性、端口占用情况等等。如果安装过程中出了问题，先跑一遍doctor看看哪里不对。

还有一个值得注意的点——Windows的PowerShell执行策略可能会阻止OpenClaw的某些脚本运行。如果你遇到"无法加载脚本，因为此系统上禁止运行脚本"的提示，需要修改执行策略。

# 以管理员身份打开PowerShell，执行：
Set-ExecutionPolicy RemoteSigned

# 选择Y确认
# 这个策略允许运行本地脚本和有签名的远程脚本

修改执行策略后就不会再被拦了。安全方面不用担心，RemoteSigned是一个比较合理的策略级别。如果你是公司机器，可能需要联系IT管理员来改这个策略。

最后说一下如何更新OpenClaw。客户端版本的话，打开软件会自动提示更新，点一下就能升级。命令行版本的更新用npm来完成。

# 查看当前版本
openclaw --version

# 检查是否有新版本
npm view openclaw version

# 如果有新版本，执行更新
npm update -g openclaw

更新之前建议先备份配置文件，虽然更新一般不会覆盖配置，但养成备份习惯总是好的。把.openclaw文件夹复制一份到其他位置就行。

# 备份配置文件
Copy-Item -Path "$env:USERPROFILE\.openclaw" -Destination "$env:USERPROFILE\.openclaw-backup" -Recurse

# 更新完成后如果出问题，可以恢复
Copy-Item -Path "$env:USERPROFILE\.openclaw-backup\*" -Destination "$env:USERPROFILE\.openclaw" -Recurse -Force

以上就是OpenClaw在Windows上安装的完整流程。两种方式各有优劣，按自己的习惯选就行。安装过程本身不复杂，大部分坑都集中在环境配置上，善用doctor命令排查问题能省不少时间。如果你在安装过程中遇到什么奇怪的问题，可以在评论区留言，我看到都会回复。