网宝
登录 快速注册
新闻中心 / / 正文

如何在 Ubuntu 服务器上部署 OpenClaw 系统

2026-03-09 10:54
技术部
← 返回

OpenClaw（前身为 Clawdbot / Moltbot）是一个开源的自托管个人 AI 代理框架，支持通过 Telegram、WhatsApp、Discord 等聊天工具用自然语言指挥 AI 真正执行任务（文件操作、浏览器自动化、代码提交、邮件发送等）。在 Ubuntu 服务器上部署后，可实现 24/7 稳定运行，作为你的“数字员工”。

以下是针对 Ubuntu 22.04 / 24.04 LTS 的完整部署流程（基于官方文档 + 社区验证），通常 10–25 分钟完成。

一、前置条件与服务器准备

推荐配置（日常使用）：

  • CPU：2–4 核
  • 内存：8GB+（4GB 勉强可用，本地模型或多 Agent 建议 12GB+）
  • 磁盘：≥30GB SSD
  • 系统：Ubuntu 22.04 或 24.04 LTS（Server 版或 Desktop 版均可）

步骤 1：登录服务器 & 更新系统

Bash
 
# 通过 SSH 登录（推荐非 root 用户，有 sudo 权限即可）
ssh yourusername@你的服务器IP

# 更新系统
sudo apt update && sudo apt upgrade -y

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

步骤 2：安装 Node.js（必须 v22 LTS）

官方强烈推荐 v22.x，不要用 v20 或 v24+（兼容性问题多）。

Bash
 
# 使用官方 NodeSource 源安装 v22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证（必须看到 v22.x.x）
node --version
npm --version
 
 

可选但强烈推荐：安装 pnpm（更快、更省空间）

Bash
 
npm install -g pnpm@latest
 
 

步骤 3：安装 Chromium（浏览器自动化工具必须）

Bash
 
sudo apt install -y chromium-browser fonts-liberation libappindicator3-1 \
libasound2 libatk-bridge2.0-0 libatk1.0-0 libcups2 libdbus-1-3 \
libgdk-pixbuf2.0-0 libnspr4 libnss3 libxcomposite1 libxdamage1 \
libxext6 libxfixes3 libxrandr2 xdg-utils
 
 

二、安装 OpenClaw（最推荐方式：一键脚本）

Bash
 
# 官方一键安装脚本（macOS/Linux 通用）
curl -fsSL https://openclaw.ai/install.sh | bash
 
 

脚本会自动：

  • 检测 Node.js
  • 全局安装 openclaw CLI
  • 创建默认工作目录（通常 ~/.openclaw 或 ~/openclaw）

验证安装：

Bash
 
openclaw --version
# 应显示类似 2026.3.x 或更高版本
 
 

如果一键脚本失败（网络/代理问题），手动安装：

Bash
 
npm install -g openclaw@latest
# 或用 pnpm（推荐）
pnpm add -g openclaw@latest
 
 

三、运行 Onboarding 向导（核心配置）

Bash
 
# 启动配置向导，并安装为后台服务
openclaw onboard --install-daemon
 
 

向导会一步步引导（英文界面，但选项简单）：

  1. 工作目录 → 保持默认（~/.openclaw 或 ~/openclaw）
  2. 选择大模型（推荐优先级）：
    • Anthropic Claude（Opus / Sonnet 4）→ 粘贴 API Key（从 console.anthropic.com 获取）
    • OpenAI GPT-4o / o1
    • Google Gemini（免费额度高）
    • Ollama 本地模型 → 输入 http://127.0.0.1:11434（需提前安装 Ollama）
  3. Gateway 设置 → 选择“是”作为 daemon 运行（会自动创建 systemd user 服务）
  4. 添加第一个渠道（强烈推荐 Telegram）：
    • 选 Telegram → 去 @BotFather 创建 Bot，拿到 Token 粘贴
    • 手机 Telegram 搜索你的 Bot，发送 /pair 配对码 完成绑定
    • 其他可选：WhatsApp（需手机扫码）、Discord 等
  5. 安全设置（重要！）：
    • 先开启 Read-Only 模式（AI 只能读文件，不能写/删/执行）
    • 设置 PIN 码保护高危操作（shell、写文件、邮件等）

完成后 Gateway 会自动启动。

四、服务管理与开机自启

检查状态：

Bash
 
# CLI 查看
openclaw gateway status

# systemd 查看（用户级服务，非 root）
systemctl --user status openclaw-gateway
 
 

常用管理命令：

Bash
 
# 重启
systemctl --user restart openclaw-gateway

# 开机自启（默认已开，如未开执行）
systemctl --user enable openclaw-gateway

# 查看实时日志
journalctl --user -u openclaw-gateway -f

# 或用 CLI
openclaw logs
 
 

防火墙放行（如果启用 ufw）：

Bash
 
sudo ufw allow 18789/tcp
sudo ufw reload
 
 

远程访问 Dashboard（默认 http://localhost:18789）：

  • 生产环境不要直接暴露 18789 端口

  • 推荐方式：SSH 隧道（本地电脑执行）

    Bash
     
    ssh -L 18789:localhost:18789 yourusername@服务器IP
     
     

    然后浏览器打开 http://localhost:18789

五、第一次测试

在绑定的 Telegram 给 Bot 发送：

  • 简单测试：你好，能做什么？
  • 文件测试（关闭 read-only 后）：在 ~/test 创建文件夹 OpenClawSuccess，里面新建文件 ok.txt 内容“Ubuntu部署成功🦞”
  • 网络测试：用中文总结 Hacker News 今天前5热门

Bot 正常回复 → 部署完成！

六、常见问题快速修复

  • Node 版本不对 → 重新安装 v22（见步骤2）
  • 权限错误 → 不要用 root 运行，用普通用户 + sudo 仅限必要命令
  • Telegram 无响应 → 检查 Token、Bot 是否 mute、服务器出站网络、ufw 是否放行
  • 浏览器工具失败 → 确认 chromium 已安装，必要时 config 加 --no-sandbox
  • 升级：openclaw update

推荐进阶：

  • Docker 部署（更隔离）：git clone https://github.com/openclaw/openclaw && cd openclaw && ./docker-setup.sh
  • 反向代理：用 Nginx/Caddy + HTTPS
  • 监控：简单 cron 脚本检查服务是否活着

 

官方文档：https://docs.openclaw.ai 社区：Discord https://discord.gg/clawd 或 GitHub https://github.com/openclaw/openclaw

QQ客服 提交工单