OpenClaw(前身为 Clawdbot / Moltbot)是一个开源的自托管个人 AI 代理框架,支持通过 Telegram、WhatsApp、Discord 等聊天工具用自然语言指挥 AI 真正执行任务(文件操作、浏览器自动化、代码提交、邮件发送等)。在 Ubuntu 服务器上部署后,可实现 24/7 稳定运行,作为你的“数字员工”。
以下是针对 Ubuntu 22.04 / 24.04 LTS 的完整部署流程(基于官方文档 + 社区验证),通常 10–25 分钟完成。
推荐配置(日常使用):
步骤 1:登录服务器 & 更新系统
# 通过 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+(兼容性问题多)。
# 使用官方 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(更快、更省空间)
npm install -g pnpm@latest
步骤 3:安装 Chromium(浏览器自动化工具必须)
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
# 官方一键安装脚本(macOS/Linux 通用)
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动:
验证安装:
openclaw --version
# 应显示类似 2026.3.x 或更高版本
如果一键脚本失败(网络/代理问题),手动安装:
npm install -g openclaw@latest
# 或用 pnpm(推荐)
pnpm add -g openclaw@latest
# 启动配置向导,并安装为后台服务
openclaw onboard --install-daemon
向导会一步步引导(英文界面,但选项简单):
完成后 Gateway 会自动启动。
检查状态:
# CLI 查看
openclaw gateway status
# systemd 查看(用户级服务,非 root)
systemctl --user status openclaw-gateway
常用管理命令:
# 重启
systemctl --user restart openclaw-gateway
# 开机自启(默认已开,如未开执行)
systemctl --user enable openclaw-gateway
# 查看实时日志
journalctl --user -u openclaw-gateway -f
# 或用 CLI
openclaw logs
防火墙放行(如果启用 ufw):
sudo ufw allow 18789/tcp
sudo ufw reload
远程访问 Dashboard(默认 http://localhost:18789):
生产环境不要直接暴露 18789 端口
推荐方式:SSH 隧道(本地电脑执行)
ssh -L 18789:localhost:18789 yourusername@服务器IP
然后浏览器打开 http://localhost:18789
在绑定的 Telegram 给 Bot 发送:
Bot 正常回复 → 部署完成!
推荐进阶:
官方文档:https://docs.openclaw.ai 社区:Discord https://discord.gg/clawd 或 GitHub https://github.com/openclaw/openclaw