🦞
OpenClaw 安装指南
写给电脑小白的保姆级教程 手把手教你在 Windows 上安装自己的 AI 助手
1 装Node.js | 2 装OpenClaw | 3 配置向导 | 4 选AI模型 | ✓ 开始使用 |
🦞 OpenClaw 是什么?
OpenClaw(开源龙虾)是一个免费开源的个人 AI 助手。安装在自己的电脑上,通过微信、Telegram、Discord 等聊天工具和它对话,让它帮你:
回答问题、总结文章
写邮件、翻译文档
管理日程、整理文件
执行代码、分析数据
简单来说:它就像一个住在你电脑里的 ChatGPT,但完全由你自己掌控。
💡 预计耗时:整个安装过程约 15~20 分钟。跟着步骤走就行,不需要任何编程知识。
📋 目录
1.准备工作 — 你需要什么
2.第一步 — 安装 Node.js
3.第二步 — 打开命令行窗口
4.第三步 — 安装 OpenClaw
5.第四步 — 运行配置向导
6.第五步 — 选择 AI 模型(免费 vs 付费)
7.第六步 — 打开控制面板,开始使用
8.常用命令速查表
9.常见问题 FAQ
0准备工作 — 你需要什么
在开始之前,请确认你有以下东西:
✅ 一台 Windows 10 或 Windows 11 的电脑
✅ 能连上网络(需要下载软件)
✅ 电脑上有管理员权限(自己的电脑就行)
✅ 大约 2 GB 的硬盘空间
⚠️ 安全提示:OpenClaw 是实验性软件,建议不要在存有重要私密文件的电脑上安装,也不要给它访问敏感文件的权限。
🚨 警惕假冒:请只从官方渠道下载:官网:docs.openclaw.aiGitHub:github.com/openclaw/openclaw不要从搜索引擎广告或来路不明的网站下载!
1第一步 — 安装 Node.js
Node.js 是 OpenClaw 运行所需的基础软件,就像玩游戏得先装游戏引擎一样。
1.1 下载 Node.js
1打开浏览器,访问:https://nodejs.org
2点击页面上左边写着 "LTS"(长期支持版)的按钮
💡 版本要求:OpenClaw 需要 Node.js 22 或更高版本,目前直接下载 LTS 即可。
1.2 安装 Node.js
1找到下载的文件(在「下载」文件夹),文件名类似 node-v22.x.x-x64.msi
2双击打开,弹出安装向导
3一路点 Next(下一步)即可
4遇到 "Automatically install the necessary tools" 选项,勾选它 ✅
5最后点 Install → Finish,完成安装
1.3 验证安装
按 Win 键,搜索 cmd,打开「命令提示符」,输入:
node --version
看到 v22.x.x 或更高版本号,说明安装成功。
✅ 显示版本号 v22.x.x 或更高 = 安装成功!
2第二步 — 打开命令行窗口
接下来的操作都在「命令行」里进行——就是在一个黑色窗口里打字,别紧张。
方法 A(推荐)
1同时按住 Win + R
2在弹出的小框里输入 cmd,点「确定」
方法 B
1在桌面空白处,按住 Shift 再右键单击
2选择「在此处打开 PowerShell 窗口」
💡 如果上一步已经打开了命令提示符窗口,可以直接继续使用。
3第三步 — 安装 OpenClaw
在命令行窗口中,复制下面这行命令,粘贴后按 回车:
npm install -g openclaw@latest
💡 怎么粘贴?在命令行黑色窗口中右键单击,内容就会粘贴进去。或者按 Ctrl+V。
按回车后会出现滚动文字(正在下载安装),耐心等待 1~3 分钟,直到重新出现 C:\> 提示符。
验证安装
openclaw --version
显示版本号(如 2026.3.x)即安装成功 🎉
⚠️ 如果报错 "npm 不是内部或外部命令":说明 Node.js 没有正确安装。关闭所有命令行窗口,重启电脑,重新打开命令行再试。
4第四步 — 运行配置向导
输入以下命令启动配置向导:
openclaw onboard --install-daemon
💡 onboard = 启动配置向导--install-daemon = 让 OpenClaw 开机自动在后台运行,以后无需手动启动
向导会问你几个问题,参考下表回答:
5第五步 — 选择 AI 模型
OpenClaw 是「管家框架」,需要一个 AI 大脑来驱动。你有两个选择:
☁️ 方案 A:云端 AI 使用 OpenAI / Anthropic / Google 的模型效果最好,反应快,需要注册账号付费 付费使用 | 💻 方案 B:本地 AI AI 跑在自己电脑上,完全免费数据不外传,但需要较好配置 完全免费 |
☁️ 方案 A:云端 AI(推荐新手)
推荐使用 Anthropic(Claude)或 OpenAI(GPT),去对应官网注册账号,创建 API Key,在配置向导中填入即可。
💡 API Key 是什么?就像一把钥匙,让 OpenClaw 调用云端 AI。是一串字符串,类似 sk-xxxxxxxxxxxxxxxx。
💻 方案 B:本地 AI — Ollama(完全免费)
⚠️ 配置要求:建议至少 16GB 内存,有 NVIDIA 独显最佳。配置一般的电脑建议选方案 A。
安装 Ollama:
1下载:https://ollama.com/download,双击安装(一路 Next)
2安装完后打开新命令行窗口,下载 AI 模型:
# 下载约 4~8GB,需要等几分钟
ollama pull llama3.3
💡 其他推荐模型:ollama pull qwen2.5-coder:32b 编程能力强ollama pull deepseek-r1:32b 推理能力强
在配置向导中选 Ollama,API Key 填 ollama-local(本地运行不需要真正密钥,但字段不能为空)。
# 或配置完成后手动设置
openclaw config set models.providers.ollama.apiKey "ollama-local"
6第六步 — 打开控制面板,开始使用!
一切准备就绪!启动 OpenClaw 控制面板:
openclaw dashboard
浏览器会自动打开:
http://127.0.0.1:18789/
如果浏览器没有自动打开,请手动在地址栏输入上面的地址。
🎉 安装完成!在控制面板中你可以:• 直接在网页上和 AI 聊天• 连接微信 / Telegram / Discord 等聊天软件• 管理 AI 模型和插件• 查看聊天记录和使用统计
💡 以后怎么使用?安装时加了 --install-daemon,OpenClaw 每次开机后自动在后台运行。只需打开浏览器,输入 http://127.0.0.1:18789/ 即可,无需再运行任何命令。
📋 常用命令速查表
❓ 常见问题
Q:命令行窗口突然关闭了怎么办?
A:重新打开命令行(Win+R,输入 cmd),从中断的步骤继续就行。已安装好的部分不会丢失。
Q:"npm 不是内部或外部命令" 怎么办?
A:关闭所有命令行窗口 → 重启电脑 → 重新打开命令行再试。仍报错则重新安装 Node.js,安装时不要更改任何默认选项。
Q:"openclaw 不是内部或外部命令" 怎么办?
A:关闭命令行窗口,重新打开一个新的再试。如果还不行,运行 npm config get prefix 查看安装路径是否在系统 PATH 中。
Q:Ollama 本地模型回答很慢怎么办?
A:① 有 NVIDIA 显卡(RTX 3060+)速度会快很多② 没有独显,换更小模型:ollama pull llama3.2:3b③ 或切换到云端 AI(方案 A),效果更好也更快
Q:OpenClaw 安全吗?聊天记录会被上传吗?
A:OpenClaw 是开源软件,代码完全公开。使用云端 AI 时,对话内容会发送到对应 AI 厂商;使用 Ollama 本地模型则所有数据不会离开你的电脑。
Q:怎么卸载 OpenClaw?
A:命令行输入:npm uninstall -g openclaw。如也想卸载 Node.js,去「设置 → 应用」找到 Node.js 卸载即可。
🔗 参考链接
▶ OpenClaw 官方安装文档
▶ OpenClaw GitHub 仓库
▶ Node.js 官网
▶ Ollama 官网
夜雨聆风