香港云服务器首购 
云计算服务
服务器租用
DDOS 防护
虚拟主机
域名服务
基础设施
关于我们
2026 年，开源 AI 智能体 “龙虾 Open Claw” 凭借私有化部署、多平台适配、自主执行任务的核心优势，成为个人与企业降本增效的首选工具。CentOS 作为服务器领域主流系统，稳定性强、生态成熟，是搭建龙虾 Open Claw 的优选平台。但新手常因系统版本不匹配、依赖版本过低、防火墙 / SELinux 配置不当导致安装失败。
本文结合 2026 年最新实测数据、官方文档与 CentOS 专属适配方案，从环境准备、核心安装、配置优化、故障排查四大模块，详细拆解 CentOS 系统安装龙虾 Open Claw 的完整流程，重点解决 CentOS 7/8/9 版本差异、依赖安装、端口开放等关键问题，步骤清晰、可直接复制执行，确保新手零失败搭建成功。
一、安装前必做准备（决定 90% 的成功率）
1. 系统与硬件要求（核心底线，不可妥协）
| 项目 | 最低要求 | 推荐配置 | 说明 |
|---|---|---|---|
| CentOS 版本 | CentOS 8+（推荐 9/Stream） | CentOS 9 Stream | CentOS 7 因 glibc 版本过低，无法安装 Node.js 22+，需升级 |
| CPU | 2 核（vCPU） | 4 核 | 保证指令解析、脚本执行流畅 |
| 内存 | 4GB（≥2GB） | 8GB | 避免程序启动崩溃、依赖安装失败 |
| 存储 | 20GB SSD | 50GB NVMe SSD | 高速读写，程序启动与依赖安装更高效 |
| 网络 | 1Mbps + 带宽 | 5Mbps+ | 需拉取源码、安装依赖，国内用户需稳定网络 |
2. 核心依赖与工具准备
必备工具：git（拉取源码）、curl（下载脚本）、vim（编辑配置）
核心依赖：Node.js ≥22.0.0（LTS 版，官方推荐）、pnpm（包管理器，替代 npm）
关键凭证：大模型 API 密钥（Minimax、阿里云百炼、Claude 等支持 OpenAI API 的平台）
3. 前期环境检查（规避 90% 踩坑）
检查系统版本
执行命令，确认 CentOS 版本≥8：
cat /etc/os-release
若为 CentOS 7，需先升级系统或重装 CentOS 8+/9。
更新系统依赖
清理旧缓存并更新系统包，确保环境干净：
sudo dnf clean all && sudo dnf update -y # CentOS 8/9 # 若为CentOS 7，执行：sudo yum clean all && sudo yum update -y
安装基础工具
安装git、curl、vim等必备工具：
sudo dnf install -y git curl vim # CentOS 8/9 # 若为CentOS 7，执行：sudo yum install -y git curl vim
检查网络连通性
测试能否访问 GitHub 与国内镜像源，确保依赖下载通畅：
curl -I https://gitee.com # 国内镜像，优先测试 curl -I https://github.com
若访问失败，检查服务器防火墙与 DNS 配置。
二、CentOS 系统安装龙虾 Open Claw
（一）安装 Node.js 与 pnpm（核心依赖，必装）
龙虾 Open Claw 基于 Node.js 开发，必须安装 Node.js 22.0.0 及以上版本，CentOS 默认源版本过低，需通过 NodeSource 仓库安装。
添加 NodeSource 仓库并安装 Node.js
以 Node.js 22 LTS 为例（长期支持版，稳定性最强）：
# 下载并执行NodeSource安装脚本 curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash - # 安装Node.js sudo dnf install -y nodejs # CentOS 8/9 # 若为CentOS 7，执行：sudo yum install -y nodejs
验证 Node.js 安装
输出版本号≥22.0.0 即表示成功：
node -v # 输出示例：v22.0.0 npm -v # 输出对应npm版本
安装 pnpm 并配置国内镜像
pnpm 安装速度快、依赖冲突少，是龙虾 Open Claw 推荐的包管理器；国内用户配置淘宝镜像，提升下载效率：
# 安装pnpm npm install -g pnpm # 配置pnpm国内镜像（关键！） pnpm config set registry https://registry.npmmirror.com/ # 验证pnpm安装 pnpm -v # 输出版本号即成功
（二）拉取龙虾 Open Claw 源码（国内优先选 Gitee）
为避免 GitHub 访问慢，优先从Gitee 国内镜像拉取源码，提升下载速度：
# 创建安装目录（建议放在/opt或用户目录，避免C盘权限问题） mkdir -p ~/openclaw && cd ~/openclaw # 从Gitee克隆源码（国内速度快） git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git # 进入源码目录 cd openclaw-cn
（三）安装项目依赖（一键执行，无冲突）
进入源码目录后，执行 pnpm 安装依赖，自动处理所有包依赖：
# 安装项目所有依赖（首次安装需几分钟，耐心等待） pnpm install # 验证依赖安装（查看node_modules目录是否生成） ls -la | grep node_modules
若出现依赖安装失败，重新执行pnpm install即可。
（四）配置大模型 API 密钥（核心功能开关）
龙虾 Open Claw 需调用大模型才能执行智能任务，需将 API 密钥填入配置文件：
进入配置目录：
cd config
编辑配置文件（使用 vim 编辑）：
vim config.json
填入 API 密钥：
找到"openai"节点下的"apiKey"字段，将获取的 API 密钥填入，示例如下：
json
{
"openai": {
"apiKey": "sk-你的API密钥", // 替换为真实密钥
"baseURL": "https://api.minimax.chat/v1" // 若用Minimax，替换为对应地址
},
"port": 18789 // 默认通信端口，无需修改
}保存退出：按Esc键，输入:wq回车。
（五）启动龙虾 Open Claw（两种方式，按需选择）
1. 前台启动（测试用，关闭终端则停止）
返回源码主目录，执行启动命令：
cd ~/openclaw/openclaw-cn # 回到源码根目录 pnpm start
启动成功后，输出OpenClaw started on port 18789即表示运行正常。
2. 后台启动（生产用，终端关闭不停止）
使用pm2工具实现后台运行，确保长期稳定：
# 安装pm2 pnpm install -g pm2 # 启动龙虾Open Claw并设置开机自启 pm2 start src/index.js --name openclaw pm2 startup # 生成开机自启命令，按提示执行即可 # 查看运行状态 pm2 status # 状态为online即正常
（六）开放端口与防火墙 / SELinux 配置（关键，必做）
CentOS 默认防火墙与 SELinux 会拦截外部访问，需开放 18789 端口（龙虾 Open Claw 默认端口），否则无法远程访问管理面板。
1. 开放防火墙端口
# 永久开放18789/tcp端口 sudo firewall-cmd --permanent --add-port=18789/tcp # 重新加载防火墙规则 sudo firewall-cmd --reload # 验证端口是否开放 sudo firewall-cmd --list-ports # 输出18789/tcp即成功
2. 处理 SELinux（CentOS 专属，可选但推荐）
若 SELinux 为开启状态，可能导致端口访问失败，需添加端口规则：
# 查看SELinux状态 getenforce # 输出Enforcing表示开启 # 临时关闭SELinux（测试用，重启失效） setenforce 0 # 永久关闭（生产用，需重启） sudo vim /etc/selinux/config # 将SELINUX=enforcing改为SELINUX=disabled，保存退出后重启服务器
若需保留 SELinux，执行以下命令添加端口类型：
sudo semanage port -a -t http_port_t -p tcp 18789
三、验证安装：确认龙虾 Open Claw 正常运行
1. 本地验证（服务器终端）
curl http://localhost:18789
返回管理面板 HTML 代码即表示本地访问成功。
2. 远程验证（本地电脑浏览器）
打开浏览器，访问http://服务器IP:18789，若能看到龙虾 Open Claw 管理面板，说明端口开放成功、程序可远程访问。
3. 功能测试（核心验证）
打开 Telegram，搜索龙虾 Open Claw 机器人（安装时自动生成），发送指令"整理一份文档"或"编写一个简单脚本"，若机器人能正常响应并执行任务，说明安装完全成功。
四、CentOS 专属故障排查（新手必看）
结合 2026 年实测经验，CentOS 系统安装常见故障及解决方法如下，确保新手快速排查问题：
1. 报错：Node.js 版本过低（CentOS 7 常见）
原因：CentOS 7 默认 yum 源的 Node.js 版本≤16，无法满足龙虾 Open Claw≥22.0.0 的要求。
解决：
方案 1：升级系统至 CentOS 8+/9（推荐）；
方案 2：通过 NVM 安装高版本 Node.js（略复杂，新手不推荐）。
2. 报错：依赖安装失败（网络超时 / 镜像未配置）
原因：网络不通、未配置国内镜像，导致依赖下载超时。
解决：
# 重新配置pnpm国内镜像 pnpm config set registry https://registry.npmmirror.com/ # 重新安装依赖 pnpm install # 若仍失败，从GitHub拉取源码（测试网络） git clone https://github.com/openclaw-team/openclaw.git
3. 报错：端口被占用（18789/tcp）
原因：18789 端口被其他进程占用，导致启动失败。
解决：
# 查找占用18789端口的进程PID sudo ss -tlnp | grep 18789 # 结束对应进程（替换PID） sudo kill -9 进程PID # 重新启动龙虾Open Claw pm2 restart openclaw
4. 报错：无法远程访问管理面板（防火墙 / SELinux 问题）
原因：防火墙未开放端口、SELinux 拦截访问。
解决：
方案 1：重新开放防火墙端口（见前文）；
方案 2：临时关闭 SELinux（setenforce 0），测试能否访问；
方案 3：检查云服务商安全组（如阿里云、腾讯云），需同步开放 18789 端口入站规则。
5. 报错：API 密钥无效（无响应 / 调用失败）
原因：API 密钥填写错误、过期，或权限不足。
解决：
# 重新编辑配置文件，核对密钥 vim config.json # 验证密钥有效性（替换为你的密钥） curl https://api.openai.com/v1/models \ -H "Authorization: Bearer sk-你的API密钥"
若返回 401/403 错误，说明密钥无效，需重新获取。
五、CentOS 系统优化与安全设置（必做）
1. 性能优化（提升稳定性）
关闭无关进程：执行top命令，结束占用 CPU / 内存过高的无关进程，释放资源；
开启虚拟内存：若内存为 4GB，创建 swap 分区，避免内存不足：
sudo fallocate -l 4G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
定期更新依赖：每隔 1-2 个月，进入源码目录执行pnpm update，更新依赖包。
2. 安全设置（规避风险）
限制 API 密钥权限：仅分配 “轻量调用” 权限，避免被盗用产生高额费用；
限制端口访问：在防火墙与云安全组中，仅允许指定 IP 访问 18789 端口，避免恶意攻击；
定期备份数据：备份config（配置文件）、data（记忆数据）目录，避免服务器故障导致数据丢失；
禁止违规操作：龙虾 Open Claw 权限较高，禁止用于部署违规内容、执行越权操作，避免服务器被攻击。
六、CentOS 安装龙虾 Open Claw 核心要点
CentOS 系统安装龙虾 Open Claw 的核心逻辑是“适配版本→安装依赖→拉取源码→配置 API→开放端口”，关键在于系统版本≥8、Node.js≥22.0.0、防火墙 / SELinux 开放 18789 端口。
新手优先选择CentOS 9 Stream，兼容性最强；
国内用户务必配置pnpm 国内镜像，提升依赖下载速度；
生产环境使用pm2 后台启动，确保程序长期稳定运行；
重点关注防火墙 / SELinux 配置，避免端口访问失败。
按本文步骤操作，新手可在 30 分钟内完成安装，实现 “自主执行任务、24 小时值守” 的核心需求。若安装过程中仍遇到问题，可对照故障排查模块解决，或联系服务器服务商获取技术支持。
.png)
.png)
