1. 从零把 OpenClaw 接进飞书我踩过的那些坑OpenClaw 是一个自托管网关简单说就是跑在你自己机器上的一个进程把飞书、Telegram、Discord 这类聊天工具和 AI 编码代理连起来。你在飞书里发一句话网关收到后转发给模型再把结果回传到飞书会话里。它适合愿意自己掌控数据、又想在聊天窗口里随手调用 AI 的开发者。这篇要解决的核心问题是OpenClaw 本体装好了飞书插件也装了但应用凭证、权限、事件回调、统一 Key 这几块串不起来消息发出去没反应。我会按环境准备、插件安装、TaoToken 统一 Key 接入、settings.json/config.toml 骨架配置、端到端验证的顺序走一遍配置片段可以直接复制。飞书这条链路比 Telegram 麻烦的地方在于它需要在飞书开放平台建应用、配权限、订阅事件、发版本任何一步漏了都会表现为「机器人不回消息」。而模型侧如果每个渠道都单独填一套 Key维护起来很痛苦所以这里用 TaoToken 做统一入口一个 Key 覆盖多个模型通道。2. 环境准备与 OpenClaw 安装2.1 版本要求与安装前清理Node 版本必须大于等于 22这是硬门槛低于这个版本装到一半会报模块解析错误。如果你之前装过旧版先卸干净再装避免残留配置干扰。# 卸载旧版本 pnpm uninstall -g openclaw pnpm list -g --depth0 # 删除旧配置目录 rm -rf ~/.openclaw一键安装脚本最省事curl -fsSL https://openclaw.ai/install.sh | bash也可以用 npm 或 pnpm 手动装# npm 方式 npm install -g openclawlatest # pnpm 方式 pnpm add -g openclawlatest装完先确认版本和健康状态openclaw --version openclaw doctordoctor会检查 Node 版本、配置目录权限、网关端口占用等输出里如果有红色项先解决再往下走。2.2 初始化向导openclaw onboard --install-daemon这个命令会引导你完成基础配置并注册后台守护进程。向导里会让你选模型提供方这里先跳过或随便选后面我们统一改成 TaoToken 通道。装完守护进程后网关默认监听 18789 端口Web UI 地址是http://127.0.0.1:18789/chat?sessionagent%3Amain%3Amain常用基础命令记一下后面排障会反复用openclaw gateway restart # 改配置后必须重启才生效 openclaw gateway stop openclaw models list # 列出当前可用模型 openclaw config # 打开配置编辑 openclaw tui # 终端界面3. TaoToken 统一 Key 接入3.1 为什么用统一 KeyOpenClaw 支持多渠道多代理如果飞书、钉钉、QQ 各配一套模型凭证改一次模型要动好几处。TaoToken 提供统一的 API 通道一个 Key 就能在多个模型之间切换配置只写一份渠道插件共用。对自托管网关这种场景来说集中管理凭证比分散填写省心得多。3.2 获取 Key 与配置通道先到控制台创建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy创建后复制 Key注意只显示一次。接入文档在这里参数细节可以对照看https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deployAPI 基础地址是https://taotoken.net/api这个地址不带任何查询参数直接填进配置即可。3.3 config.toml 骨架配置OpenClaw 的模型通道配置写在~/.openclaw/config.toml里。下面是一个可用的骨架把apiKey换成你自己的[providers.taotoken] type openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 defaultModel claude-sonnet-4-20250514 [agents.main] provider taotoken model claude-sonnet-4-20250514type用openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 能直接识别。defaultModel和 agent 里的model保持一致避免路由时找不到模型。改完重启网关openclaw gateway restart openclaw models listmodels list里能看到 taotoken 通道下的模型说明 Key 和地址都通了。如果这里就报 401先别急着装飞书插件把 Key 和 baseUrl 核对一遍。4. 飞书插件安装与 settings.json 配置4.1 安装插件OpenClaw 默认自带 Feishu/Lark 插件如果没有再手动装cd ~/.openclaw/extensions openclaw plugins install m1heng-clawd/feishu openclaw plugins list openclaw plugins info feishu启用插件并加入信任列表openclaw plugins enable feishu openclaw config set plugins.allow [feishu]4.2 飞书开放平台建应用到飞书开放平台创建应用https://open.feishu.cn/app?langzh-CN建完拿到 App ID 和 App Secret这两个是配对凭证。然后添加「机器人」应用能力进入权限管理批量导入下面这组权限{ scopes: { tenant: [ im:message:send_as_bot, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:readonly, im:resource, contact:user.employee_id:readonly, drive:drive:readonly, application:application:self_manage, application:bot.menu:write, contact:contact.base:readonly, event:ip_list, im:chat.access_event.bot_p2p_chat:read, im:chat.members:bot_access ], user: [ im:chat.access_event.bot_p2p_chat:read ] } }权限里im:message和im:message:send_as_bot是收发消息的核心缺了机器人就是哑巴。事件与回调里勾选「接收消息」事件否则飞书不会把用户消息推给网关。最后发布版本不发布的话权限不生效。4.3 settings.json 渠道配置飞书渠道的配置写在~/.openclaw/settings.json的channels节点下{ channels: { feishu: { enabled: true, appId: cli_xxxxxxxxxxxxxxxxxx, appSecret: xxxxxxxxxxxxxxxxxx, domain: feishu, groupPolicy: disabled } } }domain填feishu表示国内版groupPolicy设为disabled表示只响应私聊群聊需要 才触发的话改成对应策略。改完重启openclaw gateway restart5. 端到端验证与成功结果5.1 配对流程飞书插件需要配对才能绑定会话。在飞书里给机器人发一条消息网关会生成配对码然后执行openclaw pairing approve feishu 7QP32BRW配对码有时效性收到后尽快执行。配对成功后再发一条消息机器人应该能正常回复。5.2 验证请求在飞书私聊窗口发一句「你好帮我列一下当前目录」观察三件事飞书里是否收到回复、网关日志是否有请求记录、openclaw models list里的模型是否被调用。日志可以这样看openclaw gateway logs --follow如果回复正常说明飞书事件回调、插件路由、TaoToken 通道三段都通了。想单独验证模型通道可以用模型对话页面直接测https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy5.3 长期编码场景如果你打算把 OpenClaw 当日常编码助手用飞书里频繁调用模型建议走 Coding Plan额度更稳https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy6. 常见报错排查6.1 机器人不回消息先查三处飞书开放平台的事件订阅是否勾了「接收消息」、版本是否已发布、settings.json里enabled是否为 true。这三项任意一个没配好消息都到不了网关。再看网关日志有没有收到事件推送没有的话就是飞书侧的问题。6.2 401 或模型不可用models list报 401多半是 Key 填错或 baseUrl 写成了带路径的地址。baseUrl 必须是https://taotoken.net/api不要在后面加/v1之类的后缀。Key 复制时注意别带空格。6.3 插件未加载openclaw plugins list里看不到 feishu检查是否执行了plugins enable feishu以及plugins.allow数组里有没有包含feishu。信任列表没加的话插件会被安全策略拦下。6.4 配对码失效配对码有时效过期后重新在飞书发消息生成新的再执行pairing approve。别用旧的码反复试。6.5 改配置不生效OpenClaw 的配置改动必须重启网关才生效openclaw gateway restart是高频操作。改完config.toml或settings.json都记得重启一次。整条链路跑通后飞书里发消息、网关转发、TaoToken 通道调模型、结果回传四步闭环。后面换模型只改config.toml里的model字段飞书侧不用动。
OpenClaw + 飞书插件完整部署指南：TaoToken 统一 Key 接入与配置验证
1. 从零把 OpenClaw 接进飞书我踩过的那些坑OpenClaw 是一个自托管网关简单说就是跑在你自己机器上的一个进程把飞书、Telegram、Discord 这类聊天工具和 AI 编码代理连起来。你在飞书里发一句话网关收到后转发给模型再把结果回传到飞书会话里。它适合愿意自己掌控数据、又想在聊天窗口里随手调用 AI 的开发者。这篇要解决的核心问题是OpenClaw 本体装好了飞书插件也装了但应用凭证、权限、事件回调、统一 Key 这几块串不起来消息发出去没反应。我会按环境准备、插件安装、TaoToken 统一 Key 接入、settings.json/config.toml 骨架配置、端到端验证的顺序走一遍配置片段可以直接复制。飞书这条链路比 Telegram 麻烦的地方在于它需要在飞书开放平台建应用、配权限、订阅事件、发版本任何一步漏了都会表现为「机器人不回消息」。而模型侧如果每个渠道都单独填一套 Key维护起来很痛苦所以这里用 TaoToken 做统一入口一个 Key 覆盖多个模型通道。2. 环境准备与 OpenClaw 安装2.1 版本要求与安装前清理Node 版本必须大于等于 22这是硬门槛低于这个版本装到一半会报模块解析错误。如果你之前装过旧版先卸干净再装避免残留配置干扰。# 卸载旧版本 pnpm uninstall -g openclaw pnpm list -g --depth0 # 删除旧配置目录 rm -rf ~/.openclaw一键安装脚本最省事curl -fsSL https://openclaw.ai/install.sh | bash也可以用 npm 或 pnpm 手动装# npm 方式 npm install -g openclawlatest # pnpm 方式 pnpm add -g openclawlatest装完先确认版本和健康状态openclaw --version openclaw doctordoctor会检查 Node 版本、配置目录权限、网关端口占用等输出里如果有红色项先解决再往下走。2.2 初始化向导openclaw onboard --install-daemon这个命令会引导你完成基础配置并注册后台守护进程。向导里会让你选模型提供方这里先跳过或随便选后面我们统一改成 TaoToken 通道。装完守护进程后网关默认监听 18789 端口Web UI 地址是http://127.0.0.1:18789/chat?sessionagent%3Amain%3Amain常用基础命令记一下后面排障会反复用openclaw gateway restart # 改配置后必须重启才生效 openclaw gateway stop openclaw models list # 列出当前可用模型 openclaw config # 打开配置编辑 openclaw tui # 终端界面3. TaoToken 统一 Key 接入3.1 为什么用统一 KeyOpenClaw 支持多渠道多代理如果飞书、钉钉、QQ 各配一套模型凭证改一次模型要动好几处。TaoToken 提供统一的 API 通道一个 Key 就能在多个模型之间切换配置只写一份渠道插件共用。对自托管网关这种场景来说集中管理凭证比分散填写省心得多。3.2 获取 Key 与配置通道先到控制台创建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy创建后复制 Key注意只显示一次。接入文档在这里参数细节可以对照看https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deployAPI 基础地址是https://taotoken.net/api这个地址不带任何查询参数直接填进配置即可。3.3 config.toml 骨架配置OpenClaw 的模型通道配置写在~/.openclaw/config.toml里。下面是一个可用的骨架把apiKey换成你自己的[providers.taotoken] type openai-compatible baseUrl https://taotoken.net/api apiKey sk-你的TaoToken密钥 defaultModel claude-sonnet-4-20250514 [agents.main] provider taotoken model claude-sonnet-4-20250514type用openai-compatible是因为 TaoToken 的接口兼容 OpenAI 格式OpenClaw 能直接识别。defaultModel和 agent 里的model保持一致避免路由时找不到模型。改完重启网关openclaw gateway restart openclaw models listmodels list里能看到 taotoken 通道下的模型说明 Key 和地址都通了。如果这里就报 401先别急着装飞书插件把 Key 和 baseUrl 核对一遍。4. 飞书插件安装与 settings.json 配置4.1 安装插件OpenClaw 默认自带 Feishu/Lark 插件如果没有再手动装cd ~/.openclaw/extensions openclaw plugins install m1heng-clawd/feishu openclaw plugins list openclaw plugins info feishu启用插件并加入信任列表openclaw plugins enable feishu openclaw config set plugins.allow [feishu]4.2 飞书开放平台建应用到飞书开放平台创建应用https://open.feishu.cn/app?langzh-CN建完拿到 App ID 和 App Secret这两个是配对凭证。然后添加「机器人」应用能力进入权限管理批量导入下面这组权限{ scopes: { tenant: [ im:message:send_as_bot, im:message, im:message.group_at_msg:readonly, im:message.p2p_msg:readonly, im:message:readonly, im:resource, contact:user.employee_id:readonly, drive:drive:readonly, application:application:self_manage, application:bot.menu:write, contact:contact.base:readonly, event:ip_list, im:chat.access_event.bot_p2p_chat:read, im:chat.members:bot_access ], user: [ im:chat.access_event.bot_p2p_chat:read ] } }权限里im:message和im:message:send_as_bot是收发消息的核心缺了机器人就是哑巴。事件与回调里勾选「接收消息」事件否则飞书不会把用户消息推给网关。最后发布版本不发布的话权限不生效。4.3 settings.json 渠道配置飞书渠道的配置写在~/.openclaw/settings.json的channels节点下{ channels: { feishu: { enabled: true, appId: cli_xxxxxxxxxxxxxxxxxx, appSecret: xxxxxxxxxxxxxxxxxx, domain: feishu, groupPolicy: disabled } } }domain填feishu表示国内版groupPolicy设为disabled表示只响应私聊群聊需要 才触发的话改成对应策略。改完重启openclaw gateway restart5. 端到端验证与成功结果5.1 配对流程飞书插件需要配对才能绑定会话。在飞书里给机器人发一条消息网关会生成配对码然后执行openclaw pairing approve feishu 7QP32BRW配对码有时效性收到后尽快执行。配对成功后再发一条消息机器人应该能正常回复。5.2 验证请求在飞书私聊窗口发一句「你好帮我列一下当前目录」观察三件事飞书里是否收到回复、网关日志是否有请求记录、openclaw models list里的模型是否被调用。日志可以这样看openclaw gateway logs --follow如果回复正常说明飞书事件回调、插件路由、TaoToken 通道三段都通了。想单独验证模型通道可以用模型对话页面直接测https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy5.3 长期编码场景如果你打算把 OpenClaw 当日常编码助手用飞书里频繁调用模型建议走 Coding Plan额度更稳https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_feishu_deploy6. 常见报错排查6.1 机器人不回消息先查三处飞书开放平台的事件订阅是否勾了「接收消息」、版本是否已发布、settings.json里enabled是否为 true。这三项任意一个没配好消息都到不了网关。再看网关日志有没有收到事件推送没有的话就是飞书侧的问题。6.2 401 或模型不可用models list报 401多半是 Key 填错或 baseUrl 写成了带路径的地址。baseUrl 必须是https://taotoken.net/api不要在后面加/v1之类的后缀。Key 复制时注意别带空格。6.3 插件未加载openclaw plugins list里看不到 feishu检查是否执行了plugins enable feishu以及plugins.allow数组里有没有包含feishu。信任列表没加的话插件会被安全策略拦下。6.4 配对码失效配对码有时效过期后重新在飞书发消息生成新的再执行pairing approve。别用旧的码反复试。6.5 改配置不生效OpenClaw 的配置改动必须重启网关才生效openclaw gateway restart是高频操作。改完config.toml或settings.json都记得重启一次。整条链路跑通后飞书里发消息、网关转发、TaoToken 通道调模型、结果回传四步闭环。后面换模型只改config.toml里的model字段飞书侧不用动。
