Ubuntu 部署 OpenClaw 智能体框架实战指南

环境准备

安装 Node.js 22+

推荐使用 nvm 安装，可灵活管理 Node.js 版本。

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
source ~/.bashrc

# 安装 Node.js 最新稳定版（确保 v22.x.x 以上）
nvm install node

# 验证 Node.js 版本
node --version
# 正常输出应为 v22.x.x

安装系统依赖

安装必要的系统库，解决运行时可能出现的依赖缺失问题。

sudo apt update && sudo apt upgrade -y
sudo apt install -y libatomic1 # 解决 libatomic.so.1 缺失报错

安装 OpenClaw

提供两种安装方式，推荐新手使用一键脚本，便捷高效；有经验的用户可选择 npm/pnpm 安装，灵活控制版本。

方式一：一键脚本安装（推荐）

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

方式二：npm/pnpm 安装

# 使用 npm 全局安装最新版
npm install -g openclaw@latest

# 或使用 pnpm 安装（内存占用更低，推荐）
# pnpm add -g openclaw@latest

配置与初始化

运行引导向导

执行以下命令，启动 OpenClaw 配置向导，按提示完成各项设置：

openclaw onboard --install-daemon

向导配置说明

• Onboarding mode：选择「QuickStart」（快速启动模式），适合首次部署。
• Model provider：选择你的 LLM 服务商（国内用户：阿里云百炼、DeepSeek；国际用户：Anthropic (Claude)、OpenAI、Google Gemini；免费体验：kimi-k2.5-free，速率限制较严格）。
• Channel：选择需要接入的 IM 平台（Telegram、飞书、Discord 等）。
• Daemon 安装：选择「yes」，自动创建 systemd 服务，实现服务后台运行。

飞书接入示例

1. 登录飞书开放平台，创建企业应用。
2. 在应用管理中获取「App ID」和「App Secret」。
3. 回到 OpenClaw 配置向导，填入上述凭证，完成飞书平台配对。

系统服务化配置

使用 --install-daemon 参数后，向导会自动创建 systemd 服务，无需手动配置；若需验证服务状态或手动创建服务，可参考以下步骤。

服务状态验证与开机自启

# 查看 OpenClaw 服务运行状态
systemctl --user status openclaw

# 设置开机自启（关键命令，确保服务器重启后服务自动运行）
sudo loginctl enable-linger $USER

手动创建 systemd 服务（如需自定义）

# 创建服务配置目录
mkdir -p ~/.config/systemd/user/

# 编写服务配置文件
cat > ~/.config/systemd/user/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw Agent
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/openclaw gateway
Restart=always
RestartSec=10
# 服务异常退出后，10 秒自动重启

[Install]
WantedBy=default.target
EOF

# 重载服务配置并启动服务
systemctl --user daemon-reload
systemctl --user enable --now openclaw

网络与安全配置

部署完成后，需配置防火墙、反向代理及安全加固，保障服务稳定运行和数据安全。

防火墙设置

开放 OpenClaw 运行所需的核心端口，以 UFW 防火墙为例（大部分 Ubuntu 系统默认自带）：

# 开放 Web 控制面板端口（18789/tcp，如需外网访问）
sudo ufw allow 18789/tcp

# 开放 HTTP/HTTPS 端口（如配置 Nginx 反向代理）
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# 开放 SSH 端口（默认 22，用于远程连接服务器）
sudo ufw allow 22/tcp

# 启用防火墙（生效配置）
sudo ufw enable

Nginx 反向代理（生产环境推荐）

生产环境中，建议配置 Nginx 反向代理，实现 HTTPS 加密访问、域名绑定，提升服务稳定性和安全性。配置示例如下：

server {
    listen 443 ssl http2;
    server_name openclaw.yourdomain.com; # 替换为你的域名

    # SSL 证书配置（替换为你的证书路径）
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;

    location / {
        proxy_pass http://127.0.0.1:18789; # 转发至 OpenClaw 服务
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        # 支持 WebSocket 通信（关键配置，确保实时交互正常）
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

安全加固建议

• 非 root 用户运行：创建普通用户，避免使用 root 权限运行服务，降低安全风险。

sudo adduser claw
sudo usermod -aG sudo claw
su - claw
# 切换至 claw 用户，后续操作均在此用户下执行

• 加密存储密钥：使用 OpenClaw Vault 功能，加密存储 API 密钥等敏感信息，避免明文暴露。

openclaw vault set ANTHROPIC_API_KEY sk-ant-...
openclaw vault set TELEGRAM_BOT_TOKEN 123456:ABC...

• 启用配对模式：限制未授权用户访问，仅允许指定账号对接（以 Telegram 为例）。

# 编辑配置文件 ~/.openclaw/config.yaml
channels:
  telegram:
    dmPolicy:
      pairing: allowlist
      - your_telegram_id # 替换为你的 Telegram ID

• 绑定本地地址：防止管理端口直接暴露在外网，仅允许本地访问（配合反向代理使用）。

openclaw gateway --bind 127.0.0.1

常见问题与解决方案

部署和使用过程中，若遇到以下问题，可参考对应解决方案快速排查：

后续优化建议

部署完成后，可通过以下优化，提升 OpenClaw 运行效率、降低成本，并保障服务长期稳定。

1. 模型路由配置

为不同任务配置不同的 LLM 模型，实现资源合理分配：轻量级模型（如 kimi-k2.5-free）处理简单对话、自动化指令，Claude/GPT-4 处理复杂推理、多步骤任务，可降低使用成本 50% 以上。

2. 插件生态扩展

通过 OpenClaw Web UI 安装社区插件，扩展功能边界，支持浏览器自动化、图像生成、日历同步、邮件发送等更多场景需求。

3. 监控与日志管理

定期查看服务日志，及时排查异常，确保服务正常运行：

# 查看实时日志（最后 100 行）
openclaw logs --tail 100

# 查看警告级别及以上日志（快速定位异常）
openclaw logs --level warn

4. 备份策略

定期备份 ~/.openclaw/ 目录下的配置文件和 Vault 加密文件，避免配置丢失或误操作导致服务异常，建议每周备份一次。

总结

通过云服务器部署 OpenClaw，可获得一个 7×24 小时在线、支持多平台联动的自主智能体，无论是作为个人效率工具（自动化处理日常任务），还是团队客服支持（多平台统一响应），都能发挥重要作用。

部署建议：新手优先选择阿里云、百度云的应用镜像一键部署，无需关注环境配置，快速上手；有运维经验的用户，可选择 AWS、Hetzner 等裸机服务器手动部署，获得更高的灵活性和性价比。

注意事项：部署过程中务必妥善保管 API 密钥等敏感信息，建议先在测试环境验证配置无误后，再切换至生产环境使用。