全栈应用服务器

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

    一键部署 OpenClaw

    最近更新时间: 2026-02-26 18:13:24

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

    部署前准备

    1. 七牛云账号,开通两步验证,且账户余额或额度不低于 5 元:完成七牛云账号注册与实名认证(个人 / 企业均可),登录七牛云控制台,并开通两步验证;
    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 替换为符合要求的密码。

    日志或产物存储位置:可选, 保持默认即可

    • 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.xxOpenClaw-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 等模型的无缝对接,步骤如下:

    1. 编辑 OpenClaw 配置文件,配置模型参数
    2. 在 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.5MiniMax-M2.5 即可;

    1. 使配置生效,设置默认模型

    执行以下两条命令,重启网关并绑定默认大模型:

    # 重启OpenClaw网关,加载新的模型配置
    clawdbot gateway restart
    # 设置七牛云MiniMax-M2.5为默认模型(可替换为其他模型ID)
    clawdbot models set qiniu/minimax/minimax-m2.5
    
    1. 检查服务状态并访问 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 是否复制完整。

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