夜雨聆风你有没有过这样的经历——
看到别人用 AI 助手写代码、查资料、分析数据，效率翻了好几倍，心里痒痒的，想着"我也想整一个"。结果一打开安装文档，满屏都是命令行、环境变量、 PATH 配置……还没开始就劝退了。
我懂你。
作为一个从零走过来的人，我太知道那个"第一步"有多难迈了。今天这篇文章，就是写给完全没有技术背景、第一次接触这类工具的朋友们的。手把手，一步一步，带你从 0 到 1 ，把 OpenClaw 这个超强的 AI 助手装好、跑起来。
读完你就会发现——其实没那么难，我在旁边呢。
OpenClaw 是什么？
先说清楚这个东西是干啥的。
OpenClaw 是一个本地运行的 AI 助手框架，你可以把它理解成一个"AI 操作系统"。装好之后，它能帮你：
最关键的是——跑在你自己的电脑上，数据不经过第三方服务器，隐私有保障。
而且它对国内用户很友好，支持 MiniMax 、硅基流动等国内 AI 接口，不需要科学上网就能用。
用一个词总结：你的私人 AI 助手，本地的，能联网的，接微信/飞书的。
中国安装第一步：先搞定 Node.js
OpenClaw 是基于 Node.js 运行的，所以在安装 OpenClaw 之前，我们得先把 Node.js 装好。
Node.js 是什么？ 你暂时不用理解，只需要知道：很多 AI 工具和开发者的工具都是用它写的，装了这个，很多软件才能跑起来。
第一步：下载 Node.js 24
打开浏览器，访问 Node.js 官网：
👉 https://nodejs.org
你会看到两个大大的绿色按钮，LTS（长期支持版）和 Current（最新版）。
我们选 LTS 版本，Node.js 22.x 或更高版本都支持 OpenClaw。我推荐直接装最新版 Node.js 24，性能最好。
💡 Windows 用户：点击"Windows Installer"下载
.msi安装包，双击运行，一路点"下一步"就好。
macOS 用户：点击"macOS Installer"下载.pkg安装包，同样的方式安装。
Linux 用户：可以用包管理器，比如sudo apt install nodejs（ Ubuntu/Debian ）。
第二步：验证安装成功
装完之后，我们来验证一下有没有装好。
Windows 用户：按 Win + R，输入 cmd，回车，打开"命令提示符"。
macOS / Linux 用户：打开"终端"（ Terminal ）。
在命令行里输入：
node-v
然后回车。
如果显示类似这样的内容（版本号可能略有不同）：
v22.14.1
或者
v24.14.1
就说明安装成功了！🎉
再输入：
npm-v
应该会显示 npm 的版本号，比如 10.9.0。
两个都有输出，说明 Node.js 环境完全就绪了。
中国特色问题： npm 换源（必做！）
好， Node.js 装好了。现在很多朋友会直接尝试安装 OpenClaw ，然后发现——下载速度慢到崩溃。
这不怪你，也不怪网速。这是因为 npm 默认的软件源服务器在国外，从国内访问就像从北京开车去纽约——绕了半个地球。
解决方案很简单：把 npm 的下载地址换成国内的镜像。
只需要在终端里运行这一行命令：
npmconfigsetregistryhttps://registry.npmmirror.com
回车，运行。
这行命令的意思是：告诉 npm"以后下载东西去淘宝的镜像站，别去国外的原站"。国内访问，速度能快几十倍。
💡 如果以后遇到某个包下载特别慢，可以在命令后面加上
--registry https://registry.npmmirror.com临时指定镜像。
bash npm install some-package --registry https://registry.npmmirror.com
镜像换好了，现在我们正式开始安装 OpenClaw 。
正式安装 OpenClaw ：两行代码搞定
安装 OpenClaw 其实非常简单，就两行命令。
macOS / Linux 用户
打开终端，输入这两行（一行一行输入，每行回车）：
curl-fsSLhttps://openclaw.ai/install.sh|bash
回车，等它运行完。然后运行配置命令：
openclawonboard--install-daemon
Windows 用户
用 PowerShell（不是 CMD ！），右键开始菜单 → 选择"终端（管理员）"或"PowerShell （管理员）"，然后输入：
iwr -useb https://openclaw.ai/install.ps1 | iex
回车，等待安装完成。
验证安装成功
安装完成后，在终端里输入：
openclawgatewaystatus
如果看到类似这样的输出（或者一行绿色的"running"字样），说明一切正常：
✅ Gateway running
你就已经成功安装了 OpenClaw ！
⚠️ 第一次运行可能会遇到权限提示， macOS/Linux 用户可能需要输入密码， Windows 用户点"允许"就好。这些都是正常的安全提示，不是病毒，放心操作。
一键配置 OpenClaw ： openclaw onboard 交互式引导
安装完之后，还需要做一点简单的配置。 OpenClaw 提供了一个交互式引导程序，你只需要回答几个问题，它会自动帮你搞定所有配置。
运行这个命令：
openclawonboard
或者（上面命令如果有问题，试试这个）：
openclawonboard--install-daemon
你会看到它开始问一些问题，比如：
不要慌，跟着提示一步步来就好。如果你现在手边还没有 API Key ，可以直接按回车跳过，之后再配置。
它会自动：
- 创建配置文件
- 设置好运行环境
- 启动后台守护进程（ daemon ）
💡 什么是 daemon ？ 你可以理解为一个"一直跑在后台的小助手"，这样你每次想用 AI 的时候不用重新启动，它随时待命。
配置完成后，检查一下状态：
openclawgatewaystatus
如果显示 running ，就说明后台服务正常。
注册 MiniMax Token Plan ：为什么我推荐这个
说到 AI 模型，很多人第一反应是 OpenAI 的 ChatGPT 。但对国内用户来说，直接用 OpenAI 有几个现实问题：
所以我更推荐 MiniMax Token Plan，这是国内做的非常好的 AI 模型订阅服务。
为什么推荐 MiniMax ？
套餐对比
MiniMax Token Plan 有两个主要套餐：
| 功能 | Plus ¥20/月 | Max ¥50/月 |
|---|---|---|
| M2.7 模型 | 4,500 次/5 小时 | 15,000 次/5 小时 |
| Speech 2.8 语音 | 4,000 字/天 | 11,000 字/天 |
| 图片生成 image-01 | 50 张/天 | 120 张/天 |
Plus 适合个人日常使用，Max 适合重度用户或者团队。
年付的话价格更优惠，比月付便宜不少。
👉 注册链接（专属优惠）：
https://platform.minimaxi.com/subscribe/token-plan?code=IbZSO0FeYr&source=link
💡 用这个链接注册，可能有专属优惠活动，不要错过哦！
注册完之后，在 MiniMax 控制台找到你的 API Key（一串类似密码的字符），复制下来，接下来配置要用。
配置国内 AI 模型（ MiniMax API ）
好，现在我们把 MiniMax 的 API Key 配置到 OpenClaw 里，让它使用 MiniMax 的模型。
获取 API Key
sk- 开头的字符）配置 OpenClaw
在终端里运行：
openclawconfigsetapi.minimax"你的API Key"
把 你的 API Key 替换成刚才复制的那个（不要带引号）。
或者，你也可以直接编辑配置文件。 OpenClaw 的配置文件通常在：
~/.openclaw/config.yamlC:\Users\你的用户名\.openclaw\config.yaml用文本编辑器（记事本就行）打开这个文件，找到 api: 那部分，添加：
api:
minimax:"你的APIKey"
保存，退出。
验证配置
配置完成后，运行：
openclawgatewayrestart
然后：
openclawgatewaystatus
看到 running 就说明一切正常。
现在你的 OpenClaw 已经在使用 MiniMax 的 AI 模型了！ 试试在 OpenClaw 里问它一个问题，看看响应速度和效果。
常见安装问题 Q&A
我把大家最常遇到的问题整理了一下，遇到坑直接来查这里。
Q1 ：安装命令运行到一半卡住了，怎么办？
A ：可能是网络问题，国内访问 GitHub 不稳定。可以试试：
- 换成手机热点（有时候 Wi-Fi 限流）
- 配置 GitHub 镜像或者代理
- 多次重试，有时候网络波动只是暂时的
Q2 ：提示"command not found: openclaw"，什么意思？
A ：意思是系统找不到 openclaw 这个命令。通常是因为安装没完成，或者环境变量没配置好。
解决方法：
1. 重新运行安装命令
2. 如果用的是 zsh （ macOS 默认），可以试着把 source ~/.zshrc 加到配置文件里
3. 重启终端，再试一次
Q3 ： npm 安装报网络错误，怎么解决？
A ：这是典型的 npm 源问题。请确认你已经运行了换源命令：
npmconfigsetregistryhttps://registry.npmmirror.com
如果还是不行，可以试试阿里云的备用镜像：
npmconfigsetregistryhttps://registry.npmmirror.com
Q4 ： openclaw onboard 的时候报权限错误？
A ：权限错误在 macOS/Linux 上比较常见。解决方法：
sudoopenclawonboard--install-daemon
输入你的电脑登录密码（输入时屏幕不显示字符，这是正常的 Linux 安全机制，输入完回车就好）。
Q5 ：已经装好了，但是 gateway status 显示 not running ？
A ：先尝试手动启动：
openclawgatewaystart
如果还是不行，看一下错误日志：
openclawgatewaylogs
把错误信息贴出来，大多数问题都能从日志里找到原因。
Q6 ： MiniMax API Key 报错"invalid"或者"配额不足"？
A ：
- Invalid：检查一下 Key 有没有复制完整，有没有多余的空格
- 配额不足：去 MiniMax 控制台查看你的套餐用量，可能当月的次数用完了，需要等刷新或者升级套餐
Q7 ： Windows 用户安装后找不到 openclaw 命令？
A ： PowerShell 里试试加 .\ 前缀：
.\openclaw gateway status
或者用管理员模式打开 PowerShell 再试。
Q8 ：安装成功了，但是连接飞书/微信的时候报错？
A ：连接飞书/微信属于高级配置，通常需要额外的 App ID 和 App Secret ，这些要去对应的开放平台申请。配置命令是：
openclawconfigsetchannel.feishu.appid"你的AppID"
openclawconfigsetchannel.feishu.appsecret"你的AppSecret"
具体申请流程比较长，建议先确认 OpenClaw 本身能正常运行，再来搞这些。
下一步——连接飞书/微信，开始你的 AI 助手之旅
到这里， OpenClaw 的基础安装和配置就全部搞定了！🎉
但这只是开始。 OpenClaw 真正强大的地方，是它可以连接到你的飞书、微信——让 AI 助手直接进群，随时回答问题、帮你处理信息。
连接飞书
openclawconfigsetchannel.feishu.appid"你的AppID"
openclawconfigsetchannel.feishu.appsecret"你的AppSecret"
openclawgatewayrestart
连接微信（企业微信）
企业微信的接入稍微复杂一些，需要有企业微信管理员权限。
💡 连接这部分内容较多，如果你感兴趣，我后续会专门出一篇教程来讲。
探索更多功能
安装完成之后，可以用这些命令来探索 OpenClaw 的能力：
openclawdashboard
openclaw--help
openclawdocs
写在最后
好了，教程到这里就结束了。
我知道这一步迈出去不容易——你要下载东西、敲命令、面对一些陌生的报错信息。但你做到了。
回望一下，你今天学会了：
- 安装 Node.js 环境 ✅
- 给 npm 换了国内镜像 ✅
- 安装并配置了 OpenClaw ✅
- 注册了 MiniMax ，接入了国产 AI 模型 ✅
- 知道怎么查文档、提问题 ✅
这些都是实打实的能力。以后你装任何开发相关的工具，这些经验都能用上。
有问题欢迎随时回来查这篇教程，或者去 OpenClaw 的官方文档找答案。
你的 AI 助手之旅，现在正式开始了。 🚀
