gateway 已启用远程模式需满足：绑定地址非127.0.0.1（如0.0.0.0或局域网ip）、开启“允许局域网设备发现”、防火墙放行18789端口，且访问http://[电脑局域网ip]:18789/status返回{"status":"online"}。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认 Gateway 是否已启用远程模式
AionClaw 的跨设备连接依赖于本地运行的 Gateway 服务，它默认监听 127.0.0.1:18789，但手机无法直连本地回环地址。必须先在电脑端打开「安全保护」→「网络设置」，将 Gateway Mode 切换为 Remote（非 Local），并确保「允许局域网设备发现」已勾选。
常见错误现象：手机扫码后提示“连接失败”或“网关不可达”，大概率是 Gateway 仍处于 Local 模式，或电脑防火墙拦截了 18789 端口。
实操建议：
- Mac 用户需在「系统设置 → 隐私与安全性 → 防火墙选项」中手动放行
AionClaw应用 - Windows 用户检查「高级安全 Windows 防火墙」入站规则，确认
18789/TCP已启用 - 用手机浏览器访问
http://[电脑局域网IP]:18789/status（如http://192.168.1.102:18789/status），返回{"status":"online"}才算真正就绪
手机扫码配对时必须用 AionClaw 官方 App
OpenClaw 生态下多个客户端（如 AutoClaw、ShellMate）都支持扫码，但只有 AionClaw 移动端 能完整同步技能、定时任务和数字专家状态。iOS 和 Android 均需从官方渠道下载——App Store 搜索 AionClaw，安卓用户认准官网底部「移动端下载」按钮提供的 APK，勿安装第三方渠道打包版。
关键细节：
- 扫码位置在电脑端「手机控制」模块右上角，不是「个人中心」或「使用指南」页
- 首次配对需手机开启蓝牙和 Wi-Fi（即使不联网，蓝牙用于辅助设备发现）
- 配对成功后，手机端不会弹出登录框，而是直接进入「节点管理」页，显示当前注册的
node_id
同步失败？重点检查这三项权限和路径
即使配对成功，文件整理、定时抓取、微信消息转发 等操作仍可能失败，根源常在权限链断裂：
常见错误现象：手机触发任务后，PC端无响应 或 任务日志里反复出现“permission denied on /Users/xxx/.aionclaw”。
实操建议：
- 电脑端启动 AionClaw 时，必须用「完整权限」运行：Mac 右键应用 →「显示简介」→ 勾选「以管理员身份运行」；Windows 右键快捷方式 →「属性 → 兼容性 → 以管理员身份运行」
- 手机端在「设置 → 应用权限」中，确保
AionClaw已授予「存储访问」「后台活动」「无障碍服务」（Android）或「屏幕录制」「照片/文件」（iOS） - 检查电脑端工作路径是否被重定向：进入「工具管理 → 环境配置」，确认
workspace_dir是绝对路径（如/Users/xxx/AionClaw-Workspace），而非相对路径或 OneDrive 同步目录
跨设备任务实际能做什么，不能做什么
不是所有功能都能无缝跨端。AionClaw 的设计逻辑是「PC 执行、手机触发/采集」，不是「手机替代 PC」：
能稳定实现的场景：
- 手机语音说「生成上周周报」→ PC 自动拉取邮件+飞书记录+本地文档，生成并保存 PDF
- 手机拍一张发票照片 → PC 端调用 OCR 技能识别，填入 Excel 并归档到指定文件夹
- PC 上设好「每早 9 点抓取竞品价格」→ 手机端实时查看结果卡片，点开即跳转原始网页
容易误判的限制点：
- 手机无法直接运行需桌面 GUI 环境的任务（如自动点击某款未开放 API 的国产软件）
- 涉及敏感操作（如删除系统文件、修改 hosts、执行 shell 命令）默认被 Gateway 拦截，需在电脑端「安全保护 → 高危操作白名单」手动添加
- 手机端发起的 RPA 流程，若中途 PC 锁屏或休眠，任务会暂停，不会自动唤醒系统
最常被忽略的一点：同步延迟不是网络问题，而是 Gateway 的心跳周期默认为 12 秒。如果需要亚秒级响应（比如监控告警），得在电脑端配置文件中手动把 heartbeat_interval_ms 改小，但会增加局域网广播流量。
