Clawdbot 对接企业微信单向推送全流程指南
本文针对非管理员用户(无企微后台权限),详细拆解从 Clawdbot 安装到企微机器人正常推送的全步骤,所有命令可直接复制,新手也能快速上手。
一、前置说明(必看)
1. 适用场景
非企微管理员,仅能创建「企微群机器人」,实现 Clawdbot→企微群单向推送 (无法接收企微消息回复,适合通知、告警、播报场景);若为管理员,可进一步实现双向对话(文末附拓展方向)。
2. 环境要求
支持 Mac/Linux/Windows(本文以 Linux 为例),需联网且能访问公网(企微 Webhook 需外部请求),最好直接就是美西的机器。
3. 核心工具
Clawdbot(AI 机器人框架)、企微群机器人(Webhook)、Python 依赖(requests 库)。
二、第一步:安装 Clawdbot(基础环境搭建)
Clawdbot 支持一键安装,全程在系统终端操作,无需复杂配置。
1. 一键安装 Clawdbot
打开终端,复制以下命令执行(Mac/Linux 通用):
curl -fsSL https://clawd.bot/install.sh | bash
2. 初始化 Clawdbot(关键步骤)
安装完成后,终端会自动进入初始化流程,按以下选项依次选择:
- Select workspace :默认即可(路径为
~/clawd),按回车确认。 - Select model :推荐选国产模型(如 Qwen),新手直接选
qwen-portal/coder-model(无需额外配置 API 密钥)。 - 授权登录 Qwen,等待一段时间后,出现下面第一张图的鼠标选中的内容,复制网页到浏览器打开。
- Select channel (QuickStart) :选
Skip for now(企微不在预设通道,后续自定义对接),按空格键勾选后回车。 - Configure skills now? :选
No(先打通推送,后续再配置技能),按空格键勾选后回车。 - Enable hooks? :选
Skip for now(无需钩子功能),按空格键勾选后回车。
3. 退出 TUI(后续配置需用到终端)
在 TUI 界面按 Ctrl+C 退出,回到系统终端(后续修改配置、部署脚本需在此操作)。
三、第二步:创建企微群机器人(获取 Webhook Key)
无需管理员权限,仅需为企微内部群创建机器人,获取推送所需的 Webhook Key。
- 打开企微,进入目标内部群(外部群不支持机器人),点击右上角
…→ 找到 消息推送 → 点击 自定义消息推送。 - 点击
新建机器人,输入机器人名称(如 Clawdbot)、选择头像,点击完成。 - 创建成功后,会生成专属 Webhook 地址,复制该地址中的 Key 部分 (示例地址:
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=123456-abcdef-7890,Key 即为123456-abcdef-7890),保存备用(后续需用到)。
四、第三步:部署企微推送技能脚本(核心对接)
Clawdbot 需通过自定义技能脚本对接企微 Webhook,本文提供优化版脚本(支持配置文件存储 Key,兼顾安全与易用),直接复制部署即可。
1. 安装依赖库
终端执行以下命令,安装脚本所需的 requests 库:


