从零搭建 Clawdbot 对接企业微信机器人单向推送指南

若显示目录内容（如 bluebubbles、github 等技能文件），说明为系统级技能目录（本文默认此目录）。

3. 部署技能脚本

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

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"):
        config = get_config()
        webhook_key = config.get("webhook_key", "")
        if not webhook_key:
            return "❌ 请先设置 Key：run wecom_set_key webhook_key='你的 Key'"
        url = f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key={webhook_key}"
        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，执行简单命令即可测试推送，步骤如下：

1. 终端执行命令，进入 TUI：

   clawdbot tui
   

2. 在 TUI 输入框执行命令，设置企微 Key（替换为第二步保存的 Key，仅需执行一次）：

   run wecom_set_key webhook_key="你的企微机器人 Key"
   

   若提示 ✅ 企微 Key 已保存！，说明 Key 配置成功。也可以直接在 ~/.clawdbot/wecom_config.json 配置文件中配置好：

   {
       "webhook_key": "这里填你的企微群机器人 Webhook Key"
   }
   

3. 发送测试消息（文本格式）：

   run wecom_send content="终于能推送啦！Clawdbot→企微群"
   

   若提示 ✅ 推送成功！，同时企微群收到该消息，说明全流程打通。
4. 进阶测试（Markdown 格式，支持加粗、标题、列表）：

   run wecom_send content="### 🚀 Clawdbot 推送通知\n**核心功能**：\n- 文本消息推送\n- Markdown 格式支持\n> 新手也能轻松上手" msg_type="markdown"
   

   企微群会显示带样式的消息。

六、进阶拓展方向

1. 定时推送：结合 Clawdbot 定时技能，实现每日日报、定时告警，命令示例：

   run schedule add --cron "0 9 * * *" --command "run wecom_send content='每日早报：今日工作安排'"
   

   （每天 9 点推送）。
2. 多群推送：修改脚本支持多 Key 配置，实现同时推送到多个企微群。
3. 双向对话：若为企微管理员，可创建自建应用，用 Webhook+ 事件订阅实现企微消息回调到 Clawdbot，支持双向交互。

七、总结

本文通过「安装 Clawdbot→创建企微机器人→部署脚本→测试推送」四步，实现了 Clawdbot 到企微群的单向推送，全程无需复杂开发，命令可直接复制。适合办公场景中的自动化通知、告警、内容分发需求。