第一步:先把“地基”打好——安装 Node.js
在正式安装 OpenClaw 之前,得先把它的运行环境搞定。这一步不难,说白了就是装一个叫 Node.js 的东西。
你可以把 Node.js 理解成 OpenClaw 的“电”或“土壤”,没有它,啥也跑不起来。
操作如下:
打开官网:nodejs.org
根据你的电脑系统(macOS / Windows)下载对应的安装包
版本建议选 Node 24(Node 22.16+ 也可以,放心用)
💡 小技巧:如果你不确定电脑上是不是已经装过 Node.js,可以这样查一下:
Mac 用户 → 打开「终端」
Windows 用户 → 打开「PowerShell」输入下面这行命令,回车:
node -v
如果看到一串版本号(比如 v24.0.0),恭喜你,这一步已经搞定了✅如果提示“找不到命令”,那就按上面步骤正常安装即可,几分钟的事。
第二步:一键安装 OpenClaw(真的只要一行命令)
环境准备好了,接下来就是主角登场——安装 OpenClaw。
别紧张,这一步比你想象的要简单得多。不需要手动下载、不需要解压、不需要配置环境变量,全部交给脚本自动完成。
🍎 Mac / Linux / WSL2 用户
打开终端(Terminal),复制下面这行命令,回车:
curl -fsSL https://openclaw.ai/install.sh | bash全程自动化,你只需要看着屏幕等一两分钟☕
Windows 用户(原生 PowerShell)
打开 PowerShell(建议右键“以管理员身份运行”),粘贴下面这行命令,回车:
iwr -useb https://openclaw.ai/install.ps1 | iex💡 如果遇到执行策略报错,可以先运行:Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser然后再执行上面的安装命令。🐧 WSL2 用户(重点提示)
如果你用的是 Windows + WSL2,强烈推荐直接用 Mac/Linux 的那条 curl 命令,稳定性更好,踩坑更少。
✅ 验证安装是否成功
安装完成后,别急着关窗口。输入下面这行命令,确认一下:
openclaw --version如果屏幕上出现一个版本号(比如 v1.2.3),恭喜你 🎉 —— OpenClaw 已经稳稳地装好了!第三步:配置 OpenClaw(核心步骤,仔细看)
环境装好了,程序也装好了,接下来就是让 OpenClaw 认识你、连上服务。
这一步稍微有一点点配置工作,但别担心——跟着下面走,不会乱。
🔁 如果安装脚本没有自动进入配置向导
在终端中手动输入以下命令:
openclaw onboard --install-daemon然后回车,配置向导就会启动。📋 配置向导操作流程(一步一步来)
向导会依次问你几个问题,按下面的方式操作就行:
1️⃣ 接受条款
屏幕上会出现一份使用条款。
⚠️ 注意:此时鼠标无效需要用键盘的 ← 左方向键 移动到
Yes,然后按 回车 确认。
2️⃣ 选择启动方式
选择 Quick Start(快速开始),回车。
3️⃣ 选择模型(API 配置)
这里会问你用哪个大模型。
👉 推荐选择:Qwen(千问模型)
为什么选它?因为 Qwen 提供了免费的语言模型 API,非常适合刚开始测试和使用的场景。
你需要提前做的事:
前往 Qwen 官网完成免费注册
获取你自己的 API 密钥(API Key)
拿到 API Key 之后,再回到这里粘贴进去。
4️⃣ 选择频道(Channel)
这里选择 Chatbot 模式。
本教程以 Telegram 为例选择后按回车,进入 Telegram Bot 配置。
(如果你暂时没有 Telegram,也可以先选其他支持的频道,逻辑类似)
🎛️ 打开可视化控制面板
配置完成后,在终端输入以下命令:
openclaw dashboard浏览器会自动打开一个页面:
http://127.0.0.1:18789🎉 恭喜!这就是你的 OpenClaw 可视化控制界面。
💡 这一步的目标
先把 OpenClaw 跑起来。不用一次性把所有插件和高级能力都配好。先跑通,再扩展。后面的事情,一步一步来。
第四步:创建 Telegram Bot(获取 Token)
OpenClaw 需要通过 Telegram Bot 和你对话,这一步就是把它“生出来”。
🤖 操作步骤
1. 打开 Telegram,搜索 @BotFather
⚠️ 重要:必须认准带有蓝色认证标志 ✅ 的官方账号假冒账号很多,别点错了。
2. 点击 Start,输入命令
/newbot3. 给 Bot 起名字
先起一个显示名称(随便起,比如
我的助手)再设置一个唯一用户名(必须以
bot结尾,例如ortex_philip_bot)
4. 获取 Token
BotFather 会发回一段类似这样的代码:
1234567890:ABCdefGHIjklmNOPqrstUVwxyz🔒 这就是 Token,请务必保管好,不要泄露给任何人!
5. 填回终端
复制 Token,切换回终端窗口,粘贴并回车。
第五步:其他配置与安装
这一步选项比较多,跟着下面走,不会迷路。
📋 逐项操作指南
browse 或 search | ||
Enable hook? 下按空格选中 Skip for now,回车 | ||
💡 做完这些,安装界面就会开始正式安装,耐心等一会儿。
第六步:激活与运行
最后一步,让 Bot 和你“握手”成功。
🔗 操作步骤
1. 激活 Bot
回到 Telegram,找到你刚刚创建的 Bot,点击 Start 按钮。
2. 获取配对码
Bot 会自动发送一个配对码(一串数字/字母)。
3. 输入配对码
建议:新开一个终端窗口,把配对码粘贴进去,回车。
4. 完成 ✅
看到提示信息后,代表 OpenClaw 基础配置已完成!
⚠️ 重要提醒(避坑指南)
🎉 恭喜你!
到这里,OpenClaw 已经完整安装并配置完成。
你现在可以:
在 Telegram 里和你的 Bot 对话
打开
openclaw dashboard查看控制面板后续逐步接入更多插件和能力
先跑通,再扩展。慢慢玩 🦞
夜雨聆风