从零搭建 Clawdbot 对接企业微信机器人单向推送指南
介绍在无管理员权限下,通过安装 Clawdbot 框架并部署自定义 Python 脚本,实现向企业微信群单向推送通知。步骤涵盖环境准备、机器人创建、脚本部署及测试验证,支持文本与 Markdown 格式,适用于告警播报等自动化场景。

介绍在无管理员权限下,通过安装 Clawdbot 框架并部署自定义 Python 脚本,实现向企业微信群单向推送通知。步骤涵盖环境准备、机器人创建、脚本部署及测试验证,支持文本与 Markdown 格式,适用于告警播报等自动化场景。

本文针对非管理员用户(无企微后台权限),详细拆解从 Clawdbot 安装到企微机器人正常推送的全步骤,所有命令可直接复制,新手也能快速上手。
非企微管理员,仅能创建「企微群机器人」,实现 Clawdbot→企微群单向推送 (无法接收企微消息回复,适合通知、告警、播报场景);若为管理员,可进一步实现双向对话(文末附拓展方向)。
支持 Mac/Linux/Windows(本文以 Linux 为例),需联网且能访问公网(企微 Webhook 需外部请求),最好直接就是美西的机器。
Clawdbot(AI 机器人框架)、企微群机器人(Webhook)、Python 依赖(requests 库)。
Clawdbot 支持一键安装,全程在系统终端操作,无需复杂配置。
打开终端,复制以下命令执行(Mac/Linux 通用):
curl -fsSL https://clawd.bot/install.sh | bash

安装完成后,终端会自动进入初始化流程,按以下选项依次选择:
~/clawd),按回车确认。qwen-portal/coder-model(无需额外配置 API 密钥)。Skip for now(企微不在预设通道,后续自定义对接),按空格键勾选后回车。No(先打通推送,后续再配置技能),按空格键勾选后回车。Skip for now(无需钩子功能),按空格键勾选后回车。




在 TUI 界面按 Ctrl+C 退出,回到系统终端(后续修改配置、部署脚本需在此操作)。
无需管理员权限,仅需为企微内部群创建机器人,获取推送所需的 Webhook Key。
… → 找到 消息推送 → 点击 自定义消息推送。新建机器人,输入机器人名称(如 Clawdbot)、选择头像,点击 完成。https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=123456-abcdef-7890,Key 即为 123456-abcdef-7890),保存备用(后续需用到)。Clawdbot 需通过自定义技能脚本对接企微 Webhook,本文提供优化版脚本(支持配置文件存储 Key,兼顾安全与易用),直接复制部署即可。
终端执行以下命令,安装脚本所需的 requests 库:
pip install requests
不同安装方式的技能目录不同,先执行命令确认目录(终端执行):
# 查看技能目录是否存在
ls /usr/local/nodejs/lib/node_modules/clawdbot/skills/
若显示目录内容(如 bluebubbles、github 等技能文件),说明为系统级技能目录(本文默认此目录)

终端执行以下命令,一键在正确目录生成脚本(系统级目录为例):
import requests
import json
import os
from pathlib import Path
from clawdbot_skill import BaseSkill, register_skill
# 配置文件路径(存储企微 Key,自动创建)
CONFIG_PATH = Path.home() / ".clawdbot" / "wecom_config.json"
# 初始化配置文件(首次运行自动生成)
def init_config():
if not CONFIG_PATH.parent.exists():
CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
if not CONFIG_PATH.exists():
with open(CONFIG_PATH, "w", encoding="utf-8") as f:
json.dump({"webhook_key": ""}, f)
# 读取配置文件
def get_config():
init_config()
with open(CONFIG_PATH, "r", encoding="utf-8") as f:
return json.load(f)
# 写入配置文件(存储 Key)
def set_config(key: str, value: str):
config = get_config()
config[key] = value
with open(CONFIG_PATH, "w", encoding="utf-8") as f:
json.dump(config, f, indent=2)
# 技能 1:设置企微 Webhook Key(仅需执行一次)
@register_skill()
():
():
set_config(, webhook_key)
os.chmod(CONFIG_PATH, )
():
():
config = get_config()
webhook_key = config.get(, )
webhook_key:
url =
data = {: msg_type, msg_type: {: content}}
:
resp = requests.post(url, json=data, timeout=)
result = resp.json()
result[] == :
:
Exception e:
终端执行命令,确保脚本可被 Clawdbot 加载,同时重启生效:
# 给脚本加执行权限
sudo chmod 755 /usr/local/nodejs/lib/node_modules/clawdbot/skills/wecom_webhook.py
# 重启 Clawdbot,加载新技能
clawdbot restart
进入 Clawdbot TUI,执行简单命令即可测试推送,步骤如下:
终端执行命令,进入 TUI:
在 TUI 输入框执行命令,设置企微 Key(替换为第二步保存的 Key,仅需执行一次):
若提示 ✅ 企微 Key 已保存!,说明 Key 配置成功。也可以直接在 ~/.clawdbot/wecom_config.json 配置文件中配置好:
{
"webhook_key": "这里填你的企微群机器人 Webhook Key"
}

若提示 ✅ 推送成功!,同时企微群收到该消息,说明全流程打通。
企微群会显示带样式的消息。

(每天 9 点推送)。
本文通过「安装 Clawdbot→创建企微机器人→部署脚本→测试推送」四步,实现了 Clawdbot 到企微群的单向推送,全程无需复杂开发,命令可直接复制。适合办公场景中的自动化通知、告警、内容分发需求,非技术背景用户也能快速落地。
若需进阶功能(多群推送、定时任务、双向对话),可参考上述拓展方向。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online