目录
- 引言
- 一、OpenClaw小龙虾安装方式
- 二、本地Mac小龙虾OpenClaw部署安装教程
引言
3月5日公网已超22万OpenClaw部署实例，一发不可收拾。3月6日，腾讯在深圳腾讯大厦楼下举办过一次临时装机活动，引发近千人排队，之后国内兴起龙虾提供商大战。
早在2月份小龙虾开始火爆，小马曾经写过一篇《初探来会会OpenClaw这只龙虾》，简单阐述了小龙虾是什么以及如何安装。有小伙伴觉得过于简陋了，那行，安排！今天就来沉浸式体验下本地Mac小龙虾OpenClaw的部署安装。
一、OpenClaw小龙虾安装方式
安装教程之前，为什么小马特意想说一下这个呢？因为大部分非专业的同学都会混淆一个概念，安装小龙虾就是安装一本AI软件。其实，不能这么理解的。
OpenClaw小龙虾本质上可以通俗理解为是一个AI Agent 应用（一份程序代码），然后它是通过连接的大模型实现的Agent。然后OpenClaw内所谓的频道其实就是我们通常所说的通过什么通信软件与小龙虾进行交互，比如国内的插件有 飞书、QQ、企微等等，这些通信软件通过小龙虾程序的网关地址和token进行网络交互。
因此，初步理解小龙虾与大模型、频道、还有通信软件之前的关系，有助于搞清楚我们平时讲的那些都是些什么概念。
聊完概念，我们就来说一下云部署安装和本地安装的区别。其实也很好理解，云部署安装是将OpenClaw程序安装在云服务器上的，那么本地安装就是将OpenClaw安装在自己本地的电脑上或者服务器上，本地安装还有一种情形就是有些会将OpenClaw进行进一步软件封装后提供本地安装。这里最大的使用区别是，云机器上相对于用户来说是一台空机器，龙虾助理所需要的所有资料和用户习惯都需要从新开始养成，而本地的天然有资料优势，我本地的资料它一览无余，安装即掌握。
本地安装既然这么好，为什么不直接都用本地呢?首先，本地机器谁也没有那么多呀，其次本地安装目前存在的安全问题仍然存在，龙虾的权限有点大，而且一旦失误或者受到攻击，对自己的本地机器将是一个天大的灾难，乃至无法挽回。
那么问题来了，全国产商风靡一时的免费安装小龙虾服务又是什么概念？
正如上文所说，免费安装本来就是免费的，因为OpenClaw程序本来就是开源的。真正需要收费的是安装之后 的LLM大模型 token购买费用 以及 云服务机器的购买费用，而且小龙虾目前烧token烧得很厉害，非常耗token。
一般主流产商，光在云部署上还会有多种产品。
云部署其实相对都比较简单，产商一般都是提供傻瓜化的一键安装了，免不免费安装其实也是无所谓了，按照教程小白也能很轻松安装。小马认为更重要的反而是后面的龙虾养殖工作，比如SKILLs的加载和制作，龙虾习惯的日益养成等等。只要搞清楚基本概念，安装和使用都不是梦，完全不用焦虑免费排队部署排不上队那一套。
那么重点来了，如何自己本地部署呢？小马之前刷到还有专门请人部署的金主BOSS，也有专门提供部署服务的个人和team，而且一次部署还能收200-300米不等。什么？部署工作这玩意还要花钱部署？真的是隔行如隔山，一个信息差就能大淘金。
好了，下面小马就开始价值200-300米的本地部署教程。😆哈哈哈哈哈。
二、本地Mac小龙虾OpenClaw部署安装教程
无论如何还是要先放上官方软件的开源github地址：https://github.com/openclaw/openclaw。一来是致敬，二来是因为它上面readme有官方的安装教程呀。☺️
看完教程的同学是不是觉得略显复杂？对的，这个不是给小白看的。于是我们还有一个官方教程文档：https://docs.openclaw.ai/install。
还是太难了？
算了，我们自己来吧。
2.1、安装方式
| 安装方式 | 适用场景 | 是否需要 Git | 是否需要 pnpm |
|---|---|---|---|
| 官方安装脚本 | 新手快速安装 | 否 | 否 |
| 手动全局安装 | 已有 Node.js 环境 | 否 | 否 |
| 源码构建 | 开发者或自定义需求 | 是 | 是 |
| Docker 部署 | 跨平台、避免环境冲突 | 否 | 否 |
| WSL2 安装 | Windows 用户推荐 | 否 | 否 |
2.2、系统要求
bash
System requirements
Node.js 版本：推荐 Node 24 或 Node 22.16+，安装脚本会自动处理。
pnpm：仅在从源码构建时需要。
平台支持：macOS、Linux、Windows（WSL2 更稳定）。
如果你已经安装了 Node.js 22+，可以直接使用 npm install -g openclaw@latest 安装 OpenClaw。对于普通用户使用 npm install -g openclaw 或官方安装脚本，无需手动安装 Git。
若你是开发者或从源码安装，需要先安装 Git。
我们选的是 手动全局安装 方式。（当然 官方安装脚本 方式 可能更快更简单）
2.3、手动全局安装
2.3.1、安装Homebrew和node
如果没有Homebrew，先安装。（用于后续安装node）
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装node。
bash
brew install node验证是否安装成功。
bash
node -v
npm -v2.3.2、全局安装命令
大家别急着敲官方的命令哈，一般不出意外的话都会出点意外，有坑（报错）。小马先把验证过成功的命令统一先整理哈，急用的同学可以先照敲，不急的同学我们后续再聊沉浸式过程。
打开Mac命令终端，执行如下命令。
bash
## 以下是过程中前置的全部命令，按步骤敲就可以了。
# 切换为国内淘宝源镜像（后续如需也可自行改回配置为原镜像源）
npm config set registry https://registry.npmmirror.com
# 改为http，避免出现SSH配置错误的问题（但不是必须）
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
# 防止证书报错的解决：如果你只是临时需要安装包，可以禁用 SSL 验证
npm config set strict-ssl false
# npm config set strict-ssl true 安装完成后，建议重新启用
# 以管理员权限安装
sudo npm install -g openclaw@latest
# 清除飞书缓存，避免后续安装插件冲突（坑点）
sudo rm -rf ~/.openclaw/extensions/feishu
openclaw onboard --install-daemon这是从证书报错到设置 strict-ssl false 之后，安装成功的响应。
继续 执行openclaw onboard --install-daemon，我们可以看到如下的界面。
2.3.3、安装配置引导
这里选择yes，往下。
选择快捷安装。
选择你的小龙虾Agent使用的大模型，一般需要先到对应模型平台注册，然后拿到key准备用来配置。（=用来扣钱）
例如 我们选模型提供商 选OpenAI，授权方式选 API Key。
小马没有，先随便配一个。
选择 默认的模型。（这个随便，后续也可以仪表盘界面调整配置）
频道配置，这里就是上文说的，你要选择什么客户端和你的小龙虾交互。这里也可以先跳过，后续到面板配置。
网络搜索提供商的配置，同上，这里也可以先跳过。
Skills技能的配置，这里如果暂时没有想好或者还有清晰的使用场景也是可以先跳过的，后续面板再配置，毕竟这块也是龙虾能力的重点。
Hooks是自动化触发机制，当智能体执行命令时可自动触发对应操作。小白先选 session-memory 完事吧。
体验一下过程。
选择管理龙虾机器人的方式，选 Web UI。
我看可以看到响应，并在浏览器自动打开了地址 http://127.0.0.1:18789/chat?session=main。
我们试着用UI发起交互，对话，可以看到弹出了提示，因为我们大模型key当时是随便配的。
到此，小龙虾程序的安装工作就已经结束了。后续可以在面板把我们安装向导时跳过的部分配置补上。特别是 大模型和 频道交互客户端的配置，就可以基础使用了。
2.3.4、认识面板
网关
这是网关，没有网关，你的"小龙虾"就无法被唤醒和使用。
网关（Gateway）------ AI系统的"总控台"
网关在 OpenClaw 架构中扮演着核心枢纽的角色，所有外部通信都必须经过它中转 。
它的主要功能包括：
- 统一接入入口
无论你是通过飞书、WhatsApp 还是本地 Web 控制台与 AI 交互，消息都会先发送到网关，再由它转发给具体的 AI 智能体（Agent）处理 。
- 协议转换与会话管理
网关能适配不同聊天平台的通信协议，并为每条消息生成唯一的"会话密钥"，确保私聊、群聊任务互不干扰 。
- 服务稳定性保障
执行 openclaw gateway stop 会关闭整个系统对外服务能力，只有重启后（如 openclaw gateway start）才能恢复连接 。
✅ 简单理解：网关 = 家里的路由器，没有它，设备无法联网。
网关 Token 是一种访问凭证，用于验证请求是否来自合法用户，防止未授权访问 。
它的核心作用如下：
身份认证 每次你从浏览器、手机 App 或第三方工具尝试连接 OpenClaw 网关时，系统都会检查你提供的 Token 是否有效，就像登录邮箱需要密码一样 。
频道
这里就是上文所说的，飞书、QQ啥的插件 交互客户端就在这里 完善配置。
定时任务
Skills 技能
你的龙虾的十八般武艺基本全靠它。
2.3.5、龙虾如何停服
命令如下：
bash
# 查看状态
openclaw gateway status
#停止服务
openclaw gateway stop
#启动服务
openclaw gateway run
#启动服务
# openclaw gateway start 这个命令小马没跑成功若要直接杀进程：
bash
# 先找到openclaw进程ID
ps aux | grep openclaw
# 用进程ID查看占用端口
lsof -i :端口号 # 替换为实际端口号
# 或者直接通过进程关联查看
lsof -p 进程ID查看状态
停止服务
启动服务
查看服务进程
关于小龙虾在本地运行的安全注意事项和配置，可以文章引言中提到的文章和小马之前的skill文章《OpenClaw 小龙虾技能扩展 Skills》，今天这篇文章就到这啦。
- 彩蛋的位置~~
