使用SAE部署OpenClaw

方式 A：通过 SAE 控制台 WebShell

1. 在应用列表中点击openclaw-gateway的应用 ID跳转到应用详情页。

2. 点击实例列表页签，点击任意实例右侧的Webshell，即可登录容器内部的终端。

方式 B：通过 saectl 命令行工具（推荐）

1. 安装并配置 saectl 命令行工具，详见安装与配置saectl工具。

2. 执行以下命令，即可登录容器内部的终端：

   saectl exec -it -n <namespace> <pod-name>

   详见使用saectl工具管理应用实例Pod。

初始化 OpenClaw 运行环境

1. 设置终端逻辑尺寸（避免 TUI 渲染异常）：

   stty rows 40 cols 120

   说明

   如果关闭容器内部的终端，下次进入终端后需要再次执行此命令，以避免 TUI 渲染异常。

2. 执行初始化命令：

   openclaw onboard --install-daemon

   此命令将通过交互形式引导您完成基础配置，并安装后台守护进程：

   • Onboarding mode：选择 QuickStart。

   • Model/auth provider：选择 Skip for now。

   • Filter models by provider：选择 All providers。

   • Default model：选择 Keep current。

   • Select channel：选择 Skip for now。

   • Configure skills now：选择 No。

   • Enable hooks：选择 Skip for now。

     说明

     • 等待初始化完成，通常需要 1~2 分钟。

     • 如果提示Systemd user services are unavailable，可忽略，因为OpenClaw 在容器环境中使用轻量级进程管理器 supervisord 替代 systemd。

   • Install shell completion script：选择 Yes。

3. 初始化后，可查看以下配置文件和工作路径：

   • OpenClaw 配置文件：cat /data/.clawdbot/openclaw.json

   • 工作区：ls ~/.openclaw/workspace

   • 会话：ls /data/.clawdbot/agents/main/sessions

启动 OpenClaw Gateway 服务

在容器内使用 supervisord 管理服务生命周期：

• 首次部署后启动服务：

  supervisorctl start openclaw

• 后续修改配置后重启服务：

  supervisorctl restart openclaw

配置OpenClaw Gateway 绑定的端口和网络

# 查看当前配置
openclaw config get gateway.port # 应该返回：18789。如果不满足，需要修改为 18789。
openclaw config get gateway.bind # 应该返回："lan"。如果返回 "loopback"，则无法从外部访问，需要修改为 "lan"。
openclaw config get gateway.http.endpoints.responses.enabled # 应该返回：true。如果返回 false，则无法回复钉钉发送的消息。

# 修改配置
openclaw config set gateway.port 18789 # 修改为正确的绑定端口
openclaw config set gateway.bind "lan" # 允许外部访问
openclaw config set gateway.http.endpoints.responses.enabled true # 允许回复钉钉发送的消息

supervisorctl restart openclaw # 重启服务使配置生效

通过绑定 CLB 实现从公网访问应用

1. 在应用列表中点击openclaw-gateway的应用 ID跳转到应用详情页。

2. 在应用信息页签的应用访问设置区域，选择基于 CLB 访问。

3. 点击公网访问地址右侧的添加公网CLB 访问。

4. 选择HTTP 协议，配置如下：

   1. HTTP 端口：输入80。

   2. 容器端口：输入18789，即 OpenClaw Gateway 监听端口。

5. 选择HTTPS 协议，配置如下：

   1. HTTPS 端口：输入18789。

   2. SSL 证书：选择已有的 SSL 证书，或点击创建SSL证书，详见创建证书。

   3. 容器端口：输入18789，即 OpenClaw Gateway 监听端口。

   4. 其余参数保持默认，点击确定。

   说明

   需要同时配置HTTP 协议与HTTPS 协议的原因是：

   • HTTP 协议用于后续接收用户通过钉钉发送的消息。

   • HTTPS 协议用于后续访问OpenClaw的控制界面。

6. 等待公网访问地址生成，通常需要 2~3 分钟。记录公网访问地址，后续步骤需要使用。

通过配置 NAT 网关实现应用访问公网资源

1. 在应用信息页签的应用信息区域，点击 VPC ID，跳转到 VPC 详情页。

2. 在资源管理页签的公网访问服务区域，查看公网NAT网关的数量并点击，跳转到公网NAT网关列表。

3. 点击列表中公网NAT网关右侧的设置SNAT。

   说明

   如果列表中没有公网NAT网关，则点击创建公网NAT网关，详见公网 NAT 网关。

4. 点击创建SNAT条目，配置如下：

   1. SNAT条目粒度：选择交换机粒度。

   2. 选择交换机：选择部署应用时创建的2个交换机，以确保所有应用实例都能够访问公网资源。

   3. 选择弹性公网IP地址：选择已绑定到当前公网NAT网关的弹性公网IP。

      说明

      如果未绑定弹性公网IP，则点击新购弹性公网IP并绑定，详见公网 NAT 网关。

   4. 点击确定创建。

通过 Web Control UI 访问 OpenClaw 控制界面

1. 获取认证凭据：

   # 获取 Gateway 认证 Token
   openclaw config get gateway.auth

2. 记录返回结果中的<GATEWAY_AUTH_TOKEN>，后续步骤需要使用。

   {
     "mode": "token",
     "token": "<GATEWAY_AUTH_TOKEN>"
   }

3. 在浏览器中访问 OpenClaw 的控制界面，URL如下：

   https://<CLB_PUBLIC_IP>:18789?token=<GATEWAY_AUTH_TOKEN>
   
   # 将URL中的变量用实际值替换：
   # <CLB_PUBLIC_IP>：公网访问地址。
   # <GATEWAY_AUTH_TOKEN>：认证凭据。

4. 首次访问将显示pairing required，表示需授权当前设备：

   # 避免 TUI 渲染异常
   stty rows 40 cols 120
   
   # 列出待处理的配对请求，注意将以下命令中<GATEWAY_AUTH_TOKEN>按实际值替换
   openclaw devices list --token "<GATEWAY_AUTH_TOKEN>"
   
   # 找到状态为 Pending 的 Request ID，并批准，注意将以下命令中<requestId>按实际值替换
   openclaw devices approve <requestId>

5. 刷新浏览器页面，即可访问 OpenClaw 控制界面。

6. 在Chat页面，开始对话。

   User: 你使用的模型是什么？# 测试模型配置是否成功
   Agent: 我当前使用的是 **DashScope 平台上的 Qwen3-Max 模型**... # 返回类似结果表明模型配置成功
   

通过命令行 TUI 与 OpenClaw 交互

开始对话（默认进入 main Agent 的 main Session）：

openclaw tui

Step 2：创建 AppFlow 连接流

1. 访问AppFlow 模板。

2. 点击立即使用。

3. 账户授权：

   1. 钉钉应用机器人：在下拉列表中点击添加新凭证。

      • 凭证名称：可自定义，例如test-dingding。

      • Client ID 和 Client Secret：填写已创建的应用的Client ID 和 Client Secret。

      • Ip白名单：OpenClaw 应用绑定的 CLB 实例默认无访问控制策略，即允许所有公网IP访问。建议创建访问控制策略，并添加以下IP（具体配置方法，详见访问控制）：

        • 您的设备的公网出口IP，确保您能够访问 OpenClaw 的控制界面。

        • 当前页面显示的AppFlow的IP列表（点击复制IP列表），确保 AppFlow 能够访问 OpenClaw。

      • 点击确定。

      • 选择已添加的凭证。

   2. MoltBot：在下拉列表中点击添加新凭证。

      • token：输入通过以下命令获取的 token。

        openclaw config get gateway.auth

      • 凭证名称：可自定义，例如test-bot。

      • 点击确定。

      • 选择已添加的凭证。

4. 执行动作：

   • 公网地址：填写之前配置的SAE 应用公网访问地址<CLB_PUBLIC_IP>:80。

   • 模板ID：填写之前已创建的模板 ID。

5. 基本信息：保持默认配置。

6. 完成：

   1. 复制并保存WebhookUrl，后续步骤需要使用。

   2. 点击发布。

Step 3：配置钉钉机器人

1. 添加并配置机器人

   1. 访问钉钉开放平台 - 钉钉应用页面，点击已创建的应用名称，进入应用详情页。

   2. 在左侧导航栏点击添加应用能力，选择机器人，点击添加。

   3. 开启机器人配置开关。

      • 消息接收模式：选择HTTP模式。

      • 消息接收地址：填写之前保存的WebhookUrl。

      • 其他参数可自定义。

   4. 点击发布。

2. 发布应用版本

   1. 在左侧导航栏点击版本管理与发布。

   2. 点击创建新版本：

      • 应用版本号：可自定义，例如1.0.0。

      • 版本描述：可自定义，例如应用正式版本。

      • 应用可用范围：建议先选择全部员工，待测试通过后，再细化配置。

      • 点击保存。然后根据页面提示操作，完成发布。

3. 在钉钉群中使用机器人

   1. 在钉钉中进入目标钉钉群。

   2. 点击右上角...图标，进入群设置页面。

   3. 找到并点击机器人，进入机器人管理页面。

   4. 点击添加机器人，在企业机器人中，点击已创建的机器人。

   5. 点击添加，根据页面提示完成添加。

   6. 在群聊中@该机器人，或与该机器人私聊 ，即可开始对话。