企业微信接入：把 AI 助手挂进工作群
💡 一句话总结：用 OpenClaw 建立住在企业微信里的 AI 同事 —— 装腾讯企微插件、配 Bot 模式进群、放行 wecom-cli 业务工具。
办公路线第一课。你在场景实战选了这条路，这一课就把 Claw 挂进真正的办公现场：企业微信的单聊和工作群。OpenClaw 企业微信接入靠的是 @wecom/wecom-openclaw-plugin 插件——由腾讯企业微信团队维护、列在 OpenClaw 官方渠道目录，单聊群聊、流式回复、待办日程会议这些企微业务操作都有原生支持。全部示例基于 OpenClaw v2026.10.9。
学完你能做什么
- 在企业微信单聊和群聊里向 AI 助手提问，收到带「思考中」占位的流式回复
- 让它直接操作企微的待办、日程、会议、在线文档、微盘、通讯录等 12 类业务对象
- 用群白名单 + 发送者白名单，控制谁能用、哪些群能进
- （进阶）配好 Agent 模式，让定时晨报按部门、标签、群主动推送
为什么用 OpenClaw，而不是网页版 AI？
| 能力 | 网页版 AI | OpenClaw + 企微插件 |
|---|---|---|
| 出现的位置 | ❌ 单独开网页，群里用不了 | ✅ 就在企微单聊/群聊里，说话就行 |
| 回复体验 | ❌ 等整段生成完才显示 | ✅ 流式回复 + 「思考中」占位（Bot 模式） |
| 企微业务操作 | ❌ 碰不到待办/日程/会议/微盘 | ✅ wecom-cli 覆盖邮件、文档、待办、日程、会议、微盘、通讯录 |
| 主动找你 | ❌ 只能你先问它 | ✅ 定时任务向用户/群/部门/标签主动推送 |
| 数据与模型 | ❌ 对话全在服务商手里 | ✅ Gateway 跑在自己机器上，模型随便换（含国产模型） |
你现在的困境
- 团队知识散在几十个群和文档里，问一句「上周会议定了什么」，没人答得全
- 日报、纪要、待办分派这些重复活，每天吃掉你一两个小时
- 公司内部数据不敢往公网 AI 网页里贴，但同事又确实需要个顺手的 AI
什么时候用这一招
当你需要：
- AI 助手直接出现在企业微信里，同事在聊天窗口里说一句就能用，不装新工具
- 它能顺手建待办、订日程、读会议纪要、搜文档
- 定时把晨报/日报推进群
而且不想：
- 每次切到浏览器，在网页版里复制粘贴
- 把公司对话托给第三方托管服务
- 自己从零写一套企微回调服务
🎒 开始前的准备
- 走完了 场景实战：选择你的路线：Gateway 正在运行、至少连上一个模型
openclaw --version显示 2026.3.28 以上（插件 README 的环境要求；本教程基准 v2026.10.9 满足）- 一个能在企业微信侧创建智能体机器人的账号——Bot ID 与 Secret 都从企业微信获取，入口见官方接入指引
- 一杯水 ☕——15 分钟后你的工作群里会多一位 AI 同事
跟我做
第 1 步：安装 OpenClaw 企业微信插件（wecom-openclaw-plugin）
为什么：企微渠道不在 OpenClaw 核心安装里，是外部插件；装好它，Gateway 才认识 wecom 这个渠道。
方式 A：企微官方 CLI 向导（推荐）——自动安装插件并完成配置，升级也用它：
npx -y @wecom/wecom-openclaw-cli install方式 B：OpenClaw 渠道目录安装——从官方 catalog 装固定版本：
openclaw channels add --channel wecom方式 C：手动装插件包：
openclaw plugins install @wecom/wecom-openclaw-plugin你应该看到：安装完成、无报错。方式 A 失败就加 --force 重试：npx -y @wecom/wecom-openclaw-cli install --force。
💡 版本配套要看一眼
插件 README 特别说明：OpenClaw 2026.3.22 及以上，插件要 2026.3.24 及以上；OpenClaw 2026.3.22 以下，插件保持 2026.3.20。本教程基准 v2026.10.9，直接装最新插件即可。
- 安装命令跑完无报错
第 2 步：创建企业微信机器人，拿到 Bot ID 与 Secret
为什么：Bot 模式（WebSocket）是最快跑通的方式，只要 botId + secret 两个凭据，不需要公网 URL、不碰回调。
操作：按企业微信官方指引创建智能体机器人，拿到 Bot ID 与 Secret：
凭据、连接模式、回调路由这些细节归插件管，以插件包文档（对应你装的版本）为准。
交互式配置（按提示输入 Bot ID 与 Secret）：
openclaw channels add你应该看到：向导提示输入机器人凭据，输入后配置写入。
第 3 步：配置 Bot 模式并重启 Gateway
为什么：WebSocket 是默认连接方式（connectionMode: "websocket"），长轮询自动保活重连，不用配任何回调。
openclaw config set channels.wecom.botId <YOUR_BOT_ID>
openclaw config set channels.wecom.secret <YOUR_BOT_SECRET>
openclaw config set channels.wecom.enabled true
openclaw gateway restart你应该看到：Gateway 重启无报错，openclaw channels status --channel wecom 显示 wecom 渠道在线。
openclaw channels status --channel wecom显示在线
第 4 步：在企微里说第一句话
为什么：端到端验证——凭据、连接、模型三段链路一次打通。
操作：在企微里找到你的机器人，单聊发一句「你好」；再把它拉进一个群里提问。
你应该看到：先出现「思考中」占位消息，随后回复流式更新（Bot 模式特性）；回复支持 Markdown 格式。发一段语音，它会自动转成文字再处理。
💡 这就是 OpenClaw 的独有价值
网页版 AI 进不了你的工作群；这只 Claw 住在群里，还原生带着语音转文字、引用消息、图文混排的处理能力——都是企微插件内置的，不用你写一行集成代码。
第 5 步：放行 wecom-cli 企微业务工具
为什么：插件内置 wecom-cli 工具与配套 Skills，覆盖 12 类企微业务；但默认工具策略不放行插件工具，要手动放行（tools.profile 为 full 时可跳过）。
openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]'
openclaw gateway restart⚠️ 别覆盖已有条目
若 tools.alsoAllow 里已有其他条目，把 wecom-openclaw-plugin 合并进现有数组，不要覆盖。
你应该看到：对它说「帮我建个明天上午 10 点的日程」，它调用 wecom-cli 完成，日程出现在你的企微日历里。
| wecom-cli 覆盖的业务 | 能做什么 |
|---|---|
| 待办 / 日程 / 会议 | 增删改查、分派参与人、读会议纪要与转写原文 |
| 在线文档 / 表格 / 智能表格 | 新建、导入、读改、追加、权限管理 |
| 邮件 / 微盘 / 通讯录 | 发信搜信、上传下载文件、按姓名搜成员 |
第 6 步：收紧访问控制再上线
为什么：默认 dmPolicy: "open"、groupPolicy: "open"——所有用户、所有群都能用。个人尝鲜没事，企业里先收紧。
在配置文件（openclaw.json）里改：
{
"channels": {
"wecom": {
"dmPolicy": "allowlist",
"allowFrom": ["user_id_1", "user_id_2"],
"groupPolicy": "allowlist",
"groupAllowFrom": ["group_id_1"],
"groups": {
"group_id_1": { "allowFrom": ["user_id_1", "user_id_2"] }
}
}
}
}改完执行 openclaw gateway restart。三层白名单各管一段：
allowFrom：单聊白名单（用户 ID）groupAllowFrom：群白名单（群 ID）groups.<群ID>.allowFrom：群内发送者白名单——没列出的成员，消息被静默忽略
你应该看到：白名单外的同事私聊或在群里说话，都不再得到回复。
💡 想更省心？
dmPolicy 还支持 pairing（配对码审批，审批命令 openclaw pairing list wecom、openclaw pairing approve wecom <CODE>）与 disabled。访问控制的完整体系见 安全加固（一）：访问控制与身份。
📋 魔法 Prompt
以下 Prompt 直接粘贴到企微聊天窗口发给你的 AI 助手。
⏳ 每日晨报推进群
预期效果：AI 调用 Cron API 创建定时任务，每个工作日 9 点自动生成晨报并推送到目标会话——对话里创建，立即生效，无需重启。
创建一个定时任务：每个工作日早上 9 点向全公司发送每日简报。
简报要求：
- 汇总昨天的行业新闻，挑 5 条最重要的
- 每条一句话摘要，附原文链接
- 结尾列出今天团队日程里最重要的 3 件事⚠️ 定时投递的前置条件
定时投递走 Agent 出站通道：先按下方「进阶技巧」配好 Agent 模式，且服务器 IP 要在企微可信 IP 白名单内（IP 不固定就配 egressProxyUrl）。目标也可以换成群（group:wr123abc）、部门（party:5）、标签（tag:Ops）或个人（user:zhangsan）。
📝 会议纪要一键整理
预期效果：AI 通过 wecom-cli 读取会议纪要与转写原文，整理成结构化纪要发回当前会话。
## 角色
你是会议秘书，擅长把冗长的转写整理成能执行的纪要。
## 任务
读取【会议名称/时间】这场会议的转写原文，整理成会议纪要发到本群。
## 输入信息
### 必填项
- 会议：【会议名称或时间段】
### 选填项
- 重点议题：【需要重点关注的议题?】
## 输出规范
按「结论 / 待办 / 遗留问题」三段输出；待办用表格：事项 | 负责人 | 截止时间。
## 约束条件
- ✅ 每条待办指到具体的人
- ✅ 没定负责人的待办单独列出待认领
- ❌ 不要逐句复述转写内容
- ❌ 纪要整理成一条消息发出，不要在群里逐条刷屏✅ 会后待办落到企微
预期效果：AI 调用 wecom-cli 待办能力，把纪要里的待办逐条建成企微待办并分派参与人。
## 角色
你是项目助理，负责把会议结论落成可跟踪的待办。
## 任务
把上面纪要里的待办逐条创建成企业微信待办，并分派给对应负责人。
## 输入信息
### 必填项
- 待办来源：上面纪要中的待办清单
### 选填项
- 默认截止时间：【没有明确截止的待办统一用哪天?】
## 输出规范
全部创建完成后，在群里回一句汇总：共几条、分给了谁。
## 约束条件
- ✅ 截止时间用纪要里写的；没写的先问我
- ✅ 汇总只发一条消息，方便群里的人一眼看完
- ❌ 不要漏项，也不要自创纪要里没有的待办检查点 ✅
openclaw channels status --channel wecom显示企业微信渠道在线- 企微单聊发消息，先见「思考中」占位，再见流式回复
- 机器人进群后能回话；语音消息能被转文字处理
- 让它建一条日程或待办，wecom-cli 正常完成
dmPolicy/groupPolicy已从默认open收紧（或你明确决定保持开放）
踩坑提醒
❌ 插件版本与 OpenClaw 不匹配
现象：插件装了，渠道却连不上或行为异常。
原因：OpenClaw 2026.3.22 及以上配了老插件（2026.3.20）——插件 README 特别说明过这条兼容线。
正确做法：
# 升级插件到 2026.3.24 及以上
npx -y @wecom/wecom-openclaw-cli install --force❌ Agent 模式回调 URL 一点「保存」就校验失败
原因：企微后台点保存会立即发校验请求（带 echostr 的 GET）；Gateway 还没配好 token / encodingAESKey，解不了密，校验自然不过。
正确顺序：先把 channels.wecom.agent.* 五项配好并 openclaw gateway restart，再回企微后台保存回调 URL。
❌ 定时任务建好了，消息从没到过
原因：Cron 投递走 Agent 出站通道——没配 Agent 模式（corpId / corpSecret / agentId）发不出去；服务器出口 IP 不在企微可信 IP 白名单，也会被企微侧拦下。
正确做法：配好 Agent 模式；IP 不固定就配 channels.wecom.network.egressProxyUrl 走固定出站代理。
❌ 放行工具时覆盖了已有配置
现象：tools.alsoAllow 里原来的条目失效，其他插件的工具突然不能用。
原因：openclaw config set 写的是整个数组，直接设就把旧值冲掉了。
正确做法：把 wecom-openclaw-plugin 合并进现有数组再写入。
进阶技巧（可选）
Agent 模式：自建应用解锁主动推送
定时投递（晨报、告警、广播）走 Agent 出站通道，没配 Agent 模式就发不出去，得加 Agent 模式——在企微管理后台创建自建应用，拿 CorpID / CorpSecret / AgentId，再在应用「API 接收」里生成 Token / EncodingAESKey：
openclaw config set channels.wecom.agent.corpId <YOUR_CORP_ID>
openclaw config set channels.wecom.agent.corpSecret <YOUR_CORP_SECRET>
openclaw config set channels.wecom.agent.agentId <YOUR_AGENT_ID>
openclaw config set channels.wecom.agent.token <YOUR_CALLBACK_TOKEN>
openclaw config set channels.wecom.agent.encodingAESKey <YOUR_ENCODING_AES_KEY>
openclaw gateway restart回调 URL 填 https://<your-gateway-host>/plugins/wecom/agent/<accountId>（例如 /plugins/wecom/agent/default；单账号也可用 /plugins/wecom/agent）。记住第 2 个坑：先配 Gateway，再回后台点保存。
配好后，出站投递Bot 优先、Agent 兜底：Bot WebSocket 可用时走 WS（支持 Markdown、流式），不可用自动回退 Agent HTTP API；只有 Agent 的账号也能发主动消息、Cron 投递与广播，媒体文件会先下载再经 Agent API 上传发送，失败则回退为文本 + URL。
主动推送的目标格式
delivery.to（CLI 里是 --to）支持：
| 格式 | 目标 | 示例 |
|---|---|---|
party:<id> / dept:<id> | 部门 | party:1（根部门 = 全员） |
tag:<id> | 标签组 | tag:Ops |
user:<id> | 指定用户 | user:zhangsan |
group:<id> / chat:<id> | 群聊 | group:wr123abc |
| 纯数字 | 自动识别为部门 | 1 → party:1 |
wr... / wc... 开头 | 自动识别为群聊 | wr123 |
wecom:、qywx: 等命名空间前缀会自动去除，不用手动清。
更多玩法一句话版
- 多账号：
accounts配多个企微账号（如 main / support），账号级字段覆盖顶层；多账号下没有显式bindings的账号不会回退默认 agent，记得给每个账号配 bindings - 动态 Agent 路由：
dynamicAgents.enabled: true按用户/群自动创建隔离 Agent，会话互不串线 - 媒体限制：图片/视频超 10MB、语音超 2MB（仅 AMR）自动降级为文件发送；文件上限 20MB，超出拒绝
- 出站代理：
channels.wecom.network.egressProxyUrl优先于HTTPS_PROXY等环境变量
多账号与 bindings 的完整玩法见 C3 多 Agent 协作。
本课小结
✅ 你现在能：
- 完成 OpenClaw 企业微信接入：单聊/群聊里用上流式回复的 AI 助手（装插件 → 配 Bot → 进群）
- 放行 wecom-cli，让它操作待办、日程、会议、文档、微盘、通讯录
- 用白名单控制谁能用、哪个群能进、群里谁能说话
- 配 Agent 模式，解锁主动推送与定时晨报
关键配置字段回顾：
| 字段 | 推荐值 | 说明 |
|---|---|---|
channels.wecom.enabled | true | 启用企微渠道 |
channels.wecom.botId / secret | 机器人凭据 | Bot 模式（WebSocket）必填 |
channels.wecom.connectionMode | websocket（默认） | Bot 连接方式，可选 webhook |
channels.wecom.dmPolicy / groupPolicy | allowlist | 默认 open，上线前收紧 |
tools.alsoAllow | ["wecom-openclaw-plugin"] | 放行 wecom-cli 业务工具 |
channels.wecom.agent.* | 五项应用凭据 | Agent 模式：回调接收 + 主动推送 |
下一课预告
下一课 A2 飞书接入：官方插件、群聊与文档工具，你会学到：
- 官方
@openclaw/feishu插件与企微外部插件的差别 - WebSocket 默认模式怎么零公网 URL 跑起来
- 飞书文档 / wiki / 云盘 / Bitable 工具的用法
- 飞书的群聊配置与访问控制
公司主用飞书？直接跳过去；两家都用就照着再配一遍——渠道之间互不干扰，一个 Gateway 全带走。