Ubuntu 部署 OpenClaw 实战指南

安装 Node.js 推荐使用 nvm 管理版本，确保是 v22.x.x 以上：

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

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

sudo apt update && sudo apt upgrade -y
sudo apt install -y libatomic1

3. 安装 OpenClaw

有两种方式，新手建议用脚本，老手可以用 npm/pnpm：

# 方式一：一键脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 方式二：npm 全局安装
npm install -g openclaw@latest
# 或者 pnpm（内存占用更低）
pnpm add -g openclaw@latest

4. 配置与服务化

运行引导向导 openclaw onboard --install-daemon，按提示选择 QuickStart 模式。Model provider 选你用的服务商（国内可选阿里云百炼、DeepSeek；国际选 Anthropic、OpenAI）。Channel 选要接入的平台，Daemon 安装选 yes 以自动创建 systemd 服务。

飞书接入示例 需要在飞书开放平台创建企业应用，拿到 App ID 和 Secret 后填入向导即可。

验证服务状态 向导会自动处理 systemd，但你可以手动检查：

# 查看服务状态
systemctl --user status openclaw
# 设置开机自启（关键命令）
sudo loginctl enable-linger $USER

如果需要自定义服务配置，可以手动编写 ~/.config/systemd/user/openclaw.service 文件，设置 Restart=always 保证异常退出后自动重启。

网络与安全配置

部署完成后，防火墙和反向代理不能少。

防火墙设置

以 UFW 为例，开放必要端口：

sudo ufw allow 18789/tcp # Web 控制台
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw allow 22/tcp    # SSH
sudo ufw enable

Nginx 反向代理

生产环境建议配 Nginx，绑定域名并开启 HTTPS。重点是把 WebSocket 支持加上，否则实时交互会出问题：

server {
    listen 443 ssl http2;
    server_name openclaw.yourdomain.com;
    
    ssl_certificate /etc/nginx/ssl/cert.pem;
    ssl_certificate_key /etc/nginx/ssl/key.pem;
    
    location / {
        proxy_pass http://127.0.0.1:18789;
        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";
    }
}

安全加固建议

1. 非 root 用户运行：创建普通用户 claw，降低风险。
2. 加密存储密钥：使用 openclaw vault set 命令存储敏感信息，别明文写配置文件。
3. 限制访问：在 config.yaml 中配置 pairing allowlist，只允许指定账号对接。
4. 绑定本地地址：网关启动时加 --bind 127.0.0.1，配合反向代理使用。

常见问题排查

后续优化建议

• 模型路由：简单对话用轻量模型（如 kimi-k2.5-free），复杂推理用 Claude/GPT-4，可降低成本。
• 插件扩展：通过 Web UI 安装社区插件，支持浏览器自动化、邮件发送等场景。
• 监控日志：定期查看 openclaw logs --tail 100，关注 warn 级别日志。
• 备份策略：每周备份 ~/.openclaw/ 目录下的配置和 Vault 文件。

总结

通过云服务器部署 OpenClaw，能获得一个全天候在线、支持多平台联动的智能体。新手优先选应用镜像一键部署，有运维经验的用户推荐手动部署以获得更高灵活性。记住，部署过程中务必保管好 API 密钥，先在测试环境验证无误后再切生产环境。