1 前言

最近小龙虾绝对是比较火爆的啦，我也玩一下，体验一下养龙虾的快乐~

2 核心架构

2.1 架构说明

2.2 组件说明

组件	部署位置	功能
OpenClaw Gateway	云端	核心中枢，负责任务分发、权限管理、IM接入
OpenClaw Bridge	云端	桥接层，连接云端Gateway与本地节点
OpenClaw 本地节点	本地电脑	执行具体任务，访问本地资源和设备
IM 软件	任意	用户交互界面（飞书/钉钉/QQ/微信等）

3 软件要求

• Node.js >= 22.0.0 LTS
• Git
• npm 或 cnpm

4 云端 OpenClaw 部署

4.1 按照Git

dnf install git -y

4.2 安装 Node.js 22+

4.2.1 Ubuntu/Debian 系统

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
dnf install nodejs -y

4.2.2 CentOS/RHEL 系统

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
dnf install nodejs -y

4.2.3 验证安装

node -v && npm -v

4.2.4 国内网络加速配置（重要）

由于国内访问 GitHub 和 npm 可能较慢，建议提前配置镜像：

# 配置 npm 国内镜像源 阿里云（推荐）
npm config set registry https://registry.npmmirror.com

验证配置：

npm config get registry

4.3 安装 OpenClaw

4.3.1 方式一（一键安装脚本）

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

4.3.2 方式二（npm 全局安装）（推荐）

npm install -g openclaw@latest --verbose

验证当前进度：
你可以用这个命令实时查看下载进度：

# 另开一个终端，监控网络连接
lsof -i | grep -E "github|npm"

或者直接看 npm 的详细日志：
npm install --verbose 2>&1 | tee install.log
如果看到类似 Downloading binary from https://github.com/... 的日志，说明就是在等 GitHub 下载。

如何查看下载进度和速度：
方法一：查看网络流量（推荐）

# 实时查看这个进程的网络流量
watch -n 1 'ss -ti | grep -A 5 "55175"'

或者更直观地看总流量变化：
# 每隔 2 秒查看一次进程的网络累计流量
watch -n 2 'cat /proc/55175/net/dev

注：最后这个框起来的包特别慢，耐心等待一下

4.3.3 方式三（使用 Yarn 替代 npm）

如果 npm 持续卡顿，可以试试用 Yarn 来安装，它的依赖解析和下载机制有时能绕过 npm 的问题。

使用 Yarn 替代 npm

npm install -g yarn

设置 Yarn 镜像源：

yarn config set registry https://registry.npmmirror.com

用 Yarn 全局安装 OpenClaw：

yarn global add openclaw@latest --verbose

注： --verbose。这个命令会输出非常详细的安装过程，可以让你看到具体是下载哪个包时卡住了，方便定位问题

4.4 验证安装

openclaw --version
或 openclaw --help

如果能正常显示版本号和帮助信息，就说明完全可以用了。

4.5 初始化配置

openclaw onboard

配置向导选项说明：

提示	推荐选择	说明
I understand this is personal-by-default…	Yes	确认安全风险
Onboarding mode	QuickStart	快速开始模式
Model/auth provider	Skip for now	稍后配置模型
Filter models by provider	All providers	显示所有提供商
Select channel	Skip for now	稍后配置渠道
Configure skills now?	No	稍后配置技能
How do you want to hatch your bot?	Do this later	稍后启动

4.6 启动服务

# 启动 Gateway 服务
openclaw gateway start

# 设置开机自启（可选）
sudo loginctl enable-linger $USER

# 查看运行状态
openclaw gateway status

4.7 开放端口

根据云服务商控制台的安全组/防火墙规则，放行 18789 端口（TCP 协议）。

开启单个防火墙端口命令：
firewall-cmd --zone=public --add-port=18789/tcp --permanent
重新加载防火墙配置：
firewall-cmd --reload

如果开启了安全组，还需要在云服务器添加安全组：

参考链接：https://blog.csdn.net/smilehappiness/article/details/105184233?spm=1001.2014.3001.5502

4.8 云端部署验证清单

• SSH 能正常连接服务器
• openclaw --version 能正常输出版本号
• openclaw gateway status 显示服务运行中
• 浏览器能访问 http://ip:18789 并显示控制台
• 已保存管理员 Token

4.9 访问云服务器openclaw

4.10 接入IM，这里以微信举例

云服务器执行命令：

npx -y @tencent-weixin/openclaw-weixin-cli@latest install

微信扫描即可完成配置。

5 可能遇到的问题

5.1 僵尸进程

这个进程状态显示：
进程 20566 是一个僵尸进程（defunct）

关键信息：
[yum] <defunct> - 这表明是一个僵尸进程
父进程 PID 是 20565

状态码显示它已经终止，但未被父进程正确回收

解决方法，首先查找父进程：

ps -ef | grep 20565

根据情况处理：
如果父进程是正常的，可以尝试重启父进程或杀死父进程（僵尸进程会随之消失）
如果父进程已经不存在，系统应该会自动清理，但有时需要重启

强制清理（如果必要）：

# 杀死父进程（假设父进程 PID 是 20565） 杀死父进程后，僵尸进程会成为孤儿进程，由 init (PID 1) 接管并自动清理。
kill -9 20565
注意： 僵尸进程本身不占用系统资源（除了进程表中的一个条目），通常不会影响系统运行。但如果积累过多，可能会耗尽进程表空间。由于这是 yum 命令产生的僵尸进程，可能是之前的 yum 操作被中断导致的。

如果父进程是 init (PID 1)
如果僵尸进程的父进程是 1，说明父进程已经退出，但僵尸进程仍存在。这种情况只能重启系统来清理。

5.2 Cannot find module ‘@buape/carbon’

[openclaw] Failed to start CLI: Error: Cannot find module '@buape/carbon'

手动安装缺失模块：

# 进入 OpenClaw 的全局安装目录
cd /usr/lib/node_modules/openclaw

# 手动安装缺失的依赖
npm install @buape/carbon

修复高危问题：

 npm audit fix --force

5.3 如果按照openclaw过程有问题，重新安装（推荐）（大概率网络导致的）

# 1. 先卸载
npm uninstall -g openclaw

# 2. 清理缓存
npm cache clean --force

# 3. 重新安装
npm install -g openclaw@latest
或者使用 npm install -g openclaw@latest --verbose