乐于分享
好东西不私藏

10分钟养一只龙虾:OpenClaw保姆级安装教程

10分钟养一只龙虾:OpenClaw保姆级安装教程

10分钟养一只龙虾:OpenClaw保姆级安装教程

昨天我们认识了龙虾——GitHub星标第一的AI Agent框架。

很多人看完后第一反应是:想试,但不会装。

今天这篇文章,就是为你写的。从零开始,手把手教你把龙虾养起来。

全程不超过10分钟。


安装前的准备:你有Node.js吗?

OpenClaw基于Node.js运行,不是Python。所以第一步,确认你电脑上有Node.js。

打开终端(Mac/Linux)或PowerShell(Windows),输入:

node -v

如果返回 v24.x.xv22.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》