从零搭建 Clawdbot 与企业微信机器人实现单向推送全流程指南
介绍非管理员用户如何从零搭建 Clawdbot 并对接企业微信群机器人,实现单向消息推送。流程涵盖环境安装、机器人创建、技能脚本部署及测试验证,支持文本与 Markdown 格式,适用于通知告警场景。

介绍非管理员用户如何从零搭建 Clawdbot 并对接企业微信群机器人,实现单向消息推送。流程涵盖环境安装、机器人创建、技能脚本部署及测试验证,支持文本与 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 等技能文件),说明为系统级技能目录(本文默认此目录)。

终端执行以下命令,一键在正确目录生成脚本(系统级目录为例):
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)
# 技能 1:设置企微 Webhook Key(仅需执行一次)
@register_skill(name="wecom_set_key", description="Set WeCom webhook key (only once)")
class WeComSetKeySkill(BaseSkill):
def run(self, webhook_key: str):
set_config("webhook_key", webhook_key) # 自动设置安全权限(仅当前用户可读)
os.chmod(CONFIG_PATH, 0o600)
return f"✅ 企微 Key 已保存!(已自动开启安全权限)"
# 技能 2:发送消息到企微群(核心功能)
@register_skill(name="wecom_send", description="Send message to WeCom group (text/markdown)")
class WeComWebhookSkill(BaseSkill):
def run(self, content: str, msg_type: str = "text"):
# 读取已保存的 Key
config = get_config()
webhook_key = config.get("webhook_key", "")
not webhook_key:
url = f
data = {: msg_type, msg_type: {: content}}
try:
resp = requests.post(url, json=data, =10)
result = resp.json()
result[] == 0:
f
:
f
except Exception as e:
f
EOF
终端执行命令,确保脚本可被 Clawdbot 加载,同时重启生效:
# 给脚本加执行权限
sudo chmod 755 /usr/local/nodejs/lib/node_modules/clawdbot/skills/wecom_webhook.py
# 重启 Clawdbot,加载新技能
clawdbot restart
进入 Clawdbot TUI,执行简单命令即可测试推送,步骤如下:
终端执行命令,进入 TUI:
clawdbot tui在 TUI 输入框执行命令,设置企微 Key(替换为第二步保存的 Key,仅需执行一次):
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"企微群会显示带样式的消息。

定时推送 :结合 Clawdbot 定时技能,实现每日日报、定时告警,命令示例:
run schedule add --cron "0 9 * * *" --command "run wecom_send content='每日早报:今日工作安排'"
(每天 9 点推送)。多群推送 :修改脚本支持多 Key 配置,实现同时推送到多个企微群。
双向对话 :若为企微管理员,可创建自建应用,用 Webhook+ 事件订阅实现企微消息回调到 Clawdbot,支持双向交互。
本文通过「安装 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