安卓手机上跑OpenClaw接入飞书:ADB+cpolar配置与验证全流程
1. 为什么要在安卓手机上跑 OpenClaw 并接入飞书把一台闲置安卓手机变成随身 AI 智能体服务器这件事的吸引力在于手机自带电池、自带网络、24 小时在线功耗还低。OpenClaw 本身是一个开源的 AI 智能体平台能读写文件、执行命令、跑脚本数据全部在本地运行。安卓版通过 Termux proot Ubuntu 方案让手机不用 root 就能跑起完整的 Linux 环境和 OpenClaw 网关。但光在手机本地跑起来还不够——你不可能一直盯着手机屏幕敲命令。真正好用的形态是手机揣兜里当服务器你在飞书里发条消息AI 就开始干活。要实现这个链路需要三块拼图ADB 无线调试让 OpenClaw 能操控手机本身cpolar 内网穿透把本地服务暴露到公网飞书事件订阅回调把消息通道打通。这篇教程面向的是已经或准备在安卓手机上部署 OpenClaw 的读者重点不在安装 APK而在部署完成后的接入与联调ADB 怎么配对、cpolar 隧道怎么配、飞书后台参数怎么填、消息收发怎么验证。每一步都给出可复制的命令和参数清单跟着做就能复现端到端可用状态。2. 前置准备TaoToken 与 OpenClaw 模型接入OpenClaw 跑起来之后第一件事是给它接一个大模型。没有模型的 OpenClaw 只是一个空壳网关飞书发消息过去也不会有任何智能回复。模型接入有两种常见路径一是直接用各家平台的原生 API Key二是通过兼容 OpenAI 协议的中转服务统一管理。如果你手上有多个模型来源、或者想在一个地方统一查看用量和切换模型用 TaoToken 这类兼容 OpenAI 协议的服务会比较省事——它的 API 地址是https://taotoken.net/api在 OpenClaw 的 Custom Provider 里填 Base URL 和 Key 就能用。具体操作在 OpenClaw 终端配置向导里选择Custom ProviderAPI Base URL 填https://taotoken.net/apiAPI Key 填你在控制台创建的密钥模型名称按你实际要用的填。保存后重启网关日志里出现Gateway is healthy就说明模型通道已经通了。如果你还没有密钥可以先到控制台创建一个https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole。创建完在 API Keys 页面复制注意不要泄露到公开仓库。提示OpenClaw 的模型配置支持随时切换。如果你后续想换模型不用重装环境在AI提供商页面改配置再重启网关即可。模型通了之后先在 Web UI 里发一条测试消息确认能正常回复再往下走飞书接入。否则飞书那边配好了、消息发过去没反应排查起来会多一层干扰。3. 可复制配置ADB 无线调试 cpolar 隧道 飞书后台这一节是整篇的核心三块配置按顺序做先让 OpenClaw 能通过 ADB 控制手机再用 cpolar 把 SSH 暴露到公网方便远程调试最后在飞书后台把事件订阅和权限配好。3.1 ADB 无线调试配对先在手机开发者选项里开启无线调试。以 iQOO/vivo 为例设置 → 关于手机 → 版本信息 → 连续点击软件版本号开启开发者模式然后回到设置 → 系统管理与升级 → 开发者选项 → 无线调试 → 启用。启用后进入无线调试页面记下三样东西无线调试地址和端口192.168.50.225:38687 配对码08225 配对码的地址和端口192.168.50.225:42515注意配对码窗口不能关闭关闭后配对码和端口会重新生成。然后回到飞书和 OpenClaw 机器人的对话直接让它帮你装 ADB 并配对。先发请你在当前运行的操作系统上安装 ADB 工具我稍后要做无线调试安装好后我会给你配对信息等它回复安装完成后再发我的无线调试地址和端口是 192.168.50.225:38687配对码的地址和端口是 192.168.50.225:42515配对码是 08225OpenClaw 会执行adb pair和adb connect成功后你在开发者选项的已配对设备里能看到新增的localhost设备。如果配对失败最常见的原因是配对码窗口被关了重新打开无线调试页面生成新的配对码再试。3.2 cpolar 隧道配置cpolar 的作用是把手机局域网里的 SSH 端口映射到公网这样你人在外面也能连回手机终端改配置、查日志。在电脑的 PowerShell 里通过 SSH 连上手机 Ubuntu 后执行一键安装curl -L https://www.cpolar.com/static/downloads/install-release-cpolar.sh | bash因为手机 Ubuntu 里没有 systemd需要配置伪自启动。把下面这段追加到~/.bashrccat 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测试连接ssh root1.tcp.cpolar.top -p 11491能连上就说明穿透成功。免费版地址每 24 小时变一次如果你要长期用可以在 cpolar 后台预留一个固定 TCP 地址然后在隧道编辑里把端口类型改成「固定TCP端口」并填入预留地址。3.3 飞书后台参数填写清单飞书这边需要配的东西比较多按下面清单逐项核对配置项位置填写内容应用创建开发者后台 → 创建企业自建应用应用名称、描述、图标机器人能力添加应用能力 → 机器人添加并设置机器人名称权限导入权限管理 → 批量导入粘贴 JSON 权限配置凭证获取凭证与基础信息复制 App ID 和 App Secret事件订阅事件与回调 → 事件配置订阅方式改为「长连接」添加事件事件与回调 → 添加事件搜索「接收消息」并勾选版本发布版本管理与发布创建版本并确认发布权限 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 的「接入消息平台」页面选择飞书填入这两个值并保存。然后回首页停止网关再启动日志里出现Gateway is healthy就说明飞书渠道加载成功。注意飞书事件订阅的长连接方式必须在 OpenClaw 网关已启动且飞书渠道已添加的前提下才能保存成功。如果保存失败先检查网关状态和渠道配置。4. 验证请求飞书消息收发联调配置完成后需要验证整条链路是否真的通了。验证分两步先确认飞书机器人能收到消息再确认 OpenClaw 能回复。4.1 授权配对在飞书客户端里找到刚发布的机器人发一条任意消息。正常情况下会收到类似这样的回复OpenClaw: access not configured. Your Feishu user id: ou_415413aace1ec226fa05abbac8de1e6b Pairing code: PDTJ8KKR Ask the bot owner to approve with: openclaw pairing approve feishu PDTJ8KKR复制最后那行命令在手机 Ubuntu 终端里执行openclaw pairing approve feishu PDTJ8KKR授权成功后再给机器人发消息就能正常对话了。4.2 消息收发测试发一条测试消息比如你好你现在运行在什么设备上接入的是什么模型如果机器人能正常回复说明飞书 → OpenClaw → 模型 → 飞书这条链路已经通了。4.3 ADB 控制验证飞书通道通了之后可以进一步验证 ADB 控制能力。在飞书里发帮我打开相机延时 3 秒拍一张照片然后把照片文件传给我在飞书上看一眼OpenClaw 会通过 ADB 执行相机启动和拍照命令然后把文件回传。实测下来第一次可能会有些小问题比如截图而非拍照但多试几次调整指令就能成功。再试一个滑动操作帮我打开抖音每隔 5 秒向上滑动一次屏幕循环执行 3 次如果手机没登录抖音会弹登录窗这时候可以补一句继续刷 2 次屏幕上有一个登录弹窗你刚才没有叉掉导致只刷了一次我叉掉了弹窗OpenClaw 会根据你的反馈调整操作。这种「对话式调试」正是智能体相比固定脚本的优势。5. 本篇常见错排查5.1 ADB 配对失败最常见的原因是配对码窗口被关闭。无线调试页面一旦退出配对码和端口就会重新生成。解决办法重新进入无线调试页面生成新的配对码和端口再发给 OpenClaw。另一个原因是手机和 OpenClaw 不在同一局域网。ADB 无线调试要求控制端和设备在同一网段检查手机 Wi-Fi 和 OpenClaw 运行环境的网络是否一致。5.2 cpolar 隧道连不上先确认 cpolar 进程是否在运行pgrep -x cpolar如果没有输出手动启动nohup cpolar start-all -daemonon -dashboardon -config/usr/local/etc/cpolar/cpolar.yml -log/var/log/cpolar/access.log /dev/null 21 然后检查隧道列表里的本地端口是否改成了 8022。默认的 22 端口在手机 Ubuntu 里通常没有服务监听必须改成 SSH 实际端口。5.3 飞书长连接保存失败飞书事件订阅的长连接方式依赖 OpenClaw 网关处于运行状态。如果保存时提示失败按顺序检查网关是否已启动、飞书渠道是否已添加、App ID 和 App Secret 是否填写正确。改完配置后记得停止网关再重新启动让配置生效。5.4 机器人不回复消息先看 OpenClaw 网关日志有没有收到飞书事件。如果日志里没有事件记录说明飞书那边的事件订阅没配好检查「接收消息」事件是否已添加、版本是否已发布。如果日志里有事件但没回复检查模型配置是否正常可以在 Web UI 里先测试模型对话。5.5 SSH 连接被拒绝确认 SSH 服务已启动。在 OpenClaw 首页的「SSH访问」里点击「Start Server」并设置好密码。如果端口不是默认的 8022连接命令里的-p参数要对应修改。6. 长期编码与 Agent 场景的延伸走到这里你已经完成了安卓手机跑 OpenClaw 飞书接入 ADB 控制 cpolar 穿透的完整链路。这套组合的延伸空间很大手机放在家里当常驻 Agent飞书当遥控器ADB 当手脚cpolar 当任意门。如果你后续想把这套环境用于长期编码或 Agent 任务比如让 OpenClaw 持续跑脚本、管理文件、执行定时任务可以考虑用 Coding Plan 来统一管理模型调用和额度https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan。它的定位是给长期运行的编码和 Agent 场景提供稳定的模型通道避免频繁切换 Key 或额度耗尽导致任务中断。另外OpenClaw 的tools.profile默认是coding只开放文件读写和执行命令等基础工具。如果你需要消息发送、浏览器控制、飞书文档操作等能力可以切换到fullopenclaw config set tools.profile full改完重启网关生效。但要注意full模式下 OpenClaw 拥有几乎全部工具权限建议只在受信任的环境中使用。如果你在配置过程中遇到模型接入或 API 报错可以先到接入文档查一下参数格式https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc。文档里有 Base URL、鉴权方式、常见错误码的说明比在日志里盲猜快得多。整套流程跑通之后这台闲置安卓手机就不再是抽屉里的电子垃圾而是一台低功耗、随时在线、能听你指挥干活的 AI 智能体服务器。飞书发条消息它就开始动手这种体验值得你花一个周末折腾一遍。