从零搭建Clawdbot+企微机器人：单向推送全流程指南（新手可玩）
从零搭建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库：
pip install requests 2. 确认Clawdbot技能目录
不同安装方式的技能目录不同，先执行命令确认目录（终端执行）：
# 查看技能目录是否存在 ls /usr/local/nodejs/lib/node_modules/clawdbot/skills/ 若显示目录内容（如bluebubbles、github等技能文件），说明为系统级技能目录（本文默认此目录）
3. 部署技能脚本
终端执行以下命令，一键在正确目录生成脚本（系统级目录为例）：
sudo cat > /usr/local/nodejs/lib/node_modules/clawdbot/skills/wecom_webhook.py << 'EOF'import requestsimport jsonimport osfrom pathlib import Pathfrom 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", "") if not webhook_key: return "❌ 请先设置Key：run wecom_set_key webhook_key='你的Key'" # 拼接企微Webhook地址 url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={webhook_key}" # 构造消息体（支持文本/Markdown） data = {"msgtype": msg_type, msg_type: {"content": content}} try: # 发送请求 resp = requests.post(url, json=data, timeout=10) result = resp.json() if result["errcode"] == 0: return f"✅ 推送成功！" else: return f"❌ 推送失败：{result['errmsg']}（错误码：{result['errcode']}）" except Exception as e: return f"❌ 网络/未知错误：{str(e)}"EOF 4. 给脚本加权限+重启Clawdbot
终端执行命令，确保脚本可被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→企微群”
若提示 ✅ 推送成功！，同时企微群收到该消息，说明全流程打通。
* * - 进阶测试（Markdown格式，支持加粗、标题、列表）：
- 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到企微群的单向推送，全程无需复杂开发，命令可直接复制。适合办公场景中的自动化通知、告警、内容分发需求，非技术背景用户也能快速落地。
若需进阶功能（多群推送、定时任务、双向对话），可留言说明需求，后续将针对性补充教程。动手试试，让AI机器人帮你解放双手吧！
第三方的白嫖地址我收集了几个，各位自行取用：
UniVibe：https://www.univibe.cc/console/auth?type=register&invite=MB8LFU
XXAPI： https://api.gemai.cc/register?aff=X1PG
GLM Coding ：https://www.bigmodel.cn/glm-coding?ic=A9HPQXTXSF
