Agent 用例站

← 用例 · 企业协作

企微官方插件接入 OpenClaw（文档 · 日程 · 待办）

用企业微信团队官方 OpenClaw Channel 插件，一键安装后把本机 OpenClaw Agent 接到企微：Bot 长连接（默认可无公网）或 Agent 回调，并可操作文档、智能表格、日程、会议与待办。

OpenClaw企业微信

来源：GitHub · 2026-10-14 · 原文

做法 / Prompt

先确认本机 OpenClaw ≥ 2026.3.28（openclaw -v）。然后执行：npx -y @wecom/wecom-openclaw-cli install ；按向导填入企微智能机器人 Bot ID / Secret（默认 WebSocket 长连接，无需公网 IP）。成功后 openclaw gateway restart，在企微私聊机器人发一条测试消息验收。若要用文档/日程等业务能力：openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]' 后重启。Secret 只留本机，不要写进公开仓或对话。

痛点

人在企业微信里协作，Agent 却在另一套终端；想让助手直接收发企微消息，并顺手改文档、查日程、建待办，又缺官方可复现通道。站内已有「不用公网 IP 接企微」的 Grok Bot 长连接 试点，以及钉钉官方 OpenClaw 插件，但 OpenClaw × 企微官方插件 尚未收录。

与站内「不用公网 IP 把 Grok Bot 接进企业微信」不同：那条是 Grok Bot 自写长连接小程序；本条是 OpenClaw Agent 经 企微官方 Channel 插件（@wecom/wecom-openclaw-plugin）进企微，并可调用文档 / 智能表格 / 日程 / 会议 / 待办等业务能力。
与站内「钉钉官方插件接入 OpenClaw」对称：同一类官方 Channel，渠道换成企业微信。

做法

  1. 前置：本机已安装并正常运行 OpenClaw（开源个人/团队助手 Gateway）。插件要求宿主 OpenClaw ≥ 2026.3.28（openclaw -v）。若 OpenClaw 为 2026.3.22+，插件需 ≥ 2026.3.24；更旧宿主可按 README「特别说明」固定插件版本或强制重装。
  2. 一键安装（推荐）：执行 npx -y @wecom/wecom-openclaw-cli install（失败可加 --force）。CLI 会装上 Channel 插件并引导配置。npm：@wecom/wecom-openclaw-cli · 插件包 @wecom/wecom-openclaw-plugin。也可手动：openclaw plugins install @wecom/wecom-openclaw-plugin。
  3. Bot 模式（默认，长连接）：在企微侧创建智能机器人，拿到 Bot ID 与 Secret。交互式：openclaw channels add；或 CLI：openclaw config set channels.wecom.botId … / channels.wecom.secret … / channels.wecom.enabled true，再 openclaw gateway restart。默认 connectionMode: websocket（wss://openws.work.weixin.qq.com），无需公网 IP。也可用 webhook 模式（需 token + encodingAESKey）。
  4. Agent 模式（可选，自建应用）：适合企业自建应用、XML 加密回调。需先配好 Gateway 的 channels.wecom.agent.*（corpId / corpSecret / agentId / token / encodingAESKey）并重启，再在企微管理后台「API 接收」保存回调 URL（保存时会立刻校验 echostr）。与 Bot 模式可独立或同时开。
  5. 业务能力（wecom-cli）：除非 tools.profile 为 full，否则执行 openclaw config set tools.alsoAllow '["wecom-openclaw-plugin"]' 后重启，以放行文档、邮件、在线表格/智能表格、待办、日程、会议、微盘、通讯录等 Skills（以 README 能力表为准）。若 alsoAllow 已有其它项，合并进数组，勿整表覆盖。
  6. 安全：凭证与会话状态留本机 ~/.openclaw/；先当个人/小团队助手验收，再考虑进生产群；用好 DM / 群策略（pairing / allowlist 等）。不要把 Secret 写进公开仓或对话。

验收

  • openclaw -v ≥ 2026.3.28；npx … install（或手动 plugins install）成功，channels.wecom.enabled 为 true。
  • openclaw gateway restart 后，企微私聊（或约定群）能向机器人发一条消息并收到回复（Bot 模式可有「思考中」占位 / 流式）。
  • Bot Secret / corpSecret / encodingAESKey 仅在本机配置，未进 git；未在公开对话中粘贴。

来源