1. win10/11 下 OpenClaw 龙虾接入飞书与千问的完整安装链路如果你在 win10 或 win11 上折腾过 OpenClaw龙虾大概率会遇到一个很烦的问题飞书要一套 App ID/Secret千问要一套 OAuth 或 API KeyOpenClaw 自己还要一份模型配置。三套凭证散落在不同文件里改一个忘一个最后机器人不回消息你也不知道是飞书回调没通还是千问模型没鉴权成功。这篇教程就是来解决这个问题的。我会带你在 win10/11 上把 OpenClaw龙虾装好接入飞书机器人再通过 TaoToken 的统一 Key 把千问模型调用接进来最后用一条真实消息做联调验证。适合谁手里有一台 Windows 电脑、想让飞书里发消息就能驱动 OpenClaw 干活、又不想被多套 Key 搞晕的人。核心检索词先摆出来win10/11 OpenClaw 安装教程、飞书机器人回调配置、千问模型调用、TaoToken 统一 Key。这几个词会贯穿全文你照着做就能一次跑通安装与鉴权。先说清楚整体链路避免你装到一半迷路。OpenClaw 本体跑在 Windows 上通过 WebSocket 长连接和飞书开发者后台通信飞书那边负责把用户消息推给 OpenClawOpenClaw 收到消息后调用千问模型生成回复再通过飞书发回去。这里面有两个鉴权点飞书用 App ID App Secret千问用模型通道的 Key。传统做法是千问直连Key 写在 OpenClaw 配置里我这次用 TaoToken 做统一通道把模型 Key 收敛到一处config.toml 和 settings.json 里只留一个 Base URL 和一个 Key后面换模型、加工具都不用再翻飞书后台。安装前的几个提醒都是踩过的坑。第一全程用管理员方式打开 PowerShell普通权限装到一半会报脚本被禁止运行。第二安装过程会改执行策略建议先把 360 这类安全软件退出否则 openclaw 的命令行工具可能被拦截表现为命令没反应。第三电脑上别放重要资料OpenClaw 会自己写代码自己跑稳妥起见用虚拟机也行。第四网络尽量用网线长连接对稳定性有要求Wi-Fi 抖动会导致飞书那边显示连接断开。环境准备这块win10 建议 22H2 以上win11 任意版本都行。需要装的东西nvm用来管 Node 版本、git、python、Node.js 24。nvm 装到 D:/soft/nvmgit 装到 D:/soft/gitpython 装到 D:/soft/python安装时勾选 Add to PATH。装完关掉当前 PowerShell重新用管理员开一个输入 exit 能退出就说明环境变量生效了。Node 用 nvm 装最省事nvm install 24 nvm use 24.14.0 node -v npm -v如果 npm -v 报「无法加载文件 npm.ps1因为在此系统上禁止运行脚本」别慌这是执行策略问题逐行执行下面四条每行选 Y 回车Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser set-executionpolicy remotesigned Set-ExecutionPolicy RemoteSigned -Scope CurrentUser Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后重开 PowerShellnpm -v 就能出版本号了。接着装 pnpmnpm install -g pnpm pnpm -vpnpm 装的时候如果卡住不动按一下回车别连按等两分钟基本就 added 完了。到这里基础环境就齐了。下一节进入 OpenClaw 本体安装和 TaoToken 前置配置这是整条链路里最容易出问题的地方我会把每一步的命令和预期输出都写清楚。2. TaoToken 前置配置与 OpenClaw 安装统一 Key 解决多工具鉴权分散OpenClaw 装完之后默认会让你选模型提供方。如果你选千问直连就要走一遍 Qwen OAuth授权链接、user_code、回调一套下来能通但问题是飞书插件、后续可能加的其它工具各自还要配 Key时间一长你自己都记不清哪个 Key 对应哪个服务。我这次的做法是先用 TaoToken 把模型通道统一起来OpenClaw 里只认一个 Base URL 和一个 Key。TaoToken 在这里的角色是统一 API 通道。你可以在它的控制台里创建 Key然后所有需要模型能力的工具都指向同一个地址。对 OpenClaw 来说它不关心背后是千问还是别的模型只要 Base URL 和 Key 对就能正常发请求。这样飞书那套 App ID/Secret 归飞书模型这套归 TaoToken职责清晰排障也快。先拿 Key。打开 TaoToken 控制台路径是 console登录后在 API Keys 页面创建一个新 Key复制出来存好后面 config.toml 和 settings.json 都要用。控制台地址我放在这里你直接进https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建 Key 的时候注意两点一是权限范围选模型调用相关别开多余的二是复制后立刻保存页面刷新就看不到了。如果你还没决定用哪个模型可以先在模型对话页面试一下千问的响应确认通道通了再往下走https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接下来装 OpenClaw。官方一键脚本有时候会报 -app 相关的错误我实测下来用 npm 指定参数更稳npm install -g openclawlatest --omitoptional --ignore-scripts等两分钟看到 added 673 packages 就是成功了。然后装 clawhubnpm i -g clawhub如果这条不行换 pnpm add -g clawhub再不行用 npm install clawhub。装完执行初始化openclaw onboard --install-daemon交互式向导里几个关键选择我列一下你照着选提示项选择个人使用确认YesOnboarding modeQuickStartModel/auth providerQwen 千问Default modelqwen-portal/vision-modelSelect channelFeishu/Lark (飞书)Install Feishu pluginDownload from npm (openclaw/feishu)Feishu connection modeWebSocket (default)Which Feishu domainFeishu (feishu.cn) - ChinaGroup chat policyOpen - respond in all groupsSearch providerSkip for nowConfigure skills nowNoEnable hooksSkip for now选到 Qwen 的时候会弹 OAuth 授权链接复制到浏览器打开登录授权后回到 PowerShell 继续。这一步如果你已经用 TaoToken 统一了通道其实可以跳过 OAuth直接在后面的 config.toml 里写 TaoToken 的 Base URL 和 Key。两种方式都行我建议先用 OAuth 把向导走完确保 OpenClaw 本体能跑再改配置指向 TaoToken这样出问题好定位。飞书插件安装那步向导默认给的是本地路径 D:\soft\nvm\v24.14.0\node_modules\openclaw\extensions\feishu这个路径容易出问题一定选 Download from npm (openclaw/feishu)。装的时候如果卡住按一下回车别连按。向导走完OpenClaw 就装好了。接下来是配置文件的活儿。OpenClaw 的配置分两块config.toml 管模型通道和网关settings.json 管飞书通道和插件参数。下面给你可复制的骨架路径按你实际安装位置调整。config.toml 骨架[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model_id qwen-portal/vision-model [gateway] port 18789 verbose true [daemon] enabled truesettings.json 骨架{ feishu: { app_id: cli_你的AppID, app_secret: 你的AppSecret, connection_mode: websocket, domain: feishu.cn, group_policy: open }, plugins: { feishu: { source: npm, package: openclaw/feishu } } }注意 config.toml 里的 base_url 用 https://taotoken.net/api不要加 UTM 参数那是给网页链接用的。api_key 填你刚才在控制台创建的那串。model_id 先填 qwen-portal/vision-model后面想换模型只改这一行。这两份配置写完OpenClaw 的模型通道和飞书通道就都指向了统一入口。下一节讲飞书开发者后台的具体配置和回调联调这是整条链路里最需要耐心的部分。3. 飞书机器人回调配置open.feishu.cn 后台权限与事件订阅实操飞书这边的配置全在 open.feishu.cn 开发者后台完成。先用手机号注册登录飞书然后进开发者后台创建企业自建应用。应用名称填 OpenClaw助手描述随便写背景色选你喜欢的创建。创建完进入应用详情左侧菜单按顺序配第一步添加应用能力。左侧「添加应用能力」→ 机器人 → 添加。添加后机器人能力就开通了。第二步权限管理。左侧「权限管理」→ 开通权限。先配应用身份权限 tenant_access_token搜索「消息」全选添加权限再搜「获取通讯录基本信息」添加。然后切到用户身份权限 user_access_token搜索「获取消息」全选添加权限。这几组权限是机器人收发消息的基础少一个后面回调就会报权限不足。第三步事件与回调。左侧「事件与回调」→ 事件配置 → 订阅方式 → 编辑 → 直接保存。这一步先保存后面长连接建立后再回来加事件。第四步拿凭证。左侧「凭证与基础信息」这里能看到 App IDcli_ 开头和 App Secret。把这两个值填到上面 settings.json 的对应位置。App Secret 后面有个眼睛图标点开才能看到完整内容。第五步装 lark-oapi 并跑长连接脚本。这一步是为了让飞书后台检测到你的应用已经建立长连接否则事件订阅保存不了。先装库pip install lark-oapi -U如果提示 python.exe -m pip install --upgrade pip可以执行执行完继续。中断了就 pip uninstall lark-oapi 重来。然后新建一个脚本文件比如 C:\a.txt内容如下把 YOUR_APP_ID 和 YOUR_APP_SECRET 替换成你自己的import lark_oapi as lark def do_p2_im_message_receive_v1(data: lark.im.v1.P2ImMessageReceiveV1) - None: print(f[ do_p2_im_message_receive_v1 access ], data: {lark.JSON.marshal(data, indent4)}) def do_message_event(data: lark.CustomizedEvent) - None: print(f[ do_customized_event access ], type: message, data: {lark.JSON.marshal(data, indent4)}) event_handler lark.EventDispatcherHandler.builder(, ) \ .register_p2_im_message_receive_v1(do_p2_im_message_receive_v1) \ .register_p1_customized_event(这里填入你要自定义订阅的 event 的 key例如 out_approval, do_message_event) \ .build() def main(): cli lark.ws.Client(YOUR_APP_ID, YOUR_APP_SECRET, event_handlerevent_handler, log_levellark.LogLevel.DEBUG) cli.start() if __name__ __main__: main()替换完保存新开一个 PowerShell 执行python c:/a.txt看到长连接建立成功的日志后回到飞书后台「事件与回调」→ 事件配置 → 订阅方式 → 编辑 → 直接保存。这时候「添加事件」按钮会变蓝说明保存成功。点击添加事件搜索「接收消息」把下面三个都加上读取用户发给机器人的单聊消息接收群聊中机器人消息事件获取群组中所有消息敏感权限加完检查一遍三个都显示「已开通」。第六步发布版本。左侧「版本管理与发布」→ 创建版本 → 版本号填 1.0.0更新说明填 openclaw → 保存 → 发布。发布完回到跑 python c:/a.txt 的那个窗口按 CtrlC 停掉出现盘符就行报错不用管。到这里飞书后台配置完成。但机器人还不能用因为 OpenClaw 那边还没批准配对。你在飞书里给机器人发一条消息会收到类似这样的回复OpenClaw: access not configured. Your Feishu user id: ou_82171bb8b13ca090bf81a16b02f1f777 Pairing code: PMHRTLWA Ask the bot owner to approve with: openclaw pairing approve feishu PMHRTLWA复制那行 openclaw pairing approve feishu 命令在管理员 PowerShell 里执行把配对码换成你自己的openclaw pairing approve feishu PMHRTLWA执行完再给机器人发消息这次就应该能收到 OpenClaw 的回复了。如果没回看下一节的排障。4. 联调验证飞书发消息触发千问模型调用的完整请求链路配置都写完了现在做一次端到端验证确认飞书消息能触发 OpenClawOpenClaw 能通过 TaoToken 调千问千问的回复能回到飞书。先确认 OpenClaw 网关在跑。管理员 PowerShell 执行openclaw gateway --port 18789 --verbose看到网关启动日志端口 18789 监听成功。这个窗口别关后面看请求日志就靠它。然后确认飞书长连接。在飞书里给 OpenClaw助手 发一条「你好」观察两个地方一是 OpenClaw 网关窗口有没有收到消息事件日志二是飞书里有没有回复。如果网关窗口打印了类似 do_p2_im_message_receive_v1 access 的日志说明飞书消息已经推到 OpenClaw 了。接着看有没有模型调用的日志正常会显示向 https://taotoken.net/api 发请求返回 choices 字段。如果这一步报 401说明 TaoToken 的 Key 不对或者没生效检查 config.toml 里的 api_key。验证千问模型调用是否走通可以单独发一条需要模型推理的消息比如「帮我写一个 Python 快速排序」。OpenClaw 会把这条消息转给千问千问返回代码OpenClaw 再通过飞书发回给你。整个过程在网关 verbose 日志里能看到完整的请求和响应。如果你想更直接地验证 TaoToken 通道可以在模型对话页面手动发一条同样的请求对比返回结果。模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content联调成功的标志有三个飞书里收到机器人回复、网关日志里有 200 响应、回复内容确实是千问生成的不是报错信息。三个都满足说明 win10/11 OpenClaw 安装、飞书回调、千问模型调用这条链路全通了。如果你打算长期用 OpenClaw 做编码或 Agent 任务可以考虑 Coding Plan把模型调用额度固定下来避免临时 Key 过期导致机器人突然不回消息https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content联调过程中如果遇到问题下一节列了几个真实报错和排查方法。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 失败这一节按报错原文对照排查都是我实际遇到过的。401 Unauthorized。出现在网关日志里说明模型通道鉴权失败。检查三处config.toml 的 api_key 是不是 TaoToken 控制台创建的那串、base_url 是不是 https://taotoken.net/api不要带 UTM、Key 有没有过期或被删。改完配置后重启网关openclaw gateway --port 18789 --verboselocal proxy failed。这个通常是网络层问题OpenClaw 连不上模型通道。先确认电脑能正常访问外网再确认没有安全软件拦截 openclaw 进程。如果用了公司网络可能有出口限制换手机热点试一下。注意不要用任何网络代理工具这类工具本身也会导致长连接不稳定。reading choices 报错。日志里出现 reading choices 或 cannot read property choices说明模型返回的 JSON 结构不符合预期。常见原因是 model_id 填错了比如填了一个 TaoToken 通道不支持的模型名。回到 config.toml把 model_id 改成 qwen-portal/vision-model 再试。如果还不行在模型对话页面确认这个模型能正常返回。OAuth 授权失败。向导里选 Qwen 会弹授权链接如果浏览器打开后一直转圈或者提示 code 无效多半是 user_code 过期了。重新跑 openclaw onboard会生成新的 code。如果你已经决定用 TaoToken 统一通道可以直接跳过 OAuth在 config.toml 里写 TaoToken 的配置效果一样。飞书消息发了没反应。先看网关日志有没有收到事件。没有的话检查飞书后台事件订阅是否保存成功、三个事件是否都添加了、版本是否已发布。有事件但没回复检查配对是否批准执行 openclaw pairing approve feishu 配对码。配对码在机器人回复里。npm 报脚本禁止运行。回到第 1 节的执行策略四条命令逐行执行选 Y然后重开 PowerShell。飞书插件安装卡住。向导里选 Download from npm如果卡住按一下回车别连按。装完确认 node_modules 下有 openclaw/feishu 目录。网关端口被占用。18789 被别的程序占了换一个端口openclaw gateway --port 18790 --verbose同时把 settings.json 里如果有端口配置也改掉。排查的核心思路是分层先确认 OpenClaw 本体能跑再确认模型通道能通最后确认飞书回调能到。哪一层断了就修哪一层别一次改多个地方。6. 把 Key 收敛到一处TaoToken 统一通道的长期用法装完这一套你手里其实有三套凭证飞书 App ID/Secret、TaoToken Key、OpenClaw 自己的配置。飞书那套是平台强制的改不了能收敛的就是模型这套。TaoToken 的价值在于不管你后面加多少个工具、换多少个模型Base URL 和 Key 都不用变只改 model_id 就行。具体做法所有需要模型能力的工具config.toml、settings.json、Cline MCP 配置、Codex auth.json全部指向 https://taotoken.net/api 和同一个 Key。这样你排障的时候只需要确认一件事这个 Key 还有效吗。有效问题就在工具侧无效去控制台续期或重建。API Keys 管理入口https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在这里遇到配置字段不确定的时候查一下https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content如果你用 Claude Code 做编码Anthropic 兼容通道的配置也在文档里Base URL 和 Key 的填法跟 OpenClaw 一致https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后说一个实用技巧把 config.toml 和 settings.json 备份一份到 U 盘或云盘。OpenClaw 升级或者重装的时候直接覆盖回去省得重新走一遍向导。飞书的 App ID/Secret 也记在密码管理器里别只存在浏览器。这样下次换电脑或者重装系统十分钟就能把整条链路恢复起来。