openclaw onboard 加飞书渠道模型凭证那步 Base URL 填 TaoTokenopenclaw onboard的安装向导本身不算难走飞书开放平台建企业自建应用、复制 App IDcli_开头那串、复制 App Secret、权限管理里批量导入 scopes JSON、应用能力里开启机器人、openclaw channels add添加 Feishu 渠道、openclaw gateway status确认网关已经起来再回开放平台把事件订阅切成「使用长连接接收事件」并加上im.message.receive_v1——这些照着文档填基本不会出错。真正容易把人卡在半路的是向导中间那一步它开始问模型的 API 凭证Base URL 填什么、Key 从哪来原文流程里没有交代。这篇就把这段补上模型通道走 TaoToken先在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu 注册并创建 KeyBase URL 填https://taotoken.net/api飞书侧的 App ID、App Secret、权限 JSON、长连接订阅全部一个字不用动。1. openclaw onboard 走到模型凭证这步缺的是什么先把向导做的两件事拆开看后面就不容易混。第一件事是渠道接入把 openclaw 和飞书这个聊天入口接上。它要的是 App ID、App Secret、事件订阅方式解决的是「消息怎么进来、机器人怎么把话发出去」。飞书侧长连接建起来之后事件能推给本机 gateway渠道就算通了。第二件事是模型通道机器人收到消息之后由哪个模型服务来生成回复。这一步要的是 API Key、Base URL、模型 ID解决的是「回复内容由谁生成」。它跟飞书应用没有关系飞书不会给你模型额度TaoToken 也不会参与飞书应用创建、机器人能力开启、渠道添加和长连接这些动作。原文流程把第一件事写得很全第二件事留了个空。所以典型现象是向导一路 Next 到底openclaw gateway status显示网关正常飞书那边事件订阅也保存成功了但在飞书私聊里给机器人发消息要么半天不回要么日志里直接抛认证失败。这时候不用回去重做飞书应用缺的就是模型凭证这一格。这篇适用的场景也比较明确企业自建应用、gateway 跑在自己机器上、先用私聊把机器人跑通再考虑群聊和发布。Lark 国际版把开放平台换成open.larksuite.com/app配置里补domain: lark即可其余步骤同构。2. 飞书侧照原流程填App ID、Secret、权限与长连接一处不改这一段是原文的核心接入 TaoToken 之后它完全不变这里只把顺序和容易踩的点重新捋一遍。在飞书开放平台用飞书账号登录创建企业自建应用填名称、描述、图标。创建完成后进「凭证与基础信息」页面复制两样东西App ID格式是cli_xxxApp Secret。App Secret 只在这一页看得到别截图发群里后面填进 openclaw 之后就靠它做签名。权限管理页面点「批量导入」把原文给出的那份 scopes JSON 整段粘进去一键导入。注意是整份导入不要自己挑着勾缺一个im:message:send_as_bot或者im:message.p2p_msg:readonly之类的 scope后面表现就是消息能收到但回不出去排查起来很费时间。接着进「应用能力 机器人」开启机器人能力并配置机器人名称。这一步不做事件订阅页面里根本看不到消息类事件。然后是渠道和网关顺序很关键openclaw channels add openclaw gateway statusopenclaw channels add里把渠道选成 Feishu填入刚才复制的 App ID 与 App Secret。加完之后用openclaw gateway status确认网关处于运行状态。这里必须确认网关已经起来因为开放平台的事件订阅页面会做校验。回到开放平台的「事件订阅」页面接收方式选「使用长连接接收事件」WebSocket 模式然后添加事件im.message.receive_v1接收消息。如果前面网关没起或者渠道没加这一步保存会直接失败——这不是权限问题是顺序问题。最后是版本管理与发布创建版本、提交审核、发布等待管理员审批。企业自建应用一般会自动通过。到这里飞书侧就绪机器人已经能被找到、能收到私聊只是它还不知道该找谁生成回复。3. 模型凭证这一步先拿 TaoToken 的 Key 和 Base URL轮到向导里的模型/API 凭证配置时不要在这里停住按下面两步拿到两个值。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu 注册账号进控制台创建一个 API Key形如YOUR_API_KEY创建后立刻复制保存页面刷新之后通常不再完整显示。同时到模型广场挑一个你要用的模型把它的模型 ID 原样复制下来——模型 ID 必须以模型广场当前展示为准不要凭记忆手写。第二个值是 Base URL固定填https://taotoken.net/api两个细节要强调末尾不要加/v1也不要图省事把带 UTM 参数的官网地址粘进来当 Base URL。UTM 是给页面统计用的带进配置里只会让请求路径拼错。4. 把 Base URL 和 Key 写进 openclaw 的模型配置如果向导正停在模型凭证这一步直接按提示填Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEY模型 ID 填刚从模型广场复制的那串。填完继续往下走。如果向导已经跑完、需要事后补填或修改就改 openclaw 的模型配置文件。常见位置在用户目录下的.openclaw目录里具体文件名和字段名以你本机安装版本为准可以先看一下openclaw --help或者安装目录里的示例配置。结构大致是这样一份 JSON{ models: { default: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY, model: 从模型广场复制的模型ID } } }关键只有三行base_url是https://taotoken.net/apiapi_key是YOUR_API_KEYmodel是模型广场上的真实 ID。provider这一项按你的版本填兼容协议名称即可。改完配置文件必须重启网关让新配置生效openclaw gateway restart openclaw gateway status只改文件不重启是后面所有 401 里最常见的一种——配置文件明明是对的进程里还是旧值。5. 验证先飞书私聊发一条再回原文流程做配对这里建议把验证拆成两半先确认模型通道通再走配对不要一上来就折腾发布。第一步在飞书里找到刚发布的机器人私聊发一条最简单的消息比如「你好」。观察两处飞书里有没有回复以及 openclaw 的网关日志里有没有出现上游请求。如果回复正常返回、日志里没有认证错误说明 Base URL 和 Key 这一格已经填对了。第二步机器人默认会回复一个配对码。回到终端执行openclaw pairing list openclaw pairing approve feishu 配对码把配对码换成实际收到的那串批准之后私聊会话才算正式绑定。这一步是 openclaw 自己的配对机制跟 TaoToken 无关Key 只是让模型通道能出话。配对完成之后再按原文继续做事件订阅的收尾和版本发布。如果这个阶段你想单独试一下模型 ID 是否可用、请求是否通可以用模型对话页面直接发一条请求比在飞书里来回试快得多。6. 常见错误与排查只列接入这一段真正会遇到的几种。飞书私聊有反应但报 401 / Unauthorized。先查 Key 是不是复制时带了首尾空格或换行这是最高频的原因。再确认配置文件改完之后是否重启过 gateway。最后确认你填进模型凭证那一格的确实是 TaoToken 控制台创建的 Key而不是把飞书的 App Secret 填错了位置——这两个值格式差别很大App Secret 通常是cli_无关的随机串App ID 才是cli_开头填串了必然认证失败。提示路径不存在、404 或者模型找不到。大概率是 Base URL 写成了https://taotoken.net/api/v1或者把带 UTM 参数的完整官网链接粘了进去。把 Base URL 改回https://taotoken.net/api末尾不加/v1不带查询参数。另一种情况是模型 ID 手写错了回到模型广场重新复制一次。开放平台里长连接保存失败。这不是模型凭证的问题是执行顺序的问题必须先openclaw channels add把 Feishu 渠道加上并且openclaw gateway status显示网关在跑再回开放平台选长连接。顺序反过来保存按钮会直接报错。网关状态正常但机器人完全没反应。检查事件订阅里有没有加上im.message.receive_v1以及应用版本是否已经发布。自建应用在审核通过前事件不会实际推送。能收到消息但没有回复、日志里也没有上游请求。这种是模型通道没走到回到第 4 节检查配置文件里的base_url、api_key、model三项改完重启网关再看日志。收到消息但拿不到配对码。确认私聊的是已经发布的应用对应机器人且消息发送者和应用在同一个企业内。配对相关命令是openclaw pairing list和openclaw pairing approve feishu 配对码跟模型 Key 没有依赖关系。7. 接下来怎么走把上面这套跑通之后你手上应该有两样东西飞书侧的 App ID / App Secret 和已经加好的 Feishu 渠道以及一份可用的模型凭证。前者继续按原文流程管理后者需要单独维护——Key 要轮换、要分环境、要看用量这些都在控制台里做。建议现在就去 API Keys 页面把刚创建的 Key 备注清楚比如标记为openclaw-feishu方便以后区分是哪个机器人实例在调用https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu如果你在别的机器或别的客户端上也想接同一套模型通道接口字段是完全一致的可以直接参照 Claude Code 接入文档里的配置写法迁移https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu等飞书这边的私聊、群聊都稳定了再考虑把 Agent 类的长任务挂上去那种场景对并发和用量更敏感可以提前看一下 Coding Plan 的说明https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu openclaw onboard 加飞书渠道，模型凭证那步 Base URL 填 TaoToken
openclaw onboard 加飞书渠道模型凭证那步 Base URL 填 TaoTokenopenclaw onboard的安装向导本身不算难走飞书开放平台建企业自建应用、复制 App IDcli_开头那串、复制 App Secret、权限管理里批量导入 scopes JSON、应用能力里开启机器人、openclaw channels add添加 Feishu 渠道、openclaw gateway status确认网关已经起来再回开放平台把事件订阅切成「使用长连接接收事件」并加上im.message.receive_v1——这些照着文档填基本不会出错。真正容易把人卡在半路的是向导中间那一步它开始问模型的 API 凭证Base URL 填什么、Key 从哪来原文流程里没有交代。这篇就把这段补上模型通道走 TaoToken先在官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu 注册并创建 KeyBase URL 填https://taotoken.net/api飞书侧的 App ID、App Secret、权限 JSON、长连接订阅全部一个字不用动。1. openclaw onboard 走到模型凭证这步缺的是什么先把向导做的两件事拆开看后面就不容易混。第一件事是渠道接入把 openclaw 和飞书这个聊天入口接上。它要的是 App ID、App Secret、事件订阅方式解决的是「消息怎么进来、机器人怎么把话发出去」。飞书侧长连接建起来之后事件能推给本机 gateway渠道就算通了。第二件事是模型通道机器人收到消息之后由哪个模型服务来生成回复。这一步要的是 API Key、Base URL、模型 ID解决的是「回复内容由谁生成」。它跟飞书应用没有关系飞书不会给你模型额度TaoToken 也不会参与飞书应用创建、机器人能力开启、渠道添加和长连接这些动作。原文流程把第一件事写得很全第二件事留了个空。所以典型现象是向导一路 Next 到底openclaw gateway status显示网关正常飞书那边事件订阅也保存成功了但在飞书私聊里给机器人发消息要么半天不回要么日志里直接抛认证失败。这时候不用回去重做飞书应用缺的就是模型凭证这一格。这篇适用的场景也比较明确企业自建应用、gateway 跑在自己机器上、先用私聊把机器人跑通再考虑群聊和发布。Lark 国际版把开放平台换成open.larksuite.com/app配置里补domain: lark即可其余步骤同构。2. 飞书侧照原流程填App ID、Secret、权限与长连接一处不改这一段是原文的核心接入 TaoToken 之后它完全不变这里只把顺序和容易踩的点重新捋一遍。在飞书开放平台用飞书账号登录创建企业自建应用填名称、描述、图标。创建完成后进「凭证与基础信息」页面复制两样东西App ID格式是cli_xxxApp Secret。App Secret 只在这一页看得到别截图发群里后面填进 openclaw 之后就靠它做签名。权限管理页面点「批量导入」把原文给出的那份 scopes JSON 整段粘进去一键导入。注意是整份导入不要自己挑着勾缺一个im:message:send_as_bot或者im:message.p2p_msg:readonly之类的 scope后面表现就是消息能收到但回不出去排查起来很费时间。接着进「应用能力 机器人」开启机器人能力并配置机器人名称。这一步不做事件订阅页面里根本看不到消息类事件。然后是渠道和网关顺序很关键openclaw channels add openclaw gateway statusopenclaw channels add里把渠道选成 Feishu填入刚才复制的 App ID 与 App Secret。加完之后用openclaw gateway status确认网关处于运行状态。这里必须确认网关已经起来因为开放平台的事件订阅页面会做校验。回到开放平台的「事件订阅」页面接收方式选「使用长连接接收事件」WebSocket 模式然后添加事件im.message.receive_v1接收消息。如果前面网关没起或者渠道没加这一步保存会直接失败——这不是权限问题是顺序问题。最后是版本管理与发布创建版本、提交审核、发布等待管理员审批。企业自建应用一般会自动通过。到这里飞书侧就绪机器人已经能被找到、能收到私聊只是它还不知道该找谁生成回复。3. 模型凭证这一步先拿 TaoToken 的 Key 和 Base URL轮到向导里的模型/API 凭证配置时不要在这里停住按下面两步拿到两个值。打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu 注册账号进控制台创建一个 API Key形如YOUR_API_KEY创建后立刻复制保存页面刷新之后通常不再完整显示。同时到模型广场挑一个你要用的模型把它的模型 ID 原样复制下来——模型 ID 必须以模型广场当前展示为准不要凭记忆手写。第二个值是 Base URL固定填https://taotoken.net/api两个细节要强调末尾不要加/v1也不要图省事把带 UTM 参数的官网地址粘进来当 Base URL。UTM 是给页面统计用的带进配置里只会让请求路径拼错。4. 把 Base URL 和 Key 写进 openclaw 的模型配置如果向导正停在模型凭证这一步直接按提示填Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEY模型 ID 填刚从模型广场复制的那串。填完继续往下走。如果向导已经跑完、需要事后补填或修改就改 openclaw 的模型配置文件。常见位置在用户目录下的.openclaw目录里具体文件名和字段名以你本机安装版本为准可以先看一下openclaw --help或者安装目录里的示例配置。结构大致是这样一份 JSON{ models: { default: { provider: openai-compatible, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY, model: 从模型广场复制的模型ID } } }关键只有三行base_url是https://taotoken.net/apiapi_key是YOUR_API_KEYmodel是模型广场上的真实 ID。provider这一项按你的版本填兼容协议名称即可。改完配置文件必须重启网关让新配置生效openclaw gateway restart openclaw gateway status只改文件不重启是后面所有 401 里最常见的一种——配置文件明明是对的进程里还是旧值。5. 验证先飞书私聊发一条再回原文流程做配对这里建议把验证拆成两半先确认模型通道通再走配对不要一上来就折腾发布。第一步在飞书里找到刚发布的机器人私聊发一条最简单的消息比如「你好」。观察两处飞书里有没有回复以及 openclaw 的网关日志里有没有出现上游请求。如果回复正常返回、日志里没有认证错误说明 Base URL 和 Key 这一格已经填对了。第二步机器人默认会回复一个配对码。回到终端执行openclaw pairing list openclaw pairing approve feishu 配对码把配对码换成实际收到的那串批准之后私聊会话才算正式绑定。这一步是 openclaw 自己的配对机制跟 TaoToken 无关Key 只是让模型通道能出话。配对完成之后再按原文继续做事件订阅的收尾和版本发布。如果这个阶段你想单独试一下模型 ID 是否可用、请求是否通可以用模型对话页面直接发一条请求比在飞书里来回试快得多。6. 常见错误与排查只列接入这一段真正会遇到的几种。飞书私聊有反应但报 401 / Unauthorized。先查 Key 是不是复制时带了首尾空格或换行这是最高频的原因。再确认配置文件改完之后是否重启过 gateway。最后确认你填进模型凭证那一格的确实是 TaoToken 控制台创建的 Key而不是把飞书的 App Secret 填错了位置——这两个值格式差别很大App Secret 通常是cli_无关的随机串App ID 才是cli_开头填串了必然认证失败。提示路径不存在、404 或者模型找不到。大概率是 Base URL 写成了https://taotoken.net/api/v1或者把带 UTM 参数的完整官网链接粘了进去。把 Base URL 改回https://taotoken.net/api末尾不加/v1不带查询参数。另一种情况是模型 ID 手写错了回到模型广场重新复制一次。开放平台里长连接保存失败。这不是模型凭证的问题是执行顺序的问题必须先openclaw channels add把 Feishu 渠道加上并且openclaw gateway status显示网关在跑再回开放平台选长连接。顺序反过来保存按钮会直接报错。网关状态正常但机器人完全没反应。检查事件订阅里有没有加上im.message.receive_v1以及应用版本是否已经发布。自建应用在审核通过前事件不会实际推送。能收到消息但没有回复、日志里也没有上游请求。这种是模型通道没走到回到第 4 节检查配置文件里的base_url、api_key、model三项改完重启网关再看日志。收到消息但拿不到配对码。确认私聊的是已经发布的应用对应机器人且消息发送者和应用在同一个企业内。配对相关命令是openclaw pairing list和openclaw pairing approve feishu 配对码跟模型 Key 没有依赖关系。7. 接下来怎么走把上面这套跑通之后你手上应该有两样东西飞书侧的 App ID / App Secret 和已经加好的 Feishu 渠道以及一份可用的模型凭证。前者继续按原文流程管理后者需要单独维护——Key 要轮换、要分环境、要看用量这些都在控制台里做。建议现在就去 API Keys 页面把刚创建的 Key 备注清楚比如标记为openclaw-feishu方便以后区分是哪个机器人实例在调用https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu如果你在别的机器或别的客户端上也想接同一套模型通道接口字段是完全一致的可以直接参照 Claude Code 接入文档里的配置写法迁移https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu等飞书这边的私聊、群聊都稳定了再考虑把 Agent 类的长任务挂上去那种场景对并发和用量更敏感可以提前看一下 Coding Plan 的说明https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw-feishu