What makes Weixinclaw Proactive Push notable?

965 downloads. Trust evidence available

How should Weixinclaw Proactive Push be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

Weixinclaw Proactive Push

通过 WorkBuddy 已连接的 ClawBot 微信 bot 通道（weixinClawBot / ilink bot，非微信客服号）主动向老板微信推送文本/图片/文件/视频。当用户要求"通过 ClawBot 主动推送/给老板发微信/微信主动推送测试/微信独立消息/发图片给老板/发文件给老板"时使用。协议严格对齐腾讯官方插件 @tencent-weixin/[email protected]（src/api + src/messaging + src/cdn）。 Skill: Weixinclaw Proactive Push Owner: noaheleven Summary: 通过 WorkBuddy 已连接的 ClawBot 微信 bot 通道（weixinClawBot / ilink bot，非微信客服号）主动向老板微信推送文本/图片/文件/视频。当用户要求"通过 ClawBot 主动推送/给老板发微信/微信主动推送测试/微信独立消息/发图片给老板/发文件给老板"时使用。协议严格对齐腾讯官方插件 @tencent-weixin/[email protected]（src/api + src/messaging + src/cdn）。 Tags: clawbot:1.0.3, latest:1.0.3, push:1.0.3, wechat:1.0.3, weixin:1.0.3 Version history: v1.0.3 | 2026-09-02T08:06:30.

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

965

Updated

Oct 12, 2026

Version

1.0.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 965 downloads reported by the source. Last updated 10/12/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 12, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 12, 2026
Adoption signal: 965 downloadsadoption · observed Oct 12, 2026
Latest release: 1.0.3release · observed Sep 2, 2026
Handshake status: UNKNOWNsecurity

What changed

Newest first. Only changes that point at a source are listed.

Release 1.0.3release
同步 weixinclaw-proactive-push 0.1.2：2026-08-28 微信通道实测修正（会话过期后文本/媒体均 ret:-2，协议内无自激活，唯一激活=用户发消息）。
Observed Sep 2, 2026 · source

Install and run

Setup complexity: low.

clawhub skill install s176ns2k88htgg2h6v9myyxg7x83q8k1:weixinclawbot

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-noaheleven-weixinclawbot/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

42,703 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: weixinclaw-proactive-push
description: 通过 WorkBuddy 已连接的 ClawBot 微信 bot 通道（weixinClawBot / ilink bot，非微信客服号）主动向老板微信推送文本/图片/文件/视频。当用户要求"通过 ClawBot 主动推送/给老板发微信/微信主动推送测试/微信独立消息/发图片给老板/发文件给老板"时使用。协议严格对齐腾讯官方插件 @tencent-weixin/[email protected]（src/api + src/messaging + src/cdn）。
---

> 📦 **本 skill 源码仓库**：https://github.com/NoahEleven/weixinclaw-proactive-push （公开，欢迎 clone / 提 Issue）
>
> 🔒 **隐私红线（务必遵守）**：本 skill 运行时**只读本机凭据、不写出任何密钥、日志不打印 token 明文**。
> 分享 / 备份 / 提交时，**严禁**携带以下文件（含 bot 完整凭证 / 老板微信 id）：
> - `~/.workbuddy/settings.json`（含完整 `botToken`、`userId`）
> - `~/.workbuddy/claw-state/weixin/`（cursor 游标内含 bot 凭证镜像 `get_updates_buf`）
> 本仓库**只含 `SKILL.md` + `send.js`**，接收方用自己的 `settings.json` 即可，无需你提供任何密钥。

# 微信(ClawBot)主动推送（weixinClawBot / ilink bot）

## 背景
WorkBuddy 迁移自 OpenClaw。微信主动推送能力其实**一直活着**，藏在
`~/.workbuddy/settings.json` 的 `claw/users/<uid>/channels/weixinClawBot` 里——
它是 ClawBot 的微信 bot 通道（ilink bot，polling 模式），对接 `https://ilinkai.weixin.qq.com`。

> ⚠️ **这不是微信客服号**：微信客服号走公众平台客服消息 API（48 小时会话限制），
> 而本通道是 WorkBuddy / ClawBot 内置的 bot 通道，走 ilink bot API，可随时主动推送，不受客服号限制。

协议实现**严格对齐腾讯官方插件 `@tencent-weixin/[email protected]`**
（npm 包，含 `src/api/api.ts`、`src/api/types.ts`、`src/messaging/*`、`src/cdn/*`）。
关键常量、请求头、item 结构、AES 加密、错误码检查均与官方保持一致。

> ⚠️ `openclaw-weixin-cli` 不需要装（那是 OpenClaw 的通道安装器，对 WorkBuddy 无用）。

## 何时用
- "通过 ClawBot 主动推一条消息给老板"（文本默认空 context_token，无需激活；详见下方机制专节）
- "微信主动推送测试""给老板发条微信 bot 消息"
- "发张图/发个文件/发段视频给老板"（context_token 自动读取，详见机制专节）
- 定时任务把结果主动推到老板微信（ClawBot bot 消息，非对话气泡）

## 怎么跑
脚本自动读 `settings.json` 取凭据与收件人，向老板微信发消息：

```bash
NODE="C:/Users/<USER>/.workbuddy/binaries/node/versions/22.22.2/node.exe"   # 将 <USER> 换成你的 Windows 用户名
SKILL="C:/Users/<USER>/.workbuddy/skills/weixinclaw-proactive-push/send.js"  # ⚠️ 必须指到 send.js；只传目录会 MODULE_NOT_FOUND（无 package.json main）

# 文本（默认空 context_token，无需激活；详见下方机制专节）
"$NODE" "$SKILL" "🦐 你的消息内容"

# 从文件读长文本
"$NODE" "$SKILL" --text-file 内容.txt

# 图片 + 可选说明（context_token 自动读取）
"$NODE" "$SKILL" --image 截图.png --caption "看这张图"

# 文件 + 文件名 + 可选说明（context_token 自动读取）
"$NODE" "$SKILL" --file 报告.pdf --name "周报.pdf" --caption "请查阅"

# 视频（context_token 自动读取）
"$NODE" "$SKILL" --video clip.mp4

# 显式指定 token（极端兜底：手动传入一个已知有效的 context_token）
"$NODE" "$SKILL" "回复内容" --context <context_token>
```

- 不传参数 → 发送默认测试文案（文本）。
- 跑的时候若因沙箱拦截网络，加 `dangerouslyDisableSandbox: true`（或在弹窗点允许）。
- 成功标志：终端打印 `[weixinclaw] OK`，老板微信里会收到一条 **ClawBot bot 消息**（不是对话气泡）。

## 凭据从哪来（settings.json）
```
claw/users/<uid>/channels/weixinClawBot = {
  "enabled": true,
  "channelId": "<你的 bot channelId，从你的 settings.json 读取>",
  "botToken":  "<完整 botToken 串，含 accountId: 前缀；脚本自动从你的 settings.json 读取，无需手填>",  // 完整 token = Bearer 凭据
  "baseUrl":   "https://ilinkai.weixin.qq.com",                                // apiBaseUrl
  "accountId": "<你的 bot accountId，从你的 settings.json 读取>",
  "userId":    "<老板的 im.wechat id = to_user_id；脚本自动从你的 settings.json 读取>",                       // 老板的 im.wechat id = to_user_id
  "connectionMode"

README.md

# weixinclaw-proactive-push

通过 WorkBuddy 已连接的 **ClawBot 微信 bot 通道**（`weixinClawBot` / ilink bot，**非微信客服号**）主动向老板微信推送 **文本 / 图片 / 文件 / 视频**。

协议严格对齐腾讯官方插件 `@tencent-weixin/[email protected]`（`src/api` + `src/messaging` + `src/cdn`）。

> 本 skill 源码即本仓库：clone 后放入 `~/.workbuddy/skills/weixinclaw-proactive-push/` 即可使用。

## 文件说明

| 文件 | 作用 |
|---|---|
| `SKILL.md` | 完整使用文档（通道原理、token 获取、推送、排错） |
| `send.js` | 推送主脚本：文本 / 图片 / 文件 / 视频 |

## 核心机制（2026-07-09 定稿）

| 推送类型 | `context_token` | 是否需要激活 |
|----------|------------------|--------------|
| **文本** | 默认**空串**，长期有效 | ❌ 不需要 |
| **媒体**（图片 / 文件 / 视频）| **必须**带 → 读 `claw-state/weixin/<ACCOUNT_ID>_im.bot.cursor.json` 的 `get_updates_buf`（原样，零变换） | 读不到 / 被拒才激活 |
| **任意类型被拒 `ret:-2`** | — | ✅ 都要激活（文本被拒通常是底层 bot id 轮换，同样需激活） |

- **文本免激活的原因**：空 `context_token` 对文本长期有效，因此闲置十几小时仍能推文字。
- **媒体必须带 token**：图片 / 文件 / 视频接口强制要求非空 `context_token`，从宿主刷新的 cursor 游标文件读取。
- **唯一需要激活的时刻 = 实际被拒（`ret:-2`）**：先到微信给 ClawBot 发一条任意消息激活，再重跑 `send.js` 自动读最新游标重发。

### 协议常量（官方 `@tencent-weixin/[email protected]`）

- `Authorization: Bearer <完整 botToken，含 accountId: 前缀>`
- 6 个请求头：`Content-Type`、`AuthorizationType: ilink_bot_token`、`X-WECHAT-UIN`、`Authorization`、`iLink-App-Id: bot`、`iLink-App-ClientVersion: 132102`
- `base_info`：`{ channel_version: "2.4.6", bot_agent: "OpenClaw" }`
- 发送接口：`POST {baseUrl}/ilink/bot/sendmessage`，`baseUrl = https://ilinkai.weixin.qq.com`

### 🔴 隐私红线

- `claw-state/weixin/<ACCOUNT_ID>_im.bot.cursor.json` 内含 bot 凭证镜像，**禁止随仓库提交 / 分享**。
- 本 skill 仅**只读**本机凭据（从 `settings.json` 与本地 cursor 文件读取），不向任何文件写入密钥。
- 日志只打印 token 长度，绝不打印明文。

## 快速开始

```bash
# 0. 依赖：Node 18+（推荐 WorkBuddy managed node 22）
# 1. 确保 settings.json 已配置 weixinClawBot 通道（凭据自动读取，无需手填）

# 2. 推送文本（context_token 默认空，免激活）
node send.js "你好，老板 🦐"

# 3. 推送图片 / 文件 / 视频（自动读 cursor 游标当 context_token）
node send.js --image ./pic.png
node send.js --file  ./report.pdf
node send.js --video ./clip.mp4

# 4. 显式覆盖 context_token（一般情况不需要）
node send.js "文本" --context "<token>"
```

详见 `SKILL.md`。

_meta.json

{
  "ownerId": "kn769gn5we5rgv7bfhb9ztd8j983p8qc",
  "slug": "weixinclawbot",
  "version": "1.0.3",
  "publishedAt": 1788336390275
}

skill-card.md

## Description:

Sends proactive text, image, file, and video messages through a locally configured WorkBuddy ClawBot WeChat bot channel.

This skill is ready for commercial/non-commercial use.

## Publisher:

[noaheleven](https://clawhub.ai/user/noaheleven)

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agent operators use this skill when an agent needs to send proactive WeChat notifications or media to a configured recipient through the user's local WorkBuddy ClawBot account.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill can send real WeChat messages and files through the user's local WorkBuddy ClawBot account.

Mitigation: Use it only for intentional outbound notifications to the configured recipient, and add an explicit confirmation step before routine or automated sends.

Risk: Local bot tokens, cursor files, context tokens, message contents, and recipient IDs are sensitive.

Mitigation: Keep settings and cursor files local, avoid sharing them, and redact recipient identifiers and token-derived values from logs or transcripts.

Risk: Credentials could be sent to an unexpected endpoint if local configuration is altered.

Mitigation: Verify that ~/.workbuddy/settings.json uses the official Weixin iLink base URL before running the skill.

Risk: Broad sandbox bypasses increase the chance of unintended network access.

Mitigation: Avoid disabling sandboxing broadly; grant only the network access needed for the intended WeChat send workflow.

## Reference(s):

- [ClawHub skill page](https://clawhub.ai/noaheleven/skills/weixinclawbot)
- [Publisher profile](https://clawhub.ai/user/noaheleven)
- [Weixin iLink endpoint](https://ilinkai.weixin.qq.com)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Plain text or Markdown guidance with shell commands; runtime sends WeChat bot text or media messages]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Can send text, images, files, or videos using local WorkBuddy ClawBot credentials.]

## Skill Version(s):

1.0.3 (source: ClawHub release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 3d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW

Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular