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