Push-Server WeCom Notification for Openclaw

A Python-powered notification agent that sends rich-media alerts to WeCom users through the Push Server OpenAPI.

es-v
v1.0.0
Mar 12, 2026
0
827
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install push-server-py

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install push-server-py using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Push-Server WeCom Notification?

Push-Server WeCom Notification is a specialized tool designed to bridge the gap between automated systems and Enterprise WeChat (WeCom) users. By utilizing the Push Server OpenAPI, this skill allows for the delivery of critical updates in various formats including plain text, rich markdown, interactive text cards, and news articles. It is an essential component for developers using Openclaw Skills who need to maintain high visibility into system statuses or team updates directly within their communication platform.

Push-Server WeCom Notification Use Cases

  • Automating server health alerts and performance monitoring notifications.
  • Delivering automated weekly or monthly business reports using interactive cards.
  • Sending real-time CI/CD pipeline status updates to development teams.
  • Distributing internal news and company announcements with rich-media support.

How Push-Server WeCom Notification Works

  1. The user or agent triggers the skill by passing a JSON payload containing message details and target recipients.
  2. The skill validates the required QYWX_PUSH_API_KEY and QYWX_PUSH_URL environment variables.
  3. A Python script processes the input to determine the message type (TEXT, MARKDOWN, TEXT_CARD, or NEWS).
  4. The agent executes an HTTP request to the Push Server OpenAPI endpoint with the formatted payload.
  5. The system returns a success or error response indicating whether the WeCom notification was delivered correctly.

Push-Server WeCom Notification Setup

To integrate this skill with Openclaw Skills, configure your openclaw.json as follows:

"skills": {
  "entries": {
    "push-server-py": {
      "apiKey": "your-api-key-here",
      "env": {
        "QYWX_PUSH_URL": "https://push.wechat.com"
      }
    }
  }
}

Ensure Python 3 is installed in your environment. You can test the notification via the CLI:

python3 {baseDir}/notify.py '{"toUser":"user1","content":"Test Message","msgType":"TEXT"}'

Push-Server WeCom Notification Data Schema & Taxonomy

The skill processes JSON-based requests and returns standardized status objects.

Request Parameters

Parameter Type Required Description
toUser string Yes Pipe-separated user IDs (e.g., user1
msgType string No One of: TEXT, MARKDOWN, TEXT_CARD, NEWS
content string Conditional Required for TEXT and MARKDOWN types
articles list Conditional Required for NEWS type articles

Response Format

Key Type Description
success boolean Indicates if the push was successful
message string Status message or error description
errCode integer API error code (0 for success)

Push-Server WeCom Notification Advanced Features

  • Multi-format support for rich information density including Markdown and News styles.
  • Flexible user targeting using pipe-separated strings for group notifications.
  • Interactive call-to-action buttons within TEXT_CARD message types.
  • Easy integration with other Openclaw Skills for end-to-end automation workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins python3
Github Stars: 0
forks: 0

Featured*