学习目标

花 10 分钟准备好安装 OpenClaw 所需的一切：检查电脑环境、安装必要软件、注册 AI 模型账号。

概念解释

想象你要开一家餐厅。在正式开业之前，你需要准备好厨房（电脑环境）、锅碗瓢盆（Node.js 软件）、食材供应商的联系方式（AI 模型的 API Key）。

这一课就是帮你把这些”开业准备”全部搞定。

API Key（应用程序接口密钥）听起来很技术，其实就相当于一个”会员卡号”——你注册了 AI 模型的服务后，系统会给你一串字母和数字的组合，小龙虾就是用这串号码来”打电话”给 AI 的。你不需要理解它的技术原理，只需要知道：有了它，小龙虾才能帮你干活。

动手做

第一步：检查你的电脑是否符合要求

小龙虾对电脑的要求不高，大部分现代电脑都可以运行。打开你的电脑，对照下面的表格检查：

项目	最低要求	怎么检查
操作系统	Windows 10 及以上，或 macOS 12 及以上	Windows：右键”此电脑” -> 属性；Mac：左上角苹果图标 -> 关于本机
内存（RAM）	4GB 以上	同上，在系统信息里可以看到
硬盘空间	至少 500MB 空余	打开”我的电脑”或”访达”查看
网络连接	需要能上网	打开浏览器试试能不能访问网站

如果你的电脑是最近 5 年内买的，基本都没问题，放心往下走。

第二步：安装 Node.js

Node.js 是小龙虾运行的基础环境，就像植物需要土壤一样，小龙虾需要 Node.js 才能工作。

操作步骤：

1. 打开浏览器，访问 https://nodejs.org
2. 你会看到两个下载按钮，选择下载 Node.js 24（推荐），或者至少 Node.js 22.14+
3. 下载完成后，双击安装包，一路点”下一步”就行，不需要修改任何设置
4. 安装完成后，我们来验证一下是否成功

验证安装：

打开”终端”（Terminal）或者”命令提示符”（Command Prompt）：

• Windows：按 Win + R，输入 cmd，按回车
• Mac：按 Cmd + 空格，输入 terminal，按回车

在打开的黑色（或白色）窗口里输入：

node --version

按回车，你应该看到类似这样的输出：

v22.14.0

或者：

v24.0.0

只要版本号以 24. 开头，或者显示 22.14 或更高的 22.x 版本，就没问题。

如果你看到的版本号低于 22.14，说明需要更新。回到 nodejs.org 下载最新版本重新安装即可。

第三步：配置网络环境（中国大陆用户特别注意）

如果你在中国大陆，npm（Node.js 的包管理工具，相当于一个”应用商店”）默认连接的是国外的服务器，下载速度可能很慢甚至失败。

解决方法：换成国内镜像源

在终端里输入这条命令：

npm config set registry https://registry.npmmirror.com

按回车，没有任何报错就说明设置成功了。这条命令的意思是告诉 npm：“以后下载东西去国内的仓库取，别跑国外去了。”

验证是否设置成功：

npm config get registry

如果输出是 https://registry.npmmirror.com/，就说明设置成功了。

第四步：注册 AI 模型的 API Key

小龙虾需要一个 AI”大脑”才能工作。目前推荐两个选择：

选项 A：DeepSeek（推荐，性价比最高）

DeepSeek 是国产 AI 模型，中文理解能力很强，价格便宜，非常适合日常使用。

注册步骤：

1. 打开浏览器，访问 https://platform.deepseek.com
2. 点击”注册”，可以用手机号注册
3. 注册完成后，登录进去
4. 找到左侧菜单的 “API Keys”（API 密钥）
5. 点击 “创建 API Key”
6. 系统会生成一串以 sk- 开头的长字符串——这就是你的 API Key
7. 重要：把这串字符复制保存好！它只会显示一次，关掉页面就看不到了。 建议保存到记事本或者密码管理器里

充值：

• 建议先充值 10 元人民币试试
• 在”充值”页面用支付宝或微信扫码就行
• 10 元钱大约可以支持你日常使用好几天甚至一两周

选项 B：OpenAI（功能更全面，价格更高）

如果你已经有 ChatGPT Plus 账号，也可以用 OpenAI 的 API Key。不过价格会比 DeepSeek 贵一些，这里就不展开了，感兴趣的话可以查看 OpenAI 的官方文档。

第五步：整理你的准备清单

完成以上步骤后，对照这个清单确认：

• 电脑系统满足要求（Windows 10+ 或 macOS 12+）
• 内存 4GB 以上
• 已安装 Node.js 22.14+ 或 24.x
• （中国大陆用户）已切换 npm 镜像源
• 已注册 AI 模型账号并获取 API Key
• API Key 已安全保存

全部打勾了？太棒了，你已经准备好进入下一课——安装小龙虾了！

检查你的成果

打开终端，依次运行以下命令，确认结果：

node --version

预期结果：显示 v22.14.x 或 v24.x.x

npm config get registry

预期结果（中国大陆用户）：显示 https://registry.npmmirror.com/

另外确认：

• 你的 DeepSeek（或其他 AI）API Key 已经安全保存
• 你知道 API Key 不能泄露给别人（就像银行卡密码一样）

常见失败排查

1. “输入 node —version 后提示 ‘node 不是内部或外部命令’”

这说明 Node.js 没有正确安装，或者安装后终端没有刷新。

解决方法：

• 先确认你确实下载并安装了 Node.js（检查”控制面板” -> “程序和功能”里有没有 Node.js）
• 如果已经安装了，关掉终端窗口，重新打开一个新的终端窗口再试
• 如果还是不行，重新去 nodejs.org 下载安装包，再安装一次

2. “npm config set registry 命令报错”

可能是 Node.js 安装不完整。

解决方法：

• 先确认 node --version 能正常输出版本号
• 如果 Node.js 正常但 npm 命令不行，尝试重新安装 Node.js
• 也可以试试用管理员权限打开终端（右键”命令提示符” -> “以管理员身份运行”）

3. “DeepSeek 注册后找不到 API Key 在哪里”

解决方法：

• 登录 platform.deepseek.com
• 看页面左侧边栏，找到 “API Keys” 菜单项
• 如果没有看到侧边栏，试试看页面左上角有没有菜单按钮（三条横线图标）
• 点击进去后，点 “创建 API Key” 按钮

挑战任务

准备好了？来试试这个：

在终端里运行 npm --version，看看输出什么数字。然后搜索一下 npm 是什么的缩写，它是干什么用的。

进阶挑战（可选）：

如果你有两个 AI 模型的账号（比如 DeepSeek 和 OpenAI），试着想想它们各自适合用来做什么。在下一课的配置环节，你可以选择先配置哪一个。