仪表盘小程序

在 Telegram 中作为 Mini App 运行 Control UI。

Dashboard Mini App¶

Dashboard Mini App 以 Telegram WebApp 形式打开完整的 OpenClaw Control UI。在与机器人的私聊中运行 /dashboard，然后点击 Open dashboard。当 Telegram 插件处于活动状态时，该命令会自动注册；没有独立的 Mini App 标志。

要求：

• gateway.tailscale.mode: "serve" 或 "funnel"，用于已发布的 HTTPS Mini App URL。
• 你的数字 Telegram 用户 ID 必须位于所选账户的有效 allowFrom 或 commands.ownerAllowFrom 中。通配符和用户名不授予 Mini App 所有者权限。
• 请使用私聊。在群组中，/dashboard 会回复 open this in a DM with the bot，并且不会发送按钮。
• Docker 安装：Serve/Funnel 模式要求网关在 tailscaled 旁边绑定回环（loopback），而带有已发布端口（published ports）的桥接网络无法满足此要求。请以 network_mode: host 运行网关容器，并将宿主机的 tailscaled socket（/var/run/tailscale）以及 tailscale CLI 挂载到容器中。

配置一种受支持的 Tailscale 发布模式：

{
  gateway: {
    tailscale: {
      mode: "serve", // or "funnel"
    },
  },
}

OpenClaw 在构建 Control UI 和 WebSocket URL 时，会自动遵循 gateway.controlUi.basePath。

当 Mini App 打开时，Telegram 会提供经签名的 WebApp initData。OpenClaw 使用所选机器人账户的令牌验证其签名，拒绝缺失、无效、过期或重放的数据，提取数字 Telegram 用户 ID，并在移交给 Control UI 之前再次检查所有者权限。

如果 /dashboard 无法解析已发布的 HTTPS URL，它会回复：

Mini App needs an HTTPS gateway URL. Set `gateway.tailscale.mode: serve` or `funnel`, then retry.

设置上述模式之一，确保 Tailscale 在网关主机上运行，然后重试该命令。

Mini App 是仅限 Tailscale 的 v1 路径，不支持 Telegram Web iframe。