WeChat Work Notifier

微信（WeChat Work / 企业微信）消息通知 Skill。 通过企业微信群机器人的 Webhook 接口向微信群/微信用户发送消息通知。 支持：文本消息、Markdown、卡片消息、图片。 适用场景：定时报告、报警通知、交易信号推送、自动化工作流通知。

Security Scan

The skill appears to implement a straightforward WeChat Work webhook notifier, but its metadata omits the required WECHAT_WEBHOOK_URL environment variable which is needed to operate — this mismatch is a coherence issue you should review before installing.

Purpose & Capability

Name/description match the code and instructions: the package sends messages to WeChat Work group webhooks (text, markdown, card, image). However the registry metadata lists no required environment variables or primary credential, while the SKILL.md and code clearly expect a WECHAT_WEBHOOK_URL — this is an inconsistency in declared requirements.

Instruction Scope

SKILL.md instructions and the code are narrowly scoped to constructing webhook payloads and POSTing them to the provided qyapi.weixin.qq.com webhook URL. The instructions only reference installing requests and setting WECHAT_WEBHOOK_URL; they do not ask the agent to read unrelated files, other env vars, or forward data to unexpected endpoints.

Install Mechanism

No install spec provided (instruction-only), and the included setup script only runs 'pip install requests' if missing. There are no downloads from third‑party URLs, no archive extraction, and no creation of non-standard system binaries.

Credentials

The skill requires a sensitive secret-like value (WECHAT_WEBHOOK_URL) to post messages, but the registry metadata did not declare any required env vars or primary credential. This mismatch could cause users to overlook the need to provide the webhook URL or to misunderstand what secrets the skill needs. Otherwise, the only environment access the code uses is the single webhook URL.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system-wide configuration, and does not persist credentials beyond reading WECHAT_WEBHOOK_URL from the environment. Autonomous invocation is enabled by default but is not combined with elevated privileges here.

What to consider before installing

This skill's functionality is coherent with its description (it POSTs messages to a WeChat Work webhook), but the package metadata omitted the required WECHAT_WEBHOOK_URL environment variable. Before installing: (1) verify you have a valid webhook URL and set it only in a secure place (do not commit to git); (2) review the included wechat_notify.py (it only posts to the webhook URL and uses requests); (3) understand that any holder of the webhook URL can post messages to your group — treat it like a secret and rotate it if exposed; (4) run the code in a trusted environment and inspect network traffic if you want to confirm it only contacts qyapi.weixin.qq.com. If you maintain the registry entry, update the metadata to declare WECHAT_WEBHOOK_URL as a required credential to remove the inconsistency.

WeChat Work 消息通知

通过企业微信 Webhook 向微信群/用户发送消息

支持功能

• ✅ 文本消息
• ✅ Markdown 消息（企业微信格式）
• ✅ 图文卡片消息
• ✅ 定时推送（结合 OpenClaw Cron）
• ✅ 多群/多用户推送

环境要求

• 企业微信账号（需开通「群机器人」功能）
• Python 3.10+
• requests 库（pip install requests）

快速安装

clawhub install wechat-notify

配置

Step 1：获取 Webhook 地址

1. 打开企业微信 PC 版
2. 进入任意群聊 → 点击右上角「群机器人」→「添加机器人」
3. 复制生成的 Webhook URL，格式如：

   https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXXXXXXX-XX
   

Step 2：配置环境变量

export WECHAT_WEBHOOK_URL="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"

或在 .env 文件中：

WECHAT_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY

使用方法

Python API

import sys
sys.path.insert(0, "/home/user/.openclaw/workspace")

from skills.wechat_notify import WeChatNotifier

# 初始化（默认使用 WECHAT_WEBHOOK_URL 环境变量）
notifier = WeChatNotifier()

# ─── 发送文本消息 ───────────────────────────
notifier.send_text("BTC 价格跌破 60000，建议关注！")

# ─── 发送 Markdown（企业微信格式）────────────
notifier.send_markdown("""
## 📊 交易信号报告

**BTC/USDT**: 买入信号
- RSI: 32（超卖）
- MACD: 金叉

> 时间：2026-03-25 17:30
""")

# ─── 发送图文卡片 ───────────────────────────
notifier.send_news(
    title="交易信号提醒",
    description="BTC 出现买入信号",
    url="https://www.binance.com",
    picurl="https://example.com/btc.png"
)

# ─── 多个 Webhook（多群推送）─────────────────
notifier2 = WeChatNotifier(
    webhook_url="https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YYY"
)
notifier2.send_text("通知到第二个群")

命令行

# 发送文本
python -m skills.wechat_notify --text "测试消息"

# 发送 Markdown
python -m skills.wechat_notify --markdown "**粗体** 和 _斜体_"

# 发送图文
python -m skills.wechat_notify --news "标题" "描述" "URL" "图片URL"

配合 Cron 定时推送

from skills.wechat_notify import WeChatNotifier
from datetime import datetime

notifier = WeChatNotifier()

def send_daily_report():
    notifier.send_markdown(f"""
## 📅 每日报告 - {datetime.now().strftime('%Y-%m-%d')}
- 系统运行正常
- 策略收益：+2.3%
    """)

# 在 OpenClaw Cron 中设置定时任务

故障排除

问题	解决方法
40014 错误	Webhook URL 不正确或已失效，重新获取
40003 错误	指定的用户/群不存在，检查 key
消息发送成功但群里看不到	检查企业微信版本是否支持群机器人
curl 失败	确认网络能访问 qyapi.weixin.qq.com

安全提示

• Webhook URL 不要提交到 Git（包含 key）
• 每个群的 Webhook 只在该群有效
• Webhook 可以@群里所有人

Webhook 限制

• 每个 webhook 每分钟最多发送 20 条消息
• 消息内容大小限制：Markdown 不超过 2048 字节
• 建议结合 OpenClaw Cron 使用时，最小间隔 3 分钟以上