一键部署 OpenClaw
OpenClaw 作为硅谷爆火的开源 AI 智能体,凭借系统级行动力、持久化记忆和多 IM 工具无缝集成的特性,成为新一代「数字员工」标杆。本地部署需解决硬件成本、公网 IP、环境配置等问题,而七牛云全栈应用服务器 LAS 支持开箱即用的一键部署,无需自建环境、无需购置硬件,成本仅为传统硬件部署的 1/500。您有以下2种方式可选
部署前准备
- 七牛云账号,开通两步验证,且账户余额或额度不低于 5 元:完成七牛云账号注册与实名认证(个人 / 企业均可),登录七牛云控制台,并开通两步验证;
- 已获取七牛云 MaaS API Key
- 工具准备:本地电脑安装 SSH 远程连接工具(如 FinalShell、Xshell、Putty),浏览器支持主流内核(Chrome/Edge/Firefox);
- 网络要求:本地设备可访问外网,七牛云 LAS 实例默认放行 22(SSH)、18789(OpenClaw 主端口)端口,无需额外配置防火墙。
基于资源栈编排的一键部署
1. 创建资源栈
登录七牛云控制台,进入云基础资源 - 全栈应用服务器 LAS 页面,点击「资源栈」-「创建资源栈」;
- 选择区域:选择要部署的目标区域
- 填写资源栈名称:如 openclaw
- 选择模块来源:选择 代码仓库同步模块
2. 配置模块信息
在"代码仓库同步模块"页面填写以下信息:
| 字段 | 值 |
|---|---|
| 仓库地址 | https://github.com/qiniu/terraform-module |
| 仓库子目录 | openclaw |
| 仓库分支或 Tag | main(或保持默认) |
模块变量(JSON 格式):
{
"qiniu_maas_api_key": "your-maas-api-key",
"root_password": "your-password"
}
注意:请将 your-maas-api-key 替换为您的七牛 MaaS API Key,your-password 替换为符合要求的密码。
日志或产物存储位置:可选, 保持默认即可
- OpenClaw 配置:/home/openclaw/.openclaw/openclaw.json
- 工作目录:/home/openclaw/.openclaw/workspace
- 初始化日志:/var/log/openclaw-init.log
3. 确认并创建
检查配置无误后,勾选左下角,点击 创建 开始部署。部署过程约需 5-10 分钟。
4.查看输出
部署完成后,在资源栈详情页的 输出值 标签页可以看到:
- instance_id:实例 ID
- public_ip:公网 IP 地址
- ssh_command:SSH 连接命令
- ssh_tunnel_command:SSH 隧道命令
- dashboard_url:Dashboard 访问地址(敏感信息)
5.访问 Dashboard
在本地终端执行(使用输出中的 ssh_tunnel_command):
ssh -N -L 18789:127.0.0.1:18789 openclaw@<七牛云 LAS 服务器 IP>
输入密码后,隧道建立成功(终端会保持连接状态)。
在浏览器中打开输出中的 dashboard_url: http://localhost:18789/?token=<<你的 Dashboard Token>> 即可访问 Dashboard
安全提醒:Dashboard Token 存储在配置文件中,请妥善保管。
6.SSH 登录
使用 openclaw 用户登录实例:
ssh openclaw@<七牛云 LAS 服务器 IP>
openclaw 用户已添加到 sudo 组,可执行管理员操作。
常见问题
Q: 部署失败如何排查?
在资源栈详情页的 资源栈信息 Tab 中,找到 日志或产物存储位置,点击链接查看 Terraform 执行日志进行排查。
Q: 部署失败,提示找不到镜像?
确保选择的区域已上架 OpenClaw 社区镜像(镜像名称格式:OpenClaw-v2026.1.x)。
Q: Gateway 服务未启动?
SSH 登录后检查服务状态:
# 查看初始化日志
cat /var/log/openclaw-init.log
# 手动启动 gateway
openclaw gateway restart
# 检查端口监听
ss -lntp | grep 18789
Q: 如何修改 AI 模型?
编辑配置文件后重启 gateway:
vim ~/.openclaw/openclaw.json
openclaw gateway restart
附录参数说明
必填参数:
| 参数名 | 类型 | 说明 |
|---|---|---|
| root_password | string | 实例密码(root 和 openclaw 用户共用),不少于 8 位,必须同时包含字母、数字和特殊符号 |
| qiniu_maas_api_key | string | 七牛 MaaS API Key |
可选参数(有默认值):
| 参数名 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| instance_type | string | 实例规格 | ecs.t1.c4m8 |
| system_disk_size | number | 系统盘大小(GiB) | 50 |
| internet_max_bandwidth | number | 公网带宽(Mbps) | 100 |
| default_model | string | AI 模型 | minimax/minimax-m2.1 |
| gateway_port | number | Gateway 端口 | 18789 |
| instance_name_prefix | string | 实例名称前缀 | openclaw |
支持的模型(通过七牛 MaaS):
- minimax/minimax-m2.1(默认)
- deepseek/deepseek-chat
- qwen/qwen-max
- 其他七牛 MaaS 支持的模型
基于云主机专属镜像的一键部署
1. 创建 LAS 实例,选择 OpenClaw 专属镜像
登录七牛云控制台,进入云基础资源 - 全栈应用服务器 LAS 页面,点击「实例」-「创建服务器」;
2. 实例配置选择
- 地域:按需选择(中国、亚太等多区域已部署,推荐就近选择降低延迟);
- 实例规格:个人测试推荐轻量型 T1(ecs.t1.c1m2,1 核 2GiB),企业使用可选择计算型 C1 系列(2 核 4GiB 至 32 核 64GiB);
- 镜像:必须选择社区镜像 Clawdbot-v2026.1.24-3.xx 或 OpenClaw-v2026.1.29.xx,操作系统为 Ubuntu 24.04LTS,已预装 OpenClaw 核心环境;
- 填写并确认实例密码(需牢记,后续 SSH 登录使用),点击「立即购买并创建」,等待 1-2 分钟,实例即可运行。
3. 远程连接 LAS 实例,初始化 OpenClaw 环境
你可以在已购买的 LAS 实例详情页,点击 远程连接
或者通过本地终端登录
- 在已创建的 LAS 实例详情页,复制实例公网 IPv4 地址,打开本地 SSH 工具,以root账号登录
ssh root@<七牛云 LAS 服务器 IP>
输入创建实例时设置的密码,完成登录
- 执行以下命令,创建独立 OpenClaw 运行账户、配置后台常驻并启动安装程序
# 1. 创建clawd账户并赋予sudo权限,按提示输入clawd账户密码(牢记,后续登录必用)
adduser clawd && usermod -aG sudo clawd && su - clawd
# 2. 配置后台常驻,关闭SSH后仍能持续运行
loginctl enable-linger
# 3. 启动OpenClaw安装程序,按向导提示扫码完成基础配置
clawdbot onboard --install-daemon
4. 接入七牛云大模型,注入 AI 能力
OpenClaw 的核心能力依赖大模型支持,需配置七牛云的 MaaS API Key,实现与 DeepSeek、MiniMax 等模型的无缝对接,步骤如下:
- 编辑 OpenClaw 配置文件,配置模型参数
- 在 SSH 终端中,执行命令打开模型配置文件
nano .clawdbot/clawdbot.json
- 找到"models"配置段,替换为以下内容(将 sk-your-api-key-here 替换为实际获取的七牛云 MaaS API Key):
"models": {
"mode": "merge",
"providers": {
"qiniu": {
"baseUrl": "https://api.qnaigc.com",
"apiKey": "sk-your-api-key-here",
"api": "anthropic-messages",
"models": [
{
"id": "minimax/minimax-m2.5",
"name": "MiniMax-M2.5",
"reasoning": false,
"input": ["text"],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 200000,
"maxTokens": 128000
}
]
}
}
}
若需使用 DeepSeek、Qwen、Kimi 等模型,可在七牛云模型广场复制目标模型的「ID」和「名称」,直接替换上述配置中的 minimax/minimax-m2.5 和 MiniMax-M2.5 即可;
- 使配置生效,设置默认模型
执行以下两条命令,重启网关并绑定默认大模型:
# 重启OpenClaw网关,加载新的模型配置
clawdbot gateway restart
# 设置七牛云MiniMax-M2.5为默认模型(可替换为其他模型ID)
clawdbot models set qiniu/minimax/minimax-m2.5
- 检查服务状态并访问 OpenClaw
执行命令:
ss -lntp | grep 18789
确认 18789 端口已被 clawdbot-gateway 占用。
执行命令获取 dashboard 连接信息:
clawdbot dashboard
终端会输出 Dashboard URL(如http://127.0.0.1:18789/?token=xxxx),复制 Token 用于访问。
执行 SSH 端口映射命令
ssh -N -L 18789:127.0.0.1:18789 clawd@<七牛云 LAS 服务器 IP>
将 <七牛云 LAS 服务器 IP> 替换为实际实例 IP,按提示输入clawd 账户密码
打开本地浏览器,访问链接:http://localhost:18789/?token=<你的Dashboard Token>,即可进入 OpenClaw 互动界面。
常见问题
Q: SSH 登录失败
检查实例是否处于「运行中」状态,公网 IP 是否正确,密码是否输入无误,七牛云 LAS 默认放行 22 端口,无需额外配置;
Q: 18789 端口未监听
确认配置文件修改正确,执行clawdbot gateway restart重启网关,或重新执行安装程序;
Q: 模型调用失败
检查七牛云 MaaS API Key 是否正确,是否已领取七牛云 Token 资源包,模型 ID 是否与七牛云模型广场一致;
Q: 控制台无法访问
确认本地端口映射命令是否正常运行,未关闭终端,Token 是否复制完整。