从零搭建 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. 部署技能脚本

终端执行以下命令，一键在正确目录生成脚本（系统级目录为例）：

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", "")
        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)}"

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 到企微群的单向推送，全程无需复杂开发，命令可直接复制。适合办公场景中的自动化通知、告警、内容分发需求，非技术背景用户也能快速落地。

若需进阶功能（多群推送、定时任务、双向对话），可参考上述拓展方向。