RK3588 这类 arm 开发板刷上 Armbian 之后其实已经是一台能跑 AI 工具链的小主机了。我手上这块 NanoPi R6CRK3588、8G DDR、32G eMMC系统是 Armbian Ubuntu 24.03 LTS就是典型代表功耗低、常驻开机、arm64 原生支持越来越好。这篇要聊的是在这台 arm 设备上部署 OpenClaw并且把多模型调用统一收敛到 TaoToken 的 Key 通道上解决一个很现实的问题——以前每接一个模型就要改一次配置、换一次 Key散落在好几个文件里维护起来很烦。目标很明确在 armbian rk3588 上跑通 OpenClaw用一份 config.toml 和 settings.json 骨架配合 CC Switch 切换最后做一次 API 连通性验证。适合手里有 arm 开发板、想把它当常驻 AI 牛马用的人。1. 为什么要在 armbian 上折腾 OpenClaw先说场景。OpenClaw 这类工具本质是一个本地跑的 AI 工作台能接模型、能执行任务、能开 Web UI。放在 x86 服务器上当然也行但 RK3588 开发板的优势是7x24 常开不心疼电费体积小塞在角落就行armbian 又是干净的 Debian/Ubuntu 底子apt 生态齐全。真正让我下决心的是 Key 管理这件事。一开始我是每个模型单独配千问一个 Key、Claude 一个 Key、别的又一个 Key散在~/.openclaw/openclaw.json、环境变量、还有几个脚本里。换模型要翻三个地方时间一长自己都记不清哪个 Key 对应哪个服务。后来改成走 TaoToken 统一通道所有模型调用都指向同一个入口配置只维护一份切换模型只改模型名Key 不动。这才是 arm 设备当牛马的正确姿势——稳定、少维护。下面按实际落地顺序走先装依赖再装 OpenClaw然后接 TaoToken最后验证。2. TaoToken 前置拿到统一 Key 和接入地址在动 OpenClaw 配置之前先把 TaoToken 这边的准备工作做完不然后面配置填不进去。你需要两样东西一个 API Key和一个接入地址。Key 在控制台生成地址用官方给的 API 入口。整个流程是注册登录 → 进控制台 → 创建 API Key → 复制保存。具体入口我列一下方便你直接点控制台生成和管理 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档各语言/工具怎么填https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api这个不带任何参数配置里就填它。Key 生成后形如sk-xxxx只显示一次记得存好。注意Key 属于敏感凭证别提交到 git也别贴到公开的 issue 里。armbian 上建议放在~/.openclaw/目录下并chmod 600。如果你后面要长期跑编码类、Agent 类任务可以顺带看下 Coding Plan额度模型更适合常驻调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite3. armbian 环境准备与 OpenClaw 安装3.1 补齐基础依赖Armbian Ubuntu 24.03 默认没装 curl先补上。SSH 进设备后执行sudo apt update sudo apt install curl -y装完确认一下版本能打印出来就说明 OKcurl --version3.2 安装 OpenClaw官方提供了一键脚本指定 git 安装方式curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git这一步在 arm64 上会拉源码并编译依赖RK3588 八核跑起来不算慢耐心等几分钟。3.3 踩坑一缺少 pnpm安装过程中大概率会报找不到 pnpm。OpenClaw 的依赖管理用 pnpm单独装一下sudo npm install -g pnpm如果提示 npm 也没有先装 Node.jssudo apt install nodejs npm -y装完 pnpm 后重新执行 3.2 的安装命令让它继续。3.4 踩坑二找不到 openclaw 命令安装脚本跑完直接敲openclaw可能提示 command not found。这不是没装上而是当前 shell 的 PATH 没刷新。最省事的办法是关掉当前终端重新开一个 SSH 会话再敲openclaw --version能出版本号就说明装好了。如果还不行手动 source 一下 profilesource ~/.bashrc4. 可复制配置config.toml 与 settings.json 骨架这是全文的核心。OpenClaw 的模型接入配置主要落在两个文件里下面给的是可直接改的骨架把 Key 换成你自己的即可。4.1 config.toml 骨架放在~/.openclaw/config.toml# OpenClaw 主配置 - armbian/rk3588 实测骨架 [provider.taotoken] # 统一 Key 通道所有模型走这里 base_url https://taotoken.net/api api_key sk-你的Key # 默认模型可被 settings.json 覆盖 default_model claude-sonnet-4-20250514 [gateway] # 局域网访问 bind lan port 18789 [gateway.controlUi] # http 访问需要放开否则会被拦 allowInsecureAuth true几个参数说明一下避免填错参数作用建议值base_url模型调用入口https://taotoken.net/apiapi_key统一凭证控制台生成的 sk-xxxdefault_model默认模型按需填bind监听范围lan局域网或 localallowInsecureAuth允许 http 访问 UItrue4.2 settings.json 骨架放在~/.openclaw/settings.json用来做模型级别的细调{ models: { default: claude-sonnet-4-20250514, fallback: qwen-plus, list: [ claude-sonnet-4-20250514, qwen-plus, gpt-4o-mini ] }, provider: taotoken, request: { timeout: 60, retry: 2 } }provider指向 config.toml 里定义的taotoken这样模型列表和凭证就解耦了换模型只动 settings.jsonKey 永远在 config.toml 里不动。4.3 CC Switch 切换示例如果你装了 CC SwitchClaude Code 的配置切换工具可以把它也指到同一个通道实现命令行和 OpenClaw 共用一份 Key。配置片段{ profiles: { taotoken: { base_url: https://taotoken.net/api, api_key: sk-你的Key, model: claude-sonnet-4-20250514 } }, active: taotoken }切换时执行cc-switch use taotoken这样 OpenClaw 和 CC Switch 都走 TaoTokenKey 只维护一处。CC Switch 相关的接入细节在文档里有https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite5. 验证请求一次 API 连通性测试配置写完别急着开 UI先用 curl 打一次接口确认 Key 和地址都对。这一步能省掉后面一堆排查。curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 16 }返回里能看到choices字段和一段回复内容就说明通道通了。如果返回 401是 Key 问题返回 404多半是 base_url 或路径写错超时则是网络出口问题。接口通了之后重启 OpenClaw 的 gateway 让配置生效openclaw gateway restart然后浏览器访问http://设备局域网IP:18789?tokenYOUR_TOKENYOUR_TOKEN在~/.openclaw/openclaw.json的 auth 段里。能打开 Web UI 并且模型列表正常加载就说明 arm 设备上的统一 Key 通道跑通了。想直接在网页里试模型对话也可以走这个入口验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite6. 本篇常见错误排查把我在 RK3588 上实际遇到的坑整理成对照表遇到问题直接查现象原因解决curl: command not found系统没装 curlsudo apt install curl -ypnpm: not found依赖管理器缺失sudo npm install -g pnpmopenclaw: command not foundPATH 未刷新重开终端或 source ~/.bashrc401 UnauthorizedKey 错误或过期重新生成并替换404 Not Foundbase_url 写错确认为 https://taotoken.net/apiUI 打不开/被拦未开 allowInsecureAuth设为 true 并重启 gateway局域网访问不了bind 为 local改为 lan 后重启模型列表为空provider 名不匹配检查 settings.json 的 provider 字段几个容易忽略的点改完 config.toml 一定要openclaw gateway restart不然不生效armbian 上防火墙如果开了 ufw记得放行 18789 端口sudo ufw allow 18789/tcp另外 RK3588 内存 8G跑 OpenClaw 本身没问题但如果同时开多个模型会话注意看下free -h必要时在 settings.json 里把并发降下来。7. 后续怎么用这套统一通道跑通之后日常维护就轻松了。换模型只改 settings.json 的default字段Key 永远不动要加新模型往list里加名字就行前提是 TaoToken 那边支持。CC Switch 和 OpenClaw 共用一份凭证命令行和 Web UI 行为一致。如果后面要接 Claude Code 这类编码工具同样把 base_url 指向https://taotoken.net/apiKey 复用即可接入方式文档里写得很细https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite长期常驻跑 Agent 任务的话建议看下 Coding Plan 的额度模型比按次调用更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite最后提醒一句armbian 系统升级内核后偶尔会动到网络配置如果哪天 UI 突然访问不了先ip addr看下 IP 有没有变再检查 gateway 是否在跑。这套东西在 RK3588 上稳定跑了一周多没出现掉线当个安静的 AI 牛马挺合适。