Linux上安装OpenClaw完整指南：从零到一的“数字员工”部署

资讯

最近，OpenClaw这个开源AI助手项目彻底引爆了全球科技圈。GitHub星标数一个月内暴涨15.2万+，甚至引发了Mac mini抢购潮——不是果粉在发力，而是大家要给这位“数字员工”配台专属电脑！

今天，我就为你带来最详细的Linux安装教程，让你也能拥有自己的“贾维斯”级AI助手。

一、系统要求：先看看你的机器够不够格

在开始安装前，请确保你的Linux系统满足以下最低要求：

硬件要求

  • 内存：最低2GB，推荐4GB+（内存不足会导致安装失败）
  • 存储：至少20GB可用磁盘空间
  • CPU：x64或ARM64架构，2核以上推荐

软件依赖

  • 操作系统：Ubuntu 18.04+/CentOS 7+/Debian 10+（推荐Ubuntu 22.04/24.04）
  • Node.js：≥ 22.12.0（必须）
  • npm：≥ 9.0.0（随Node.js安装）
  • Git：用于源码安装和更新
  • Python：某些技能可能需要（可选）

网络要求

  • 稳定的互联网连接（首次安装和模型调用需要）
  • 默认使用18789端口，确保不被占用
  • 防火墙允许相关端口通信

二、环境准备：打好基础才能盖高楼

1. 更新系统并安装基础依赖

Ubuntu/Debian系统：

# 更新包列表
sudo apt update

# 安装基础工具
sudo apt install -y curl wget git build-essential

CentOS/RHEL系统：

# 安装EPEL仓库
sudo yum install -y epel-release

# 安装开发工具
sudo yum groupinstall -y "Development Tools"

# 安装其他依赖
sudo yum install -y curl wget git

2. 安装Node.js（关键步骤）

OpenClaw对Node.js版本有严格要求，必须≥22.12.0。以下是推荐安装方法：

使用NVM（Node Version Manager）安装：

# 安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 重新加载环境变量
source ~/.bashrc

# 安装Node.js 22版本
nvm install 22

# 验证安装
node -v  # 应该输出 "v22.x.x"
npm -v   # 应该输出 "9.x.x"或更高

Ubuntu/Debian使用NodeSource仓库：

# 添加NodeSource仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装Node.js
sudo apt-get install -y nodejs

CentOS/RHEL使用NodeSource仓库：

# 添加NodeSource仓库
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -

# 安装Node.js
sudo yum install -y nodejs

三、安装OpenClaw：四种方法任你选

OpenClaw提供了多种安装方式，按推荐程度排序：

🥇 方法一：官方一键安装脚本（最推荐）

这是最简单、最快捷的安装方式，适合大多数用户：

# 官方脚本安装
curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动完成以下工作：

  • 检测你的操作系统
  • 安装必要的依赖
  • 将openclaw命令部署到全局
  • 自动进入onboarding交互式设置向导

如果遇到内存不足的情况（常见于2GB内存的VPS），可以使用以下命令替代：

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

🥈 方法二：npm全局安装

如果你已经安装了Node.js环境，可以直接使用npm安装：

# 使用npm安装
npm install -g openclaw@latest

# 或使用pnpm（更快）
pnpm add -g openclaw@latest

🥉 方法三：从源码安装（开发者模式）

适合需要修改代码或参与开发的用户：

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
pnpm install

# 构建UI
pnpm ui:build

# 构建整个项目
pnpm build

# 初始化并安装为系统后台服务
pnpm openclaw onboard --install-daemon

🐳 方法四：Docker安装

熟悉容器化技术的用户可以使用Docker：

# 拉取官方镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

四、初始化配置：让你的AI助手“活”起来

安装完成后，运行初始化向导：

# 运行配置向导
openclaw onboard --install-daemon

配置向导详细步骤：

步骤1：安全警告

I understand this is powerful and inherently risky. Continue?
● Yes / ○ No

必须选择Yes继续。OpenClaw能直接执行系统命令和操作文件，确实存在风险。建议先阅读安全文档了解详情。

步骤2：模式选择

Onboarding mode
● QuickStart (Configure details later via openclaw configure.)
○ Manual

推荐选择QuickStart，后续可以通过openclaw configure命令详细配置。

步骤3：模型选择

Model/auth provider
● OpenAI (Codex OAuth + API key)
○ Anthropic
○ MiniMax
○ Moonshot AI
○ Google
○ OpenRouter
○ Qwen
○ Z.AI (GLM 4.7)
○ Skip for now

建议选择已有API Key的供应商。如果没有，可以选择Skip for now跳过，稍后配置。

步骤4：消息渠道配置

Select channel (QuickStart)
○ Telegram (Bot API)
○ WhatsApp (QR link)
○ Discord (Bot API)
○ Skip for now

同样，如果没有你希望的渠道，选择Skip for now跳过，稍后配置。飞书、QQ、企业微信、钉钉等国内的渠道都可以通过插件来安装。

步骤5：Skills配置

Skills status
Eligible: 15
Missing requirements: 39
Blocked by allowlist: 0

Configure skills now? (recommended)
● Yes / ○ No

随便选择一个就行，后面我们一般会根据自己的需求安装。

步骤6：安装Gateway服务

Install Gateway service (recommended)
● Yes
○ No

选择Yes，这会安装systemd服务，让OpenClaw在后台持续运行。

五、验证安装：看看你的AI助手是否“健康”

安装完成后，使用以下命令验证：

基本状态检查

# 查看整体状态
openclaw status

# 查看详细状态
openclaw status --all

# 检查网关运行状态
openclaw gateway status

健康检查

# 快速健康检查
openclaw health

# 深度健康检查
openclaw health --deep

# 安全审计
openclaw security audit

成功标志

  • ✅ openclaw status显示网关正在运行
  • ✅ openclaw health返回健康状态
  • ✅ 网关端口18789可以访问
  • ✅ 可以通过浏览器访问 http://127.0.0.1:18789/

六、远程访问：在本地电脑控制服务器上的AI

如果你的OpenClaw安装在远程服务器上，可以通过SSH端口转发在本地访问：

# SSH端口转发
ssh -N -L 18789:127.0.0.1:18789 user@your-server-ip

然后在本地浏览器中访问：

http://localhost:18789/#token=你的token

token在哪里找？

  • 在初始化配置时显示
  • 保存在 ~/.openclaw/openclaw.json文件中
  • 在Gateway配置的auth部分

七、常见问题及解决方案

1. 内存不足导致安装失败

症状：安装过程中进程被Killed

解决方案：

# 使用git方法安装，减少内存占用
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --method git

# 或增加swap空间
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

2. sharp模块安装错误

症状：sharp模块编译失败

解决方案：

# 设置环境变量
export SHARP_IGNORE_GLOBAL_LIBVIPS=1

# 重新安装
npm install -g openclaw@latest

3. 入口文件后缀问题

症状：安装脚本寻找.js文件但最新版是.mjs

解决方案：

# 手动创建入口文件
cat > /usr/local/bin/openclaw << 'EOF'
#!/bin/bash
# 注意这里指向的是 .mjs 文件
exec node "/root/openclaw/dist/entry.mjs" "$@"
EOF

# 修改权限
chmod +x /usr/local/bin/openclaw

4. systemd服务启动失败

症状：systemctl --user status openclaw-gateway显示失败

解决方案：

# 检查服务文件
vim ~/.config/systemd/user/openclaw-gateway.service

# 重新加载systemd配置
systemctl --user daemon-reload

# 重启服务
systemctl --user restart openclaw-gateway

八、安全警告：便利从不免费

OpenClaw以其能接管电脑、直接执行任务的特性吸引了大量关注，也带来了新的安全隐患。

主要风险：

  1. 公网暴露：全球有上万OpenClaw实例被直接暴露在公网上，处于无防护的"裸奔"状态
  2. 提示词注入：黑客只需给你发一封夹带恶意指令的邮件，当OpenClaw读取并"理解"时，就可能被操控去窃取资料或执行破坏命令
  3. 持续记忆风险：由于它拥有持续记忆，一次攻击的影响可能潜伏数周后才爆发

安全建议：

  1. 隔离运行：不要在个人主力电脑上运行OpenClaw，建议使用独立的服务器或虚拟机
  2. 账号隔离：只在OpenClaw设备上登录权限受限的小号
  3. 互相检查：设置多个AI互相检查的工作流，让AI们互相博弈，把错误率降到极低
  4. 关键检查还得自己做——AI可以干活，但AI不能替你坐牢，也不能替你赔钱

九、进阶配置：让你的AI助手更强大

1. 配置国产大模型

如果你希望使用国产大模型（如智谱GLM、通义千问、MiniMax等），可以在配置向导中选择相应供应商，或手动配置：

# 查看可用的模型供应商
openclaw configure --section models

# 配置智谱GLM
openclaw config set models.provider "zai"
openclaw config set models.zai.apiKey "你的API密钥"

2. 配置飞书等国内渠道

OpenClaw默认不支持国内通讯工具，但可以通过插件安装：

# 安装飞书插件
openclaw skills install feishu

# 配置飞书App ID和Secret
openclaw config set channels.feishu.appId "你的App ID"
openclaw config set channels.feishu.appSecret "你的App Secret"
openclaw config set channels.feishu.mode "websocket"

3. 安装实用Skills

OpenClaw有一个丰富的技能市场，可以安装各种实用功能：

# 查看可用的Skills
openclaw skills list

# 安装常用Skills
openclaw skills install web-search    # 网页搜索
openclaw skills install file-manager  # 文件管理
openclaw skills install email-client  # 邮件客户端

十、维护与更新

如何更新OpenClaw

# 使用内置更新命令
openclaw update

# 或重新安装
npm install -g openclaw@latest

# 运行医生检查
openclaw doctor

如何卸载OpenClaw

# 停止服务
openclaw gateway stop

# 移除服务
openclaw gateway uninstall

# 卸载CLI
npm uninstall -g openclaw

# 清理配置（可选）
rm -rf ~/.openclaw

备份和恢复

# 备份配置
cp -r ~/.openclaw ~/.openclaw.backup

# 恢复配置
cp -r ~/.openclaw.backup ~/.openclaw

结语：你的数字员工已就位

OpenClaw不仅仅是一个工具，它代表了一种全新的AI哲学：Your assistant. Your machine. Your rules（你的助手，你的机器，你的规则）。

它让AI的所有权从平台回到了个人。一旦习惯了"AI跟着你走"，就很难再回到"打开App找AI"的旧范式。这种变化是不可逆的。

未来，我们不再仅仅是AI的使用者，而是数字生命的培养者。OpenClaw这样的工具，让我们第一次有机会拥有真正属于自己的、可以长期协作、持续成长的数字伙伴。

这不仅仅是技术的进步，更是工作方式、生活方式乃至存在方式的革命。

AI是最强的画笔，而你，就是那个握笔的灵魂画手。

你准备好迎接你的数字员工了吗？它正在等待你的第一句指令。

腾讯云精选福利

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

腾讯云精选福利