OpenClaw 是一款免费的 AI 工具,能帮你自动做很多事 —— 比如处理邮件、记日程、自动签到,还能对接聊天软件。最关键的是,它全程在你自己的电脑上运行,不会泄露隐私,安全又放心。
这篇教程专门针对 Windows 11 系统,把安装、设置、启动的每一步都拆得明明白白,新手跟着点就行,不用懂复杂操作。
一、安装前必做:先装两个 “基础工具”
OpenClaw 得靠 Git 和 Node.js 这两个工具才能运行,所以第一步先把它们装好在电脑上。
1. 安装 Git(简单理解为 “文件下载工具”)
下载链接:https://github.com/git-for-windows/git/releases/download/v2.52.0.windows.1/Git-2.52.0-64-bit.exe
安装方法:点开下载好的文件,不用改任何设置,一路点 “下一步”,最后点 “完成” 就行。
2. 安装 Node.js(简单理解为 “运行环境”)
下载链接:https://nodejs.org/(打开网页后,选带 “LTS” 字样的版本,这是稳定版,不容易出错)
安装方法:同样点开文件,一路默认点 “下一步”,安装时会自动配置好,不用手动操作。
注意:这个工具的版本必须是 22 及以上,不然 OpenClaw 用不了。
3. 检查是不是装好了(很简单,别漏了)
步骤:在电脑左下角搜 “CMD”,找到 “命令提示符”,右键点它,选 “以管理员身份运行”(一定要选这个,不然会出错)。
操作:在弹出的黑色窗口里,依次输入三行命令,每输完一行按一下回车:
git --version
node -v
npm -v
判断:如果每输完一行,都能显示一串数字(比如 “git version 2.52.0”),就说明装好了;要是提示 “不是内部命令”,就是没装对,重新装一次就行。
二、安装 OpenClaw 主程序(核心步骤,仔细点)
这一步要用到刚才打开的 “管理员 CMD 窗口”,而且电脑得能正常上 GitHub(如果打不开,换个网络试试)。
1. 打开 “管理员 CMD”(如果刚才关了,按上面的方法重新打开)
再强调一次:必须是 “以管理员身份运行” 的 CMD,普通 CMD 会报错。
2. 复制命令,粘贴执行(不用懂命令意思,照做就行)
先看官方参考(可选,不用管):https://docs.openclaw.ai/zh-CN/install
选下面任意一个命令,复制后,右键粘贴到黑色 CMD 窗口里,按回车:
选项 1:iwr -useb https://openclaw.ai/install.ps1 | iex
选项 2:npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com
成功的样子:窗口里会显示 “更新了多少个文件”,没有红色报错,最后提示 “安装成功”。
失败的样子:出现 “code 128”,这是网络波动导致的,再复制命令粘贴一次,多试两次就行。
3. 遇到 “禁止运行脚本” 报错?这样解决
如果粘贴命令后,出现 “无法加载文件…… 禁止运行脚本” 的提示,别慌:
在 CMD 窗口里复制这个命令:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
粘贴后按回车,然后再重新执行刚才的安装命令就行。
4. 检查主程序是不是装好了
在 CMD 窗口里输入:openclaw --version
按回车后,如果显示类似 “2026.3.2” 的数字,就说明装成功了;要是没显示,重新装一次主程序。
三、设置一下,启动 AI 工具
装完主程序后,得简单设置一下,绑定 AI 模型,才能用起来。
1. 输入初始化命令(照抄就行)
在 CMD 窗口里复制这个命令,粘贴后按回车:openclaw onboard --install-daemon
2. 跟着向导一步步选(新手直接按下面选,不会错)
弹出设置界面后,按提示选就行,不用自己瞎改:
问 “是否同意协议”:选 “Yes”(按键盘上的 Y 键,再回车);
问 “安装模式”:选 “QuickStart”(快速启动,适合新手);
问 “配置怎么处理”:选 “Use existing values”(用已有的设置,不用改);
问 “选哪个 AI 模型”:新手选 “Qwen” 或 “Moonshot AI (Kimi K2.5)”,这两个好用又稳定;
问 “API 怎么弄”:去你选的 AI 平台(比如 Kimi)弄一个 “API Key”,复制过来粘贴进去就行;
问 “要不要加通讯渠道”:选 “Skip for now”(先跳过,以后想加再弄);
问 “要不要装技能依赖”:全部选 “Skip for now”(先不装,后续慢慢加);
问 “要不要填其他 API Key”:都选 “No”;
问 “要不要网关服务”:选 “Skip”(跳过)。
3. 启动工具,打开操作面板
所有设置选完后,会出现 “Open the Web UI” 的选项,选它(按键盘上的对应数字,或用鼠标点);
之后会自动弹出浏览器,打开一个网页:http://127.0.0.1:18789/chat
要是网页打不开,或者提示 “需要 token”:
打开电脑文件夹,在地址栏输入:C:\Users\Administrator.openclaw\(直接复制粘贴);
找到 “config.json” 文件,用记事本打开;
里面会有一行 “token”: "xxxxxx"(xxxxxx 是你的专属码);
把网页地址改成:http://127.0.0.1:18789/?token=xxxxxx(把 xxxxxx 换成你文件里的专属码);
打开后,要是能看到版本号,而且显示 “健康正常”,就说明启动成功了。
四、常见问题:遇到问题不用慌,这样解决
安装时出现 “code 128”:多试两次安装命令,换个网络(比如连手机热点),或者检查 Git 是不是装好了;
启动后没弹出网页:重新执行 “openclaw onboard --install-daemon” 命令,再检查一下电脑里有没有其他程序占了 “18789” 这个端口(比如关掉多余的软件再试);
AI 模型用不了:看看 API Key 是不是复制错了(别多复制空格),选国内的 AI 平台(比如 Qwen、Kimi)会更稳定;
用着偶尔出错:官方说搭配 “WSL2” 用更稳定,Windows 原生系统可能有点小问题,要是想更稳定,可以搜 “Windows 11 安装 WSL2”,按教程装一下再用 OpenClaw。
五、总结
OpenClaw 是个轻量又好用的本地 AI 助手,Windows 11 系统按 “装基础工具→装主程序→简单设置→启动面板” 四步走,5-10 分钟就能搞定。新手全程选默认设置,别乱改,先把基础功能用起来,熟悉了之后再慢慢加通讯渠道和其他技能就行。
夜雨聆风