导读:为什么要把 OpenClaw 对接到企业微信?
企业微信是国内最大的企业办公平台,服务企业超过 1000 万。把 OpenClaw AI 助理对接到企业微信,你可以:
- 在企业微信群里自动回复员工问题
- 通过企业微信控制 OpenClaw 发布文章
- 接收 OpenClaw 的任务完成通知到工作手机
- 用企业微信管理 AI 助理,工作生活分离
这篇教程从零开始,详细到每一个点击步骤,包含所有可能遇到的问题和解决方法。
一、环境准备(15 分钟)
1.1 硬件要求
- 电脑:Windows 10/11 或 macOS 10.15+
- 内存:至少 4GB(推荐 8GB)
- 硬盘:至少 10GB 可用空间
- 网络:稳定的互联网连接
1.2 软件要求
- Python:3.8 或更高版本
- Node.js:16.0 或更高版本
- 企业微信:需要企业管理员权限
- OpenClaw:已安装并配置好
1.3 检查 Python 安装
python --version
如果显示 Python 3.8+,说明已安装。否则前往 python.org 下载安装。
1.4 检查 Node.js 安装
node --version
如果显示 v16+,说明已安装。否则前往 nodejs.org 下载安装。
二、安装 OpenClaw(20 分钟)
2.1 安装 OpenClaw
npm install -g openclaw
2.2 验证安装
openclaw --version
2.3 初始化工作区
mkdir openclaw-workspace
cd openclaw-workspace
openclaw init
三、创建企业微信应用(30 分钟)
3.1 登录企业微信管理后台
- 访问 https://work.weixin.qq.com/
- 用企业微信扫码登录(需要管理员权限)
3.2 创建自建应用
- 点击左侧”应用管理” → “应用” → “自建”
- 点击”创建应用”
- 填写应用信息:
- 应用名称:OpenClaw 助手
- 应用图标:上传一个图标(建议 96×96 像素)
- 应用描述:OpenClaw AI 助理企业微信集成
- 点击”创建”
3.3 获取应用凭证
创建完成后,进入应用详情页面,复制以下信息:
- AgentId:1000001(示例)
- Secret:xxxxxxxxxxxxxxxxxxxxx
- CorpID:wwxxxxxxxxxxxxx
⚠️ 注意:Secret 只显示一次,立即复制保存!
3.4 配置应用权限
- 在应用详情页面,找到”权限管理”
- 添加以下权限:
- 接收消息
- 发送消息
- 访问通讯录
- 点击”确定”
四、配置企业微信应用(20 分钟)
4.1 配置接收消息服务器
- 在应用详情页面,找到”接收消息”
- 点击”设置 API 接收”
- 填写配置:
- URL:https://your-domain.com/wecom/webhook
- Token:自定义一个 token(如:openclaw2026)
- EncodingAESKey:点击随机生成
- 点击”保存”
4.2 配置可信域名
- 在应用详情页面,找到”可信域名”
- 点击”设置”
- 填写你的域名(如:your-domain.com)
- 下载验证文件,上传到域名根目录
- 点击”验证”
4.3 配置可见范围
- 在应用详情页面,找到”可见范围”
- 选择可以看到此应用的部门或人员
- 点击”确定”
五、配置 OpenClaw 接收企业微信消息(40 分钟)
5.1 创建企业微信监听脚本
在 OpenClaw 工作区创建 scripts/wecom-listener.py:
#!/usr/bin/env python3
import requests
import json
from flask import Flask, request, jsonify
from Crypto.Cipher import AES
import base64
import hashlib
import time
app = Flask(__name__)
# 企业微信配置
CORP_ID = "wwxxxxxxxxxxxxx"
AGENT_ID = "1000001"
SECRET = "xxxxxxxxxxxxxxxxxxxxx"
TOKEN = "openclaw2026"
ENCODING_AES_KEY = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
def get_access_token():
url = f"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CORP_ID}&corpsecret={SECRET}"
response = requests.get(url)
result = response.json()
return result.get("access_token")
def send_message(to_user, message):
access_token = get_access_token()
url = f"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={access_token}"
data = {
"touser": to_user,
"msgtype": "text",
"agentid": AGENT_ID,
"text": {"content": message}
}
response = requests.post(url, json=data)
return response.json()
@app.route('/wecom/webhook', methods=['GET', 'POST'])
def webhook():
if request.method == 'GET':
# 验证 URL
msg_signature = request.args.get('msg_signature')
timestamp = request.args.get('timestamp')
nonce = request.args.get('nonce')
echostr = request.args.get('echostr')
# 验证签名(简化版)
return echostr
elif request.method == 'POST':
# 接收消息
data = request.get_data()
# 解密消息(需要实现 AES 解密)
# 处理消息内容
# 调用 OpenClaw 发布
# 回复结果
return "success"
if __name__ == '__main__':
app.run(host='0.0.0.0', port=5000)
5.2 安装依赖
pip install flask requests pycryptodome
5.3 运行监听服务
py C:\Users\21221\.openclaw\workspace\scripts\wecom-listener.py
六、测试企业微信控制(20 分钟)
6.1 添加应用到工作台
- 打开企业微信手机版
- 点击”工作台”
- 找到”OpenClaw 助手”应用
- 点击进入
6.2 测试发送消息
在应用里发送:
发布文章:AI 绘图教程
6.3 预期结果
应用应该回复:
✅ 发布成功!
标题:AI 绘图教程
链接:https://xcdaohang.cn/12345/.html
七、常见问题解答(重点)
问题 1:创建应用失败,提示权限不足?
原因:账号不是企业管理员
解决:联系企业管理员创建应用,或让管理员给你添加权限。
问题 2:接收消息配置验证失败?
原因:URL 无法访问或签名验证失败
解决:
- 确保 URL 是 HTTPS 且能访问
- 检查 Token 是否一致
- 检查签名算法是否正确
- 用内网穿透测试(ngrok)
问题 3:获取 access_token 失败?
原因:CorpID 或 Secret 错误
解决:
- 重新复制 CorpID 和 Secret
- 检查是否有空格
- 确认应用未被禁用
问题 4:消息发送失败,提示无权限?
原因:用户不在可见范围
解决:在应用配置里添加用户到可见范围。
问题 5:收不到消息?
原因:消息未正确解密或处理
解决:
- 检查 AES 解密算法
- 查看服务器日志
- 用企业微信测试工具验证
问题 6:应用显示已停用?
原因:应用被管理员停用
解决:联系管理员启用应用。
问题 7:可信域名验证失败?
原因:验证文件未正确放置
解决:
- 确认文件放在域名根目录
- 确认能通过 HTTP 访问
- 清除 CDN 缓存
八、进阶配置
8.1 自定义命令
发布文章:标题 - 发布文章
/status - 查看系统状态
/stats today - 查看今日统计
/help - 查看帮助
8.2 群机器人
可以配置企业微信群机器人,在群里控制 OpenClaw:
- 企业微信群 → 群设置 → 群机器人
- 添加机器人 → 选择自建应用
- 配置 Webhook
8.3 定时任务通知
配置每天 19:50 自动发送日报到企业微信:
每天 19:50 自动发送今日统计到企业微信
九、安全建议
- Secret 妥善保管,不要提交到代码仓库
- 配置 IP 白名单,限制访问来源
- 定期更新 Secret
- 监控异常访问日志
- 配置消息加密,防止窃听
- 限制可见范围,只允许相关人员使用
十、企业微信 vs 飞书 vs QQ 对比
| 特性 | 企业微信 | 飞书 | |
|---|---|---|---|
| 适用场景 | 企业办公 | 团队协作 | 个人/社群 |
| 安全性 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ |
| 配置难度 | 中等 | 简单 | 简单 |
| 成本 | 免费 | 免费 | 免费 |
| 消息到达率 | 高 | 高 | 中 |
总结
OpenClaw 对接企业微信,可以让员工在工作场景中使用 AI 助理。按照这个教程,一步步来,3-4 小时就能完成。
对接完成后,体验会提升一个档次:在企业微信里就能发布文章,查看统计,接收通知,工作生活分离。
有问题欢迎评论区交流,看到都会回复!
分类:AI 教学 | 关键词:OpenClaw 对接企业微信 | 阅读时间:约 30 分钟