1. 为什么要在 Android 上跑 OpenClaw 节点OpenClaw 是一个把大模型能力接到真实设备上的开源网关你可以把它理解成一个「调度中枢」网关负责和模型对话、管理工具调用而节点负责采集数据、执行动作。Android 手机天然带摄像头、麦克风、GPS、通知栏把它当成 OpenClaw 的移动节点等于给 Agent 装上了一双眼睛、一对耳朵和一张嘴。「人人养虾」这个说法来自 OpenClaw 社区指的是让每个普通用户都能低成本养一只属于自己的 Agent 小虾。相比买树莓派、租云主机闲置的安卓手机是最容易上手的载体不用额外花钱插上电就能 7×24 小时在线还能随时拿走当随身设备用。这篇内容适合三类人手里有闲置安卓机想折腾 Agent 的爱好者想给 OpenClaw 增加移动感知能力的开发者以及被「后台被杀」「配对失败」折磨过的同学。我会从 adb 连接讲起一路走到 APK 安装、Node 环境初始化、配置片段复制最后用一次完整的验证请求确认整条链路跑通。全程命令都可以直接复制遇到报错我会在第五节逐条对照。需要提前说明的是OpenClaw 节点本身只负责设备侧能力模型调用走的是网关。如果你还没搭好网关或者想让手机节点直接调用模型可以用 TaoToken 提供的统一 Key 和 API 通道官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 后面第三节我会给出具体的配置写法。2. 前置准备adb 环境、TaoToken Key 与设备要求动手之前先把三样东西备齐adb 工具链、一台满足要求的安卓机、以及一个可用的模型通道 Key。很多人卡在第一步不是技术难而是环境没装全。adb 属于 Android SDK Platform-ToolsWindows 用户下载压缩包解压后把目录加入 PATHmacOS 用brew install android-platform-toolsLinux 用apt install adb即可。装完执行adb version能打印版本号就说明通了。手机侧要打开「开发者选项」连续点击「设置 → 关于手机 → 版本号」七次然后在开发者选项里打开「USB 调试」。部分厂商小米、OPPO还需要额外打开「USB 安装」否则后面adb install会报INSTALL_FAILED_USER_RESTRICTED。设备要求方面Android 10API 29及以上、ARM64 架构、至少 150MB 可用空间。这个门槛不高近五年的主流机型基本都满足。连接时用数据线插上手机会弹「允许 USB 调试吗」勾选「始终允许」再确认。执行adb devices看到类似9A2X1B2C3D device的输出就代表连接成功如果显示unauthorized说明授权弹窗没点确认拔插一次重来。TaoToken 的作用是提供统一的 Key 和 API 通道让网关侧调用模型时不用分别对接各家接口。你需要拿到两样东西Base URL 和 API Key。Base URL 固定为https://taotoken.net/apiKey 在控制台的 API Keys 页面创建。创建时建议按用途命名比如openclaw-gateway方便后续排查是哪个客户端在调用。Key 只在创建时完整显示一次复制后妥善保存不要提交到 Git 仓库。这里有个容易忽略的点手机节点和网关必须在同一网络或者网关开启远程访问。如果你打算让手机在外网也能连回网关需要网关侧配置openclaw gateway --remote并准备好可访问的域名和端口。家庭宽带没有公网 IP 的话优先考虑同一局域网内使用稳定性最好。3. 可复制配置APK 安装、Node 初始化与 settings 片段环境就绪后进入实操。第一步是拿到 APK。官方渠道是 Google Play 搜索「OpenClaw Node」但很多同学访问不了所以侧载Sideload是更通用的方式。从 GitHub Releases 下载对应 ARM64 的 APK 后用 adb 安装# 确认设备在线 adb devices # 安装 APK-r 表示覆盖安装-d 允许降级 adb install -r openclaw-node-v1.0.0.apk # 如果提示 INSTALL_FAILED_USER_RESTRICTED # 去开发者选项打开「USB 安装」后重试安装成功后桌面会出现 OpenClaw 图标。首次启动需要授予通知、麦克风、摄像头、定位权限建议全部允许否则后面能力开关会失效。第二步是 Node 环境初始化。OpenClaw 节点依赖 Node 运行时APK 内置了精简运行时但如果你要在手机上跑自定义脚本需要确认 Node 版本。通过 adb 进入应用沙盒查看# 查看 OpenClaw 进程与 Node 版本 adb shell dumpsys activity processes | grep openclaw adb shell run-as com.openclaw.node node -v正常会输出v20.x.x之类的版本号。如果提示run-as: package not debuggable说明你装的是 release 包改用adb logcat -s OpenClaw观察启动日志即可。第三步是配置片段。OpenClaw 的节点配置采用 YAML网关侧调用模型的部分建议单独抽出来方便替换。下面这份配置把模型通道指向 TaoToken同时开启前台服务和部分唤醒锁防止后台被杀# ~/.openclaw/config.yaml model: provider: openai-compatible base_url: https://taotoken.net/api api_key: sk-你的TaoTokenKey model_id: claude-sonnet-4-5 timeout: 60 node: type: mobile capabilities: audio: true camera: true location: true notifications: true android: foreground_service: true wake_lock: partial power: mode: balanced location: update_interval: 300如果你用的是 Claude Code 或 Cline 这类客户端配置字段名会不同但三件套不变Base URL 填https://taotoken.net/apiAPI Key 填你创建的那串Model ID 按需选择。以 Claude Code 的settings.json为例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey, ANTHROPIC_MODEL: claude-sonnet-4-5 } }Codex 用户则改~/.codex/auth.json把base_url和api_key换成上面的值。Cline MCP 场景下在 MCP Server 配置里同样填这三项。记住一个原则任何客户端接入先确认 Base URL、Key、Model ID 三件套齐全缺一个都会在验证阶段报错。配置写完后重启节点adb shell am force-stop com.openclaw.node adb shell am start -n com.openclaw.node/.MainActivity4. 验证请求一次完整的配对与调用配置到位后用一次真实请求验证整条链路。先在网关设备上生成配对码openclaw pairing --generate # 输出示例Pairing code: 7F3K-9Q2M打开手机上的 OpenClaw App点击「手动配对」输入这串码点「连接」。如果手机和网关在同一局域网几秒内状态会变成connected。也可以用扫码方式网关执行openclaw qr生成二维码App 里点「扫码配对」直接扫。配对成功后从网关侧发起一次能力调用验证手机节点是否真的在线可用# 查询节点状态 openclaw node list # 触发一次摄像头快照 openclaw node invoke --capability camera --mode snapshot # 触发一次语音播报 openclaw node invoke --capability audio --text 节点已上线正常返回类似{ node_id: android-9A2X1B2C3D, status: online, capabilities: [audio, camera, location, notifications], last_seen: 2025-01-15T10:23:41Z }接着验证模型通道。在网关侧发一条对话请求确认 TaoToken 的 Key 生效curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoTokenKey \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复节点验证通过}] }返回体里choices[0].message.content出现「节点验证通过」说明模型通道和节点通道都通了。这时候你可以试着让 Agent 做一件组合动作比如「拍一张照片并描述画面内容」观察手机摄像头是否被唤起、网关是否收到图像、模型是否返回描述。整个闭环跑通养虾流程就算落地了。验证阶段建议开一个终端专门盯日志adb logcat -s OpenClaw:V日志里会打印配对握手、能力注册、请求转发的全过程出问题时这是最直接的线索来源。5. 常见报错排查401、local proxy failed 与后台被杀这一节按真实报错逐条对照都是我踩过的坑。401 Unauthorized九成是 Key 问题。先确认Authorization头里是Bearer sk-xxx格式别漏了Bearer和空格。再确认 Key 没有多余换行从控制台复制时容易带上尾部空白。如果 Key 确认无误仍报 401检查是不是用了已删除的 Key或者 Base URL 写成了带路径的https://taotoken.net/api/v1导致拼接重复。正确写法是 Base URL 只到/api具体路径由客户端补全。local proxy failed / connection refused这个报错通常出现在网关侧说明网关没能把请求转发出去。先curl一下 Base URL 确认网络可达再检查网关配置里的base_url是否被本地代理覆盖。有些客户端会读取系统环境变量HTTP_PROXY如果之前设过清掉再试。手机节点侧出现这个错多半是手机和网关不在同一网段用ping确认互通性。reading choices 报错cannot read property choices of undefined说明返回体不是预期的 OpenAI 格式通常是模型 ID 写错或者通道返回了错误对象。打印完整响应体看error字段常见的是model not found。把 Model ID 换成通道支持的名称即可。OAuth 相关报错如果你用的是 Claude Code 且配置了 OAuth 登录又同时填了 API Key两者会冲突。解决办法是明确走 Key 模式清掉 OAuth 缓存目录~/.claude/下的凭据文件只保留settings.json里的三件套。后台被杀这是 Android 节点最顽固的问题。通用做法是开启前台服务配置里foreground_service: true并在系统设置里把 OpenClaw 加入电池优化白名单# 查看当前白名单 adb shell dumpsys deviceidle whitelist # 手动加入白名单 adb shell dumpsys deviceidle whitelist com.openclaw.node厂商层面还要针对性设置小米在「省电策略」选「无限制」并允许自启动OPPO 关闭「睡眠待机优化」vivo 在「后台高耗电」里放行华为在「启动管理」里手动允许自启动、关联启动、后台活动三星把应用从「深度休眠」移到「永不休眠」。这些设置做完节点基本能稳定在线。APK 安装失败INSTALL_FAILED_USER_RESTRICTED去开发者选项开「USB 安装」INSTALL_FAILED_INSUFFICIENT_STORAGE清理空间INSTALL_PARSE_FAILED_NO_CERTIFICATES说明 APK 下载不完整重新下载。6. 长期运行与接入建议节点跑通只是开始真正决定体验的是长期稳定性。我的做法是给手机配一个固定电源关掉自动亮度把 OpenClaw 设为常驻前台然后每周用adb shell dumpsys activity processes | grep openclaw检查一次进程存活。如果发现频繁重启优先怀疑电池策略其次看内存是否被其他应用挤占。模型通道这块如果你打算长期跑 Agent 任务建议用 TaoToken 的 Coding Plan它更适合高频、长时间的编码和 Agent 场景比按次调用更省心。接入文档里有各客户端的详细配置示例遇到字段不确定时对照着改。想先验证模型效果可以直接用模型对话页面发几条请求确认通道正常再落到配置里。最后提醒一句手机节点涉及摄像头、麦克风、定位这些敏感能力配置时按需开启不用的一律关掉。省电模式power.mode: saver下把location.update_interval调大、关掉摄像头能显著延长在线时长。养虾的乐趣在于慢慢调先把最小闭环跑通再一项项加能力比一上来全开然后到处排错要高效得多。