终极 OpenClaw 安装指南!🦞

一篇详尽的OpenClaw终极安装指南。带你从零开始了解什么是OpenClaw,环境准备(包括Node.js和AI API Key),并手把手教你完成安装配置过程。文章还包含如何将OpenClaw接入各类聊天工具,以及如何安装技能插件来打造专属的超能AI助手。

阅读时长: 14 分钟
共 7010字
作者: eimoon.com

到底什么是 OpenClaw??

好吧,想象一下拥有你自己的私人 AI 助手,它基本上就像是《钢铁侠》里的贾维斯,只不过它是一只龙虾。对,你没听错。一只大龙虾。🦞

OpenClaw(它以前叫 Clawdbot,因为龙虾有钳子 (claws),懂了吧?)是一个极其疯狂的程序,它能让你:

  • 通过 WhatsApp、Telegram、Discord、Slack 以及上百万种其他应用与 AI 聊天
  • 让它在你的电脑上自动操作,比如打开程序、搜索网页、基本上可以做任何事
  • 让它记住你的偏好,因此它会随着时间的推移变得越来越聪明
  • 你自己的电脑上运行它,所以你的数据能够保持完全私密(而不是保存在某个莫名其妙的服务器上)

它基本上就像是住在你电脑里的一个超级聪明的机器人朋友,可以帮你做任何事情。我第一次设置好它的时候,整个脑子都被震撼了。


开始之前 - 你需要准备什么(枯燥但重要的部分)

好的,在深入讲解之前,你需要先准备一些东西。别担心,我会详细解释一切

1. 一台电脑

你需要以下其中一种:

  • Mac(苹果电脑)
  • Windows(大多数人使用的普通 PC)
  • Linux(这是一种极客用的操作系统,但实际上非常酷)

2. Node.js(22 及以上版本)

现在你可能会问“ Node.js 到底是个啥??”别担心,我一开始也很懵!

什么是 Node.js? 它基本上是一个让你的电脑能够运行 JavaScript 程序的载体。JavaScript 是一种编程语言(就像英语是一门语言一样,只不过它是给电脑看的)。OpenClaw 是用 JavaScript 构建的,所以我们需要 Node.js 才能让它运行。

如何检查你是否已经安装了它:

打开你的终端 (Mac) 或命令提示符 (Windows)

  • Mac: 按 Command + 空格,输入 “Terminal”(终端),按回车
  • Windows: 按住 Windows 键,输入 “cmd”,按回车

输入以下命令并按回车:node --version

如果你看到类似于 v22.1.0 或者任何以 22 或更高数字开头的版本号,那说明一切准备就绪!

如果它显示“命令未找到” (command not found) 或者显示一个低于 22 的数字,你就需要安装它了。

如果没有,如何安装 Node.js:

去官网:https://nodejs.org

下载标有 “LTS”(长期支持版,意味着最稳定)的版本

运行安装程序(基本上一直点下一步就可以了,非常简单)

再次输入 node --version 来检查是否安装成功。

3. 一个 AI 服务账号

OpenClaw 需要连接到一个 AI 服务才能真正变得智能。你需要准备以下其中之一

选项 A: Anthropic (Claude)

  • 这是我的最爱,因为 Claude 超级聪明!
  • 你需要一个 Claude 账号(Pro 或 Max 版更好,但不是必须的)
  • 访问 https://www.anthropic.com/
  • 注册并获取一个 API key(稍后会演示怎么操作)

选项 B: OpenAI (ChatGPT)

  • 这个选项也很好,而且很多人都在用。
  • 你需要一个 OpenAI 账号
  • 访问 https://openai.com/
  • 注册并获取一个 API key

专家提示: Claude Opus 4.5 做这个真的非常棒,所以如果预算允许,我建议订阅 Claude Pro 或者 Max!

4. 大约 30 分钟的时间

这个设置过程不是超快,但也并不难。只要一步一步跟着做就行!


第一部分:安装 OpenClaw(最简单的部分!)

好了,让我们开始吧!🚀

第一步:打开你的终端/命令提示符

我上面已经解释过怎么做了,但这里再重复一遍:

  • Mac: Command + 空格,输入 “Terminal”
  • Windows: Windows 键,输入 “cmd” 或 “PowerShell”
  • Linux: 哈哈,你可能早就知道怎么开了

第二步:安装 OpenClaw

见证奇迹的时刻到了。我们要用一行命令让安装器帮你搞定一切!

如果是 Mac 或 Linux,精确地输入这个:

curl -fsSL https://openclaw.ai/install.sh | bash

如果是 Windows (请使用 PowerShell),输入这个:

iwr -useb https://openclaw.ai/install.ps1 | iex

这一步在做什么?

让我来拆解一下这个看起来有点怪的命令,因为我一开始也超级困惑:

  • curl -fsSL = 这是一个从网上下载东西的程序
  • https://openclaw.ai/install.sh = 这是安装器存放的网页地址
  • | bash = 这个意思是“把刚刚下载的东西直接运行起来”

所以总体来说,我们在用一个命令下载并运行安装器。很酷对吧?

第三步:等待安装完成

现在你会看到一大巴文字滚动过去。别慌!这很正常。安装器正在:

下载 OpenClaw 安装它需要的所有额外的东西(叫做“依赖”) 设置好一切 如果你没装过 Node.js 的话,也许还在顺带安装 Node.js

这大概需要 2 到 5 分钟,具体取决于你的网速。

第四步:检查是否成功

一旦完成,输入:

openclaw --version

如果你看了一个版本号(比如 v2025.2.14 之类的),成功了! 🎉

如果提示“命令未找到”,说明出了点问题。尝试关闭终端再重新开一个试试。


第二部分:新手引导向导(好玩的部分开始啦!)

好的,现在我们已经装好了 OpenClaw,但它还对你一无所知,也不知道怎么连接到 AI 服务。这就是向导登场的地方了!

第一步:启动向导

输入这个命令:

openclaw onboard --install-daemon

--install-daemon 是什么意思?

“Daemon (守护进程)” 基本上是一个永远在后台运行的程序。它就像是让 OpenClaw 一直待命准备帮助你,即便你关闭了终端它也在运行!

第二步:跟随向导的步骤

现在向导会问你一堆问题。我们挨个来看:

问题 1: “你想给你的助理起个什么名字?”

你可以起任何喜欢的名字!一些很酷的想法:

  • 贾维斯 Jarvis(钢铁侠)
  • 阿尔弗雷德 Alfred(蝙蝠侠)
  • 科塔娜 Cortana(光环)
  • 或自己造一个!我叫我的小助手 “龙虾拉里 (Lobster Larry)",因为我觉得很好笑。

直接输入名字按回车即可。

问题 2: “你想使用哪个 AI 提供商?”

这是在问你想连接到哪个 AI 服务。使用上下方向键来选择:

  • Anthropic(如果你用 Claude)
  • OpenAI(如果你用 ChatGPT)

选好后按回车。

问题 3: “输入你的 API key”

好的,这步非常重要。API key 就像是一个让 OpenClaw 和 AI 聊天服务的密码。

如何获取 API key:

如果你用 Anthropic/Claude:

  1. 访问 https://console.anthropic.com/
  2. 登录账号
  3. 点击菜单里的 “API Keys”
  4. 点击 “Create Key”(创建密钥)
  5. 复制这串密钥(它看起来像一堆杂乱无章的字母和数字)
  6. 把它粘贴进终端里(你可能看不见它显示出来,但相信我,它已经贴进去了)
  7. 按回车

如果你用 OpenAI:

  1. 访问 https://platform.openai.com/api-keys
  2. 登录账号
  3. 点击 “Create new secret key”(创建新的秘密密钥)
  4. 复制它并粘贴到终端
  5. 按回车

重要提示:一定要对这串密钥保密!千万不要把它分享给任何人或者发到网上!

问题 4: “你想使用哪个模型?”

它在问你想用什么级别的“AI大脑”。向导会给你以下选项:

  • claude-opus-4.5(超级聪明,但比较贵)
  • claude-sonnet-4.5(很不错,且便宜一些)
  • gpt-4(OpenAI 的最聪明的那个)
  • 以及其他…

用方向键选一个。强烈推荐选 Claude Opus 4.5!

问题 5: “你们要设置消息渠道嘛? (messaging channels)”

这步是问你要不要把 OpenClaw 连到诸如 WhatsApp、Telegram、Discord 这些应用里。

你可以选:

  • Yes - 如果你想在聊天软件里和它说话(推荐!)
  • No - 如果你想先只在网页面板里用(之后还可以再加)

如果选 Yes,它还会问你要开启哪些平台。

问题 6: “你想设置哪些渠道?”

如果你上一步选了 Yes,你会看到一个列表:

  • WhatsApp
  • Telegram
  • Discord
  • Slack
  • 其他…

通过空格键来选择想要的渠道,选完按回车。

注意:有些渠道需要额外的设置步骤。我们后面细说!

问题 7: “你想安装 Gateway 守护程序嘛?”

一定要选 YES!这能让 OpenClaw 一直在后台运行,随时待命。

按回车后,它就会把你刚选的所有东西部署好!

第三步:等待设置完成

向导现在会:

创建配置文件 启动网关(控制一切的核心) 启动守护进程 做一些最后的检查

这就花个三十来秒。


第三部分:了解刚才发生了什么

好吧,在继续之前,我先解释一下 OpenClaw 刚才在你电脑上留下了些啥:

OpenClaw 主文件夹

它在你主目录里悄咪咪建了一个叫 .openclaw 的隐藏文件夹(带点的都是隐藏文件,调皮!)。

它在哪?

  • Mac/Linux: /home/你的用户名/.openclaw
  • Windows: C:\Users\你的用户名\.openclaw

里面有啥?

  • openclaw.json - 核心配置文件(你所有的设置都在这)
  • credentials/ - 你的 API keys 和各大聊天的登录凭据
  • workspace/ - OpenClaw 保存文件的办公区
  • logs/ - OpenClaw 都在背地里干了嘛的活动记录

网关 (The Gateway)

网关就像是 OpenClaw 的总控制中心。它是一个跑在电脑上的程序,负责管理:

与 AI 服务交流 处理不同聊天软件里发来的消息 运行控制命令 保持一切井井有条

它运行在端口 18789 上(把它想成是电脑上一扇专属的小门)。


第四部分:检查是否一切运转正常

让我们确保这台小机器顺利跑起来了!

第一步:检查网关状态

直接输入:

openclaw gateway status

你应该能看到类似这样的信息:

✓ Gateway is running
✓ Port: 18789
✓ Status: healthy

如果它说 “not running”,输入这个可以手动开启:

openclaw gateway start

第二步:打开控制面板 (Dashboard)

太酷了。 OpenClaw 自带一个极简全能的网页可视化面板!输入:

openclaw dashboard

这会自动唤起浏览器并打开 OpenClaw 的控制面板!它看着非常有专业感,你可以在里面:

  • 直接与你的 AI 对话
  • 监控它当下在做什么
  • 调整设置
  • 也就是看看日志

如果没有自动弹出来,在浏览器里直接输 http://127.0.0.1:18789/ 就行了。

第三步:发第一条消息!

在那个面板的聊天框里,敲下一句:

Hello! Can you introduce yourself? (你好!你能做个自我介绍吗?)

如果 AI 顺滑地回应了你,那么恭喜你!!! 你已经成功把 OpenClaw 安装部署好了!🎉🎊🦞


第五部分:设置消息渠道(绝对酷炫的部分!)

好了各位,现在你可以直接在控制面板和它聊天了,但真正的魔法在于,你可以直接用你常用的日常社交 APP 使唤它!下面是几个主流平台的设置方法:

设置 WhatsApp(非常流行!)

WhatsApp 可能是最难搞的一个,但绝对值得!

第一步:开启登录

openclaw channels login whatsapp

第二步:扫码

你的终端居然会直接打印出一个二维码!你该这么做:

  1. 打开手机端 WhatsApp
  2. 点右上角三个小点(菜单)
  3. 选 “Linked Devices” (已连接的设备)
  4. 点 “Link a Device” (连接一台新设备)
  5. 拿手机摄像头对着电脑屏幕上的二维码一扫
  6. 等它连上就可以了

第三步:测试一下!

在 WhatsApp 里给自己发一条消息(对,其实是可以自己发给自己的!)。说点啥:

Hey! Are you working?

OpenClaw 会立马回你!是不是帅呆了?!

重点安全警告:默认情况下 OpenClaw 只会回复那些被你盖章审批通过的手机号码,免得那些路人甲来烦你的 AI 耗你的钱。要审批通过一个号,使用:

openclaw pairing approve whatsapp +8615555551234

设置 Telegram (电报) - (最简单省事的一个!)

Telegram 比 WhatsApp 简直容易一万倍!

第一步:创建一个 Telegram 机器人 (Bot)

  1. 打开 Telegram,搜索 @BotFather (这是官方管机器人的大头目)
  2. 开启私聊,输入 /newbot
  3. 听从指示,给你的机器人起名字
  4. BotFather 随后会反甩你一串 “Token” (一大串长得不要不要的乱码)
  5. 把它复制下来!

第二步:把 Token 输进 OpenClaw

打开配置文件:

openclaw config edit

找到写着 channels 的部分,加上这段:

"telegram": {
  "botToken": "把-你-的-token-粘-在-这-里"
}

保存并退出。

第三步:重启网关

openclaw gateway restart

第四步:测试一下!

  1. 打开 Telegram
  2. 搜你刚才起的机器人名字
  3. 发起对话
  4. 输入 “Hello!”

你的电报机器人立马就上阵回复了!🤖

设置 Discord (游戏圈狂喜!)

第一步:建个 Discord Bot

  1. 浏览器打开 https://discord.com/developers/applications
  2. 点 “New Application”
  3. 取个花名
  4. 在左侧菜单挑 “Bot”
  5. 点击 “Add Bot”
  6. 点击 “Reset Token” 然后复制得到的那个串
  7. 最下面的几个设置开关要打开:
    • Presence Intent
    • Server Members Intent
    • Message Content Intent

第二步:加进 OpenClaw

再修改:

openclaw config edit

往里面塞这段:

"discord": {
  "token": "你的-bot-token"
}

第三步:邀请机器人进你的服务器

  1. 滚回刚才 Discord 那个页面
  2. 点 “OAuth2” 再点 “URL Generator”
  3. 在上方复选框里只挑 “bot”
  4. 在下方一大堆权限里挑:
    • Send Messages
    • Read Messages
    • Read Message History
  5. 最下面会吐出一条 URL ,复制它
  6. 贴进你的浏览器地址栏里回车
  7. 在页面里选你的那台游戏开黑 Server,授权通过

第四步:重启并测试

openclaw gateway restart

现在回你的 Discord 群组猛发一条 @ 消息试试水吧!

设置其他的渠道

OpenClaw 支持成吨的其他平台:

  • Slack:和 Discord 差不多但针对牛马打工人
  • Google Chat:谷歌全家桶专用
  • Signal:极度注重的加密聊天工具
  • iMessage:苹果自带信息 (只支持用 Mac 跑的人)
  • Matrix:一个去中心化的极客平台
  • 等等等等!

每个平台都有自己的安装姿势,实在想配请直接围观 OpenClaw 官方文档哈。


第六部分:让 OpenClaw 变得绝顶聪明(打上技能与工具补丁)

好,你现在只能让 OpenClaw 当个聊天搭子,但我们要通过给其外挂各类工具来让它变身全能战士!

啥是技能 (Skills)?

技能就好比是 OpenClaw 专门用的“手机 APP”。比如:

  • Web Browsing (网页浏览技能):允许它直接搜外网
  • Calendar (日历管理技能):允许它操持你的时间表
  • File Management (文件管理技能):帮你在电脑上分类找文件
  • 以及茫茫多的其他功能!

如何加装技能

第一步:搜挂件库

https://clawhub.ai 可以一览无余地查到这几百种挂件!

第二步:安装技能

我们装一个最实用的网页搜索技能:

openclaw skills install web-search

第三步:试跑一波

现在掉头问问你的 OpenClaw:

你能帮我上网查点恐龙的相关信息么?

它应该会直接调用搜索引擎并把抓回来的科普信息拍你脸上!

酷炫技能推荐

极度推荐这些极酷的技能!:

  • calendar - 统筹你的各类日程事件
  • weather - 天气问询打更人
  • spotify - 直接帮你点歌切歌
  • file-organizer - 乱扔文件党福音:自动规整特定目录的文件
  • code-helper - 写代码好帮手
  • homework-helper - 作业辅导(别直接无脑抄袭就行!!)

第七部分:进阶玩法(等你彻底搞熟以后再碰)

自定义你的 AI 人设、性格

你不仅可以换皮,还能让它换性格!

第一步:找到 Workspace 文件夹

cd ~/.openclaw/workspace

第二步:修改 SOUL.md (灵魂注入文件!)

这是真的在改性格啊喂!打开它:

nano SOUL.md

你可以手搓几行诸如这样的指令进文件里:

你是一个极其热情并动不动讲段子的 AI。
你的态度应始终给人一种打鸡血的亢奋感。
你特别中意瞎扯两句天文冷知识。

保存之(按 Ctrl+X,再按 Y,回车)。

第三步:重新唤醒

openclaw gateway restart

现在你的 AI 就像彻底被夺舍一样变性了。

跑满 24 小时 7 天

假设你想让 OpenClaw 即便电脑重启了也死守在前线打工:

如果是 Mac/Linux:

事实上刚才那个 --install-daemon 已经这么干了,不放心可以再敲一遍:

openclaw gateway --install-daemon

如果是 Windows:

你得麻烦一点搞一个 Windows System Service 出来。具体怎么操作篇幅有限请移步官方指南。

如何多模型反复横跳

你可以让不同的任务花不一样型号的脑子(比如简单的用最蠢的,难的用最聪明的)!

拉出老伙计配置文件:

openclaw config edit

加个这么一段类似的东西:

"models": {
  "chat": "claude-opus-4.5",
  "quick": "claude-sonnet-4.5",
  "cheap": "gpt-3.5-turbo"
}

现在你就可以好钢用在刀刃上,不重要的废话丢给廉价大模型跑,替钱包省钱了。


第八部分:常见翻车现场(及其自救策略)

翻车 1:“Command not found” (命令未找到)

病因:你的系统终端不认得 openclaw 是哪路神仙。 如何救:

  • 关掉这个黑乎乎的终端窗口,新开一个
  • 重新跑那行长长的安装命令
  • 把 OpenClaw 的路径强行塞进你的环境变量 PATH 里 (这步卡了直接找身边懂电脑的大佬)

翻车 2:“Gateway won’t start” (网关死活启动不起来)

病因:可能某个占着茅坑的进程把你 18789 这个口子堵死了。 如何救:

openclaw gateway --port 18790

换个门牌号不就行了。

翻车 3:“AI isn’t responding” (AI 处于掉线且不理人的状态)

病因与救法

  • 第一时间:查 API key 对不对。
  • 绝大多数情况:你的 AI 提供商那里你的号欠费或者余额为空。充点钱再试试。
  • 通过查日志:输入 openclaw logs 看看哪里飘红了。

翻车 4:“WhatsApp keeps disconnecting” (WhatsApp 整天反复断连)

病因:WhatsApp 小姐的脾气大,查登出查得很严。 如何救:

  • 保持你的这台电脑与这台手机的良好网络状态,且在同一网络。
  • 千万不要在你手机上把那个设备直接登出了。
  • 实在不行重新来一遍,再扫码。

翻车 5:“It’s using too much money!” (它耗掉的 API 费用实在太恐怖了!)

解药:定上限控制阀!打开配置文件 openclaw config edit

"limits": {
  "maxTokensPerDay": 100000,
  "alertWhenOver": 50000
}

第九部分:有了 OpenClaw 后可以用它来做些什么好玩的事

安装配置全都完美搞定之后,试试这些指令发过去:

1. 超级辅导老师

嘿大佬!你能拿我能听懂的人话重新给我解释一遍光合作用到底是怎么一回事吗?

2. 私人日程总管

提醒我明天下午4点必须写完并提交科学作业。

3. 写码私教

你能不能手把手地慢慢教我怎么用 HTML 写一个属于我自己的土气个人小网页?

4. 论文科研向导

我这会儿在赶一篇关于古怪的古埃及的论文,你能帮我梳理提取几个最诡异震撼的历史小八卦吗?

5. 编剧接梗专家

我脑子里有一个“想做大厨的机器人”的故事雏形,能不能帮我填几句台词并续写一个开头?

6. 人型计算器与家教

大哥,求你给我展示一下这个二次方程必须一步一步怎么手算?我要抄解题过程,别给一句话的最终答案。

7. 口语与语法纠错人

我想找你纯用德语练两节回合的打字局?主题就定“在慕尼黑街边点啤酒”。如果你看到哪怕是一个词的小错误,严厉指出并给我修正示范。

8. 没正经的闲扯

话说除了做一只龙虾之外,如果有机会让你挑任何地球生物投胎,你想当啥?请用 100 字阐明理由。

第十部分:保护你在赛博世界的狗命(安全条例)

最后也是极其核心的一块:因为 OpenClaw 这个玩意是真实存在并挂钩着网络世界的工具,防坑至关重要。

1. 枪毙自己也不要乱发 API Key

你的 API key = 你在这个工具体系里的最高无限信用卡提款密码!:

  • 绝对不能截屏然后发朋友圈和 X 表演炫耀。
  • 任何“借个 Key 让我用用”的朋友直接拉黑。
  • 不要明文放在任何公开可见的 GitHub 仓库等位置。

2. 小心涉及隐私的肉身信息

就算你把 AI 当亲人,也不要对它输送如下弹药:

  • 你的精确住址。
  • 手机全号。
  • 老爹的信用卡卡号。
  • 各种平台账号密码。

3. 一定利用它的拉白名单体系 (Pairing System)

就如同咱们上边提到的那个审核机制,请一定要利用好 openclaw pairing approve 把你的账号加白,杜绝各种来路不明的信息唤醒你那还在按照字数扣费的大模型!

4. 不要把它的回答奉为真理

尽管它的确绝顶聪明,但它是大模型驱动的,不可避免地会发狂会瞎掰(所谓幻觉)。一定要:

  • 对于真金白银、生死攸关的信息切勿轻信它的数据,去多方比对复核。
  • 用于学东西找乐子搞辅助可以,完全指望其包抄答案,一旦幻觉翻车你也会跟着一起翻车。

第十一部分:下一步资源导航

继续进修去哪里

未来装杯的进阶指南

熟络之后你可以开始瞎折腾了:

  • 缝合或手写自己专属的魔改技能,实现只有你自己懂的独特功能派发。
  • 配备自动化一条龙系统,每天不用开口他就把任务全给包圆了。
  • 这条有点神仙了:做多智能代理系统,多个不一样的 AI 开场唱“智斗”再把活干完。
  • 将其和物理智能设备挂接:在控制台说一句,就能彻底操控一切。

终生学习

这帮子技术的迭代跟翻书一样快。持续发散你的那份技术狂热。你和这只龙虾接触得越多越深,你会发现它确实是通往另一个新维度的终极敲门砖!

关于

📬 关注我获取更多资讯

公众号
📢 公众号
个人号
💬 个人号
使用 Hugo 构建
主题 StackJimmy 设计