无需开发 OpenClaw 插件，作为 Gateway 外部客户端即可连接现有 Gateway，在手机上随时与你的 AI Agent 对话。
支持 sessions.list、chat.history、chat.send 与流式 chat 事件，多轮对话流畅自然，工具调用结果以卡片展示。
App 端集成百度 ASR（plus.speech），H5 端支持 Web Speech API，按住麦克风说话，松手即发送。
HomeAi-Tts 原生插件 + 百度 REST 回退，Agent 回复可自动朗读，设置页一键开关。
chat.send 携带 base64 attachments，支持相册选图、预览保存与 iOS 系统分享扩展。
Token 消耗、费用趋势、类型分布与会话排行可视化，提供商配额一目了然。
Gateway 健康检查、当前模型与 Provider、Agent/会话数量实时查看，连接状态清晰可控。
延续 App 粉蓝渐变设计语言，圆角卡片与柔和阴影，让移动端 AI 对话既专业又亲切。
确保 OpenClaw Gateway 已运行，在 Portable AI 中配置地址与 Token 即可开始对话。
在服务器或本机启动 OpenClaw Gateway 服务。
openclaw gateway --port 18789
在 App「服务器配置」页填写地址与 Token，支持 ws / wss。
ws://192.168.x.x:18789
首次连接若报 pairing required，在 Gateway 主机批准设备。
openclaw devices approve <requestId>
连接成功后进入聊天页，文字、语音或附件均可发送给 Agent。
chat.send → 流式 chat 事件
Portable AI 作为 Gateway 外部客户端，无需在 OpenClaw 侧开发插件，配置好地址与 Token 即可在手机上使用。
支持多会话切换、历史记录加载与实时流式输出。Agent 回复逐字呈现，工具调用结果以卡片形式展示，阅读更清晰。
按住麦克风说话，松手即发送；Agent 回复可开启 TTS 自动播报。适合通勤、走路等不方便打字的场景。
从相册选图或接收系统分享内容，作为附件发送给 Agent。聊天中的图片可预览、保存到相册。
查看 Token 消耗、费用趋势与会话排行；「龙虾状态」页可了解 Gateway 健康、当前模型与连接情况。
手机与 Gateway 在同一 Wi‑Fi 下，填写局域网 IP 与端口即可连接，例如 ws://192.168.x.x:18789。
通过域名或公网 IP 连接远程 Gateway，建议开启 TLS，使用 wss:// 加密传输，在 App「服务器配置」中一键切换。
连接时需填写 Gateway Token（见服务器 openclaw.json → gateway.auth.token）。Token 保存在本地，用于每次 WebSocket 握手鉴权。
首次连接远程 Gateway 需在服务器批准设备；连接成功后 App 自动维护 WebSocket，断线后自动尝试重连。
未持有正确 Token 的客户端无法完成握手。请勿将 Token 分享给他人，远程 Gateway 建议配合防火墙限制访问来源。
新设备首次连远程 Gateway 会触发 pairing 流程，须在 Gateway 主机执行 openclaw devices approve 后才可接入，防止未授权设备访问。
公网或跨网络场景请使用 wss://（TLS），避免 Token 与对话内容在传输层明文暴露。
语音输入需麦克风权限，识别数据发送至百度智能云 ASR 服务处理；使用前 App 会弹出说明并征得同意。TTS 播报仅在本地播放 Agent 回复文本。
