Qclaw Workbuddy Bridge
QClaw 与 WorkBuddy 任务分发集成桥。当用户想要: - 通过微信让 QClaw 发送任务给 WorkBuddy 执行 - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果 - 打通 QClaw(微信入口)和 WorkBuddy(执行引擎) - 远程任务分发、跨客户端任务执行 触发词... Skill: Qclaw Workbuddy Bridge Owner: liuboacean Summary: QClaw 与 WorkBuddy 任务分发集成桥。当用户想要: - 通过微信让 QClaw 发送任务给 WorkBuddy 执行 - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果 - 打通 QClaw(微信入口)和 WorkBuddy(执行引擎) - 远程任务分发、跨客户端任务执行 触发词... Tags: latest:1.2.0 Version history: v1.2.0 | 2026-04-15T02:32:58.509Z | user v1.2.0: watch --once支持launchd事件驱动,WorkBuddy自动化已停用,完全无轮询零Token v1.1.0 | 2026-04-15T02:15:16.116Z | user v1.1.0: 触发机制优化——add命令自
Rank
62
Safety
84
Downloads
962
Updated
Oct 12, 2026
Version
1.2.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 962 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
- 962 downloadsadoption · observed Oct 12, 2026
- Latest release
- 1.2.0release · observed Apr 15, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 1.2.0release
v1.2.0: watch --once支持launchd事件驱动,WorkBuddy自动化已停用,完全无轮询零Token
Observed Apr 15, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s1779brgcyhkdmz9tgjpwarx3h84vb82:qclaw-workbuddy-bridge- 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-liuboacean-qclaw-workbuddy-bridge/snapshot"
Run-check
$0.02 USD1 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
19,036 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: qclaw-workbuddy-bridge
description: |
QClaw 与 WorkBuddy 任务分发集成桥。当用户想要:
- 通过微信让 QClaw 发送任务给 WorkBuddy 执行
- QClaw 写任务 → WorkBuddy 执行 → 微信推送结果
- 打通 QClaw(微信入口)和 WorkBuddy(执行引擎)
- 远程任务分发、跨客户端任务执行
触发词:QClaw发任务、微信转WorkBuddy、QClaw工作流、远程任务、任务分发
version: 1.0.0
---
# QClaw ↔ WorkBuddy 任务分发桥
通过共享 JSON 队列文件,实现 QClaw(微信入口)和 WorkBuddy(执行引擎)的双向打通。
## 架构概览
```
微信消息
↓
QClaw(解析意图) → 写入任务到队列文件
↓
WorkBuddy(自动化轮询) → 读取任务 → 执行 → 写回结果
↓
QClaw(读取结果) → 微信推送回复给用户
```
- **队列文件**: `~/.workbuddy/queue/qclaw_tasks.json`
- **队列管理器**: `~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py`
- **轮询方式**: WorkBuddy 自动化(recurring)定期检查队列
---
## 第一步:安装与初始化
### 1.1 验证依赖
```bash
# 确认 Python 3 已安装
python3 --version
# 确认队列目录存在
ls ~/.workbuddy/queue/
# 首次运行会自动创建
```
### 1.2 初始化队列文件
```bash
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list
```
---
## 第二步:在 QClaw 侧配置
QClaw 通过对话解析用户意图,将需要 WorkBuddy 执行的任务写入队列。
### QClaw 提示词配置(发送给 QClaw)
在 QClaw 的自定义提示词或系统提示中加入以下规则:
```
---
你有一个新的能力:当用户请求的任务需要:
- 生成长文档、报告、PPT、Excel
- 深度数据分析或研究
- 需要访问本地文件的复杂操作
- 定时自动化任务
- 批量文件处理
你应主动将任务写入队列文件,格式如下:
任务分发触发条件(满足任一即写入):
1. 用户说"帮我生成/制作/分析/整理..."
2. 涉及文件创建、数据处理、多步骤操作
3. 用户说"远程执行"、"交给 WorkBuddy"、"你做不到的事"
写入命令:
```bash
python3 ~/.workbuddy/queue/qclaw_tasks.py add "任务描述"
```
如果任务复杂,先简要总结(100字内),再写入队列。
队列文件路径:~/.workbuddy/queue/qclaw_tasks.json
队列管理脚本:~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py
```
### 快速手动测试(QClaw 侧)
```bash
# 添加一个测试任务
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add "帮我查一下今天的天气并生成出行建议"
# 查看队列
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list
# 只看待处理任务
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending
```
---
## 第三步:在 WorkBuddy 侧配置自动化
### 3.1 创建轮询自动化
在 WorkBuddy 中创建定时自动化:
- **名称**: `qclaw-bridge-poll`
- **触发频率**: 每 5 分钟一次(FREQ=MINUTELY;INTERVAL=5)
- **执行内容**: 见下方自动化脚本
### 3.2 自动化执行脚本
创建自动化时,在 prompt 中填入:
```
检查任务队列 ~/.workbuddy/queue/qclaw_tasks.json 中是否有 status="pending" 的任务。
如果有,按以下步骤处理:
1. 先运行:
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py poll --once
2. 读取返回的 JSON 任务内容,提取 input.description 作为任务描述
3. 自主执行任务(调用所有需要的工具、Skill 完成工作)
4. 任务完成后,将结果写入队列:
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py done <task_id> - << 'EOF'
{"summary": "一句话结果描述", "details": "详细说明", "files": ["文件路径列表"]}
EOF
5. 如果执行失败:
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py error <task_id> "失败原因"
如果队列为空,不做任何操作,直接退出。
```
---
## 第四步:QClaw 读取结果并推送
### 自动化推送脚本(WorkBuddy 端)
任务完成后,WorkBuddy 可以主动将结果写入一个结果文件:
```bash
# 在 WorkBuddy 自动化中,完成任务后调用:
python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py result <task_id>
```
### QClaw 读取结果(轮询模式)
QClaw 可以设置一个定期检查结果的逻辑:
```
定期检查结果:
每 5 分钟检查一次 ~/.workbuddy/queue/qclaw_tasks.json
找出所有 status="done" 且尚未推送的任务
将 result.summary 通过微信消息发送给用户
然后将任_meta.json
{
"ownerId": "kn73qbrbqs4s8t2nh8pm22wxbd84vm7r",
"slug": "qclaw-workbuddy-bridge",
"version": "1.2.0",
"publishedAt": 1776220378509
}skill-card.md
## Description: Qclaw Workbuddy Bridge connects QClaw or WeChat-originated requests to WorkBuddy execution through a local JSON task queue. This skill is ready for commercial/non-commercial use. ## Publisher: [liuboacean](https://clawhub.ai/user/liuboacean) ### License/Terms of Use: MIT-0 ## Use Case: Developers and operators use this skill to configure QClaw to enqueue remote tasks and WorkBuddy to pick up, execute, and report results through a shared local queue. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Broad QClaw or WeChat requests can be forwarded into autonomous WorkBuddy execution through the shared queue. Mitigation: Narrow dispatch triggers and require explicit confirmation before file access or other side-effecting work. Risk: The persistent local queue can contain sensitive personal, business, or task context data. Mitigation: Avoid placing secrets or sensitive data in the queue and enforce owner-only permissions on queue files. Risk: A shared JSON queue has weak coordination controls for concurrent readers and writers. Mitigation: Add file locking or replace the JSON queue with SQLite for stronger consistency. Risk: WorkBuddy may execute queued tasks with more local access than intended. Mitigation: Run WorkBuddy in a sandboxed, low-privilege environment. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge) - [Skill Definition](artifact/SKILL.md) - [Queue Manager Script](artifact/scripts/qclaw_queue.py) ## Skill Output: **Output Type(s):** [text, markdown, shell commands, configuration, JSON, guidance] **Output Format:** [Markdown guidance with shell commands and JSON task records] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces local queue operations for adding, polling, completing, failing, and reading tasks.] ## Skill Version(s): 1.2.0 (source: server release evidence and target metadata; artifact frontmatter says 1.0.0) ## 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.
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!
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge",
"sourceUrl": "https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T01:16:49.014Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T01:16:49.014Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "962 downloads",
"href": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceUrl": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T01:16:49.014Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.2.0",
"href": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceUrl": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-15T02:32:58.509Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.2.0",
"description": "v1.2.0: watch --once支持launchd事件驱动,WorkBuddy自动化已停用,完全无轮询零Token",
"href": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceUrl": "https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-15T02:32:58.509Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/run-check
