- 第一章 RK3588 部署 OpenClaw 完整记录
本文记录将 OpenClaw AI 网关部署到 RK3588 开发板（Android 系统）的完整踩坑过程。涉及 Termux 环境、Proot 容器、Node.js 兼容性、OpenClaw 飞书集成等核心难点。全文基于实际操作记录，希望能帮助嵌入式开发者少走弯路。
- 设备：RK3588 开发板（ARM64 架构，8 核 2.4GHz）
- 系统：Android 12（原生 Shell 为 Bionic libc）
- 控制方式：Windows 笔记本通过 ADB + Scrcpy 远程控制
踩坑点 1：Android 原生 Shell 无法运行标准 Node.js
在 RK3588 的 ADB Shell 中直接执行安装命令：
GPT plus 代充 只需 145
根本原因：Android 使用 Bionic libc（专为移动设备优化的 C 库），而标准 Linux 软件（Node.js）依赖 glibc。两者二进制不兼容，导致官方 Node 二进制在 Android 上直接报 。
为绕过 Android 的 Bionic 限制，采用三层架构：
踩坑点 2：Termux 版本选择错误
- 不要从 Google Play 安装（版本停止维护，API 22 不兼容）
- 必须从 F-Droid 或 GitHub Releases 下载 v0.118+
安装命令：
GPT plus 代充 只需 145
踩坑点 3：Termux 原生环境 Node.js 编译失败
在 Termux 中直接运行 会遇到依赖编译错误：
解决方案：安装 Proot-distro 运行完整 Debian：
GPT plus 代充 只需 145
进入后提示符变为 ，此时拥有完整的 glibc 环境。
踩坑点 4：官方脚本 OS 检测
在 Termux 原生环境中运行官方脚本会报错：
但在 Proot Debian 中，脚本正确识别为 Linux，自动完成 Node.js 和 OpenClaw 安装：
GPT plus 代充 只需 145
踩坑点 5：koffi 原生模块编译失败
安装过程中若遇到 koffi 编译错误，需安装构建工具链：
踩坑点 6：Systemd 不可用
Proot 容器中无法使用 systemd，直接启动会提示：
GPT plus 代充 只需 145
解决方案：使用 nohup 后台运行：
踩坑点 7：手动修改配置文件被拒绝
尝试在 中添加飞书配置：
GPT plus 代充 只需 145
报错：
源码验证：查看飞书插件源码发现 ，不接受任何配置字段。
尝试环境变量也无效（ 等环境变量未**件读取）。
最终解决方案：使用 OpenClaw CLI 的交互式命令：
GPT plus 代充 只需 145
按提示输入：
- AppID: 从飞书后台获取
- App Secret: 从飞书后台获取
- Verification Token: 从飞书后台“加密策略”获取
踩坑点 8：Webhook 模式配置复杂
尝试使用 Ngrok 搭建 Webhook，但遇到：
- 免费版域名随机变化
- 飞书验证 JSON 格式失败
- 路径配置复杂（ 或 不确定）
推荐方案：长连接模式（WebSocket）
长连接优势：
- OpenClaw 主动连接飞书服务器，无需公网 IP
- 无需 Ngrok 内网穿透
- 适合嵌入式设备长期运行
踩坑点 9：长连接显示“已连接”但机器人不回复
即使飞书后台显示“已连接”，@机器人仍无响应：
检查清单：
- 事件订阅：必须添加
- 权限：开通 和
- 最关键：发布应用！
在飞书开放平台 → 版本管理与发布 → 创建版本并发布（或添加测试人员）。不发布则事件不会推送！
GPT plus 代充 只需 145
踩坑点 10：AI 无法直接执行系统命令
在 TUI 中让 AI 执行命令时，会提示需要审批：
操作方式：
GPT plus 代充 只需 145
退出 TUI，使用非交互式命令：
GPT plus 代充 只需 145
本文详细记录了在 RK3588 Android 开发板上部署 OpenClaw AI 网关的完整过程。核心难点在于 Android 系统使用 Bionic libc 与标准 Linux 软件不兼容，需要通过 Termux + Proot Debian 搭建完整的 glibc 环境。飞书机器人集成时，切记不能使用配置文件手动添加，必须通过 交互式配置，且务必在飞书后台发布应用版本才能正常接收事件。
希望这份踩坑指南能帮助到同样在嵌入式 Android 设备上部署 AI 服务的开发者，避免重复踩坑。
参考链接：
- OpenClaw 官方文档
- Termux GitHub Releases
- Proot-distro 文档
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/240685.html