OpenClaw在windows部署极简安装指南
Windows系统极简安装指南:接OpenClaw“入住”你的电脑
想在Windows上快速搞定OpenClaw?没问题。下面这份指南专为Windows用户设计,你不需要研究晦涩的技术文档,只要跟着流程一步步来,就能顺利把这位高效的AI助手请进你的系统。
???? 你的Windows专属安装地图
可以把整个过程想象成“迎接朋友来家做客”三部曲:首先得把门打开,把房间准备好(环境配置);然后请朋友进门(安装核心程序);最后安排入住,简单认识一下(初始化设置)。
一张表帮你理清脉络:
| 阶段 | 核心任务 | 你的操作 | 关键命令/说明 |
|---|---|---|---|
| 第一阶段:环境准备 | 安装Node.js | 在管理员PowerShell中执行命令 | nvm install 22 及 nvm use 22.22.0 |
| 第二阶段:安装核心 | 一键安装OpenClaw | 在管理员PowerShell中执行命令 | iwr -useb https://openclaw.ai/install.ps1 | iex |
| 第三阶段:配置与启动 | 配置AI模型并启动服务 | 跟随安装向导,或手动执行命令 | openclaw onboard --flow quickstart |
????️ 详细步骤:别担心,跟着做就好
第一步:准备“家门”——安装Node.js(约5分钟)
OpenClaw需要运行在Node.js这个环境中,所以我们先得把它搭建好。这里推荐用一个名为nvm的小工具来管理,它能让你轻松切换不同版本。
操作要点:
- 以管理员身份打开PowerShell:点击开始菜单,输入“PowerShell”,在搜索结果上右键选择“以管理员身份运行”。这一步至关重要,权限不足会导致后续步骤失败。
- 安装Node.js:在打开的蓝色窗口中,依次复制粘贴下面两行命令(PowerShell中鼠标右键即可粘贴),每粘贴一行就按一下回车:
当看到“Now using node v22.22.0”的提示时,说明环境已经就绪。# 安装 Node.js 22 版本 nvm install 22 # 使用 22.22.0 这个具体版本 nvm use 22.22.0
第二步:请“朋友”进门——一键安装OpenClaw(约3-5分钟)
环境准备好了,现在就把OpenClaw请进来。确保你仍在刚才的管理员PowerShell窗口中。
复制并粘贴下面这行命令,然后按回车:
iwr -useb https://openclaw.ai/install.ps1 | iex
屏幕上会开始滚动大量文本,别紧张,这是安装程序在自动工作。稍等几分钟,让它自己完成。
第三步:安排入住并认识一下——初始化配置(约5分钟)
安装后通常会弹出配置向导。如果没有,或者你关掉了窗口,只需在PowerShell里输入 openclaw onboard --flow quickstart 回车即可。
接下来,向导会像一位贴心的管家,问你几个问题来完善设置。参照下表回答即可:
| 向导提问 | 如何回答 | 提示 |
|---|---|---|
I understand this is powerful and inherently risky. Continue? | 用方向键选择 Yes,回车。 | 这是一个关于工具权限的常规提示,放心确认即可。 |
? What would you like to do? | 选择 Quickstart。 | 选择快速开始,跳过复杂设置。 |
? Choose model/auth provider | 选择 Custom / Other。 | 关键步骤:选这个才能手动配置智谱GLM-4.6。 |
? Enter your API Key | 粘贴你从智谱开放平台获取的API Key。 | 这个Key相当于门钥匙,务必妥善保管,别泄露。 |
? Enter custom base URL | 输入:https://open.bigmodel.cn/api/anthropic | 这是GLM-4.6的专属接口地址,确保准确无误。 |
? Enter custom model ID | 输入:glm-4.6 | 模型名称,注意大小写必须完全一致。 |
? Endpoint compatibility? | 选择 OpenAI-compatible。 | 选择兼容OpenAI的模式。 |
后续关于 Skill、Channel等高级选项,新手建议一律选择 Skip for now 或 No。我们的目标是先让核心跑起来,高级功能可以后续慢慢探索。
回答完所有问题后,向导会自动验证。当看到 Verification successful 这类绿色提示,并且浏览器自动打开一个本地页面(地址通常是 http://localhost:18789 或 http://127.0.0.1:3000),恭喜你!OpenClaw已经在你的Windows上成功安家了。
???? 一些可能有用的“锦囊”
- 如果安装时提示权限错误:请再次确认PowerShell是否以管理员模式运行。也可以先在PowerShell执行这条命令放宽权限:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser - 如果忘记了配置选项:随时可以在管理员PowerShell中输入
openclaw onboard重新走一遍配置流程。 - 如果遇到奇怪的问题:试试在PowerShell里运行
openclaw doctor,这个命令能帮你自动诊断一些常见故障。 - 想看实时日志排查错误:执行
openclaw logs follow可以持续查看运行日志。
跟着指南走下来,大部分朋友都能顺利完成。如果在某个具体环节卡住了,或者遇到了不认识的报错,随时可以带着问题来找支持。祝你一次安装成功!