1. 飞书聊天控制 OpenClaw 到底解决什么问题飞书聊天控制 OpenClawClawdbot这件事本质是把「大龙虾」这个本地 AI 助手从终端里解放出来塞进你每天都在用的飞书聊天窗口。OpenClaw 是一个可以跑在自己机器上的 AI Agent 框架能读写文件、执行命令、调用模型而飞书插件m1heng-clawd/feishu负责在飞书开放平台和 OpenClaw 网关之间搭一条长连接通道。配好之后你在飞书里 一下机器人发句话OpenClaw 就会在本地执行动作并把结果回传给你。适合谁三类人最需要一是天天泡在飞书里、懒得切终端的开发者二是想让团队非技术同学也能触发本地脚本的运维三是想把 OpenClaw 当远程 Agent 用、但不想暴露公网端口的人。整条链路的关键卡点其实不在飞书那边而在模型接入——OpenClaw 要调模型你得给它一个稳定、统一、不用来回换的 Key。这篇就用 TaoToken 统一 Key 把这块补上配合飞书插件目标 2 分钟跑通「聊天窗口下发指令 → OpenClaw 执行 → 飞书回消息」的闭环。我试过把模型配置散落在多个环境变量里换一次模型改五处后来统一收敛到 TaoToken 的 Key 上配置骨架清爽很多。下面按「前置准备 → 配置骨架 → 飞书绑定 → 验证 → 排障」走一遍。2. TaoToken 前置统一 Key 与 OpenClaw 的关系OpenClaw 本身不绑定某一家模型它通过 provider 配置去请求兼容 OpenAI 协议的服务。TaoToken 提供的就是这样一个统一入口一个 Key、一个 base_url背后可以路由到不同模型。对 OpenClaw 来说你只需要在配置里写清楚base_url和api_key剩下的模型切换在 TaoToken 侧完成本地配置不用动。这一步要做的事只有两件拿到 Key确认 base_url。访问控制台创建 API Key地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建后复制那串sk-开头的值只显示一次先存到密码管理器里。base_url 用 https://taotoken.net/api 注意这个地址后面不加任何路径后缀OpenClaw 会自己拼/v1/chat/completions。注意Key 不要写进会提交到 Git 的文件里。OpenClaw 的配置目录通常在~/.openclaw/把它加进.gitignore或者用环境变量注入。如果你还想先确认模型通不通可以打开模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 发一条测试消息确认 Key 有效再往下配。这一步花 30 秒能省掉后面一半的排障时间。3. 可复制的 TaoToken 统一 Key 配置骨架OpenClaw 支持settings.json和config.toml两种配置风格取决于你装的版本和插件读取方式。下面两份骨架你按实际用的那份填核心就是 provider 段的base_urlapi_keymodel。先看settings.json版本放在~/.openclaw/settings.json{ providers: { taotoken: { type: openai-compatible, base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, models: { default: claude-sonnet-4-5, fast: gpt-4o-mini } } }, agent: { provider: taotoken, model: claude-sonnet-4-5, max_tokens: 4096 }, channels: { feishu: { enabled: true, app_id: cli_你的AppID, app_secret: 你的AppSecret } } }再看config.toml版本适合偏好 TOML 的场景[providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 [providers.taotoken.models] default claude-sonnet-4-5 fast gpt-4o-mini [agent] provider taotoken model claude-sonnet-4-5 max_tokens 4096 [channels.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret两份配置里base_url都只写到/api不要写成/api/v1否则会拼出/api/v1/v1/chat/completions这种 404 路径。model字段填 TaoToken 侧支持的模型名写错会返回 model not found具体可用名在模型对话页能看到。如果你更想用环境变量而不是明文写 Key可以这样export TAOTOKEN_API_KEYsk-你的TaoToken密钥 export TAOTOKEN_BASE_URLhttps://taotoken.net/api然后在配置里把api_key换成${TAOTOKEN_API_KEY}OpenClaw 启动时会做变量替换。这样配置文件可以安全地放进版本库。4. 飞书插件安装与机器人绑定步骤配置骨架就位后装飞书插件。在 OpenClaw 界面或终端里执行clawdbot plugins install m1heng-clawd/feishu看到安装成功提示后去飞书开放平台创建企业自建应用。路径是「创建应用 → 企业自建应用」填名称和描述进入应用详情页。在「凭证与基础信息」里复制 App ID 和 App Secret填回上面配置的channels.feishu段。接着开机器人能力在「添加应用能力 → 机器人」页面把开关打开。权限部分用「批量导入」粘贴权限 JSON把消息收发、群聊读取、卡片写入这些 scope 一次性导入省得一个个勾。核心几个是im:message、im:message:send_as_bot、im:chat:read、im:message.group_at_msg:readonly。事件回调这一步最容易卡住。在「事件订阅」页面选长连接模式WebSocket添加订阅事件im.message.receive_v1。前提是网关已经在跑、Feishu 渠道已经加上否则长连接设置会保存失败。检查命令openclaw channels add feishu openclaw gateway status网关没起来就先openclaw gateway start。最后在「版本管理与发布」创建版本、提交审核、发布企业自建应用一般自动通过。配置改完记得重启网关让配置生效openclaw gateway restart5. 验证一条消息触发 OpenClaw 动作发布完成后在飞书搜索你的机器人名称发一条消息。第一次对话可能需要配对按提示在框里回复即可。验证动作建议用一条能明确看到执行结果的指令比如帮我在当前目录创建一个 hello-openclaw.txt内容写 feishu to openclaw ok如果链路通了机器人会回复执行结果同时你本地目录里会出现这个文件。这一步同时验证了三件事飞书长连接收到消息、OpenClaw 网关把消息转给 Agent、Agent 通过 TaoToken 调模型并执行了文件写入。想单独验证模型通道可以在 OpenClaw 里发一条纯对话指令用一句话说明你现在用的是哪个模型返回内容里会带上模型标识。如果这里报 401说明 TaoToken Key 有问题报 404多半是 base_url 写错报超时检查本机到taotoken.net的网络。飞书侧没反应但 OpenClaw 日志有记录那就是事件订阅或权限没配对。6. 本篇常见错排查长连接保存失败九成是网关没启动或 Feishu 渠道没加。先openclaw gateway status确认 running再openclaw channels add feishu然后回飞书页面重新保存。机器人不回消息检查应用是否已发布、机器人能力是否开启、事件im.message.receive_v1是否订阅。三者缺一不可。另外群聊里要 机器人才触发私聊直接发即可。401 UnauthorizedTaoToken Key 复制不全或已失效。回控制台重新生成一个注意sk-前缀别丢。如果用了环境变量确认 shell 里echo $TAOTOKEN_API_KEY有值且 OpenClaw 进程能读到。404 Not Foundbase_url多写了/v1。正确值是https://taotoken.net/api不带版本号。model not found配置里的模型名不在 TaoToken 支持列表里。去模型对话页确认可用名改成一致的。改了配置不生效OpenClaw 不会热加载所有配置改完openclaw gateway restart。飞书侧改了权限或事件也要重新发布版本。首次对话很慢正常现象Agent 在初始化上下文和加载插件。第二次开始就快了。排障时优先看 OpenClaw 网关日志飞书侧的问题基本都能在日志里看到原始错误码。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 base_url 和鉴权的完整说明配之前扫一眼能少踩坑。如果你打算长期把 OpenClaw 当编码或 Agent 用频繁调模型可以看下 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 统一 Key 配合套餐在持续调用场景下更省心。整条链路跑通后你其实就得到了一个「飞书即终端」的本地 Agent 入口后面加什么能力都只是往 OpenClaw 里加插件的事。