OpenClaw 接入微信 / 企业微信完整教程

本文介绍如何通过 OpenClaw 框架将个人微信和企业微信接入 AI Agent实现「AI 自动回复」的功能。适用于树莓派、Mac/Windows 电脑、NAS 或云服务器等各类设备。一、环境准备1.1 安装 OpenClawOpenClaw 是核心运行环境负责加载插件、管理 Agent、处理消息路由。macOS / Linux:# 安装 Node.js 22curl-fsSLhttps://openclaw.ai/install.sh|sh# 或通过 npm 安装需 Node 18npminstall-gopenclaw# 验证版本openclaw--versionWindows:下载安装包https://openclaw.ai/download树莓派 / ARM 设备curl-fsSLhttps://openclaw.ai/install.sh|sh安装完成后启动 Gateway后台服务openclaw gateway start查看状态openclaw gateway status Gateway 默认端口18789WebUI 地址http://localhost:18789二、接入个人微信openclaw-weixin2.1 安装插件个人微信通过腾讯官方的tencent-weixin/openclaw-weixin插件接入。# 安装微信插件openclaw pluginsinstalltencent-weixin/openclaw-weixinopenclaw configsetplugins.entries.openclaw-weixin.enabledtrue# 重启 Gateway 使插件生效openclaw gateway restart2.2 扫码绑定账号在与 Gateway 同一台机器的终端执行NODE_EXTRA_CA_CERTS/etc/ssl/cert.pem openclaw channels login--channelopenclaw-weixin命令执行后会弹出二维码用微信扫描即可登录。⚠️注意macOS 如遇 TLS 证书报错需要加上NODE_EXTRA_CA_CERTS/etc/ssl/cert.pem前缀。Linux 系统执行sudo apt install ca-certificates后重试。2.3 绑定多个微信号重复执行扫码命令即可绑定更多微信号每个微信号会分配独立账号 ID。2.4 配置访问权限新绑定账号默认需要配对授权。向机器人发消息后管理员执行# 查看待授权请求openclaw pairing list openclaw-weixin# 批准配对openclaw pairing approve openclaw-weixinCODE也可设为开放模式允许所有人直接对话openclaw configsetplugins.entries.openclaw-weixin.dmPolicyopenopenclaw gateway restart2.5 消息路由配置多账号隔离多个微信账号建议配置 DM 隔离策略openclaw configsetsession.dmScope per-account-channel-peer三、接入企业微信wecom企业微信接入支持两种模式可同时启用满足不同场景需求。两种模式对比智能机器人Bot 模式自建应用Agent 模式连接方式WebSocket 长连接OpenClaw 主动连接企业微信HTTP 回调企业微信推送消息到你的服务器公网地址❌ 不需要✅ 需要群聊支持✅ 可被拉入群聊支持群内对话❌ 仅支持私聊无法进入群聊配置难度简单扫码即可完成较复杂需要配置回调 URL消息格式JSONXML加密适用场景群客服、多人互动、Bot 指令企业内部应用、API 驱动消息关键区别智能机器人可以被拉到群里在群聊中响应自建应用只能一对一私聊无法参与群聊。3.1 安装插件openclaw pluginsinstallwecom/wecom-openclaw-pluginopenclaw configsetplugins.entries.wecom.enabledtrue方式一智能机器人Bot 模式— 扫码配置 ✅ 推荐3.2.1 一键扫码安装企业微信官方提供了交互式配置工具扫码即可自动完成配置NODE_EXTRA_CA_CERTS/etc/ssl/cert.pem npx-ywecom/wecom-openclaw-cliinstall命令执行后会弹出企业微信二维码用管理员微信扫码授权即可。工具会自动获取botId和secret并写入配置全程无需手动操作。⚠️ macOS 如遇证书报错加上NODE_EXTRA_CA_CERTS/etc/ssl/cert.pem前缀。3.2.2 在企业微信管理后台开启机器人扫码授权后还需要在管理后台开启机器人功能登录 企业微信管理后台 → 「应用管理」→ 找到你的应用点击「机器人」选项卡 → 开启开启后机器人即可被拉入群聊中使用。3.2.3 重启 Gatewayopenclaw gateway restart3.2.4 验证连接在企业微信中向机器人发送一条消息如果 AI 回复即表示成功。机器人模式支持被拉入群聊多人场景下同样可以响应。方式二自建应用Agent 模式— 手动配置自建应用适合需要企业微信主动推送消息的场景如定时通知、审批提醒等。3.3.1 创建自建应用登录 企业微信管理后台进入「应用管理」→「自建应用」→「创建应用」填写应用名称和描述保存AgentId和Secret3.3.2 配置回调地址在管理后台找到应用点击「接收消息」→「设置企业微信应用的 URL」配置项值URLhttps://你的公网域名/plugins/wecom/agent/defaultToken填入随机字符串记录下来EncodingAESKey点击「随机生成」记录下来 公网域名可使用 Cloudflare Tunnel 将本地服务暴露到公网无需固定 IP。3.3.3 配置 OpenClaw获取CorpId、AgentId、Secret、Token、EncodingAESKey后通过 CLI 配置openclaw configsetchannels.wecom.agent.corpId你的CorpIdopenclaw configsetchannels.wecom.agent.corpSecret你的Secretopenclaw configsetchannels.wecom.agent.agentId你的AgentIdopenclaw configsetchannels.wecom.agent.token你的Tokenopenclaw configsetchannels.wecom.agent.encodingAESKey你的EncodingAESKey3.3.4 重启 Gatewayopenclaw gateway restart3.3.5 验证连接在企业微信中找到你的应用向机器人发送一条消息。如果 AI 回复说明接入成功。3.4 同时启用两种模式两种模式可以共存同时生效私聊走 Agent 模式群聊走 Bot 模式配置后分别验证即可。四、注意事项4.1 个人微信插件重启后账号丢失⚠️重要个人微信插件openclaw-weixin在 Gateway 热重载restart后已绑定的账号可能不会自动恢复。新增账号后的正确操作流程# Step 1: 扫码绑定新账号NODE_EXTRA_CA_CERTS/etc/ssl/cert.pem openclaw channels login--channelopenclaw-weixin# Step 2: 完整停启不要用 restart否则旧账号会失联OPENCLAW_ALLOW_OLDER_BINARY_DESTRUCTIVE_ACTIONS1openclaw gateway stop openclaw gateway start4.2 端口与内网穿透OpenClaw 默认监听127.0.0.1:18789对外暴露需通过反向代理或 Cloudflare Tunnel# Cloudflare Tunnel 快速暴露cloudflared tunnel--urlhttp://localhost:187894.3 访问控制配置说明dmPolicy: pairing需要管理员审批默认dmPolicy: open对所有人开放dmPolicy: allowlist仅白名单用户可对话dmPolicy: disabled完全禁用4.4 消息路由配置session.dmScope可以决定多账号场景下会话如何隔离# 按账号通道对话者隔离最适合多微信场景openclaw configsetsession.dmScope per-account-channel-peer五、参考资料官方文档OpenClaw 官方文档OpenClaw 安装指南OpenClaw 插件管理Channel 通道概览OpenClaw Gateway 配置个人微信插件tencent-weixin/openclaw-weixin 官方包WeChat 接入文档配对Pairing机制企业微信插件wecom/wecom-openclaw-plugin 官方包WeCom Plugin README详细配置企业微信 AI Bot 官方文档WeCom Plugin 快速接入指引内网穿透Cloudflare Tunnel 快速上手Cloudflare Tunnel 官方文档社区OpenClaw GitHubOpenClaw 社区 DiscordOpenClaw Skills 库 ClawhHub本文基于 OpenClaw2026.5.3tencent-weixin/openclaw-weixinv2.4.2 wecom/wecom-openclaw-pluginv2026.5.7 编写如有版本差异请参考官方文档。