微信/企业微信接入实战
本指南介绍如何在 OpenClaw 中接入微信生态渠道，包括企业微信和第三方微信解决方案。
📱 微信渠道概览
| 渠道类型 | 官方支持 | 稳定性 | 接入难度 | 适用场景 |
|---|---|---|---|---|
| 企业微信 | ✅ | ⭐⭐⭐⭐⭐ | 中等 | 企业内部、团队协作 |
| 飞书 | ✅ | ⭐⭐⭐⭐⭐ | 简单 | 企业内部、知识管理 |
| Feishu | ✅ | ⭐⭐⭐⭐⭐ | 简单 | 与企业微信类似 |
| 微信个人号（非官方） | ⚠️ | ⭐⭐⭐ | 复杂 | 个人使用，有风险 |
🏢 企业微信接入（推荐）
前置条件
- 已注册企业微信账号
- 管理员权限
- 已创建应用
Step 1: 获取企业微信凭证
- 登录 企业微信管理后台
- 进入「应用管理」→「应用」→「自建」
- 创建应用或选择已有应用
- 记录以下信息：
AgentId: 应用的 AgentIdSecret: 应用的 SecretCorpId: 企业的 CorpId（在「我的企业」中）
Step 2: 配置 OpenClaw
{
channels: {
feishu: {
enabled: true,
// 企业微信配置
corpId: "your-corp-id",
agentId: "your-agent-id",
secret: {
source: "env",
provider: "default",
id: "FEISHU_SECRET"
},
// 接收消息配置
dmPolicy: "allowlist",
},
},
}Step 3: 设置接收消息
- 在企业微信应用中，进入「接收消息」
- 设置回调 URL：
https://your-domain.com/channels/feishu/webhook - 配置 Token 和 EncodingAESKey
- 在 OpenClaw 配置中填写对应值
{
channels: {
feishu: {
// ... 其他配置
webhook: {
token: "your-token",
encodingAESKey: "your-aes-key",
},
},
},
}Step 4: 验证配置
# 检查渠道状态
openclaw channels status --probe
# 发送测试消息
openclaw message send --channel feishu --target "user-id" --message "测试消息"🎯 飞书接入（更简单）
飞书提供更完善的 API 和更好的文档，推荐作为企业首选。
Step 1: 创建飞书应用
- 登录 飞书开放平台
- 创建企业自建应用
- 记录 App ID 和 App Secret
Step 2: 配置 OpenClaw
{
channels: {
feishu: {
enabled: true,
appId: "your-app-id",
appSecret: {
source: "env",
provider: "default",
id: "FEISHU_APP_SECRET"
},
encryptKey: "your-encrypt-key", // 可选
verifyToken: "your-verify-token", // 可选
},
},
}Step 3: 订阅事件
- 在飞书应用中，进入「事件订阅」
- 设置请求 URL：
https://your-domain.com/channels/feishu/webhook - 订阅所需事件（如：接收消息、群组变更等）
⚠️ 微信个人号接入（非官方）
⚠️ 警告：使用非官方方式接入微信个人号存在封号风险，仅建议个人学习使用。
可用方案
WeChatPadPro（iPad 协议）
- 稳定性较好
- 需要额外插件
- 参考：openclaw-wechat
zca-js（Zalo Personal）
- 支持 Zalo（越南微信）
- 配置参考：Zalo Personal Plugin
安装步骤
# 安装微信插件
openclaw plugins install @icesword760/openclaw-wechat
# 重启 Gateway
openclaw gateway restart
# 扫码登录
openclaw channels login --channel wechat🔧 常见问题
问题一：企业微信消息收不到
排查步骤：
- 检查回调 URL 是否可访问：
curl https://your-domain.com/channels/feishu/webhook - 查看企业微信后台的「推送记录」
- 检查 OpenClaw 日志：
openclaw logs --tail 100
问题二：飞书加密失败
解决方案：
{
channels: {
feishu: {
// 确认 Key 和 Token 正确
encryptKey: "从飞书后台复制的完整 Key",
verifyToken: "从飞书后台复制的完整 Token",
},
},
}问题三：微信插件登录失败
可能原因：
- 网络问题（微信服务器封锁）
- 协议变更（插件未及时更新）
- 账号风控（频繁操作）
解决方案：
- 切换网络环境
- 更新插件到最新版
- 降低使用频率
📊 最佳实践
企业场景
- 使用企业微信或飞书：官方支持，稳定性高
- 配置权限隔离：不同部门使用不同应用
- 设置消息审计：记录关键操作日志
- 配置告警：服务异常时及时通知
个人场景
- 优先使用官方渠道：Telegram、Discord 等更稳定
- 微信仅作补充：不依赖单一渠道
- 定期备份配置：防止账号被封后数据丢失
- 遵守使用规范：避免频繁操作触发风控
🔗 相关文档
💡 进阶技巧
多账号管理
{
channels: {
feishu: {
enabled: true,
accounts: {
main: { /* 主账号配置 */ },
backup: { /* 备用账号配置 */ },
},
},
},
}消息过滤
{
channels: {
feishu: {
// 只处理特定群组
allowedGroups: ["group-id-1", "group-id-2"],
// 忽略特定用户
ignoredUsers: ["bot-user-id"],
},
},
}消息转发
配置消息在不同渠道间转发：
{
automation: {
hooks: [
{
trigger: {
type: "message.channel",
channel: "feishu",
},
action: {
type: "message.send",
channel: "telegram",
},
},
],
},
}