OpenClaw 安装教程:中国开发小白从 0 到 1 完整指南

你有没有过这样的经历——

看到别人用 AI 助手写代码、查资料、分析数据，效率翻了好几倍，心里痒痒的，想着"我也想整一个"。结果一打开安装文档，满屏都是命令行、环境变量、 PATH 配置……还没开始就劝退了。

我懂你。

作为一个从零走过来的人，我太知道那个"第一步"有多难迈了。今天这篇文章，就是写给完全没有技术背景、第一次接触这类工具的朋友们的。手把手，一步一步，带你从 0 到 1 ，把 OpenClaw 这个超强的 AI 助手装好、跑起来。

读完你就会发现——其实没那么难，我在旁边呢。

OpenClaw 是什么？

先说清楚这个东西是干啥的。

OpenClaw 是一个本地运行的 AI 助手框架，你可以把它理解成一个"AI 操作系统"。装好之后，它能帮你：

•操作电脑：用自然语言让它帮你查文件、改配置、跑脚本

•连接各种 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

你会看到它开始问一些问题，比如：

•你想用哪个 AI 模型？

•你的 API Key 在哪里？

•要不要连接飞书/微信？

不要慌，跟着提示一步步来就好。如果你现在手边还没有 API Key ，可以直接按回车跳过，之后再配置。

它会自动：
- 创建配置文件
- 设置好运行环境
- 启动后台守护进程（ daemon ）

💡 什么是 daemon ？你可以理解为一个"一直跑在后台的小助手"，这样你每次想用 AI 的时候不用重新启动，它随时待命。

配置完成后，检查一下状态：

openclawgatewaystatus

如果显示 running ，就说明后台服务正常。

注册 MiniMax Token Plan ：为什么我推荐这个

说到 AI 模型，很多人第一反应是 OpenAI 的 ChatGPT 。但对国内用户来说，直接用 OpenAI 有几个现实问题：

1.需要科学上网，而且不稳定

2.API 访问速度受线路影响，响应慢

3.充值麻烦，需要外币卡

4.中文支持不如国产模型

所以我更推荐 MiniMax Token Plan，这是国内做的非常好的 AI 模型订阅服务。

为什么推荐 MiniMax ？

•✅ 国内直连：不需要任何代理，响应速度快

•✅ 全模态覆盖：文本、图片、语音、视频，一个订阅全搞定

•✅ 中文支持极好：毕竟是国产模型，中文理解和生成都很自然

•✅ 充值方便：支付宝/微信支付都可以，年付更便宜

•✅ API 统一管理：不用到处找接口、到处充值

套餐对比

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

1.打开 MiniMax 注册/登录：👉 https://platform.minimaxi.com

2.进入控制台，找到"API"或"开发者"相关页面

3.创建一个新的 API Key ，复制下来（一串 sk- 开头的字符）

配置 OpenClaw

在终端里运行：

openclawconfigsetapi.minimax"你的API Key"

把 你的 API Key 替换成刚才复制的那个（不要带引号）。

或者，你也可以直接编辑配置文件。 OpenClaw 的配置文件通常在：

•macOS/Linux ：~/.openclaw/config.yaml

•Windows ：C:\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 助手直接进群，随时回答问题、帮你处理信息。

连接飞书

1.去飞书开放平台创建一个应用： https://open.feishu.cn/app

2.获取 App ID 和 App Secret

3.在 OpenClaw 里配置：

openclawconfigsetchannel.feishu.appid"你的AppID"
openclawconfigsetchannel.feishu.appsecret"你的AppSecret"
openclawgatewayrestart

连接微信（企业微信）

企业微信的接入稍微复杂一些，需要有企业微信管理员权限。

1.登录企业微信管理后台，创建自建应用

2.获取 AgentId 、 CorpId 、 Secret

3.配置 Webhook 地址，让 OpenClaw 接收消息

💡 连接这部分内容较多，如果你感兴趣，我后续会专门出一篇教程来讲。

探索更多功能

安装完成之后，可以用这些命令来探索 OpenClaw 的能力：

openclawdashboard

openclaw--help

openclawdocs

写在最后

好了，教程到这里就结束了。

我知道这一步迈出去不容易——你要下载东西、敲命令、面对一些陌生的报错信息。但你做到了。

回望一下，你今天学会了：
- 安装 Node.js 环境 ✅
- 给 npm 换了国内镜像 ✅
- 安装并配置了 OpenClaw ✅
- 注册了 MiniMax ，接入了国产 AI 模型 ✅
- 知道怎么查文档、提问题 ✅

这些都是实打实的能力。以后你装任何开发相关的工具，这些经验都能用上。

有问题欢迎随时回来查这篇教程，或者去 OpenClaw 的官方文档找答案。

你的 AI 助手之旅，现在正式开始了。 🚀