OpenClaw移动节点配对：iOS与Android连接指南

前言

OpenClaw 不仅支持通过 Telegram、WhatsApp 等第三方平台与 AI 交互，还提供了原生的移动端配对功能。通过将你的 iOS 或 Android 设备与 OpenClaw 服务器配对，你可以直接从手机端使用 AI 助手，无需依赖第三方应用。本文将详细介绍移动节点的配对流程和常见配置。

移动节点概述

OpenClaw 的移动节点（Mobile Node）是一种轻量级客户端连接方式。你的手机通过安全的 WebSocket 连接到 OpenClaw 网关，获得与其他频道完全一致的 AI 交互能力，同时享受原生推送通知和离线消息同步。

核心优势

无需第三方应用：直接通过 OpenClaw 移动端或 PWA 使用
端到端加密：配对过程中建立的密钥保护通信安全
离线同步：设备离线期间的消息会在重新连接时自动同步
多设备支持：一个用户可以配对多台设备，会话自动同步
推送通知：支持 APNs（iOS）和 FCM（Android）推送

前置条件

在开始配对之前，请确认以下条件：

OpenClaw 服务器已启动并运行，版本 >= 1.2.0
网关已配置为允许外部连接或已设置端口转发
手机和服务器在同一网络，或服务器可从公网访问
已在服务器端启用移动节点功能

启用移动节点

在 openclaw.json 中确认以下配置：

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 18789
  },
  "channels": {
    "mobile": {
      "enabled": true,
      "maxDevices": 5,
      "pairingTimeout": 300,
      "pushNotifications": {
        "enabled": true,
        "apns": {
          "keyFile": "~/.openclaw/certs/apns-key.p8",
          "keyId": "YOUR_KEY_ID",
          "teamId": "YOUR_TEAM_ID"
        },
        "fcm": {
          "credentialsFile": "~/.openclaw/certs/fcm-credentials.json"
        }
      }
    }
  }
}

推送通知配置是可选的。不配置推送时，移动端仍然可以正常工作，只是在应用后台时无法收到通知。

配对流程

第一步：生成配对码

在服务器端生成一个临时配对码：

# 生成配对码，有效期5分钟
openclaw mobile pair --generate

# 输出示例：
# 配对码: AXKF-9M2P-RTLQ
# 有效期至: 2026-03-14 15:05:00
# 配对链接: https://your-server:18789/pair/AXKF-9M2P-RTLQ

你也可以在 Web Dashboard 的"设备管理"页面中点击"生成配对码"按钮。

第二步：在手机端输入配对码

iOS 配对

在 App Store 搜索"OpenClaw"并安装（或使用 Safari 打开 Dashboard 的 PWA 版本）
打开应用，点击"连接服务器"
输入服务器地址：your-server-ip:18789
输入配对码：AXKF-9M2P-RTLQ
等待验证完成

Android 配对

在 Google Play 搜索"OpenClaw"并安装
打开应用，点击"添加服务器"
可以选择手动输入地址和配对码，或扫描 Dashboard 上显示的二维码
确认连接

第三步：验证配对

配对成功后，服务器端会显示确认信息：

[INFO] 新设备已配对: iPhone 15 Pro (iOS 19.0)
[INFO] 设备ID: mob_a3f2c1d8
[INFO] 用户标识: mobile_user_001

在手机端，你应该能看到连接状态指示器变为绿色，并且可以开始发送消息。

二维码快速配对

除了手动输入配对码，OpenClaw 还支持更便捷的二维码配对：

# 在终端生成二维码（需要终端支持 Unicode）
openclaw mobile pair --qrcode

# 在 Dashboard 生成
# 访问 Dashboard → 设备管理 → 生成二维码

二维码中编码了服务器地址、端口和配对码，手机端扫描后一步完成连接。

设备管理

查看已配对设备

openclaw mobile list

# 输出示例：
# ID            设备名称           平台      最后活跃
# mob_a3f2c1d8  iPhone 15 Pro     iOS 19    2分钟前
# mob_b7e9f4a2  Pixel 9           Android   1小时前

移除设备

# 移除指定设备
openclaw mobile remove mob_a3f2c1d8

# 移除所有设备
openclaw mobile remove --all

移除设备后，该设备上的 OpenClaw 应用会自动断开连接，需要重新配对才能再次使用。

移动端专属配置

你可以为移动频道配置独立的行为参数：

{
  "channels": {
    "mobile": {
      "enabled": true,
      "sessionIsolation": true,
      "persona": {
        "systemPrompt": "你是用户的私人AI助手，回复简洁适合手机阅读。",
        "tone": "casual"
      },
      "mediaSupport": {
        "image": true,
        "audio": true,
        "document": false
      },
      "offlineSync": {
        "enabled": true,
        "maxPendingMessages": 100,
        "syncOnConnect": true
      }
    }
  }
}

参数说明

参数	说明
`sessionIsolation`	移动端会话是否与其他频道隔离
`persona`	移动端专属的 AI 人设
`offlineSync`	离线消息同步配置
`maxPendingMessages`	最大待同步消息数

网络与安全配置

局域网配对

如果手机和服务器在同一局域网，可以直接使用内网 IP 连接：

服务器地址: 192.168.1.100:18789

公网配对

通过公网连接时，强烈建议启用 HTTPS：

{
  "security": {
    "tls": {
      "enabled": true,
      "cert": "/path/to/cert.pem",
      "key": "/path/to/key.pem"
    }
  }
}

或者使用反向代理（如 Nginx、Caddy）在前端提供 TLS 终止。

配对安全机制

OpenClaw 的配对过程内置了多层安全保护：

配对码有效期默认为 5 分钟，过期自动失效
每个配对码只能使用一次
配对成功后，设备和服务器之间建立基于 TLS 的长连接
可以随时在服务器端撤销设备的访问权限

常见问题排查

Q: 配对码输入正确但连接失败？

检查防火墙是否放行了 18789 端口，确认 host 设置为 "0.0.0.0" 而非 "127.0.0.1"。

Q: 推送通知不工作？

确认 APNs 或 FCM 证书配置正确。iOS 需要有效的 APNs Key 文件，Android 需要 Firebase 项目的 Service Account 凭据。

Q: 多设备之间消息不同步？

确认所有设备连接到同一个 Agent，且 sessionIsolation 未设置为隔离模式。

总结

OpenClaw 的移动节点配对功能让你摆脱对第三方平台的依赖，直接从手机端使用 AI 助手。配对过程简洁安全——生成配对码、扫码或输入、确认连接，三步即可完成。配合推送通知和离线同步，移动端体验可以做到与原生应用无异。