准备工作

你需要一台云服务器,国内外主流云平台均可。

  • 配置:2核4G 即可满足大多数使用场景
  • 地域:建议选择海外节点(免备案),如新加坡、硅谷、东京等
  • 系统:Ubuntu 22.04 LTS
  • 推荐平台:腾讯云轻量、阿里云轻量、AWS Lightsail、Vultr、搬瓦工等均可

详细部署步骤

1

购买服务器

在任意云平台购买一台轻量服务器:

  1. 选择地域:海外节点(免备案),如新加坡、硅谷、东京
  2. 选择系统:Ubuntu 22.04 LTS
  3. 选择配置:2核4G(够用)
  4. 完成支付,记下服务器 IP 和密码
2

连接服务器

推荐使用 Cursor AI 编辑器 连接服务器,对新手更友好:

  1. 下载安装 Cursor
  2. 安装 Remote-SSH 扩展
  3. Ctrl+Shift+P,输入 "Remote-SSH: Connect to Host"
  4. 输入 root@你的服务器IP

Cursor 内置 AI 助手,遇到问题可以直接询问,非常适合命令行新手。

💡 大部分云平台控制台也支持网页终端直接登录
3

安装 Node.js

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重新加载 shell
source ~/.bashrc

# 安装 Node.js 22
nvm install 22
nvm use 22

# 验证安装
node --version  # 应显示 v22.x.x
💡
觉得步骤太多?

专业团队搭建,1-2 小时帮你全部搞定,零基础也能用。

了解付费搭建服务 →
4

安装 OpenClaw

# 全局安装
npm install -g openclaw@latest

# 验证安装
openclaw --version
5

运行配置向导

# 运行引导配置
openclaw onboard

向导会引导你配置:

  • AI 模型:推荐选择「自定义 OpenAI 兼容」,填入雨落 API
  • 消息渠道:选择飞书/钉钉/企业微信
  • 其他设置:按默认即可
🤔
配置搞不定?

模型选择、渠道接入、人设定制...让专业团队帮你一次配到位。

了解付费搭建服务 →
6

通过管理页面配置

启动服务后,通过 SSH 隧道访问管理页面:

# 在本地电脑执行(建立 SSH 隧道)
ssh -L 18789:127.0.0.1:18789 root@你的服务器IP

然后在本地浏览器打开 http://127.0.0.1:18789

在管理页面中可以:

  • 🧠 Models:添加雨落 API、DeepSeek 等模型
  • 📱 Channels:配置飞书、钉钉等渠道
  • 👤 Agents:设置 AI 人设和行为

💡 推荐使用 雨落 API,一个 Key 可用多种模型

7

启动服务

# 后台运行
nohup openclaw gateway > /tmp/gateway.log 2>&1 &

服务启动后,后续所有配置都可以在管理页面完成。

8

完成!开始使用

现在你可以:

  • 通过管理页面配置渠道和模型
  • 在飞书/钉钉中与 AI 助理对话
  • 随时通过管理页面调整设置

💡 建议使用 SSH 隧道访问管理页面,更安全,无需开放端口

🔧 Systemd 服务配置(可选)

配置 systemd 可以让服务开机自启、崩溃自动重启:

# 创建服务文件
sudo nano /etc/systemd/system/openclaw.service

# 填入以下内容:
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=root
Environment="PATH=/root/.nvm/versions/node/v22.22.0/bin:/usr/bin"
WorkingDirectory=/root
ExecStart=/root/.nvm/versions/node/v22.22.0/bin/openclaw gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

# 启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

# 查看状态
sudo systemctl status openclaw

常见问题

Q: 服务器重启后 Gateway 不自动启动?

A: 配置 systemd 服务,或将启动命令加入 /etc/rc.local

Q: 内存不够用怎么办?

A: 添加 swap 分区:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Q: 如何更新 OpenClaw?

A: 运行以下命令:

npm update -g openclaw
systemctl restart openclaw  # 如果使用 systemd

部署完成,接下来...