写这篇的起因是,上周有个学弟在群里问:"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工具,这才是技术普及该有的样子。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐