Clawdbot 对接企业微信机器人单向推送全流程指南
介绍如何在无企微后台权限下,通过 Clawdbot 框架实现向企业微信群单向推送消息。流程涵盖环境准备、Clawdbot 安装初始化、自定义 Python 技能脚本部署及 Webhook 配置。最终验证文本与 Markdown 格式消息推送成功,适用于通知告警场景。

介绍如何在无企微后台权限下,通过 Clawdbot 框架实现向企业微信群单向推送消息。流程涵盖环境准备、Clawdbot 安装初始化、自定义 Python 技能脚本部署及 Webhook 配置。最终验证文本与 Markdown 格式消息推送成功,适用于通知告警场景。

非企微管理员,仅能创建「企微群机器人」,实现 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 退出,回到系统终端(后续修改配置、部署脚本需在此操作)。
Clawdbot 需通过自定义技能脚本对接企微 Webhook,本文提供优化版脚本(支持配置文件存储 Key,兼顾安全与易用),直接复制部署即可。
终端执行以下命令,安装脚本所需的 requests 库:
pip install requests
不同安装方式的技能目录不同,先执行命令确认目录(终端执行):
ls /usr/local/nodejs/lib/node_modules/clawdbot/skills/
若显示目录内容(如 bluebubbles、github 等技能文件),说明为系统级技能目录(本文默认此目录)。

终端执行以下命令,一键在正确目录生成脚本(系统级目录为例):
sudo cat > /usr/local/nodejs/lib/node_modules/clawdbot/skills/wecom_webhook.py << 'EOF'
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)
():
():
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:
EOF
终端执行命令,确保脚本可被 Clawdbot 加载,同时重启生效:
# 给脚本加执行权限
sudo chmod 755 /usr/local/nodejs/lib/node_modules/clawdbot/skills/wecom_webhook.py
# 重启 Clawdbot,加载新技能
clawdbot restart
进入 Clawdbot TUI,执行简单命令即可测试推送,步骤如下:
clawdbot tui
run wecom_set_key webhook_key="你的企微机器人 Key"
若提示 ✅ 企微 Key 已保存!,说明 Key 配置成功。也可以直接在 ~/.clawdbot/wecom_config.json 配置文件中配置好:
{
"webhook_key": "这里填你的企微群机器人 Webhook Key"
}
run wecom_send content="终于能推送啦!Clawdbot→企微群"
若提示 ✅ 推送成功!,同时企微群收到该消息,说明全流程打通。run wecom_send content="### 🚀 Clawdbot 推送通知\n**核心功能**:\n- 文本消息推送\n- Markdown 格式支持\n> 新手也能轻松上手" msg_type="markdown"
企微群会显示带样式的消息。

run schedule add --cron "0 9 * * *" --command "run wecom_send content='每日早报:今日工作安排'"
(每天 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