10分钟养一只龙虾:OpenClaw保姆级安装教程
10分钟养一只龙虾:OpenClaw保姆级安装教程
昨天我们认识了龙虾——GitHub星标第一的AI Agent框架。
很多人看完后第一反应是:想试,但不会装。
今天这篇文章,就是为你写的。从零开始,手把手教你把龙虾养起来。
全程不超过10分钟。
安装前的准备:你有Node.js吗?
OpenClaw基于Node.js运行,不是Python。所以第一步,确认你电脑上有Node.js。
打开终端(Mac/Linux)或PowerShell(Windows),输入:
node -v
如果返回 v24.x.x 或 v22.14+,恭喜你,直接跳到下一步。
如果返回”command not found”,你需要先安装Node.js:
- 前往 https://nodejs.org 下载LTS版本
- 安装完成后重新打开终端,再试
node -v
小提示:推荐安装Node 24,这是OpenClaw目前最稳定的运行环境。
3种安装方式,选哪个?
| 方式 | 适合谁 | 优点 | 缺点 |
|---|---|---|---|
| 一键脚本 | 不想折腾的小白 | 一行命令搞定 | 不够灵活,出问题不好排查 |
| npm安装 ✅ | 大多数人(推荐) | 灵活、可控、社区支持好 | 需要手动装Node |
| Docker | 服务器部署/运维人员 | 隔离环境、适合生产 | 配置稍复杂 |
我的建议:第一次装,用npm。 下面也以npm安装为主讲。
7步安装流程
Step 1:确认Node.js环境
node -v # 应该返回 v24.x.x 或 v22.14+
npm -v # 确认npm可用
Step 2:全局安装OpenClaw
npm install -g openclaw@latest
等待1-2分钟,看到安装完成提示即可。
如果报
sharp相关的构建错误,用这个命令替代:
bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Step 3:运行新手引导
openclaw onboard --install-daemon
这个命令会:
– 引导你完成初始配置
– 安装后台守护进程(让龙虾在后台待命)
– 生成默认配置文件
按提示操作就行,一路回车也可以。
Step 4:验证安装
三条命令,全部通过才算成功:
openclaw --version # 确认版本号,如 2026.4.26
openclaw doctor # 检查配置健康,应该全部绿色
openclaw gateway status # 确认网关正在运行
如果三条都OK——恭喜,你的龙虾已经养活了!
Step 5:配置渠道(以微信为例)
龙虾需要通过聊天工具和你交互。国内用户最常用的就是微信。
编辑配置文件(通常在 ~/.openclaw/config.json):
{
"channels": {
"wechat": {
"appId": "你的公众号AppID",
"appSecret": "你的公众号AppSecret",
"dmPolicy": "pairing",
"allowFrom": ["你的微信号"]
}
},
"models": {
"default": "deepseek-chat"
}
}
没有公众号? 用Telegram更简单,只需一个Bot Token:
json
{
"channels": {
"telegram": {
"token": "你的Bot Token",
"dmPolicy": "pairing",
"allowFrom": ["你的Telegram用户名"]
}
}
}
Step 6:重启网关
配置完成后,重启让设置生效:
openclaw gateway restart
Step 7:安装第一个Skill
龙虾的技能叫”Skill”。装第一个试试手感:
openclaw skills install tavily-search
这个技能让龙虾具备了实时联网搜索的能力——不装的话,它只能用训练数据回答,可能过时。
安装完成后查看已装技能:
openclaw skills list
常见报错和解决方法
| 报错 | 原因 | 解决方法 |
|---|---|---|
openclaw: command not found |
npm全局路径不在PATH中 | 运行 npm prefix -g 检查路径,加入PATH |
sharp 构建错误 |
libvips依赖缺失 | SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest |
| Gateway未运行 | 守护进程没启动 | openclaw gateway restart |
| 配置异常 | JSON格式错误或缺字段 | openclaw doctor 检查具体问题 |
| 微信渠道连不上 | IP未加入白名单 | 在公众号后台把服务器IP加入白名单 |
万能排查法:遇到任何问题,先跑一遍
openclaw doctor,它会告诉你哪里不对。
更新龙虾
OpenClaw更新很频繁,建议定期升级:
openclaw update # 默认更新到最新稳定版
openclaw update --channel stable # 指定稳定通道
openclaw update --channel dev # 尝鲜开发版
安装完成!接下来做什么?
你的龙虾已经养好了,但它现在只会基本的对话。
明天,我来教你6个最实用的场景——
- 和龙虾聊天有什么技巧?
- 怎么让它帮你搜索资料?
- 怎么让它帮你写代码?
- 怎么用语音和它交互?
明天预告:《装好了不会用?这6个场景让你3分钟上手OpenClaw》
夜雨聆风