文章目录

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 modeQuickStart快速开始模式
Model/auth providerSkip for now稍后配置模型
Filter models by providerAll providers显示所有提供商
Select channelSkip 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

5.4 npm证书报错（mac pro解决思路）

npm http fetch GET https://registry.npmmirror.com/openclaw attempt 1 failed with UNABLE_TO_GET_ISSUER_CERT_LOCALLY npm http fetch GET https://registry.npmmirror.com/openclaw attempt 2 failed with UNABLE_TO_GET_ISSUER_CERT_LOCALLY

解决思路：

# 正确配置（安全）
npm config set registry https://registry.npmmirror.com
npm config set strict-ssl true

# 如果还有证书错误，用这个方法升级系统 CA
brew install ca-certificates

export NODE_EXTRA_CA_CERTS=$(brew --prefix ca-certificates)/share/ca-certificates/cacert.pem

echo 'export NODE_EXTRA_CA_CERTS=$(brew --prefix ca-certificates)/share/ca-certificates/cacert.pem' >> ~/.zshrc
# 人工智能
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

我用 NVIDIA SkillSpector 纯静态扫了一遍 GitHub 最火的 agent skills：能挖出多少注入？0 个

avatar 龙虾开发者社区
cover

周榜换血九成，Agent Skills 星数翻倍

avatar 龙虾开发者社区

写给 TypeScript 工程师的 OpenClaw.NET 上手指南：用你熟悉的 TS 思维，跑起一个生产级 AI Agent

读代码层：TS 和 C# 本来就是「远房亲戚」——asyncawait??、接口、泛型、严格空检查，你的心智模型几乎无缝平移。真正要适应的只有两件事：类型是具名而非结构化的（多一句显式声明），以及 NativeAOT 下的「禁反射」约束。写扩展层：你甚至可以不怎么碰 C#——Node.js 插件桥意味着你的 TypeScript 插件就是一等公民，而且能在生产 aot 车道跑。内核给你 .NET

avatar 龙虾开发者社区