ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

手机上的OpenClaw怎么玩?我花了3天接入飞书终于搞定了…(详细教程)

手机上的OpenClaw怎么玩?我花了3天接入飞书终于搞定了…(详细教程) 1. 手机跑 OpenClaw 接入飞书到底难在哪先说结论一部闲置安卓手机装好 OpenClaw 中文整合包再通过 ADB 无线调试和 cpolar 内网穿透确实能做到「手机揣兜里当服务器飞书发条消息 AI 就开始干活」。但这条路我走了三天踩的坑比想象中多。OpenClaw 是一个完全开源的 AI 智能体平台它不只是聊天还能直接操控设备——写代码、管文件、跑脚本。原本它只能在电脑端跑后来有开发者用 Flutter proot Ubuntu 的方案让安卓手机无需 root 就能一键跑起 OpenClaw 网关。我基于这个思路做了中文整合版UI 全部汉化打好 APK 直接装上就能用。那为什么还要折腾飞书和 ADB因为手机端跑通只是第一步。你不可能一直盯着手机屏幕敲命令真正好用的形态是飞书当遥控器手机当执行器。飞书发消息OpenClaw 在手机上执行操作结果再回传到飞书。这中间需要解决三个问题手机上的 OpenClaw 怎么被飞书调用、手机怎么被远程控制、外网怎么访问家里的手机。这篇教程面向想在移动端跑通 AI 助手的开发者交付可复制的 ADB 调试命令、cpolar 内网穿透配置与飞书机器人回调设置并给出消息收发验证动作。目标是一次性跑通手机端到飞书的闭环。适合谁看手里有闲置安卓机、想低成本跑一个随身 AI 智能体、愿意折腾 ADB 和飞书开放平台的开发者。如果你只是想体验聊天直接用网页版就行但如果你想让它真正「动手干活」这套流程值得走一遍。我试过用备用机部署过程中遇到过网关启动失败、飞书长连接保存不了、ADB 配对码过期等问题后面会逐个拆解。下面从环境准备开始一步步来。2. TaoToken 前置给 OpenClaw 接一个稳定的大模型入口OpenClaw 本身只是壳真正干活的是背后的大模型。手机端部署完成后第一件事就是配置模型提供商。你可以选 MiniMax、Qwen、硅基流动等平台也可以用一个兼容 OpenAI 接口的中转服务。这里我推荐用 TaoToken 作为模型接入层。它的好处是接口格式统一Base URL 和 API Key 配置简单适合在 OpenClaw 里做自定义提供商。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。在 OpenClaw 的终端配置向导里选择 Custom Provider然后填写API Base URLhttps://taotoken.net/apiAPI Key你在 TaoToken 控制台创建的密钥Model ID按你实际使用的模型名称填写如果你还没创建 Key可以先去控制台生成https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建完成后复制密钥回到 OpenClaw 终端粘贴即可。为什么要在手机端用 TaoToken 而不是直连某个平台因为手机端切换模型很麻烦每次都要进终端改配置。TaoToken 的兼容接口让你可以在 OpenClaw 的「AI 提供商」页面里直接切换不用反复敲命令。而且它的模型对话入口也方便你单独验证模型是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。配置完成后OpenClaw 的网关日志里会显示模型加载成功。如果日志里出现reading choices之类的报错通常是 Base URL 或 Model ID 填错了回到配置页检查。另外如果你打算长期跑编码类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它适合需要频繁调用模型、做 Agent 开发的场景。手机端跑 OpenClaw 本身就是一种轻量 Agent 实践配合稳定的模型入口体验会好很多。接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有完整的参数说明和示例。API Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。3. 可复制配置ADB 无线调试 cpolar 穿透 飞书回调这一节是核心操作区所有命令和配置都可以直接复制。建议按顺序来先开 ADB 无线调试再配 cpolar最后设飞书回调。3.1 ADB 无线调试配置在手机设置里开启开发者选项找到「无线调试」并启用。进入后记住三个信息无线调试地址和端口、配对码、配对码的地址和端口。例如# 无线调试地址和端口 192.168.50.225:38687 # 配对码 08225 # 配对码的地址和端口 192.168.50.225:42515然后在 OpenClaw 的飞书对话里让它帮你安装 ADB 工具。你可以直接发请你在当前运行的操作系统上安装一个 ADB 工具我稍后要做无线调试功能。安装完成后把配对信息发给它我的无线调试地址和端口是 192.168.50.225:38687 配对码的地址和端口是 192.168.50.225:42515 配对码是 08225。OpenClaw 会执行adb pair和adb connect命令。成功后在手机的「已配对设备」里会看到新增的localhost设备。如果你在电脑上手动操作命令格式如下adb pair 192.168.50.225:42515 08225 adb connect 192.168.50.225:38687 adb devices注意配对窗口不能关闭关闭后配对码和端口会变更。3.2 cpolar 内网穿透配置cpolar 可以把手机局域网的 SSH 端口映射到公网。先在手机 Ubuntu 环境里安装curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | bash由于当前 Ubuntu 没有 systemd需要配置伪自启动。执行cat EOF ~/.bashrc # --- Cpolar 自动化守护逻辑 --- if ! pgrep -x cpolar /dev/null; then echo 正在初始化 Cpolar 环境... nohup cpolar start-all -daemonon -dashboardon -config/usr/local/etc/cpolar/cpolar.yml -log/var/log/cpolar/access.log /dev/null 21 echo Cpolar 已在后台运行 (Web 面板端口9200) fi # --------------------------- EOF source ~/.bashrc然后在浏览器访问http://192.168.50.225:9200进入 cpolar Web UI。默认会有一个 ssh 隧道指向 22 端口但我们的 SSH 服务端口是 8022需要编辑隧道把本地地址端口改为 8022。保存后在「在线隧道列表」里会看到一条公网地址例如tcp://1.tcp.cpolar.top:11491用这个地址测试 SSHssh root1.tcp.cpolar.top -p 11491如果想固定 TCP 地址去 cpolar 后台预留一个固定端口然后在隧道编辑里选择「固定TCP端口」填入预留地址即可。3.3 飞书机器人回调配置飞书开放平台创建企业自建应用添加机器人能力然后在权限管理里批量导入以下 JSON{ scopes: { tenant: [ aily:file:read, aily:file:write, application:application.app_message_stats.overview:readonly, application:application:self_manage, application:bot.menu:write, cardkit:card:write, contact:user.employee_id:readonly, corehr:file:download, docs:document.content:read, event:ip_list, im:chat, im:chat.access_event.bot_p2p_chat:read, im:chat.members:bot_access, im:message, im:message.group_at_msg:readonly, im:message.group_msg, im:message.p2p_msg:readonly, im:message:readonly, im:message:send_as_bot, im:resource, sheets:spreadsheet, wiki:wiki:readonly ], user: [ aily:file:read, aily:file:write, im:chat.access_event.bot_p2p_chat:read ] } }导入后申请开通。然后在「凭证与基础信息」里复制 App ID 和 App Secret回到 OpenClaw 的「接入消息平台」页面填入并保存。重启网关后在飞书开放平台的「事件与回调」里把订阅方式改为「长连接」添加「接收消息」事件然后创建版本并发布。如果长连接保存失败说明 OpenClaw 网关未启动或渠道未添加。先确认网关日志里有Gateway is healthy。3.4 工具集配置OpenClaw 默认使用 coding 工具集如果要让 AI 控制手机、发消息、操作浏览器需要切换到 fullopenclaw config set tools.profile full然后重启网关。注意full 工具集权限很大建议只在受信任环境使用。4. 验证请求从飞书发消息到手机执行配置完成后验证分三步飞书消息能否到达 OpenClaw、OpenClaw 能否调用模型、模型能否通过 ADB 控制手机。第一步在飞书里给机器人发一条消息。首次会收到授权提示OpenClaw: access not configured. Your Feishu user id: ou_xxxxxxxx Pairing code: PDTJ8KKR Ask the bot owner to approve with: openclaw pairing approve feishu PDTJ8KKR复制最后一行命令在手机终端或 SSH 里执行openclaw pairing approve feishu PDTJ8KKR授权成功后再发消息就能收到回复。第二步验证模型。在飞书里问你好呀你是谁你当前运行在什么操作系统上面接入的是什么大模型如果回复正常说明模型接入成功。如果报错reading choices检查 TaoToken 的 Base URL 和 Model ID。第三步验证 ADB 控制。在飞书里发帮我打开相机延时 3 秒拍一张照片然后把照片文件传给我在飞书上看一眼。OpenClaw 会通过 ADB 执行am start打开相机然后screencap截图再通过飞书发送文件。实测下来第一次可能返回的是截图而不是真实照片多调教几次就能修复。再试一个帮我打开抖音每隔 5 秒向上滑动一次屏幕模拟刷短视频的操作循环执行 3 次。它会用adb shell input swipe模拟滑动。如果遇到登录弹窗可以继续发继续刷 2 次屏幕上有一个登录弹出你刚才没有给我叉掉导致只刷了一次我叉掉了弹窗。这样就能看到它成功执行滑动操作。验证成功后你可以在飞书里像指挥真人助手一样操控手机。出门在外只要有网络就能远程让手机干活。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节整理我在部署过程中真实遇到的报错和解决方法。401 Unauthorized通常出现在模型调用阶段。原因API Key 填错、Key 被删除、Base URL 不匹配。检查 TaoToken 控制台里的 Key 是否有效Base URL 是否为https://taotoken.net/api。如果用的是自定义提供商确认 Model ID 和平台要求一致。local proxy failed出现在 OpenClaw 网关启动时。原因手机网络不稳定、cpolar 隧道未启动、端口被占用。先检查 cpolar 是否在后台运行pgrep -x cpolar如果没有输出执行source ~/.bashrc重新启动。再检查网关日志里是否有Gateway is healthy。reading choices模型返回格式解析失败。常见于 Base URL 填成了网页地址而不是 API 地址或者 Model ID 不存在。回到 OpenClaw 的「AI 提供商」页面确认 Base URL 以/v1结尾如果平台要求Model ID 拼写正确。OAuth 相关报错飞书长连接保存失败时可能出现。原因OpenClaw 网关未启动、飞书应用未发布、事件订阅方式不是长连接。解决顺序先确认网关运行中再确认飞书应用已创建版本并发布最后在「事件与回调」里把订阅方式改为长连接并保存。ADB 配对失败配对码过期或端口变更。无线调试的配对码和端口在关闭配对窗口后会变化必须重新获取。另外手机和 OpenClaw 必须在同一局域网。飞书机器人不回复检查三件事机器人是否已发布、权限是否开通、OpenClaw 里 App ID 和 App Secret 是否填写正确。如果日志里出现access not configured说明还没执行 pairing approve 命令。cpolar 隧道 24 小时变一次免费版随机 TCP 地址会定期更换。如果需要固定地址去 cpolar 后台预留固定 TCP 端口然后在隧道编辑里选择「固定TCP端口」。6. 语义一致 CTA把手机端 OpenClaw 跑成长期可用的 Agent走到这里你已经完成了手机端 OpenClaw 的部署、模型接入、飞书打通、ADB 无线调试和 cpolar 内网穿透。这套组合的价值在于它把一部闲置安卓手机变成了低功耗、随身携带的 AI 智能体服务器。如果你在排障或接入过程中遇到问题优先看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Keys 管理在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。想单独验证模型是否可用去模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你打算长期跑编码类或 Agent 类任务Coding Plan 更适合https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。它提供更稳定的调用额度和适合开发场景的配置。最后说一个实用技巧手机端 OpenClaw 的 Web UI 目前没有完全适配移动端但你可以通过 SSH 在电脑上管理。先在手机里安装 OpenSSH# 在 OpenClaw 首页找到「可选组件」点击 OpenSSH 安装 # 安装完成后在「SSH访问」里设置密码并启动服务 ssh root192.168.50.225 -p 8022这样你就能用电脑的大屏幕和键盘舒服地调试手机里的 Ubuntu 环境。再配合 cpolar 的公网隧道无论身在何处都能连回去。整套流程跑通后这台旧手机就不再是吃灰设备而是一个随时待命的 AI 执行节点。飞书发消息它干活ADB 连上它控制手机cpolar 穿透它打破局域网限制。剩下的玩法就看你自己的想象力了。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进