aionclaw电脑端安装后无法被手机识别，因跨设备通信需手动启用本地服务aionclawd并授权网络权限；微信扫码仅认证，文件传输依赖localhost:8080双通道，须确保同局域网、端口未被占用、目标路径可写且非icloud/onedrive托管目录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
电脑端安装后无法被手机识别？先确认服务是否真正启动
很多用户以为双端装完就自动连通，实际 AionClaw 并不默认开启跨设备通信通道。它依赖本地后台服务 aionclawd 持续运行，而 macOS 或 Windows 的权限策略常导致该进程被静默终止或未获网络访问权。
检查方法：打开终端（macOS）或 PowerShell（Windows），执行 ps aux | grep aionclawd（macOS）或 Get-Process -Name "aionclawd" -ErrorAction SilentlyContinue（Windows）。若无输出，说明服务未运行。
- macOS 用户需前往「系统设置 → 隐私与安全性 → 完全磁盘访问」，手动勾选
AionClaw和aionclawd - Windows 用户需以管理员身份运行一次 AionClaw，允许其在防火墙中启用“专用网络”通信
- 重启客户端后，在主界面右下角状态栏确认是否显示
Connected: local而非Disconnected
微信扫码绑定成功但文件传不过来？重点查通讯协议和路径权限
微信只是认证入口，不是传输通道。AionClaw 的手机→电脑文件投递实际走的是本地 HTTP + WebSocket 双通道，由 aionclawd 在 localhost:8080 提供服务。手机端通过微信内嵌 WebView 访问该地址上传文件，因此必须确保：
- 电脑端没有其他程序占用
8080端口（如 Docker、Vite 开发服务器），可用lsof -i :8080（macOS）或netstat -ano | findstr :8080（Windows）排查 - 手机与电脑处于同一局域网（不能是手机热点直连电脑，也不支持 5G 热点共享给电脑后反向传文件）
- 电脑端目标路径有写入权限，比如你想传到
~/Downloads/手机素材，需确保该目录对当前用户可写，且不在 iCloud 同步或 OneDrive 托管路径下（这两类路径会触发同步锁，导致 AionClaw 移动失败）
用 QQ 机器人中转时提示 “file not found”？别忽略 nanobot 的挂载路径映射
nanobot 容器本身不直接读取宿主机文件系统，它依赖 -v 参数挂载的卷。如果配置了 -v ~/file-sync:/app/data，那所有从 QQ 收到的文件都会落地到容器内的 /app/data，而 AionClaw 默认监听的是宿主机的 ~/Documents/待处理 ——两者根本不在一个位置。
正确做法是统一路径源头：
- 要么把 nanobot 挂载点改为
-v ~/Documents/待处理:/app/data，让文件直接落进 AionClaw 监听目录 - 要么修改 AionClaw 的
skills.file-watcher.watchPaths，指向容器映射后的宿主机路径（即~/file-sync） - 注意：路径中不能含中文空格或特殊符号，
~/待处理会被某些 shell 解析失败，建议用~/Documents/phone_inbox这类纯 ASCII 命名
局域网 SFTP 直连总卡在密码验证？OpenSSH 配置要绕过 PAM 限制
macOS 自带的 OpenSSH 默认启用 PAMAuthenticationViaKBD，而 Termux 的 SFTP 客户端不支持交互式 PAM 认证，导致连接挂起。这不是密码错，是协议不兼容。
解决方式是在电脑端 /etc/ssh/sshd_config 中添加两行：
UsePAM no PasswordAuthentication yes
然后执行 sudo systemctl restart sshd（Linux）或 sudo launchctl stop com.openssh.sshd && sudo launchctl start com.openssh.sshd（macOS）。
另外 Termux 里不要用 sftp 命令交互式登录——它容易因终端尺寸检测失败卡住。改用单行命令上传：
sftp -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null clawuser@192.168.1.100:/home/clawuser/inbox 跨平台文件传输最易被忽略的点，其实是时间戳一致性。AionClaw 的 <code>file-watcher</code> 技能默认只响应「mtime 变更」事件，而云盘同步、QQ 下载、SFTP 上传等操作若没显式设置 mtime（比如 rclone mount 默认不保留时间戳），会导致文件已落地却无法触发后续动作。调试时优先用 <code>stat -f "%m" filename</code>（macOS）或 <code>Get-Item file.txt | Select-Object LastWriteTime</code>（PowerShell）确认时间戳是否真实更新。
