建议收藏，用到时照着做。 飞书后台的“保存”一直点不上？飞书官方文档亲自说了：先把 Qwen Code 跑起来，长连接在线才保存得上（附企业微信 4 步接法… · @swordBluesy · TwKit

@swordBluesy

建议收藏，用到时照着做。 飞书后台的“保存”一直点不上？飞书官方文档亲自说了：先把 Qwen Code 跑起来，长连接在线才保存得上（附企业微信 4 步接法） 这是通义千问 Qwen Code 官方文档 Channels（渠道）里的 Feishu (Lark) 和 WeCom（企业微信）两页（都标着 2026 年 10 月 22 日更新），我再对照了飞书开放平台和企业微信帮助中心的官方页面。先把结论放在前面，因为它反常识： Qwen Code 文档把“选长连接”写在配置之前，但飞书官方原话是：必须确保本地客户端启动正常，有长连接在线的情况下，才能保存成功。也就是说，照着顺序一路点下来，你会卡在保存这一步。正确顺序是先写配置、先启动，再回飞书后台保存。 另一个硬数字：同样是接聊天软件，飞书示例的私聊权限写的是 open（谁都能私聊），企业微信示例直接写 allowlist（只放名单里的人），官方还注明这是推荐的企业默认值。 先说清词。 渠道（Channel），是 Qwen Code 里“从别的软件跟它说话”的通道。你在飞书或企业微信里发一句话，电脑上的 Qwen Code 替你干活，再把结果发回来。 长连接（Long Connection，也叫 WebSocket），是你的电脑主动连到飞书或企业微信的一条常开通道。官方说用它不需要公网网址，也不需要服务器。 App ID 和 App Secret，是飞书应用的“账号和密码”；企业微信这边对应的叫 Bot ID 和 Secret。 一个真实例子（官方写的）：启动后在飞书里给机器人发一条消息，会先看到一个 OnIt 表情反应，然后出现一张实时刷新的互动卡片，卡片上还有 Stop 按钮可以中途叫停。 先把话说全： 飞书和企业微信都要求你有一个组织账号。海外读者能不能注册、要不要国内手机号，官方这几页没写，以注册页面为准。 飞书的长连接只支持企业自建应用，商店应用用不了。 飞书应用要创建版本并发布、审核通过后机器人才会工作。 企业微信这篇讲的是“智能机器人”。如果你手里是 Corp ID、Agent ID、Token、EncodingAESKey 那套自建应用凭证，官方说要用另一个 WeCom Callback 渠道，这篇不适用。 这是连载下一篇：上一篇讲了钉钉，这篇把飞书和企业微信一次讲完。 一、飞书第一步：建应用、开机器人 打开飞书开发者后台 http://open.feishu.cn/app，创建一个企业自建应用（或用已有的）。在“应用能力”里点“添加应用能力”，加上“机器人”。 二、飞书第二步：开 3 个权限 进“开发配置”下的“权限管理”，在 API 权限里开通 Qwen Code 要的三个：im:message（读和发消息），im:message:send_as_bot（以机器人身份发消息），im:resource（读图片和文件）。 想让联系人显示名字而不是一串 ID，可以再开两个可选权限：contact:user.basic_profile:readonly 和 im:chat:readonly。不开也能正常收发。 三、飞书第三步：记下 App ID 和 App Secret 在“基础信息”下的“凭证与基础信息”页面，能看到 App ID 和 App Secret，抄下来。 四、飞书第四步：写配置 打开你电脑上的 Qwen Code 设置文件 .qwen/settings.json（在用户主目录下），加一个渠道。官方示例结构：最外层 channels，里面起个名字 my-feishu，下面写 type 填 feishu，clientId 填 App ID，clientSecret 填 App Secret，privatePolicy 示例是 open，sessionScope 填 user，cwd 填你的项目目录，groupPolicy 示例是 open，collapsible 填 true，groups 里用星号配 requireMention 为 true。 我的建议：privatePolicy 别照抄 open。Qwen 渠道总览页给的更稳写法是改成 allowlist，再加一行 allowedUsers 写你自己的用户 ID。 collapsible 是把长回复折叠起来，默认关，超过 500 字才折叠（collapsibleThreshold 可改）。 五、飞书第五步：先启动，再保存长连接 终端输入 qwen channel start my-feishu（想把所有渠道一起启动就只输 qwen channel start）。保持它开着。 然后回飞书后台，进“开发配置”下的“事件与回调”，在“事件配置”里编辑订阅方式，选“使用长连接接收事件”，点保存。飞书官方说必须有长连接在线才能保存成功，这就是很多人卡住的地方。 六、飞书第六步：加“接收消息”事件 同一页的“已添加事件”区域点“添加事件”，加上“接收消息（im.message.receive_v1）”。 七、飞书第七步：发布版本 进“应用发布”下的“版本管理与发布”，点“创建版本”，填好后申请发布。飞书官方提示：如果要管理员审核，建议建一个新企业专门测试，省掉审核等待。 看到什么算成功：在飞书里给机器人发消息，出现一张会实时刷新的互动卡片。 八、飞书进群和卡住怎么办 进群要三件事：groupPolicy 改成 allowlist、pairing 或 open（默认是 disabled，群里不回）；把机器人拉进群；群里要 @ 它。想让它回群里所有消息，给那个群设 requireMention 为 false。 连不上：查 App ID 和 Secret，查是否选了长连接，查是否订阅了 im.message.receive_v1，看终端报错。 卡片一直显示“生成中”：官方说一般是回复其实做完了，但最后一次卡片更新失败，看终端里有没有限流或卡片太大的报错，表格特别多的超长回复可能撞上飞书卡片元素上限。 还有一条飞书官方写的：长连接是集群模式，同一个应用开了多个客户端，只有随机一个能收到消息。所以同一个机器人别在两台电脑上同时启动。 九、企业微信第一步：建智能机器人，选 API 模式 企业微信帮助中心的官方步骤：打开企业微信客户端，进“工作台”里的“智能机器人”，点“创建机器人”再点“手动创建”。进去后选“API模式创建”。在 API 配置页把连接方式选成“使用长连接”。页面会自动生成 Bot ID 和 Secret，存好。再补一下“可见范围”，其他保持默认，直接保存。官方还说 API 模式暂不支持预览与调试，所以别在后台找测试按钮。 最后把机器人加到你想用它的私聊或群里。 十、企业微信第二步：凭证放进环境变量 终端输入两行：export WECOM_BOT_ID=你的BotID，export WECOM_SECRET=你的Secret。也可以写在 settings.json 的 env 段里，但那是明文。 十一、企业微信第三步：写配置 渠道名 my-wecom，type 填 wecom，botId 写 $WECOM_BOT_ID，secret 写 $WECOM_SECRET，privatePolicy 写 allowlist，allowedUsers 写允许的人（示例是 zhangsan），sessionScope 填 user，cwd 填项目目录，instructions 写一句设定，示例是“You are a concise coding assistant responding via WeCom.”，groupPolicy 示例是 open。 十二、企业微信第四步：启动 终端输入 qwen channel start my-wecom，然后在企业微信里给智能机器人发消息。 企业微信的三个坑 群里不用纠结 requireMention：官方说企业微信本来就只把 @ 机器人的群消息推过来，写 true 还是 false 效果一样，可以删掉。 群用 pairing 模式要小心：一个群批准之后，群里任何成员默认都能用它，私聊的 allowedUsers 管不到群成员。要收紧，就在那个群的设置里加 senders 为 allowlist 和 allowedUsers。 能收什么、能发什么：能收文字、带转写的语音、图片、文件、视频。它想发本机图片回来，要在回复里写 [IMAGE: 图片绝对路径]，而且图片必须在系统临时目录下的 channel-files 文件夹里，其他文件、视频、语音的上传标记一律忽略，官方说这是防止模型乱传你的工作区文件。 连不上就查三样：Bot ID 和 Secret 对不对，机器人是不是 API 模式建的，运行 qwen channel start 的那个终端里有没有这两个环境变量。 参考：Qwen Code 官方文档、飞书开放平台官方文档、企业微信帮助中心（S1哥 整理） 原文链接：https://qwenlm.github.io/qwen-code-docs/en/users/features/channels/feishu/ 和 https://qwenlm.github.io/qwen-code-docs/en/users/features/channels/wecom/ 原文：Qwen Code 官方文档（由 S1哥 整理） 收藏版：5 步速查 第一步，飞书建自建应用、加机器人能力；企业微信在工作台建智能机器人，选 API 模式和长连接。 第二步，飞书开 im:message、im:message:send_as_bot、im:resource 三个权限，抄 App ID 和 Secret；企业微信抄 Bot ID 和 Secret。 第三步，在 settings.json 加渠道，privatePolicy 一律写 allowlist 加 allowedUsers。 第四步，终端运行 qwen channel start 渠道名，保持开着。 第五步，飞书回后台保存长连接、加 im.message.receive_v1 事件、创建版本发布；发一条消息看到卡片就成功。 S1哥观点 这两页文档最狠的地方，是同一个工具，两个平台的示例安全级别不一样：企业微信官方直接给 allowlist，还写明这是企业推荐默认值；飞书示例却是 open。照抄的人，安全全靠运气。 真正的信号是：给 AI 接聊天软件，就像给家里装一个对讲门铃。装门铃五分钟，想清楚谁能按、按了能进到哪间屋，才是正事。 一句话：先启动再保存，先 allowlist 再开群，这两个顺序别反。身边还在对着飞书后台反复点保存的朋友，复制链接发给他。 你卡在第几步？同系列前几篇（Qwen Code 上手、Telegram、钉钉、群聊四层闸、定时盯梢）在我主页。 今天送：Qwen Code 接飞书和企业微信：配置模板与排错清单，评论区第一条直接拿。

曝光 13 · 评论 1 · 点赞 0 · 书签 0