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

本文介绍如何通过 OpenClaw 框架，将个人微信和企业微信接入 AI Agent，实现「AI 自动回复」的功能。适用于树莓派、Mac/Windows 电脑、NAS 或云服务器等各类设备。

---

一、环境准备

1.1 安装 OpenClaw

OpenClaw 是核心运行环境，负责加载插件、管理 Agent、处理消息路由。

macOS / Linux:

# 安装 Node.js 22+
curl -fsSL https://openclaw.ai/install.sh | sh

# 或通过 npm 安装（需 Node >= 18）
npm install -g openclaw

# 验证版本
openclaw --version

Windows: 下载安装包：https://openclaw.ai/download

树莓派 / ARM 设备：

curl -fsSL https://openclaw.ai/install.sh | sh

安装完成后启动 Gateway（后台服务）：

openclaw gateway start

查看状态：

openclaw gateway status

💡 Gateway 默认端口 18789，WebUI 地址：http://localhost:18789

---

二、接入个人微信（openclaw-weixin）

2.1 安装插件

个人微信通过腾讯官方的 @tencent-weixin/openclaw-weixin 插件接入。

# 安装微信插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true

# 重启 Gateway 使插件生效
openclaw gateway restart

2.2 扫码绑定账号

在与 Gateway 同一台机器的终端执行：

NODE_EXTRA_CA_CERTS=/etc/ssl/cert.pem openclaw channels login --channel openclaw-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-weixin <CODE>

也可设为开放模式，允许所有人直接对话：

openclaw config set plugins.entries.openclaw-weixin.dmPolicy open
openclaw gateway restart

2.5 消息路由配置（多账号隔离）

多个微信账号建议配置 DM 隔离策略：

openclaw config set session.dmScope per-account-channel-peer

---

三、接入企业微信（wecom）

企业微信接入支持两种模式，可同时启用，满足不同场景需求。

两种模式对比

	智能机器人（Bot 模式）	自建应用（Agent 模式）
连接方式	WebSocket 长连接（OpenClaw 主动连接企业微信）	HTTP 回调（企业微信推送消息到你的服务器）
公网地址	❌ 不需要	✅ 需要
群聊支持	✅ 可被拉入群聊，支持群内对话	❌ 仅支持私聊，无法进入群聊
配置难度	简单，扫码即可完成	较复杂，需要配置回调 URL
消息格式	JSON	XML（加密）
适用场景	群客服、多人互动、Bot 指令	企业内部应用、API 驱动消息

💡 关键区别：智能机器人可以被拉到群里，在群聊中响应；自建应用只能一对一私聊，无法参与群聊。

---

3.1 安装插件

openclaw plugins install "@wecom/wecom-openclaw-plugin"
openclaw config set plugins.entries.wecom.enabled true

---

方式一：智能机器人（Bot 模式）— 扫码配置 ✅ 推荐

3.2.1 一键扫码安装

企业微信官方提供了交互式配置工具，扫码即可自动完成配置：

NODE_EXTRA_CA_CERTS=/etc/ssl/cert.pem npx -y @wecom/wecom-openclaw-cli install

命令执行后会弹出企业微信二维码，用管理员微信扫码授权即可。工具会自动获取 botId 和 secret 并写入配置，全程无需手动操作。

⚠️ macOS 如遇证书报错，加上 NODE_EXTRA_CA_CERTS=/etc/ssl/cert.pem 前缀。

3.2.2 在企业微信管理后台开启机器人

扫码授权后，还需要在管理后台开启机器人功能：

1. 登录 企业微信管理后台 → 「应用管理」→ 找到你的应用
2. 点击「机器人」选项卡 → 开启

开启后，机器人即可被拉入群聊中使用。

3.2.3 重启 Gateway

openclaw gateway restart

3.2.4 验证连接

在企业微信中向机器人发送一条消息，如果 AI 回复即表示成功。机器人模式支持被拉入群聊，多人场景下同样可以响应。

---

方式二：自建应用（Agent 模式）— 手动配置

自建应用适合需要企业微信主动推送消息的场景（如定时通知、审批提醒等）。

3.3.1 创建自建应用

1. 登录 企业微信管理后台
2. 进入「应用管理」→「自建应用」→「创建应用」
3. 填写应用名称和描述，保存 AgentId 和 Secret

3.3.2 配置回调地址

在管理后台找到应用，点击「接收消息」→「设置企业微信应用的 URL」：

配置项	值
URL	https://你的公网域名/plugins/wecom/agent/default
Token	填入随机字符串（记录下来）
EncodingAESKey	点击「随机生成」（记录下来）

💡 公网域名可使用 Cloudflare Tunnel 将本地服务暴露到公网，无需固定 IP。

3.3.3 配置 OpenClaw

获取 CorpId、AgentId、Secret、Token、EncodingAESKey 后，通过 CLI 配置：

openclaw config set channels.wecom.agent.corpId "你的CorpId"
openclaw config set channels.wecom.agent.corpSecret "你的Secret"
openclaw config set channels.wecom.agent.agentId "你的AgentId"
openclaw config set channels.wecom.agent.token "你的Token"
openclaw config set channels.wecom.agent.encodingAESKey "你的EncodingAESKey"

3.3.4 重启 Gateway

openclaw gateway restart

3.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 --channel openclaw-weixin

# Step 2: 完整停启（不要用 restart，否则旧账号会失联）
OPENCLAW_ALLOW_OLDER_BINARY_DESTRUCTIVE_ACTIONS=1 openclaw gateway stop
openclaw gateway start

4.2 端口与内网穿透

OpenClaw 默认监听 127.0.0.1:18789，对外暴露需通过反向代理或 Cloudflare Tunnel：

# Cloudflare Tunnel 快速暴露
cloudflared tunnel --url http://localhost:18789

4.3 访问控制

配置	说明
dmPolicy: pairing	需要管理员审批（默认）
dmPolicy: open	对所有人开放
dmPolicy: allowlist	仅白名单用户可对话
dmPolicy: disabled	完全禁用

4.4 消息路由

配置 session.dmScope 可以决定多账号场景下会话如何隔离：

# 按（账号+通道+对话者）隔离，最适合多微信场景
openclaw config set session.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 GitHub
• OpenClaw 社区 Discord
• OpenClaw Skills 库 ClawhHub

---

本文基于 OpenClaw 2026.5.3 + @tencent-weixin/openclaw-weixin v2.4.2 + @wecom/wecom-openclaw-plugin v2026.5.7 编写，如有版本差异请参考官方文档。