一键部署 OpenClaw
OpenClaw 作为硅谷爆火的开源 AI 智能体,凭借系统级行动力、持久化记忆和多 IM 工具无缝集成的特性,成为新一代「数字员工」标杆。本地部署需解决硬件成本、公网 IP、环境配置等问题,而七牛云全栈应用服务器 LAS 支持开箱即用的一键部署,无需自建环境、无需购置硬件,成本仅为传统硬件部署的 1/500。您有以下2种方式可选
部署前准备
- 七牛云账号,开通两步验证,且账户余额或额度不低于 100 元:完成七牛云账号注册与实名认证(个人 / 企业均可),登录七牛云控制台,并开通两步验证;
- 已获取七牛云 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 替换为符合要求的密码(不少于 8 位,必须同时包含字母、数字和特殊符号)。
日志或产物存储位置:可选, 保持默认即可
- 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 系列(ecs.c1.c2m4,2 核 4GiB);
- 镜像:必须选择社区镜像 OpenClaw-v2026.3.8.xx,操作系统为 Ubuntu 24.04LTS,已预装 OpenClaw 核心环境;
- 填写并确认实例密码(需牢记,后续 SSH 登录使用),点击「立即购买并创建」,等待 1-2 分钟,实例即可运行。
3. 本地终端配置、访问 OpenClaw
在本地终端登录输入以下命令配置 OpenClaw:
bash <(curl -fsSL https://kodo-toolbox.qiniu.com/las/openclaw/openclaw-tunnel.sh) <七牛云 LAS 服务器 IP> --open
其中 <七牛云 LAS 服务器 IP> 需替换为实际实例的公网 IP。
按界面提示输入 LAS 服务器登录密码和你的七牛云 MaaS API Key,系统就会自行完成 OpenClaw 的基础配置、打印输出 DashBoard URL(例如http://localhost:18789/?token=xxxx),并在浏览器中自动打开 OpenClaw DashBoard 界面。
常见问题
Q: SSH 登录失败怎么办?
检查实例是否处于「运行中」状态,公网 IP 是否正确,密码是否输入无误,七牛云 LAS 默认放行 22 端口,无需额外配置;
Q: 18789 端口未监听怎么处理?
确认配置文件修改正确,执行openclaw gateway restart重启网关,或重新执行安装程序;
Q: 模型调用失败怎么排查
检查七牛云 MaaS API Key 是否正确,是否已领取七牛云 Token 资源包,模型 ID 是否与七牛云模型广场一致;
Q: 如何切换模型?
编辑 OpenClaw 配置文件的配置模型参数可以切换模型
- 执行
ssh root@<七牛云 LAS 服务器 IP>登录到服务器 - 执行
su - openclaw切换到 openclaw 账号 - 执行命令打开模型配置文件
nano .openclaw/openclaw.json找到 “models” 配置段
若需使用 DeepSeek、Qwen、Kimi 等其他模型,可在七牛云模型广场复制目标模型的「ID」和「名称」,直接替换上述配置中的 minimax/minimax-m2.5 和 MiniMax-M2.5 即可;修改完成之后,按 ctrl x,然后 y 回车 保存退出。
之后重启 OpenClaw 网关,加载新的模型配置:openclaw gateway restart
设置新的模型为默认模型:openclaw models set qiniu/<模型ID>
Q: 控制台无法访问如何排查?
确认本地端口映射命令是否正常运行,未关闭终端,Token 是否复制完整。