连接器显示 connected。

绿的。一调接口，报 850004 aibot not api mode。

我一开始的反应跟大部分人一样——去翻配置，一项一项对。对完了，还是这个错。

后来才明白：这个错误码报的根本不是配置问题。它在告诉我，我对企微智能机器人的整套理解就是错的。

结论先给：API 模式是总闸，「可使用权限」授权决定闸内放哪些能力，企业规模档位决定你能勾的能力清单上限，再叠加「成员创建 vs 企业创建」的主体限制——四个东西同时成立，接口才通。

先推翻我自己写过的东西

以前我在内部文档里写过一个说法：接入方式分三档——API / MCP / 仅对话，开关藏在配置页最底部、三端同步。

这个说法跟企业微信官方文档不符。今天按官方 docid=21668 / 21672 / 21663 全部重写了。

官方口径其实只有两个概念：

• 机器人模式：普通模式 / API 模式
• 连接方式：长连接 / URL 回调

至于 MCP——它压根不是机器人上的一个模式选项。它是 API 模式机器人在完成「可使用权限」授权之后，以 streamableHTTP URL / JSON Config 形式暴露出来的接口形态。

一个是身份，一个是产物。把产物当成身份去配，当然配不通。

下面按三重关卡拆。这三关是串联的，任何一关不过，后面都白搭。

关卡① 机器人模式必须是「API 模式」

850004 的根因就是它。

入口：管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 创建机器人。已经建好的，在「智能机器人 → 详情 → 右上角编辑」里切。

创建时要选「API 模式创建」。

普通模式是什么？只用企微官方模型加知识集做问答，不开放任何接口。你在普通模式下怎么调都是这个错。两种模式可以随时互切，切过去就行。

API 模式下还要再选连接方式：

连接方式	要求	凭据
使用长连接（WebSocket，官方推荐）	不需要公网域名和回调地址	自动生成 Bot ID + Secret
URL 回调	需要自备已备案域名和回调服务	Token / EncodingAESKey

注意一条：长连接的 Secret 和 URL 回调的 Token / EncodingAESKey 不是同一套凭据。同一个机器人同一时刻只能保持一种连接方式，切换会让另一种失效。

补充几个数：v5.0 起手机端/电脑端「工作台 → 智能机器人」也能创建；成员创建权限默认全员开放，管理员可以在后台按部门/标签/成员收紧。单企业上限 300 个，单成员上限 20 个。

第一关过了，接口开了。但你会发现能勾的能力少得可怜。为什么？看第二关。

关卡② 能力授权 × 规模档位

入口：企微客户端「工作台 → 智能机器人 → 找到机器人 → 编辑 → 可使用权限」。

授权之后点「查看使用方式」，复制 streamableHTTP URL 或 JSON Config，配给你的 MCP Client。

关键在于：你能勾到什么，不完全由你决定，官方按企业规模分档（docid=21668）。

企业规模	API 模式智能机器人可用能力
≤10 人	消息、文档、日程、会议、待办、通讯录 全套
>10 人	仅文档 + 待办（待办 2026-07-02 起新增）；消息 / 会议 / 通讯录不开放

看到这张表，很多事就解释得通了——你在网上看到别人跑通了消息接口，你照着做却怎么都不行，很可能只是因为对方是个十人以内的小团队。

还有一个容易忽略的官方细节：≤10 人团队授权后，机器人以授权用户本人身份行事，而且限制仅创建者可对话，其他成员用不了。

第二关也过了，能力也勾上了，还有可能报错。因为还有第三关。

关卡③ 创建主体限制

这一关最容易被忽略，因为它跟”配置”完全无关。

「获取成员文档内容」这个能力，当前仅对成员创建的机器人开放，企业创建的机器人不支持。同一成员每天限取 20 篇。

这正好解释了我这边的实测现象：

旧的那个「企业创建」的机器人，怎么配都报错。换成成员创建的机器人（API 模式 + 完成授权）之后，立刻就通了。

配置一个字没改，换个创建主体就好了。这种坑，翻配置是永远翻不出来的。

顺带一提免审名单：管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 管理，可以把指定成员或企业根目录加入「获取数据访问权限无需审批」「扩大服务范围无需审批」。

那消息到底还发不发得出去？

发得出去。只是不走智能机器人这条路。

这里必须把话说准确：不是”企微不能发消息”，而是”企微 API 模式智能机器人的消息能力，对 >10 人企业未开放”。消息接口对所有企业都开放，只是要走别的通道。

通路	适用规模	内部群	对外	说明
自建应用消息 API（/message/send）	任意	✅	✅	corpid + corpsecret 换 access_token，按 userid / 部门 / 标签发。能力最强最可控，适合正式分发
群机器人 Webhook	任意	✅（指定群）	❌	群里加个机器人拿 webhook URL，POST 文本/markdown。最轻量，无需成员白名单
客服自建机器人	任意	❌	✅	只对外部微信客户，内部群不走它
桌面自动化（腾总走个人微信）	任意	✅	✅	绕开 API 规模限制，依赖本地客户端在线

我要的只是把会议纪要发给同事——那自建应用消息 API 或者群机器人 Webhook 都够用，绕开智能机器人这一整套关卡。

如果就是要走 WorkBuddy 这条线，最省事的路径是：连接器 → 添加「企业微信」→ 自动弹二维码 → 企微扫码 → 一键创建机器人并完成授权。全程不用手动复制任何配置。

官方文档三篇，建议直接看原文：

• docid=21668《如何通过 OpenClaw 使用企业微信接口能力》——规模分档、三种配置方式、免审设置
• docid=21672《支持 API 模式机器人创建、读取文档》——>10 人企业的文档能力、成员创建 vs 企业创建的差异
• docid=21663《如何使用智能机器人》——创建规则、数量上限、创建权限管理

可复用的一条经验

报错码指向的位置，未必是问题所在的位置。

850004 aibot not api mode 字面意思是”模式不对”，我照着字面去切模式，切完还是错——因为真正的约束分散在三个地方：模式、能力授权与规模档位、创建主体。错误码只报了最外面那一层。

所以遇到这类问题，我现在的第一动作不是查配置，是先去官方文档确认这个功能的完整约束条件有几条。今天推翻我自己写的”三档”说法，就是因为那份文档是我凭印象总结的，没有对着 docid 逐条核。

凭印象写的文档，比没有文档更贵。它会让你和之后所有看它的人，一起在错误的方向上使劲。