1. openclaw 添加飞书 channel 时 plugins install 报错怎么排查openclaw 是一个本地可部署的智能体运行框架默认安装包里并不带飞书Feishuchannel需要你手动通过openclaw plugins install把飞书插件装进来再走openclaw channels add完成配置。它适合谁适合已经在本地跑 openclaw、想让智能体接入飞书群聊或私聊做消息收发的开发者。核心检索词就三个openclaw、飞书 channel、plugins install。我这次的目标很明确在一台 macOS 上给 openclaw 装飞书插件装完配置好 channel最后发一条消息验证连通。整个过程踩了两个坑一个是 npm 缓存目录权限一个是插件残留导致重复安装失败。这两个坑在本地部署场景里出现频率极高所以我把完整命令、依赖清单、配置片段和排障过程都整理出来你照着做基本能一次过。先说清楚整体链路。openclaw 的插件机制是plugins install会去 npm registry 拉取指定的包用npm pack下载 tarball解压到~/.openclaw/extensions/插件名目录然后 openclaw 在启动时扫描这个目录加载插件。飞书插件包名是m1heng-clawd/feishu装完后扩展目录是~/.openclaw/extensions/feishu。理解这条链路后面报错你就能自己定位。环境信息先列一下方便你对照项目值操作系统macOSApple Siliconopenclaw 版本2026.3.2 (85377a2)Node.js建议 18 LTS 及以上npm随 Node 安装建议 9插件包m1heng-clawd/feishu扩展目录~/.openclaw/extensions/feishu安装命令本身很短就一行openclaw plugins install m1heng-clawd/feishu但就是这一行第一次跑直接给我甩了个 EACCES。下面按顺序讲先讲前置准备再讲两个报错怎么修然后讲 channel 配置和消息验证。前置准备其实就两件事。第一确认 openclaw 本体能正常启动跑openclaw --version能看到版本号。第二确认 npm 全局环境干净尤其是~/.npm目录的归属。很多人装 Node 时用过sudo npm install -g导致~/.npm/_cacache里混进了 root 权限的文件这就是后面 EACCES 的根源。你可以先自查一下ls -la ~/.npm | head -20如果看到 owner 是root而不是你自己的用户名那基本就要先处理权限。这一步花两分钟能省掉后面一堆报错。另外提醒一句openclaw 的插件安装依赖 npm 的 pack 能力所以你的 npm 必须能正常访问 registry。如果你所在网络对 npm 源有特殊要求提前配好.npmrc别等装到一半才卡住。配置 registry 的命令是npm config set registry https://registry.npmjs.org/ npm config get registry确认输出是你期望的源即可。前置做完就可以进入正式安装了。2. TaoToken 前置给 openclaw 配好模型入口再装飞书 channel飞书 channel 负责的是消息通道但 openclaw 要真正回消息背后得有模型能力。所以我的习惯是装 channel 之前先把模型入口配好这样 channel 一通就能立刻验证不用来回切配置。这里我用 TaoToken 作为模型调用入口它的 API 地址是https://taotoken.net/api官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content。为什么先配这个因为 openclaw 的 channel 验证动作是「发一条消息看智能体是否回复」。如果模型入口没配好你发出去的消息要么没响应要么报模型调用失败你就分不清是 channel 没通还是模型没通。先把模型这层打通变量就少一个。TaoToken 在这里扮演的是兼容 OpenAI 风格接口的模型调用入口openclaw 里配置 Base URL 指向它填上 Key再指定 Model ID 就行。三件套记牢Base URL、API Key、Model ID缺一不可。Base URL 用https://taotoken.net/apiKey 去控制台生成Model ID 按你实际要用的模型填。生成 Key 的入口在控制台的 API Keys 页面地址是https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite。进去新建一个 Key复制出来注意只显示一次丢了就重建。如果你还没想好用什么模型可以先去模型对话页面试试手感地址是https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite在网页里发几条消息确认模型可用再回来配 openclaw。openclaw 的模型配置一般写在它的配置文件里常见是~/.openclaw/config.json或项目目录下的 settings。下面给一个可复制的 JSON 片段路径和字段名按你本地实际文件来字段值替换成你自己的{ models: { default: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: 你的ModelID } } }注意baseUrl结尾不要多加/v1按https://taotoken.net/api填具体以接入文档为准。文档地址是https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有各语言的调用示例配之前扫一眼能少走弯路。配完模型建议先单独验证一次模型调用别急着装飞书。你可以用 curl 直接打一发curl https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 你好}] }返回里有choices字段且内容正常说明模型这层通了。这一步过了再去装飞书 channel后面验证消息收发时你就能确定问题只可能出在 channel 侧。如果你打算长期跑编码类或 Agent 类任务可以考虑 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite按需选就行。3. 可复制配置plugins install 命令、npm 依赖清单与 channel 配置片段这一节是全文最核心的操作部分我把命令、依赖、配置片段全部给全你直接复制改路径即可。第一步安装飞书插件。命令就一行openclaw plugins install m1heng-clawd/feishu正常输出会看到 openclaw 的启动 banner然后是Downloading m1heng-clawd/feishu…接着Extracting …/m1heng-clawd-feishu-0.1.15.tgz…最后提示安装成功。装完后扩展落在~/.openclaw/extensions/feishu。第二步确认 npm 依赖。飞书插件本身依赖一批 npm 包openclaw 在 pack 阶段会一并处理。你不需要手动npm install但要保证 npm 缓存目录可写。依赖清单大致包括飞书 SDK、HTTP 客户端、事件解析相关的包实际以插件package.json为准。装完后可以进扩展目录看一眼cat ~/.openclaw/extensions/feishu/package.json里面dependencies字段就是它声明的依赖。如果某个依赖缺失导致加载失败openclaw 启动日志会明确报出模块名按名字补装即可。第三步添加 channel。命令是openclaw channels add交互过程按提示走先选 yes 确认添加再选飞书Feishu然后输入密钥、输入 API 相关信息飞书版本如果是国内选 CNpolicy 配置选 open。这些交互项对应到配置文件里大致是下面这个结构。你可以直接编辑配置文件也可以走交互命令二选一{ channels: { feishu: { enabled: true, appId: cli_你的飞书AppID, appSecret: 你的飞书AppSecret, region: CN, policy: open } } }appId和appSecret来自飞书开放平台你创建的应用region国内填CNpolicy填open表示放开策略。注意plugins.allow这个字段openclaw 启动时会提示plugins.allow is empty; discovered non-bundled plugins may auto-load意思是没显式声明信任的插件 id非内置插件会被自动加载。想更严谨的话在配置里加上{ plugins: { allow: [feishu] } }这样只有feishu会被加载避免其他扩展被误加载。配置改完重启 openclaw 让 channel 生效openclaw restart或者直接停掉再起。启动日志里如果看到飞书 channel 注册成功、gateway online就说明配置被读到了。到这一步插件装好、依赖就绪、channel 配好可以进入验证环节。4. 验证请求发一条飞书消息确认 channel 连通配置写完不算通必须发一条真实消息验证。这一步是整个流程的验收点别跳过。验证前先确认 openclaw 进程在跑并且飞书 channel 已加载。启动日志里应该能看到类似Gateway online的提示以及飞书 channel 的注册信息。如果日志里没有飞书相关行说明配置没被读到回去检查配置文件路径和 JSON 格式。然后在飞书里找到你配置的那个应用机器人给它发一条消息比如「你好测试一下」。消息发出后观察两个地方一是 openclaw 的终端日志应该能看到收到消息的事件记录二是飞书里机器人是否回复。如果模型入口上一节配的 TaoToken正常机器人会返回模型生成的内容。日志里大致会经历收到飞书事件 → 解析消息 → 调用模型 → 返回回复 → 通过飞书 API 发回。任何一环断了日志都会停在对应位置这就是排障的线索。你也可以用 curl 直接打飞书的事件回调或 openclaw 的本地接口做更底层的验证但最直观的还是真人在飞书里发消息。我实测下来第一次发消息如果没回复九成是 channel 配置里的appId/appSecret不对或者飞书应用没开机器人能力。去飞书开放平台检查应用的机器人开关和权限范围把「接收消息」和「发送消息」权限开上再发一次。验证成功的标志很明确飞书里机器人正常回复openclaw 日志里模型调用返回choices且无报错。到这一步openclaw 添加飞书 channel 就算真正连通了。如果没通直接看下一节的报错对照。5. 本篇常见错排查EACCES、plugin already exists、401 与 reading choices这一节把我在这次安装里遇到的和常见的报错逐个拆开给你对照表。第一个npm 缓存权限 EACCES。完整报错长这样npm error code EACCES npm error syscall mkdir npm error path /Users/shine/.npm/_cacache/index-v5/d1/0f npm error errno -13 npm error Your cache folder contains root-owned files npm error To permanently fix this problem, please run: npm error sudo chown -R 501:20 /Users/shine/.npm本质是~/.npm里有 root 权限文件当前用户写不进去。修复命令sudo chown -R $(whoami) ~/.npm输入密码后重新跑openclaw plugins install m1heng-clawd/feishu即可。这个报错和 openclaw 本身无关纯粹是 npm 缓存归属问题。第二个plugin already exists。报错plugin already exists: /Users/shine/.openclaw/extensions/feishu (delete it first)原因是上次安装失败留下了残留目录。修复rm -rf ~/.openclaw/extensions/feishu openclaw plugins install m1heng-clawd/feishu删掉再装干净利落。注意别删错目录确认路径是~/.openclaw/extensions/feishu。第三个401 未授权。这个通常出在模型调用侧不是 channel 侧。报错里会带401 Unauthorized。检查三件套Base URL 是不是https://taotoken.net/apiAPI Key 有没有复制全、有没有多余空格Model ID 是不是你账号可用的。改完重启 openclaw 再试。第四个local proxy failed。这个多半是本地网络或代理配置干扰了请求。检查你的环境变量里有没有残留的HTTP_PROXY/HTTPS_PROXY有的话先清掉再试unset HTTP_PROXY HTTPS_PROXY第五个reading choices 报错。典型是模型返回结构不符合预期日志里出现cannot read property choices of undefined之类。原因通常是 Base URL 填错导致返回了非预期内容或者 Model ID 不存在。回到上一节的 curl 验证先确认模型接口本身返回正常再排查 openclaw 配置。第六个OAuth 相关报错。如果你在飞书侧用了 OAuth 授权模式报错会提示 token 获取失败。检查飞书应用的授权回调地址、权限范围是否配对appId/appSecret是否和开放平台一致。把这张对照表存下来遇到报错先对号入座能省大量时间报错关键词出现位置处理方向EACCESnpm pack 阶段chown 修 ~/.npm 权限plugin already exists插件安装阶段删扩展目录重装401模型调用查 Base URL/Key/Model IDlocal proxy failed网络请求清代理环境变量reading choices模型返回解析验模型接口返回结构OAuth飞书授权查回调与权限范围6. 后续接入与长期使用建议飞书 channel 通了之后你可以继续做几件事让这套环境更稳。第一把plugins.allow显式声明只加载你信任的插件避免启动时自动加载未知扩展。第二把模型配置和 channel 配置分开管理模型侧统一走 TaoToken 的 Base URL换模型只改 Model ID不动 channel。第三定期清理~/.npm缓存和~/.openclaw/extensions下的废弃插件减少重复安装报错。如果你后面要接更多 channel比如其他 IM 或自定义 webhook思路是一样的先plugins install装插件再channels add配参数最后发消息验证。把这三步固化成流程换任何 channel 都不慌。需要长期跑编码或 Agent 任务的可以看下 Coding Plan入口在https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite。API Key 管理和新建在https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入细节看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite。想先试模型效果就去模型对话页https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite。最后留一个我踩过的坑装插件前一定先确认~/.npm归属这一步花两分钟能避免后面 EACCES 和残留目录连环报错。装完记得openclaw restart配置不重启不生效。