< 返回

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

    2026-03-09 10:54 作者:技术部 阅读量:5

    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

    联系我们
    返回顶部