ClawMo 使用说明

在开始使用之前，请花两分钟了解 ClawMo 的工作方式——这将帮助你避开最常见的误解，快速上手。

ClawMo 是什么

ClawMo 是 OpenClaw Gateway 的 iOS 移动端客户端，让你可以在手机上监控和指挥运行在服务器上的 AI Agent 团队。

一个简单的类比：ClawMo 之于 OpenClaw Gateway，就像电视遥控器之于电视机——遥控器本身不播放节目，它只是让你更方便地操控电视。

你的 iPhoneClawMo
↓
服务器 / 电脑OpenClaw Gateway
↓
AI 模型 APIOpenAI / Claude…
Agent 1
Agent 2
Agent 3

AI Agents 运行在 Gateway 中，ClawMo 通过 WebSocket 与 Gateway 通信

ClawMo 做的事：连接 Gateway、显示 Agent 状态、发送和接收消息、查看流式输出。

ClawMo 不做的事：运行 AI 模型、托管 Agent、替代 Gateway。

常见误解

❌ 误解：ClawMo 是运行在手机上的 OpenClaw
ClawMo 不包含任何 AI 运行时，不能独立运行 Agent，也不能在手机上托管 Gateway。
✓ 正确理解：ClawMo 是连接远端 Gateway 的移动控制台
你的 AI Agents 始终运行在服务器或电脑上，ClawMo 只是提供了一个随身携带的操控界面。

因此，使用 ClawMo 的前提是：你已经有一个运行中的 OpenClaw Gateway 实例。

使用前提

  • 1

    一台部署了 OpenClaw Gateway 的服务器或电脑
    可以是云服务器、家庭 NAS、或你日常用的 Mac / Windows 电脑。

  • 2

    Gateway 的 WebSocket 地址
    格式为 ws:// 或 wss://，不支持 http/https。

  • 3

    Gateway 的 Token（如果启用了认证）
    可在 Gateway 管理界面获取，未启用认证可留空。

  • 4

    手机与 Gateway 之间的网络连通
    具体方式见下方两种场景。

场景一：Gateway 有公网访问

Gateway 部署在云服务器上，手机在任何网络下均可连接。

  • 1

    打开 ClawMo，进入 设置 → 添加 Gateway

  • 2

    填写 Gateway 地址（推荐使用加密连接）：

# 有 TLS 加密（推荐） wss://gateway.yourdomain.com # 无 TLS（不推荐在公网使用） ws://your-server-ip:8080
  • 3

    填写 Token（如有），保存

  • 4

    如需设备配对，见设备配对章节

安全提示
公网部署请使用 wss:// 加密传输，避免 Token 和消息被截获。

场景二：Gateway 无公网访问

Gateway 运行在本地电脑或内网服务器上，有两种方式连接：

方案 A

同一 WiFi 局域网

手机和 Gateway 连同一个 WiFi，用局域网 IP 直连。简单零成本，但离开该网络后无法使用。

方案 B · 推荐

内网穿透

用 Tailscale / ZeroTier / frp 等工具将 Gateway 暴露出来，随时随地访问。

方案 A：局域网直连

  • 1

    在 Gateway 设备上查看局域网 IP
    Mac：系统设置 → 网络 ｜ Windows：cmd → ipconfig

  • 2

    手机连接同一 WiFi

  • 3

    填写局域网地址：

ws://192.168.1.100:8080

方案 B：Tailscale（推荐）

  • 1

    在 Gateway 设备上安装并登录 Tailscale

  • 2

    iPhone 上安装 Tailscale App，登录同一账号

  • 3

    在 Tailscale 控制台查看 Gateway 设备的 IP（形如 100.x.x.x）

  • 4

    填写地址：

ws://100.x.x.x:8080
Tailscale 使用 WireGuard 加密，即使用 ws:// 传输也是安全的。

方案对比

方案随时访问安全性成本
局域网直连❌ 仅同网络局域网内免费
Tailscale✅ 支持WireGuard 加密免费（≤3台）
frp / 端口映射✅ 支持需自行配 TLS需公网服务器
云服务器部署✅ 支持建议配 wss云服务器费用

设备配对

如果 Gateway 开启了设备配对，首次连接会出现「待配对」提示。

  • 1

    连接后出现「待配对」提示，记下显示的设备 ID

  • 2

    在 Gateway 管理界面找到「待配对设备」列表

  • 3

    确认设备 ID 一致后，点击批准

  • 4

    ClawMo 自动重连，配对完成

配对信息保存在 Keychain 中，卸载重装 App 后需要重新配对。每台设备只需配对一次。

常见问题

连接后显示「无法连接」

依次检查：① Gateway 是否正在运行；② 地址是否为 ws:// 或 wss:// 格式；③ 手机与 Gateway 网络是否互通；④ 防火墙是否放行了对应端口。

Token 是什么，在哪里找

Token 是 Gateway 用于验证客户端身份的密钥，可在 Gateway 管理界面或配置文件中查看。若 Gateway 未启用认证，Token 留空即可。

没有服务器，可以用 ClawMo 吗

可以在自己的 Mac 或 Windows 电脑上运行 Gateway，再通过局域网直连或 Tailscale 使用 ClawMo，不一定需要购买云服务器。

多人共用同一个 Gateway 可以吗

可以。每台设备单独配对，Gateway 管理员可在设备列表中管理所有已连接的设备。

离线时能查看历史消息吗

可以。ClawMo 用 SwiftData 缓存消息到本地，断网时可浏览历史对话，但无法发送新消息或接收实时更新。