乐于分享
好东西不私藏

别再搜教程了!这应该是全网最丝滑的OpenClaw安装指南

别再搜教程了!这应该是全网最丝滑的OpenClaw安装指南

第一步:先把“地基”打好——安装 Node.js

在正式安装 OpenClaw 之前,得先把它的运行环境搞定。这一步不难,说白了就是装一个叫 Node.js 的东西。

你可以把 Node.js 理解成 OpenClaw 的“电”或“土壤”,没有它,啥也跑不起来。

操作如下:

  1. 打开官网:nodejs.org

  2. 根据你的电脑系统(macOS / Windows)下载对应的安装包

  3. 版本建议选 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,输入命令

/newbot

3. 给 Bot 起名字

  • 先起一个显示名称(随便起,比如 我的助手

  • 再设置一个唯一用户名(必须以 bot 结尾,例如 ortex_philip_bot

4. 获取 Token

BotFather 会发回一段类似这样的代码:

1234567890:ABCdefGHIjklmNOPqrstUVwxyz

🔒 这就是 Token,请务必保管好,不要泄露给任何人!

5. 填回终端

复制 Token,切换回终端窗口,粘贴并回车

第五步:其他配置与安装

这一步选项比较多,跟着下面走,不会迷路

📋 逐项操作指南

步骤
操作
建议
搜索提供商
可选 browse 或 search
按需选择即可
配置 Skills
选择 Yes
会在本地生成 Skills 文件夹
安装 Skills
界面列出很多插件
建议选 Skip for now(跳过),先简化流程
最终确认
持续选 No
在 Enable hook? 下按空格选中 Skip for now,回车
Hatch 确认
询问是否 Hatch 你的 Bot
直接回车确认

💡 做完这些,安装界面就会开始正式安装,耐心等一会儿。

第六步:激活与运行

最后一步,让 Bot 和你“握手”成功。

🔗 操作步骤

1. 激活 Bot

回到 Telegram,找到你刚刚创建的 Bot,点击 Start 按钮。

2. 获取配对码

Bot 会自动发送一个配对码(一串数字/字母)。

3. 输入配对码

建议:新开一个终端窗口,把配对码粘贴进去,回车。

4. 完成 ✅

看到提示信息后,代表 OpenClaw 基础配置已完成

⚠️ 重要提醒(避坑指南)

正确做法
❌ 关掉终端
✅ 运行 OpenClaw 的终端千万不能关。可以最小化,但不要关闭。关掉的话,“龙虾”就停止服务了。
❌ 用鼠标点选项
✅ 配置界面里鼠标无效,记得用方向键空格键操作。
❌ 泄露 Token / API Key
✅ 务必保护好你的 Token 和 API Key,不要发给任何人,也不要上传到公开仓库。

🎉 恭喜你!

到这里,OpenClaw 已经完整安装并配置完成

你现在可以:

  • 在 Telegram 里和你的 Bot 对话

  • 打开 openclaw dashboard 查看控制面板

  • 后续逐步接入更多插件和能力

先跑通,再扩展。慢慢玩 🦞