OpenClaw Windows部署教程,免虚拟机直接安装
写这篇的起因是,上周有个学弟在群里问:"Windows上装OpenClaw是不是必须开虚拟机跑Linux?"我当时愣了一下,心想都2026年了还有人这么问,但转念一想,之前确实很多AI工具只支持Linux,Windows用户被劝退是常态。所以今天专门写一篇,说清楚OpenClaw在Windows上是原生安装、直接跑的,不需要虚拟机,不需要Docker,甚至不需要WSL。整个过程和装一个普通软件差不多。
OpenClaw最新版本一键部署包下载地址:https://top.wokk.cn/
先说结论:OpenClaw的Windows版本是用Node.js写的,纯跨平台,Windows、macOS、Linux都能跑。官方提供的安装包里已经包含了运行时,你不需要自己装Node.js、不需要配环境变量、不需要编译什么东西。解压、运行、完事。当然,如果你机器上已经有Node.js了也没事,版本冲突的话安装脚本会自动处理。
下面开始正式的安装流程。第一步是下载部署包,推荐从官方渠道获取,确保版本是最新的。下载完成后你会得到一个zip压缩包,大概200多MB,里面包含运行时和所有依赖。
# 创建安装目录(建议用纯英文路径)
mkdir D:\openclaw
# 解压部署包到目标目录
Expand-Archive -LiteralPath "$env:USERPROFILE\Downloads\openclaw-windows-latest.zip" `
-DestinationPath "D:\openclaw" -Force
# 确认文件结构
dir D:\openclaw
# 你应该能看到:bin/ conf/ data/ openclaw.exe install.ps1 等文件
解压之后先别急着运行,看一下目录结构是否完整。bin目录里是可执行文件和脚本,conf目录放配置文件,data目录存运行时数据。如果哪个目录缺失了,说明压缩包可能下载不完整,重新下一次就好。
接下来运行安装脚本,这一步会帮你完成环境初始化。
# 以管理员身份运行PowerShell,然后执行:
cd D:\openclaw
.\install.ps1
# 脚本执行过程中你会看到类似输出:
# [INFO] 检查系统环境...
# [INFO] Node.js 运行时检测... ✓ 已包含
# [INFO] 创建数据目录... ✓ 完成
# [INFO] 初始化配置文件... ✓ 完成
# [INFO] 安装完成!运行 openclaw gateway start 启动服务
如果这一步报错了,最常见的两个原因是路径有中文和权限不够。路径有中文这个我已经强调过了,权限问题的话,右键PowerShell选择"以管理员身份运行"就好了。安装脚本的输出日志很详细,报错信息里一般会告诉你具体哪里出了问题。
安装完成后需要做一次基本配置,主要是填入你的模型API Key。OpenClaw默认使用OpenAI的API,但也可以切换到国内的模型服务。配置文件在conf目录下,叫config.yaml,用任何文本编辑器都能打开编辑。
# conf/config.yaml - 最小化配置
models:
default: gpt-4o
providers:
openai:
api_key: sk-xxxxxxxxxxxxxxxx
# 如果你需要通过代理访问,可以设置base_url
# base_url: https://your-proxy.example.com/v1
server:
host: 127.0.0.1
port: 8080
# 如果你想用国产模型,比如智谱GLM:
# models:
# default: glm-4
# providers:
# zhipu:
# api_key: your-zhipu-api-key
# base_url: https://open.bigmodel.cn/api/paas/v4
配置文件写好保存之后,启动Gateway服务。Gateway是OpenClaw的核心服务进程,负责接收请求、调度Agent、管理连接。
# 启动Gateway服务
openclaw gateway start
# 查看运行状态
openclaw gateway status
# 如果想以后台服务方式运行(开机自启)
openclaw gateway install --startup auto
start命令启动后,Gateway会在前台运行并显示日志。如果你关掉终端窗口,服务也会停。如果想让它一直在后台跑,用install命令注册成Windows服务,设置成开机自启。这样以后每次开机,OpenClaw就自动跑起来了,不需要手动操作。
服务启动成功后,打开浏览器访问 http://127.0.0.1:8080 就能看到管理界面了。如果页面打不开,先检查防火墙设置。Windows自带的防火墙可能会拦截新程序的入站连接。
# 添加防火墙规则(以管理员身份运行)
New-NetFirewallRule -DisplayName "OpenClaw HTTP" `
-Direction Inbound `
-LocalPort 8080 `
-Protocol TCP `
-Profile Any `
-Action Allow
# 如果你想从局域网其他设备访问,需要把host改成0.0.0.0
# 修改 conf/config.yaml 中的 server.host
# 然后重启服务
openclaw gateway restart
到这里安装就全部完成了。你现在有了一个运行在本地的AI Agent平台,可以创建Agent、安装技能、配置定时任务等等。整个安装过程没有涉及到任何虚拟机、Docker或者WSL,就是Windows原生运行。
# 快速验证:创建一个Agent并对话
openclaw agent create --name test-agent --model gpt-4o \
--prompt "你是一个友好的技术助手。"
# 跟Agent聊两句测试一下
openclaw chat --agent test-agent "你好,你能做什么?"
# 安装一个常用技能
skillhub_install install_skill web-search
# 给Agent配置定时任务
openclaw cron create --agent test-agent \
--schedule "0 9 * * *" \
--message "帮我总结今天的科技新闻"
上面这几条命令分别演示了创建Agent、对话测试、安装技能、配置定时任务。每一条都能独立运行,互不依赖。如果你只想要最基础的对话功能,前三条就够了。定时任务是进阶功能,配置好了之后Agent会每天早上9点自动执行你设定的任务。
最后说几个Windows上使用OpenClaw的注意事项。第一,如果你用的是公司电脑或者学校电脑,可能有安全软件拦截某些操作,这种情况下建议联系IT管理员。第二,Windows的路径分隔符是反斜杠,在配置文件里写路径的时候注意一下。第三,如果遇到编码问题(中文乱码之类的),在PowerShell里执行 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 就能解决。
免虚拟机直接安装,是OpenClaw对Windows用户最友好的地方之一。很多人对Linux命令行有畏惧感,OpenClaw在Windows上用PowerShell操作,体验上和你用其他Windows软件差别不大。降低入门门槛,让更多人能用上AI Agent工具,这才是技术普及该有的样子。
更多推荐


所有评论(0)