全网最详细的 Windows 安装教程,小白也能跟着做!
一、OpenClaw 是什么
OpenClaw(小龙虾)是目前 GitHub 上最火的 AI 智能体框架,超过 28 万 Star。简单说,它能让 AI 不只是聊天,还能帮你做事——发消息、搜网页、管日程、写代码,甚至主动找你说话。
最重要的是:它支持微信!你可以直接在微信里跟 AI 对话,就像跟朋友聊天一样。
二、安装前准备
1. 检查电脑系统
本教程适用于 Windows 10 / Windows 11 系统。
1. 安装 Node.js
OpenClaw 需要 Node.js 运行环境。
第一步:打开浏览器,访问 Node.js 官网:
第三步:双击下载的安装包,一路点 Next 就行,不用改任何选项。
第四步:验证安装是否成功。
按下键盘 Win+R,弹出运行窗口,输入 cmd,按回车。
在黑色命令行窗口中输入:
node -v
按回车,如果显示版本号(比如 v22.x.x),说明安装成功。
再输入:
npm -v
按回车,同样显示版本号就 OK 了。
注意:Node.js 版本需要 22 及以上。如果版本太低,重新下载最新版安装覆盖即可。
三、安装 OpenClaw
1. 打开命令行
按下键盘 Win+R,输入 cmd,按回车,打开命令行窗口。
1. 一键安装
在命令行中输入:
npm install -g openclaw\@latest
按回车,等待安装完成。可能需要几分钟,取决于网速。
如果安装很慢或报错,可以先切换 npm 镜像源:
npm config set registry
然后重新执行安装命令。
1. 验证安装
安装完成后,输入:
openclaw --version
显示版本号就说明安装成功了!
1. 初始化配置
输入以下命令进行初始化:
openclaw onboard
按照提示一步步操作:
- 选择模型:可以先选免费的,后面再换
- 设置网关端口:默认 18789 就行
- 其他选项按默认来即可
四、配置 AI 模型(重点!)
OpenClaw 安装好之后,还需要配置一个 AI 大模型才能用,就像手机装完系统还要装 App 一样。
所有配置都在命令行里完成。Win+R 输入 cmd,按回车,打开黑色命令行窗口,以下所有命令都在这里输入。
方式一:DeepSeek(推荐!便宜好用)
DeepSeek 是目前性价比最高的 AI 模型,中文能力极强,价格便宜到离谱。
第一步:注册 DeepSeek 账号
浏览器打开:
第二步:实名认证
登录后,进入"账号管理"完成实名认证。这是必须的,不认证没法用 API。
第三步:充值
进入"费用管理"点击"充值"。DeepSeek 最低充 10 块钱就够了,模型调用一次才几厘钱,10 块钱能聊很久。
第四步:创建 API Key
进入左侧菜单"API Keys",点击"创建 API Key"。
会弹出一串以 sk- 开头的字符串,比如:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
这就是你的 API Key,复制保存好!这个 Key 只显示一次,关了就看不到了,丢了只能重新创建。
第五步:在命令行里配置模型
Win+R 输入 cmd,按回车,在黑色窗口里输入下面两行命令(每输一行按一次回车):
openclaw config set model.primary=deepseek/deepseek-chat
openclaw secrets set DEEPSEEK\_API\_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
注意:第二行命令里,把 sk-xxx 那一整串换成你自己在第四步复制的 API Key。
比如你的 Key 是 sk-abc123def456,那就输入:
openclaw secrets set DEEPSEEK\_API\_KEY=sk-abc123def456
第六步:验证配置
输入:
openclaw health
显示模型已配置就 OK 了。
方式二:硅基流动(免费额度)
硅基流动是国内平台,注册就送免费额度,适合白嫖体验。
第一步:注册账号
浏览器打开:
注册账号并登录。
第二步:创建 API Key
进入控制台,找到"API Keys",点击"创建新密钥"。
复制生成的 Key,以 sk- 开头。
第三步:在命令行里配置
Win+R 输入 cmd,按回车,输入下面两行命令:
openclaw config set model.primary=siliconflow/Qwen/Qwen2.5-7B-Instruct
openclaw secrets set SILICONFLOW\_API\_KEY=你的API Key
把"你的API Key"换成第二步复制的 Key。
方式三:本地模型(完全免费,需要显卡)
如果你电脑配置不错(8G 以上显存),可以用 Ollama 跑本地模型,完全免费,不联网也能用。
第一步:安装 Ollama
浏览器访问:
下载 Windows 版,双击安装。
第二步:下载模型
Win+R 输入 cmd,按回车,输入:
ollama pull qwen2.5-coder:3b
等待下载完成(约 1.9GB)。
第三步:在命令行里配置
输入:
openclaw config set model.primary=ollama/qwen2.5-coder:3b
本地模型不需要 API Key,配置完就能用。
方式四:其他模型
OpenClaw 几乎支持所有主流模型,配置方式都一样,在 cmd 里输入命令就行:
OpenAI(ChatGPT):
- 申请地址:
- 配置模型:openclaw config set model.primary=openai/gpt-4o
- 设置 Key:openclaw secrets set OPENAI\_API\_KEY=你的Key
智谱(GLM):
- 申请地址:
- 配置模型:openclaw config set model.primary=zhipu/GLM-4-Flash
- 设置 Key:openclaw secrets set ZHIPU\_API\_KEY=你的Key
通义千问:
- 申请地址:
- 配置模型:openclaw config set model.primary=dashscope/qwen-turbo
- 设置 Key:openclaw secrets set DASHSCOPE\_API\_KEY=你的Key
配置完模型后,可以用这个命令查看当前配置是否正确:
openclaw config get model
五、绑定微信(重点来了!)
1. 安装微信插件
在命令行中输入:
openclaw plugins install @tencent-weixin/openclaw-weixin
等待安装完成。
1. 启动网关
在命令行中输入:
openclaw gateway run --bind loopback --port 18789
网关启动后会显示类似这样的信息:
OpenClaw 2026.x.x
\[gateway] ready
\[openclaw-weixin] starting...
注意:这个窗口不要关!关了网关就停了。
1. 扫码绑定微信
新开一个命令行窗口(Win+R 输入 cmd),输入:
openclaw channels login --channel openclaw-weixin
此时终端会显示一个二维码。
如果二维码显示不完整或扫不了,终端还会给出一个链接,你可以用手机浏览器打开链接扫码。
1. 手机微信扫码
打开手机微信,扫一扫终端中的二维码。
扫码后,终端会显示:
已将此 OpenClaw 连接到微信。
1. 开始聊天!
现在打开微信,找到刚刚绑定的聊天对象,直接发消息就行!
试试发一句"你好",AI 就会回复你了。
七、设置开机自启(可选)
不想每次手动启动?可以创建一个启动脚本。
1. 创建启动脚本
新建一个文本文件,重命名为 start-openclaw\.bat,内容如下:
@echo off
chcp 65001 >nul
title OpenClaw Gateway
set OLLAMA\_API\_KEY=ollama-local
openclaw gateway run --bind loopback --port 18789
pause
1. 创建桌面快捷方式
右键桌面,新建,快捷方式
输入位置:
cmd.exe /c "D:\你的路径\start-openclaw\.bat"
点击下一步,给快捷方式取个名字,比如"启动 OpenClaw",完成!
以后双击桌面图标就能启动了。
八、常见问题
Q:安装 OpenClaw 时报错"npm 不是内部命令"?
A:Node.js 没装好或没加到环境变量。重新安装 Node.js,确保勾选了 Add to PATH。
Q:微信扫码后没反应?
A:检查网关是否在运行。打开命令行输入 openclaw health 看看状态。
Q:微信发消息 AI 不回复?
A:可能原因:
1. 模型没配置好——输入 openclaw config get model 检查
2. 网关没启动——重新运行启动命令
3. 微信登录过期——重新执行 openclaw channels login --channel openclaw-weixin
4. API Key 没设置——重新设置 secrets
Q:AI 回复很慢?
A:本地模型需要加载时间,第一次响应可能要等几秒。换成云端模型(DeepSeek 等)速度更快。
Q:上下文爆满了怎么办?
A:在聊天中发送 /reset 或 /new 清除当前会话,重新开始。
Q:DeepSeek API Key 在哪里看?
A:登录
九、总结
整个流程就三步:
1. 装 Node.js,装 OpenClaw
2. 配模型(推荐 DeepSeek,便宜好用)
3. 绑微信,扫码,开聊
OpenClaw 的强大远不止聊天。它有 13000+ 社区技能包,可以接入各种平台,还能自定义 AI 的性格和行为。这只是开始,后续我会分享更多玩法!
觉得有用的话,点个关注不迷路,后续持续分享 OpenClaw 进阶玩法!
夜雨聆风