1. 为什么要在 OpenClaw 里接飞书还要统一 Key 通道OpenClaw 是一个可以本地部署、把大模型能力接到聊天渠道里的开源网关工具飞书则是国内团队日常协作最常用的入口之一。把两者接起来之后你可以在飞书里直接和机器人对话让它帮你查资料、写代码、整理会议纪要而模型调用走的是你自己配置的 API 通道。这套组合适合三类人一是想在内网或本地跑一个可控 AI 助手的开发者二是需要把模型能力嵌进团队工作流的运维或产品同学三是手上已经有多个模型供应商、想统一管理 Key 和 baseUrl 的技术负责人。真正动手时麻烦往往不在 OpenClaw 本身而在两件事第一模型通道怎么配才能既稳定又方便切换第二飞书那边的回调、权限、事件订阅怎么和本地网关对上。我试过把模型 Key 散落在各个配置文件里结果换一个供应商就要改三四个地方后来改成用 TaoToken 做统一 Key 通道OpenClaw 只认一个 baseUrl 和一个 Key切换模型时只改模型名配置骨架清爽很多。下面按安装、通道配置、飞书接入、验证、排障的顺序走一遍每一步都给可复制的骨架。2. 前置准备与 TaoToken 统一 Key 通道2.1 环境与账号清单操作系统方面Linux、macOS 都能直接跑Windows 建议用 WSL2避免路径和守护进程的坑。Node.js 版本要大于等于 22可以用node -v确认。飞书这边需要一个开发者账号登录 open.feishu.cn 创建应用。模型通道这边去 TaoToken 官网注册后拿到 API Key后面 OpenClaw 的模型配置就指向它。TaoToken 在这里扮演的角色是统一入口它提供 OpenAI 兼容的 API 通道OpenClaw 里只要把 baseUrl 指向https://taotoken.net/apiapiKey 填你申请到的 Key就能通过同一个通道调用不同模型。这样你不需要为每个供应商单独维护一套认证配置骨架里只出现一个 provider。2.2 安装 OpenClaw CLI一键安装脚本适合快速起步curl -fsSL https://openclaw.ai/install.sh | bash如果你更习惯 npm 管理全局包也可以用npm install -g openclawlatest安装完成后跑一次新手引导它会帮你生成主配置文件和后台服务openclaw onboard --install-daemon向导里会依次问模型认证方式、Gateway 网关端口、聊天渠道。渠道这一步可以先跳过飞书等模型通道配好再回来接避免一次改太多变量不好定位问题。2.3 用 TaoToken 配置模型通道OpenClaw 的主配置文件在~/.openclaw/openclaw.json。下面这段骨架把 provider 指向 TaoToken 的 API 地址模型名按你实际要用的填{ agents: { defaults: { model: { primary: taotoken/claude-sonnet-4 } } }, models: { mode: merge, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, api: openai-completions, models: [ { id: claude-sonnet-4, name: Claude Sonnet 4, contextWindow: 200000, maxTokens: 8192 }, { id: gpt-4o, name: GPT-4o, contextWindow: 128000, maxTokens: 8192 } ] } } } }这里有几个点值得说明。mode设为merge表示这份配置和 OpenClaw 内置的 provider 列表合并不会覆盖掉默认项。api字段用openai-completions因为 TaoToken 的通道兼容 OpenAI 的请求格式。models数组里可以放多个模型切换默认模型时只改agents.defaults.model.primary的值即可不用动 baseUrl 和 Key。如果你更习惯用 TOML 风格的配置骨架来对照参数可以把它理解成同一组键值[agents.defaults.model] primary taotoken/claude-sonnet-4 [models.providers.taotoken] baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 api openai-completions实际生效的是openclaw.jsonTOML 片段只作为参数对照方便你检查字段名有没有写错。3. 飞书应用配置与 OpenClaw 渠道接入3.1 飞书开发者后台动作进入 open.feishu.cn创建或打开你的应用。第一步是添加机器人能力左侧菜单找到「添加应用能力」把「机器人」加上。第二步配置事件与回调订阅方式选「使用长连接接收事件」这样本地网关不需要公网地址也能收到消息然后在事件列表里搜索并添加im.message.receive_v1这是接收消息的核心事件。第三步开通权限至少需要im:message和im:message.receive前者用于收发单聊和群聊消息后者用于读取用户发给机器人的消息。第四步在「凭证与基础信息」里记下 App ID 和 App Secret。最后去「版本管理与发布」创建版本并发布确认页面显示「当前修改均已发布」否则事件不会真正推送到你的网关。3.2 OpenClaw 侧渠道配置飞书渠道的配置写在同一个openclaw.json里和模型配置并列{ channels: { feishu: { enabled: true, appId: cli_你的AppID, appSecret: 你的AppSecret, connectionMode: websocket, domain: feishu, groupPolicy: open } }, plugins: { entries: { feishu: { enabled: true } } } }connectionMode用websocket对应飞书后台的「长连接」订阅方式两者必须一致否则消息推不过来。domain国内飞书填feishu海外 Lark 填lark。groupPolicy设为open表示群聊里也能响应如果你只想单聊可用可以改成更严格的策略。插件部分要确保feishu的enabled为true否则渠道配置写了也不会加载。3.3 启动 Gateway 并确认加载前台启动方便看日志openclaw gateway --port 18789 --verbose启动日志里应该能看到飞书插件加载成功、websocket 连接建立的信息。如果只看到模型 provider 初始化、没有渠道相关日志多半是插件没启用或配置键名写错。确认无误后可以用openclaw status看整体状态用openclaw health做健康检查。4. 验证请求与成功结果4.1 用 Dashboard 先验证模型通道浏览器打开http://127.0.0.1:18789/在 Dashboard 的聊天界面发一条消息。如果模型通道配对了你会看到流式返回的内容。这一步的意义是把「模型通道」和「飞书渠道」分开验证Dashboard 能通说明 TaoToken 的 baseUrl、Key、模型名都没问题Dashboard 不通就先别去查飞书集中排模型配置。4.2 用命令行验证模型列表openclaw models list这条命令会列出当前已配置的模型。你应该能看到taotoken/claude-sonnet-4这类条目。如果列表为空或报Unknown model说明models.providers里的id和agents.defaults.model.primary里的模型名对不上检查大小写和斜杠前后的 provider 名。4.3 飞书端实际对话打开飞书客户端在顶部搜索你的机器人名称点进去直接发消息。正常情况下几秒内会收到回复。如果机器人没反应先看 Gateway 的前台日志有没有收到im.message.receive_v1事件有事件但没回复问题在模型通道没事件问题在飞书后台的订阅方式、事件添加或应用发布状态。5. 本篇常见报错排查5.1 模型报错 Unknown model报错信息通常是Unknown model: xxx。原因有两个一是模型名格式不对OpenClaw 要求provider/model的形式比如taotoken/claude-sonnet-4斜杠前是 provider 键名斜杠后是 models 数组里的 id二是 provider 没配认证。用openclaw models list确认已配置模型再对照openclaw.json里的id字段逐个核对。5.2 飞书机器人收不到消息按这个顺序查飞书开发者后台的事件与回调里订阅方式是否为「长连接」事件列表里是否添加了im.message.receive_v1权限管理里是否开通了im:message.receive应用是否已经创建版本并发布。这四项缺任何一项消息都不会到达本地网关。另外确认openclaw.json里connectionMode是websocket和后台订阅方式匹配。5.3 Gateway 启动后 LLM request timed out这个报错指向模型通道的网络或地址问题。先确认baseUrl写的是https://taotoken.net/api没有多余斜杠或路径。再确认 apiKey 没有过期或被截断。如果 Dashboard 里也超时用openclaw logs --follow看实时日志通常会打印出请求的目标地址和返回码比只看报错信息更快定位。5.4 配置改了不生效OpenClaw 读取的是~/.openclaw/openclaw.json如果你在别的目录改了同名文件不会生效。改完配置后重启 Gateway或者用openclaw doctor --fix让工具检查并修复常见配置问题。另外注意 JSON 里不能有注释和尾逗号这两处最容易让配置静默失效。6. 把通道固定下来后续只换模型名整套配置跑通之后日常维护其实很轻模型通道固定在 TaoToken 的 baseUrl 和 Key 上想换模型只改agents.defaults.model.primary的值飞书渠道的 appId、appSecret、websocket 连接都不用动。如果你后面要接更多渠道比如 Telegram 或 Discord也是在同一份openclaw.json的channels下加段落模型通道保持一份即可。需要提醒的是飞书应用发布后如果改了权限或事件要重新创建版本并发布否则改动不会生效。Gateway 建议用--install-daemon装成后台服务避免关掉终端就断连。模型 Key 和 App Secret 不要提交到公开仓库本地配置文件权限收紧到只有当前用户可读。如果你在配置过程中想先确认模型通道本身是否可用可以直接在模型对话里发一条测试消息如果打算长期跑编码或 Agent 类任务Coding Plan 的额度模型更适合高频调用接入文档里有完整的字段说明和示例遇到配置键名不确定时对照查一遍比反复试错快得多。