1. 为什么我要把 OpenClaw 接到飞书里OpenClaw 是一个可以跑在个人电脑上的 AI Agent 框架图标是只龙虾2026 年初在开发者圈子里火得不行。它跟普通聊天机器人的区别在于ChatGPT、Claude 这类大模型是「大脑」而 OpenClaw 是给大脑装上了「手脚」——它能真的操作你的电脑帮你新建文件、打开浏览器搜索、执行命令、跑自动化流程。更关键的是它支持接入飞书、Telegram、Discord、Slack 这些常用聊天工具让你在手机上就能指挥它干活。这篇教程聚焦一个具体场景在本地把 OpenClaw 部署起来然后接入飞书机器人并且用 TaoToken 的统一 API Key 来管理多模型鉴权。为什么强调统一 Key因为 OpenClaw 支持 Anthropic、OpenAI、DeepSeek、Qwen 等一堆模型如果每个模型都单独配一个 Key配置文件会乱成一团切换模型时还要改 baseUrl 和 apiKey非常容易出错。TaoToken 提供的是一个兼容 OpenAI 协议的统一入口你只需要一个 Key、一个 baseUrl就能在 OpenClaw 里调用多个模型省掉分散管理的麻烦。适合谁看有 Node.js 基础、想在本地跑一个能实际干活的 AI Agent、并且希望用飞书作为交互入口的开发者。全程大约 30 分钟前提是你的网络能正常访问 npm 和飞书开放平台。2. 前置准备Node.js 环境与 TaoToken API Key2.1 确认 Node.js 版本OpenClaw 依赖 Node.js 运行版本要求 ≥ 22。先在终端里检查node --version npm --version如果版本低于 22推荐用 nvm 管理# 安装 nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash # 加载 nvm避免重启终端 . $HOME/.nvm/nvm.sh # 安装 Node.js 24 nvm install 24 # 验证 node -v # 应输出 v24.x.x npm -v # 应输出 11.x.xmacOS 用户也可以用 Homebrewbrew install node22。Windows 用户建议在 WSL2 里操作原生 Windows 下 OpenClaw 的稳定性较差。2.2 获取 TaoToken 统一 API KeyTaoToken 的定位是一个兼容 OpenAI 接口规范的 API 通道你可以在它的控制台里创建 Key然后用同一个 Key 访问不同厂商的模型。具体操作打开 TaoToken 官网注册并登录账号。进入控制台找到 API Keys 管理页面。创建一个新的 API Key复制保存好后面配置 OpenClaw 时要用。TaoToken 的 API 基础地址是https://taotoken.net/api这个地址在 OpenClaw 的 provider 配置里会用到。注意API 地址不带任何查询参数直接写这个就行。提示TaoToken 的 Key 是统一鉴权用的你不需要为每个模型单独申请 Key。模型的选择通过请求里的 model 字段区分OpenClaw 的配置里会体现这一点。3. 安装 OpenClaw 并写入 config.toml 骨架3.1 一行命令安装 OpenClawOpenClaw 官方提供了一键安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后会自动进入初始化引导。引导里会用左右方向键选择选项几个关键配置项这样选配置项建议选择说明I understand this is powerful and inherently riskyYes确认高权限风险Onboarding modeQuickStart快速生成默认配置Model/auth providerSkip for now稍后手动配置 TaoTokenFilter models by providerAll providers显示所有可选模型Default model默认即可后续会改Select channelSkip for now稍后配飞书Configure skills nowNo后续按需开启Enable hooks选中 command-logger 和 session-memory审计日志 上下文记忆How do you want to hatch your botOpen the Web UI新手友好引导结束后浏览器会自动打开http://127.0.0.1:18789但此时还不能对话因为模型 API 还没配。3.2 理解 OpenClaw 的配置文件结构OpenClaw 的配置存在~/.openclaw/openclaw.json但官方也支持用config.toml风格的配置方式通过openclaw config set命令写入。为了让你有一个可复制的骨架下面给出一个完整的 provider 配置示例把 TaoToken 作为统一入口# ~/.openclaw/config.toml 骨架示例 # 注意实际 OpenClaw 用 openclaw config set 写入 JSON # 这里用 TOML 展示结构方便你理解字段含义。 [models.providers.taotoken] baseUrl https://taotoken.net/api apiKey 你的TaoToken API Key api openai-completions [[models.providers.taotoken.models]] id claude-sonnet-4-6 name Claude Sonnet 4.6 [[models.providers.taotoken.models]] id deepseek-v3.2 name DeepSeek-V3.2 [[models.providers.taotoken.models]] id qwen3-8b name Qwen3-8B [agents.defaults.model] primary taotoken/claude-sonnet-4-6 fallbacks [taotoken/deepseek-v3.2]上面这个骨架的核心思路只配一个 providertaotoken在 models 数组里列出你要用的所有模型。这样切换模型时只需要改primary字段不用动 baseUrl 和 apiKey。3.3 用命令行写入配置OpenClaw 实际用的是 JSON 配置所以用openclaw config set来写入。把下面的你的TaoToken API Key替换成你在第 2 步拿到的 Keyopenclaw config set models.providers.taotoken { baseUrl: https://taotoken.net/api, apiKey: 你的TaoToken API Key, api: openai-completions, models: [ { id: claude-sonnet-4-6, name: Claude Sonnet 4.6 }, { id: deepseek-v3.2, name: DeepSeek-V3.2 }, { id: qwen3-8b, name: Qwen3-8B } ] }设置默认主模型和备用模型openclaw config set agents.defaults.model.primary taotoken/claude-sonnet-4-6 openclaw config set agents.defaults.model.fallbacks [taotoken/deepseek-v3.2]给模型加别名方便在聊天里用/model切换openclaw models aliases add sonnet taotoken/claude-sonnet-4-6 openclaw models aliases add deepseek taotoken/deepseek-v3.2 openclaw models aliases add qwen taotoken/qwen3-8b重启网关让配置生效openclaw gateway restart注意如果你之前初始化时选了默认的 anthropic provider~/.openclaw/openclaw.json里可能残留多余的模型配置。手动编辑这个文件把不需要的 provider 删掉再重启网关。4. 接入飞书机器人事件订阅与凭证配置4.1 在飞书开放平台创建应用访问https://open.feishu.cn/app用手机号注册登录。然后点击「创建企业自建应用」填应用名称和描述。进入应用详情页点击「添加应用能力」选择「机器人」。进入「权限管理」点击「消息与群组」把里面的权限全部勾选。进入「凭证与基础信息」复制App ID和App Secret这两个值后面要用。4.2 把飞书凭证写入 OpenClaw回到终端执行# 设置飞书 App ID openclaw config set channels.feishu.appId 你的AppID # 设置飞书 App Secret openclaw config set channels.feishu.appSecret 你的AppSecret # 重启网关 openclaw gateway restart新版 OpenClaw 已经内置了飞书支持不需要额外装插件。4.3 配置飞书事件订阅回到飞书开放平台在应用详情页找到「事件订阅」订阅方式选择「长连接」。这种方式不需要你暴露公网地址OpenClaw 本地就能接收飞书推送的事件。添加事件搜索「接收消息」勾选im.message.receive_v1。配置完权限和事件后需要发布一个版本才生效。点击「版本管理与发布」创建一个版本并提交发布。4.4 创建群聊并拉入机器人打开飞书创建一个群聊在群设置里找到「群机器人」搜索你刚发布的机器人并添加。在群里 机器人会提示授权复制授权链接在浏览器打开完成用户身份授权。授权链接格式类似https://open.feishu.cn/app/你的机器人APPID/auth?contact:contact.base:readonly授权完成后在群里 机器人发一条消息比如「你好介绍一下自己」如果配置正确机器人会回复。5. 验证请求从 Web UI 到飞书消息收发5.1 先在 Web UI 里验证模型通道打开http://127.0.0.1:18789在聊天框里输入/model deepseek 你好帮我确认一下当前用的是哪个模型如果 TaoToken 的 Key 和 baseUrl 配置正确你会看到模型正常回复并且日志里显示请求发往https://taotoken.net/api。这一步是验证统一 API Key 是否生效的关键。5.2 测试文件操作能力在 Web UI 里输入帮我在桌面新建一个 txt 文件写入 OpenClaw TaoToken 测试成功OpenClaw 会调用文件操作技能在桌面生成文件。如果这一步成功说明 Agent 的工具链正常工作。5.3 飞书端消息收发验证在飞书群里 机器人机器人 帮我查一下现在几点了机器人应该会回复当前时间。再试一个需要调用模型的指令机器人 用一句话解释什么是 AI Agent如果飞书端能正常收到模型回复说明整条链路——飞书事件订阅 → OpenClaw 网关 → TaoToken API → 模型响应 → 飞书消息推送——全部打通。5.4 查看日志排错如果飞书端没反应先在终端看网关日志openclaw gateway前台运行模式下所有请求和错误都会打印出来。重点看有没有feishu相关的报错以及taotokenprovider 的请求状态码。6. 本篇常见错误排查6.1 模型请求返回 401 或 403最常见的原因是 TaoToken API Key 填错或者 baseUrl 写成了带路径的地址。检查openclaw config get models.providers.taotoken确认baseUrl是https://taotoken.net/apiapiKey没有多余空格。如果 Key 是对的去 TaoToken 控制台确认一下 Key 是否被禁用或额度耗尽。6.2 飞书机器人不回复按顺序检查这几项飞书应用是否已发布版本权限和事件订阅修改后必须重新发布才生效。事件订阅方式是否选了「长连接」选 Webhook 的话本地收不到。im.message.receive_v1事件是否添加OpenClaw 网关是否在运行openclaw gateway restart后看日志有没有feishu channel started。群里 机器人后有没有完成授权授权链接要在浏览器里打开并确认。6.3 模型切换后不生效如果你用/model deepseek切换了模型但回复还是旧模型可能是别名没配对。检查openclaw models aliases list确认别名指向的模型 id 和 provider 配置里的 id 一致。另外agents.defaults.model.primary是默认模型聊天里用/model切换只对当前会话生效。6.4 Node.js 版本不兼容如果安装 OpenClaw 时报错Unsupported engine说明 Node 版本低于 22。用nvm install 24升级后重新执行安装脚本。6.5 配置文件残留导致启动失败初始化时如果选了默认 provider~/.openclaw/openclaw.json里可能有无效的模型配置。手动编辑这个文件删掉不需要的 provider 块或者直接rm -rf ~/.openclaw然后重新执行openclaw onboard走一遍引导。注意这会清掉所有配置包括飞书凭证需要重新配。7. 统一 Key 之后模型切换变成一行命令把 TaoToken 作为 OpenClaw 的唯一 provider 之后最直观的变化是你不再需要为每个模型维护一套 baseUrl apiKey。想换模型要么在聊天里发/model deepseek要么改一行agents.defaults.model.primary然后重启网关。对于需要长期跑 Agent 任务的场景这种统一鉴权的方式能省掉大量配置维护时间。如果你还没创建 TaoToken 的 Key可以去控制台建一个然后按第 3 步的配置写入 OpenClaw。飞书那边的应用发布和事件订阅按第 4 步走一遍基本 30 分钟内能跑通。遇到问题先看网关日志大部分错误在日志里都有明确提示。