全栈应用服务器

  • 全栈应用服务器 > 最佳实践 > 一键部署 OpenClaw

    一键部署 OpenClaw

    最近更新时间: 2026-03-13 17:52:54

    OpenClaw 作为硅谷爆火的开源 AI 智能体,凭借系统级行动力、持久化记忆和多 IM 工具无缝集成的特性,成为新一代「数字员工」标杆。本地部署需解决硬件成本、公网 IP、环境配置等问题,而七牛云全栈应用服务器 LAS 支持开箱即用的一键部署,无需自建环境、无需购置硬件,成本仅为传统硬件部署的 1/500。您有以下2种方式可选

    部署前准备

    1. 七牛云账号,开通两步验证,且账户余额或额度不低于 100 元:完成七牛云账号注册与实名认证(个人 / 企业均可),登录七牛云控制台,并开通两步验证;
    2. 已获取七牛云 MaaS API Key
    3. 工具准备:本地电脑安装 SSH 远程连接工具(如 FinalShell、Xshell、Putty),浏览器支持主流内核(Chrome/Edge/Firefox);
    4. 网络要求:本地设备可访问外网,七牛云 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.5MiniMax-M2.5 即可;修改完成之后,按 ctrl x,然后 y 回车 保存退出。
    之后重启 OpenClaw 网关,加载新的模型配置:openclaw gateway restart
    设置新的模型为默认模型:openclaw models set qiniu/<模型ID>
    Q: 控制台无法访问如何排查?
    确认本地端口映射命令是否正常运行,未关闭终端,Token 是否复制完整。

    以上内容是否对您有帮助?