手机端无法远程指挥AI员工的解决步骤为：一、确认ClawdBot Gateway服务运行并监听18789端口；二、通过Telegram创建Bot、配置Token、发送消息获取配对码完成绑定；三、WhatsApp扫码直连；四、Web UI浏览器访问；五、排查防火墙、权限、DNS等问题。
如果您希望在手机上使用ClawdBot实现远程指挥AI员工，但尚未完成手机端配对或无法通过常规方式接入，则问题通常出在配对流程未闭环、通讯渠道未启用或本地服务未运行。以下是解决此问题的步骤：
一、确认ClawdBot服务已在电脑/服务器端正常运行
手机端无法连接的根本前提是后端服务未就绪。ClawdBot本身不提供独立手机App，其“手机端”实质是通过Telegram、WhatsApp等第三方IM客户端作为交互入口，因此必须确保Gateway服务已启动且配置生效。
1、在部署设备终端中执行 clawdbot gateway status 检查服务状态，输出应为 active (running)。
2、若未运行，执行 clawdbot gateway start 启动服务。
3、确认端口监听正常：执行 netstat -tuln | grep 18789（默认Gateway端口），应有 LISTEN 状态条目。
二、通过Telegram完成手机端配对
Telegram是目前最稳定、配置门槛最低的手机接入方式，所有操作均在Telegram App内完成，无需额外安装应用。
1、在手机Telegram中搜索并关注 @BotFather，发送 /newbot 创建新机器人。
2、按提示输入机器人名称与用户名（用户名必须以 bot 结尾），获取形如 123456789:ABCdefGHIjklMNOpqrSTUvwxyz 的Bot Token。
3、将该Token粘贴至部署设备终端，执行 clawdbot config set channels.telegram.botToken "123456789:ABCdefGHIjklMNOpqrSTUvwxyz"。
4、重启服务：clawdbot gateway restart。
5、向新创建的机器人发送任意消息（如“hi”），ClawdBot将自动回复配对码（6位数字）及二维码图片。
6、在手机端打开ClawdBot终端界面（或使用 clawdbot tui 命令），输入收到的6位配对码完成绑定。
三、通过WhatsApp扫码直连手机端
WhatsApp接入依赖官方API网关，需启用WhatsApp Business账户并完成企业验证，但配对过程完全在手机端完成，无需电脑参与后续交互。
1、确保部署时已选择WhatsApp作为通讯渠道，并在 clawdbot onboard --flow quickstart 流程中完成手机号绑定与验证码校验。
2、手机端打开WhatsApp，进入设置 > 链接设备 > 扫描二维码。
3、在部署设备终端中执行 clawdbot whatsapp qr，终端将生成动态刷新的二维码。
4、用手机WhatsApp扫描该二维码，扫描成功后，ClawdBot将在WhatsApp中自动添加为联系人，头像显示为电话号码加括号标注（如 +86138****1234 (ClawdBot)）。
5、首次发送消息（如“ping”）即触发初始化握手，此后所有指令均可直接发送至该联系人。
四、使用Web UI远程访问（免安装方案）
当手机无法安装Telegram或WhatsApp，或身处受限网络环境时，可通过浏览器直接访问ClawdBot内置Web界面，实现全功能控制，无需任何客户端安装。
1、确保部署设备已启用Web UI：在 clawdbot onboard 初始化中勾选 Web Interface 选项；若已部署，编辑配置文件 ~/.clawd/config.json，将 "web": {"enabled": true} 设为true。
2、启动服务后，在部署设备终端执行 clawdbot web url 获取临时访问地址（含一次性token）。
3、将该URL粘贴至手机浏览器地址栏（支持Chrome、Safari、Edge），页面加载后即可进行对话、文件上传、浏览器控制等全部操作。
4、如需长期访问，可在配置中设置固定域名与基础认证，并通过Nginx反向代理暴露至公网（需配合SSL证书）。
五、检查并修复常见手机端连接失败原因
多数“手机端无法使用”问题并非安装失败，而是因权限、网络或配置项缺失导致通信链路中断，需逐项验证。
1、确认 浏览器控制 与 文件管理 功能已在onboard流程中启用——这两项未勾选将导致所有自动化指令（如“整理下载目录”、“截图发给我”）返回空响应。
2、检查防火墙设置：部署设备需放行 18789（Gateway）、18790（Web UI）端口，若使用云服务器，还需在安全组中同步开放。
3、验证Telegram Bot是否被禁用：登录 https://t.me/BotFather，发送 /mybots，点击对应Bot → Edit Bot → Edit Commands，确认命令列表非空。
4、排查DNS污染：若手机端收不到配对码，尝试在手机浏览器访问 http://[部署设备IP]:18789/health，返回 {"status":"ok"} 表示服务可达，否则需检查本地网络策略或更换DNS（如1.1.1.1）。
