1. 鲁班猫4 上跑 OpenClaw为什么值得折腾鲁班猫4LubanCat-4是野火基于 RK3588S 做的卡片电脑八核4×A76 4×A55、6 TOPS NPU、千兆网口跑 Debian 11 很稳。OpenClaw 是一个本地优先的 AI Agent 框架它不像普通聊天机器人只回你几句话而是能在设备上真正执行任务把飞书、Telegram 这类 IM 的消息路由给 AI 智能体再把结果发回频道。把这两者凑一起等于你有一台 7×24 小时在线、数据不出内网的本地 AI 助手。适合谁看手里有鲁班猫4 或其它 RK3588S 板子、想跑本地 Agent 的嵌入式玩家被 x86 教程坑过、在 ARM64 上装 Node.js 反复失败的开发者以及想把 OpenClaw 接进飞书做自动化的人。这篇不聊虚的从 Debian 环境确认、Node.js 24 ARM64 部署、npm 全局路径到 config.toml 与 settings.json 骨架、启动验证和报错排查一条链路走完。我试过在 4GB 内存版本上跑只要不开大模型本地推理日常 Agent 调度完全够用。需要先明确一点OpenClaw 本身是网关 Agent 调度层它调用的是远端或本地的模型 API。所以除了装 OpenClaw你还需要一个能稳定调用的模型服务入口。下面会先把这个前置条件讲清楚再进入板子上的实操。2. 前置准备模型入口与板子基础环境2.1 模型服务入口怎么选OpenClaw 要接 Claude、GPT、Gemini 或本地模型最省事的方式是走一个兼容多模型的 API 网关。TaoToken 提供的就是这类入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。它的作用是让你用一个 Key 就能切换不同模型不用在板子上分别配各家 SDK。对鲁班猫4 这种 ARM 设备来说这点很关键板子算力有限本地跑大模型不现实把推理放到远端、板子只做 Agent 调度和消息路由才是合理分工。你可以在模型对话页面先验证 Key 能不能正常出结果再去配 OpenClaw能省掉一半排错时间。2.2 板子环境确认先确认架构和系统版本别急着下载。SSH 进板子后执行uname -m cat /etc/os-release | head -n 2 free -h df -h /uname -m必须输出aarch64这是 ARM64 的标志。如果输出armv7l说明你拿的不是 64 位系统Node.js 24 的 linux-arm64 包用不了。free -h看内存4GB 版本建议关掉不必要服务df -h /确认根分区至少留 2GBnpm 全局装包会占空间。网络也要通板子要能访问外网下载 Node.js 和 npm 包ping -c 3 nodejs.org curl -I https://taotoken.net/api第二条能返回 HTTP 状态码就说明模型入口可达。如果公司网络有限制换手机热点验证一下排除是板子本身的问题。3. 可复制配置Node.js 24 与 OpenClaw 部署3.1 安装 Node.js 24ARM64 预编译包Debian 11 自带的 Node.js 版本太老OpenClaw 要求较新的运行时所以走官方预编译二进制。在板子上执行cd ~ mkdir -p Downloads cd Downloads wget https://nodejs.org/dist/v24.0.0/node-v24.0.0-linux-arm64.tar.xz tar -xvf node-v24.0.0-linux-arm64.tar.xz sudo mkdir -p /usr/local/lib/nodejs sudo mv node-v24.0.0-linux-arm64 /usr/local/lib/nodejs/建立软链接让系统能找到命令sudo ln -sf /usr/local/lib/nodejs/node-v24.0.0-linux-arm64/bin/node /usr/bin/node sudo ln -sf /usr/local/lib/nodejs/node-v24.0.0-linux-arm64/bin/npm /usr/local/bin/npm sudo ln -sf /usr/local/lib/nodejs/node-v24.0.0-linux-arm64/bin/npx /usr/local/bin/npx验证node -v npm -v输出v24.0.0和对应的 npm 版本号就对了。这里有个坑如果你之前用 apt 装过 node/usr/bin/node可能被旧链接占用-f参数会强制覆盖但保险起见可以which -a node看一眼有没有多个。3.2 配置用户级 npm 全局路径默认npm i -g要 sudo容易把权限搞乱。改成用户级目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc这样以后全局包都装在~/.npm-global不用 sudo也不会污染系统目录。3.3 安装 OpenClawnpm i -g openclaw openclaw --version如果openclaw命令找不到先npm config get prefix看前缀路径确认bin目录在 PATH 里。装完后初始化openclaw onboard --install-daemon这个命令会引导你配模型、密钥并把 Gateway 注册成系统守护进程实现开机自启。引导过程中会让你填 API 基址和 Key基址填https://taotoken.net/apiKey 用你在控制台生成的。3.4 config.toml 骨架OpenClaw 的主配置在~/.openclaw/config.toml具体路径以openclaw onboard提示为准。一个可用的骨架如下[gateway] host 0.0.0.0 port 8787 log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的Key default_model claude-sonnet-4 [channels.feishu] enabled true app_id cli_xxxxxxxx app_secret xxxxxxxx [agent] workspace /home/lubancat/.openclaw/workspace max_tokens 4096base_url指向模型入口api_key换成你自己的。default_model按你实际能调用的模型名填。飞书渠道的app_id和app_secret来自飞书开放平台后面单独说。3.5 settings.json 骨架部分版本用settings.json管理运行时偏好放在同目录{ runtime: { nodePath: /usr/local/lib/nodejs/node-v24.0.0-linux-arm64/bin/node, timezone: Asia/Shanghai }, session: { persist: true, maxHistory: 50 }, logging: { file: /home/lubancat/.openclaw/logs/openclaw.log, level: info } }nodePath写绝对路径避免守护进程启动时 PATH 不完整找不到 node。persist开启会话持久化重启后上下文还在。4. 启动验证与飞书接入4.1 启动 Gatewayopenclaw gateway start openclaw gateway statusstatus显示 running 就说明网关起来了。看日志确认没有报错tail -f ~/.openclaw/logs/openclaw.log日志里出现监听端口和模型连接成功的记录就正常了。本地可以先 curl 一下健康检查curl http://127.0.0.1:8787/health返回{status:ok}之类的 JSON 即通过。4.2 接入飞书在飞书开放平台建一个自建应用拿到app_id和app_secret填进 config.toml 的[channels.feishu]。然后重启网关openclaw gateway restart首次配对会生成验证码按提示执行openclaw pairing approve feishu XXXXXXX配对成功后在飞书里给这个机器人发一条消息能收到 AI 回复就说明整条链路通了。如果没回复先看日志里有没有渠道连接失败的记录。4.3 验证模型调用想单独确认模型入口是否正常可以在模型对话页面发一条测试消息或者用 curl 直接打 APIcurl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d {model:claude-sonnet-4,messages:[{role:user,content:ping}]}能返回内容就说明 Key 和基址都没问题问题只可能在 OpenClaw 配置层。5. 本篇常见报错排查Q1openclaw: command not foundPATH 没生效。执行source ~/.bashrc或重新登录 SSH。还不行就npm config get prefix看路径手动把bin加进 PATH。Q2npm i -g openclaw报 EACCES 权限错误没配用户级全局路径。回到 3.2 节配~/.npm-global或者临时用sudo npm i -g openclaw但不推荐长期这么干。Q3node -v报 command not found软链接没建对。检查/usr/local/lib/nodejs/下的目录名是否和软链接里写的一致重新执行 3.1 的 ln 命令。Q4Gateway 启动后立刻退出多半是 config.toml 格式错误或 api_key 无效。用openclaw gateway status看状态tail日志找具体报错行。TOML 对引号和缩进敏感检查有没有中文引号。Q5飞书消息没回复先确认[channels.feishu]的enabled true再确认 app_id/app_secret 没填错。飞书后台要开消息接收权限事件订阅地址填板子的公网地址或内网穿透地址。Q6ARM64 架构确认uname -m必须是aarch64。如果下成了 x64 的 Node.js 包运行时会报cannot execute binary file重新下 linux-arm64 版本。6. 后续怎么用起来板子跑通之后日常维护就三件事看日志、更新配置、重启网关。长期做编码或 Agent 任务的话可以了解下 Coding Plan把模型调用额度规划好避免跑一半断掉。接入文档里有更细的渠道配置说明遇到新平台接入时对着查。鲁班猫4 的 6 TOPS NPU 后面还能玩本地小模型配合 OpenClaw 做混合推理——简单任务本地跑复杂任务走远端。这套组合的想象空间比单纯装个软件大得多先把今天这条链路跑稳再往上叠。