{"id":"bdb33186-07ae-4869-a57a-bc373839681b","entityType":"agent","slug":"clawhub-liuboacean-qclaw-workbuddy-bridge","name":"Qclaw Workbuddy Bridge","canonicalUrl":"https://www.xpersona.co/agent/clawhub-liuboacean-qclaw-workbuddy-bridge","canonicalPath":"/agent/clawhub-liuboacean-qclaw-workbuddy-bridge","generatedAt":"2026-10-12T14:25:16.933Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":null},"description":"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命令自","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 962 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s1779brgcyhkdmz9tgjpwarx3h84vb82:qclaw-workbuddy-bridge","sourceUrl":"https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge","homepage":"https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/liuboacean/qclaw-workbuddy-bridge","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"QClaw 与 WorkBuddy 任务分发集成桥。当用户想要： - 通过微信让 QClaw 发送任务给 WorkBuddy 执行 - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果 - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎） - 远程任务分发、跨客户端任务执行 触发词..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":null},"stars":null,"forks":null,"downloads":962,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.2.0","tractionLabel":"962 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T01:16:48.946Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T01:16:49.014Z","lastCrawledAt":"2026-10-12T01:16:48.946Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T01:16:48.946Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.0","createdAt":"2026-04-15T02:32:58.509Z","changelog":"v1.2.0: watch --once支持launchd事件驱动，WorkBuddy自动化已停用，完全无轮询零Token","fileCount":4,"zipByteSize":8166},{"version":"1.1.0","createdAt":"2026-04-15T02:15:16.116Z","changelog":"v1.1.0: 触发机制优化——add命令自动写.trigger信号，自动化改为30分钟兜底轮询，大幅节省Token","fileCount":3,"zipByteSize":6683},{"version":"1.0.0","createdAt":"2026-04-15T01:40:25.484Z","changelog":"初始版本：QClaw与WorkBuddy双向任务管道核心，支持队列管理、轮询自动化、结果写入","fileCount":3,"zipByteSize":6217}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1779brgcyhkdmz9tgjpwarx3h84vb82:qclaw-workbuddy-bridge","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T14:25:16.933Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-liuboacean-qclaw-workbuddy-bridge/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":null},"readme":"Skill: Qclaw Workbuddy Bridge\n\nOwner: liuboacean\n\nSummary: QClaw 与 WorkBuddy 任务分发集成桥。当用户想要： - 通过微信让 QClaw 发送任务给 WorkBuddy 执行 - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果 - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎） - 远程任务分发、跨客户端任务执行 触发词...\n\nTags: latest:1.2.0\n\nVersion history:\n\nv1.2.0 | 2026-04-15T02:32:58.509Z | user\n\nv1.2.0: watch --once支持launchd事件驱动，WorkBuddy自动化已停用，完全无轮询零Token\n\nv1.1.0 | 2026-04-15T02:15:16.116Z | user\n\nv1.1.0: 触发机制优化——add命令自动写.trigger信号，自动化改为30分钟兜底轮询，大幅节省Token\n\nv1.0.0 | 2026-04-15T01:40:25.484Z | user\n\n初始版本：QClaw与WorkBuddy双向任务管道核心，支持队列管理、轮询自动化、结果写入\n\nArchive index:\n\nArchive v1.2.0: 4 files, 8166 bytes\n\nFiles: scripts/qclaw_queue.py (11378b), skill-card.md (2279b), SKILL.md (7773b), _meta.json (141b)\n\nFile v1.2.0:SKILL.md\n\n---\nname: qclaw-workbuddy-bridge\ndescription: |\n  QClaw 与 WorkBuddy 任务分发集成桥。当用户想要：\n  - 通过微信让 QClaw 发送任务给 WorkBuddy 执行\n  - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果\n  - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎）\n  - 远程任务分发、跨客户端任务执行\n  触发词：QClaw发任务、微信转WorkBuddy、QClaw工作流、远程任务、任务分发\nversion: 1.0.0\n---\n\n# QClaw ↔ WorkBuddy 任务分发桥\n\n通过共享 JSON 队列文件，实现 QClaw（微信入口）和 WorkBuddy（执行引擎）的双向打通。\n\n## 架构概览\n\n```\n微信消息\n    ↓\nQClaw（解析意图） → 写入任务到队列文件\n    ↓\nWorkBuddy（自动化轮询） → 读取任务 → 执行 → 写回结果\n    ↓\nQClaw（读取结果） → 微信推送回复给用户\n```\n\n- **队列文件**: `~/.workbuddy/queue/qclaw_tasks.json`\n- **队列管理器**: `~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py`\n- **轮询方式**: WorkBuddy 自动化（recurring）定期检查队列\n\n---\n\n## 第一步：安装与初始化\n\n### 1.1 验证依赖\n\n```bash\n# 确认 Python 3 已安装\npython3 --version\n\n# 确认队列目录存在\nls ~/.workbuddy/queue/\n# 首次运行会自动创建\n```\n\n### 1.2 初始化队列文件\n\n```bash\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n```\n\n---\n\n## 第二步：在 QClaw 侧配置\n\nQClaw 通过对话解析用户意图，将需要 WorkBuddy 执行的任务写入队列。\n\n### QClaw 提示词配置（发送给 QClaw）\n\n在 QClaw 的自定义提示词或系统提示中加入以下规则：\n\n```\n---\n你有一个新的能力：当用户请求的任务需要：\n- 生成长文档、报告、PPT、Excel\n- 深度数据分析或研究\n- 需要访问本地文件的复杂操作\n- 定时自动化任务\n- 批量文件处理\n\n你应主动将任务写入队列文件，格式如下：\n\n任务分发触发条件（满足任一即写入）：\n1. 用户说\"帮我生成/制作/分析/整理...\"\n2. 涉及文件创建、数据处理、多步骤操作\n3. 用户说\"远程执行\"、\"交给 WorkBuddy\"、\"你做不到的事\"\n\n写入命令：\n```bash\npython3 ~/.workbuddy/queue/qclaw_tasks.py add \"任务描述\"\n```\n\n如果任务复杂，先简要总结（100字内），再写入队列。\n\n队列文件路径：~/.workbuddy/queue/qclaw_tasks.json\n队列管理脚本：~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py\n```\n\n### 快速手动测试（QClaw 侧）\n\n```bash\n# 添加一个测试任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add \"帮我查一下今天的天气并生成出行建议\"\n\n# 查看队列\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n\n# 只看待处理任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending\n```\n\n---\n\n## 第三步：在 WorkBuddy 侧配置自动化\n\n### 3.1 创建轮询自动化\n\n在 WorkBuddy 中创建定时自动化：\n\n- **名称**: `qclaw-bridge-poll`\n- **触发频率**: 每 5 分钟一次（FREQ=MINUTELY;INTERVAL=5）\n- **执行内容**: 见下方自动化脚本\n\n### 3.2 自动化执行脚本\n\n创建自动化时，在 prompt 中填入：\n\n```\n检查任务队列 ~/.workbuddy/queue/qclaw_tasks.json 中是否有 status=\"pending\" 的任务。\n\n如果有，按以下步骤处理：\n\n1. 先运行：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py poll --once\n\n2. 读取返回的 JSON 任务内容，提取 input.description 作为任务描述\n\n3. 自主执行任务（调用所有需要的工具、Skill 完成工作）\n\n4. 任务完成后，将结果写入队列：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py done <task_id> - << 'EOF'\n   {\"summary\": \"一句话结果描述\", \"details\": \"详细说明\", \"files\": [\"文件路径列表\"]}\n   EOF\n\n5. 如果执行失败：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py error <task_id> \"失败原因\"\n\n如果队列为空，不做任何操作，直接退出。\n```\n\n---\n\n## 第四步：QClaw 读取结果并推送\n\n### 自动化推送脚本（WorkBuddy 端）\n\n任务完成后，WorkBuddy 可以主动将结果写入一个结果文件：\n\n```bash\n# 在 WorkBuddy 自动化中，完成任务后调用：\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py result <task_id>\n```\n\n### QClaw 读取结果（轮询模式）\n\nQClaw 可以设置一个定期检查结果的逻辑：\n\n```\n定期检查结果：\n每 5 分钟检查一次 ~/.workbuddy/queue/qclaw_tasks.json\n找出所有 status=\"done\" 且尚未推送的任务\n将 result.summary 通过微信消息发送给用户\n然后将任务 status 改为 \"pushed\"\n```\n\n---\n\n## 队列任务数据结构\n\n```json\n{\n  \"version\": \"1.0\",\n  \"tasks\": [\n    {\n      \"id\": \"a1b2c3d4\",\n      \"created_at\": \"2026-04-15T08:30:00+08:00\",\n      \"status\": \"pending\",\n      \"input\": {\n        \"description\": \"帮我生成一份本周的工作周报\",\n        \"intent\": \"用户原始意图描述\",\n        \"context\": {\n          \"user\": \"刘博\",\n          \"project\": \"ITS系统\"\n        }\n      },\n      \"result\": {\n        \"summary\": \"周报已生成，共5个工作项\",\n        \"details\": \"...\",\n        \"files\": [\"/path/to/weekly_report.md\"]\n      },\n      \"done_at\": null,\n      \"error\": null\n    }\n  ]\n}\n```\n\n## 队列操作命令速查\n\n| 操作 | 命令 |\n|------|------|\n| 添加任务 | `python3 .../qclaw_queue.py add \"任务描述\" [--intent \"意图\"]` |\n| 查看队列 | `python3 .../qclaw_queue.py list [--status pending]` |\n| 等待任务 | `python3 .../qclaw_queue.py poll --once` |\n| 获取结果 | `python3 .../qclaw_queue.py result <task_id>` |\n| 标记完成 | `python3 .../qclaw_queue.py done <task_id> <result.json>` |\n| 标记失败 | `python3 .../qclaw_queue.py error <task_id> \"原因\"` |\n| 更新状态 | `python3 .../qclaw_queue.py status <task_id> <new_status>` |\n\n---\n\n## 场景示例\n\n### 场景 1：微信说\"帮我生成周报\"\n\n**QClaw 侧**:\n```\n用户: 帮我生成本周的工作周报\n→ QClaw 识别为复杂任务，写入队列\n→ python3 .../qclaw_queue.py add \"生成本周工作周报，包含ITS系统进展和下周计划\"\n```\n\n**WorkBuddy 侧**（自动化触发）:\n```\n→ 读取任务，识别为\"生成周报\"\n→ 询问/查找本周的工作内容\n→ 调用 Word/DOCX Skill 生成周报文档\n→ 完成后写入结果\n```\n\n**结果推送**:\n```\n✅ 周报已生成！\n📄 文件: ~/weekly_report_2026-04-15.docx\n📝 摘要: 包含ITS系统、配置管理、问题管理等5个工作项\n```\n\n### 场景 2：微信说\"帮我分析这份Excel\"\n\n**QClaw 侧**:\n```\n用户: 帮我分析一下这份销售数据\n→ QClaw 询问用户文件路径\n→ 用户提供路径后，写入队列\n→ python3 .../qclaw_queue.py add \"分析销售数据，生成可视化图表和关键洞察\" --ctx '{\"file\": \"/path/to/sales.xlsx\"}'\n```\n\n---\n\n## 进阶：多用户支持\n\n如果需要支持多用户场景，可以在队列中加入 `user_id` 字段：\n\n```json\n{\n  \"input\": {\n    \"description\": \"...\",\n    \"user_id\": \"liubo\",\n    \"reply_to\": \"wechat\"\n  }\n}\n```\n\nWorkBuddy 在处理时根据 `user_id` 区分用户，结果通过对应渠道推送。\n\n---\n\n## 故障排查\n\n| 问题 | 原因 | 解决方法 |\n|------|------|----------|\n| 队列文件不存在 | 首次未初始化 | 运行 `qclaw_queue.py list` 自动创建 |\n| 自动化没触发 | 频率太低/自动化暂停 | 改为每 1 分钟或手动触发一次 |\n| 结果未推送 | QClaw 未轮询结果 | 检查 QClaw 侧结果读取逻辑 |\n| 权限错误 | 队列文件无读写权限 | `chmod 600 ~/.workbuddy/queue/qclaw_tasks.json` |\n\nFile v1.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"qclaw-workbuddy-bridge\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1776220378509\n}\n\nFile v1.2.0:skill-card.md\n\n## Description:\n\nQclaw Workbuddy Bridge connects QClaw or WeChat-originated requests to WorkBuddy execution through a local JSON task queue.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[liuboacean](https://clawhub.ai/user/liuboacean)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Broad QClaw or WeChat requests can be forwarded into autonomous WorkBuddy execution through the shared queue.\n\nMitigation: Narrow dispatch triggers and require explicit confirmation before file access or other side-effecting work.\n\nRisk: The persistent local queue can contain sensitive personal, business, or task context data.\n\nMitigation: Avoid placing secrets or sensitive data in the queue and enforce owner-only permissions on queue files.\n\nRisk: A shared JSON queue has weak coordination controls for concurrent readers and writers.\n\nMitigation: Add file locking or replace the JSON queue with SQLite for stronger consistency.\n\nRisk: WorkBuddy may execute queued tasks with more local access than intended.\n\nMitigation: Run WorkBuddy in a sandboxed, low-privilege environment.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge)\n- [Skill Definition](artifact/SKILL.md)\n- [Queue Manager Script](artifact/scripts/qclaw_queue.py)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON task records]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Produces local queue operations for adding, polling, completing, failing, and reading tasks.]\n\n## Skill Version(s):\n\n1.2.0 (source: server release evidence and target metadata; artifact frontmatter says 1.0.0)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.1.0: 3 files, 6683 bytes\n\nFiles: scripts/qclaw_queue.py (10806b), SKILL.md (7773b), _meta.json (141b)\n\nFile v1.1.0:SKILL.md\n\n---\nname: qclaw-workbuddy-bridge\ndescription: |\n  QClaw 与 WorkBuddy 任务分发集成桥。当用户想要：\n  - 通过微信让 QClaw 发送任务给 WorkBuddy 执行\n  - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果\n  - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎）\n  - 远程任务分发、跨客户端任务执行\n  触发词：QClaw发任务、微信转WorkBuddy、QClaw工作流、远程任务、任务分发\nversion: 1.0.0\n---\n\n# QClaw ↔ WorkBuddy 任务分发桥\n\n通过共享 JSON 队列文件，实现 QClaw（微信入口）和 WorkBuddy（执行引擎）的双向打通。\n\n## 架构概览\n\n```\n微信消息\n    ↓\nQClaw（解析意图） → 写入任务到队列文件\n    ↓\nWorkBuddy（自动化轮询） → 读取任务 → 执行 → 写回结果\n    ↓\nQClaw（读取结果） → 微信推送回复给用户\n```\n\n- **队列文件**: `~/.workbuddy/queue/qclaw_tasks.json`\n- **队列管理器**: `~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py`\n- **轮询方式**: WorkBuddy 自动化（recurring）定期检查队列\n\n---\n\n## 第一步：安装与初始化\n\n### 1.1 验证依赖\n\n```bash\n# 确认 Python 3 已安装\npython3 --version\n\n# 确认队列目录存在\nls ~/.workbuddy/queue/\n# 首次运行会自动创建\n```\n\n### 1.2 初始化队列文件\n\n```bash\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n```\n\n---\n\n## 第二步：在 QClaw 侧配置\n\nQClaw 通过对话解析用户意图，将需要 WorkBuddy 执行的任务写入队列。\n\n### QClaw 提示词配置（发送给 QClaw）\n\n在 QClaw 的自定义提示词或系统提示中加入以下规则：\n\n```\n---\n你有一个新的能力：当用户请求的任务需要：\n- 生成长文档、报告、PPT、Excel\n- 深度数据分析或研究\n- 需要访问本地文件的复杂操作\n- 定时自动化任务\n- 批量文件处理\n\n你应主动将任务写入队列文件，格式如下：\n\n任务分发触发条件（满足任一即写入）：\n1. 用户说\"帮我生成/制作/分析/整理...\"\n2. 涉及文件创建、数据处理、多步骤操作\n3. 用户说\"远程执行\"、\"交给 WorkBuddy\"、\"你做不到的事\"\n\n写入命令：\n```bash\npython3 ~/.workbuddy/queue/qclaw_tasks.py add \"任务描述\"\n```\n\n如果任务复杂，先简要总结（100字内），再写入队列。\n\n队列文件路径：~/.workbuddy/queue/qclaw_tasks.json\n队列管理脚本：~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py\n```\n\n### 快速手动测试（QClaw 侧）\n\n```bash\n# 添加一个测试任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add \"帮我查一下今天的天气并生成出行建议\"\n\n# 查看队列\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n\n# 只看待处理任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending\n```\n\n---\n\n## 第三步：在 WorkBuddy 侧配置自动化\n\n### 3.1 创建轮询自动化\n\n在 WorkBuddy 中创建定时自动化：\n\n- **名称**: `qclaw-bridge-poll`\n- **触发频率**: 每 5 分钟一次（FREQ=MINUTELY;INTERVAL=5）\n- **执行内容**: 见下方自动化脚本\n\n### 3.2 自动化执行脚本\n\n创建自动化时，在 prompt 中填入：\n\n```\n检查任务队列 ~/.workbuddy/queue/qclaw_tasks.json 中是否有 status=\"pending\" 的任务。\n\n如果有，按以下步骤处理：\n\n1. 先运行：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py poll --once\n\n2. 读取返回的 JSON 任务内容，提取 input.description 作为任务描述\n\n3. 自主执行任务（调用所有需要的工具、Skill 完成工作）\n\n4. 任务完成后，将结果写入队列：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py done <task_id> - << 'EOF'\n   {\"summary\": \"一句话结果描述\", \"details\": \"详细说明\", \"files\": [\"文件路径列表\"]}\n   EOF\n\n5. 如果执行失败：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py error <task_id> \"失败原因\"\n\n如果队列为空，不做任何操作，直接退出。\n```\n\n---\n\n## 第四步：QClaw 读取结果并推送\n\n### 自动化推送脚本（WorkBuddy 端）\n\n任务完成后，WorkBuddy 可以主动将结果写入一个结果文件：\n\n```bash\n# 在 WorkBuddy 自动化中，完成任务后调用：\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py result <task_id>\n```\n\n### QClaw 读取结果（轮询模式）\n\nQClaw 可以设置一个定期检查结果的逻辑：\n\n```\n定期检查结果：\n每 5 分钟检查一次 ~/.workbuddy/queue/qclaw_tasks.json\n找出所有 status=\"done\" 且尚未推送的任务\n将 result.summary 通过微信消息发送给用户\n然后将任务 status 改为 \"pushed\"\n```\n\n---\n\n## 队列任务数据结构\n\n```json\n{\n  \"version\": \"1.0\",\n  \"tasks\": [\n    {\n      \"id\": \"a1b2c3d4\",\n      \"created_at\": \"2026-04-15T08:30:00+08:00\",\n      \"status\": \"pending\",\n      \"input\": {\n        \"description\": \"帮我生成一份本周的工作周报\",\n        \"intent\": \"用户原始意图描述\",\n        \"context\": {\n          \"user\": \"刘博\",\n          \"project\": \"ITS系统\"\n        }\n      },\n      \"result\": {\n        \"summary\": \"周报已生成，共5个工作项\",\n        \"details\": \"...\",\n        \"files\": [\"/path/to/weekly_report.md\"]\n      },\n      \"done_at\": null,\n      \"error\": null\n    }\n  ]\n}\n```\n\n## 队列操作命令速查\n\n| 操作 | 命令 |\n|------|------|\n| 添加任务 | `python3 .../qclaw_queue.py add \"任务描述\" [--intent \"意图\"]` |\n| 查看队列 | `python3 .../qclaw_queue.py list [--status pending]` |\n| 等待任务 | `python3 .../qclaw_queue.py poll --once` |\n| 获取结果 | `python3 .../qclaw_queue.py result <task_id>` |\n| 标记完成 | `python3 .../qclaw_queue.py done <task_id> <result.json>` |\n| 标记失败 | `python3 .../qclaw_queue.py error <task_id> \"原因\"` |\n| 更新状态 | `python3 .../qclaw_queue.py status <task_id> <new_status>` |\n\n---\n\n## 场景示例\n\n### 场景 1：微信说\"帮我生成周报\"\n\n**QClaw 侧**:\n```\n用户: 帮我生成本周的工作周报\n→ QClaw 识别为复杂任务，写入队列\n→ python3 .../qclaw_queue.py add \"生成本周工作周报，包含ITS系统进展和下周计划\"\n```\n\n**WorkBuddy 侧**（自动化触发）:\n```\n→ 读取任务，识别为\"生成周报\"\n→ 询问/查找本周的工作内容\n→ 调用 Word/DOCX Skill 生成周报文档\n→ 完成后写入结果\n```\n\n**结果推送**:\n```\n✅ 周报已生成！\n📄 文件: ~/weekly_report_2026-04-15.docx\n📝 摘要: 包含ITS系统、配置管理、问题管理等5个工作项\n```\n\n### 场景 2：微信说\"帮我分析这份Excel\"\n\n**QClaw 侧**:\n```\n用户: 帮我分析一下这份销售数据\n→ QClaw 询问用户文件路径\n→ 用户提供路径后，写入队列\n→ python3 .../qclaw_queue.py add \"分析销售数据，生成可视化图表和关键洞察\" --ctx '{\"file\": \"/path/to/sales.xlsx\"}'\n```\n\n---\n\n## 进阶：多用户支持\n\n如果需要支持多用户场景，可以在队列中加入 `user_id` 字段：\n\n```json\n{\n  \"input\": {\n    \"description\": \"...\",\n    \"user_id\": \"liubo\",\n    \"reply_to\": \"wechat\"\n  }\n}\n```\n\nWorkBuddy 在处理时根据 `user_id` 区分用户，结果通过对应渠道推送。\n\n---\n\n## 故障排查\n\n| 问题 | 原因 | 解决方法 |\n|------|------|----------|\n| 队列文件不存在 | 首次未初始化 | 运行 `qclaw_queue.py list` 自动创建 |\n| 自动化没触发 | 频率太低/自动化暂停 | 改为每 1 分钟或手动触发一次 |\n| 结果未推送 | QClaw 未轮询结果 | 检查 QClaw 侧结果读取逻辑 |\n| 权限错误 | 队列文件无读写权限 | `chmod 600 ~/.workbuddy/queue/qclaw_tasks.json` |\n\nFile v1.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"qclaw-workbuddy-bridge\",\n  \"version\": \"1.1.0\",\n  \"publishedAt\": 1776219316116\n}\n\nArchive v1.0.0: 3 files, 6217 bytes\n\nFiles: scripts/qclaw_queue.py (9062b), SKILL.md (7773b), _meta.json (141b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: qclaw-workbuddy-bridge\ndescription: |\n  QClaw 与 WorkBuddy 任务分发集成桥。当用户想要：\n  - 通过微信让 QClaw 发送任务给 WorkBuddy 执行\n  - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果\n  - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎）\n  - 远程任务分发、跨客户端任务执行\n  触发词：QClaw发任务、微信转WorkBuddy、QClaw工作流、远程任务、任务分发\nversion: 1.0.0\n---\n\n# QClaw ↔ WorkBuddy 任务分发桥\n\n通过共享 JSON 队列文件，实现 QClaw（微信入口）和 WorkBuddy（执行引擎）的双向打通。\n\n## 架构概览\n\n```\n微信消息\n    ↓\nQClaw（解析意图） → 写入任务到队列文件\n    ↓\nWorkBuddy（自动化轮询） → 读取任务 → 执行 → 写回结果\n    ↓\nQClaw（读取结果） → 微信推送回复给用户\n```\n\n- **队列文件**: `~/.workbuddy/queue/qclaw_tasks.json`\n- **队列管理器**: `~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py`\n- **轮询方式**: WorkBuddy 自动化（recurring）定期检查队列\n\n---\n\n## 第一步：安装与初始化\n\n### 1.1 验证依赖\n\n```bash\n# 确认 Python 3 已安装\npython3 --version\n\n# 确认队列目录存在\nls ~/.workbuddy/queue/\n# 首次运行会自动创建\n```\n\n### 1.2 初始化队列文件\n\n```bash\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n```\n\n---\n\n## 第二步：在 QClaw 侧配置\n\nQClaw 通过对话解析用户意图，将需要 WorkBuddy 执行的任务写入队列。\n\n### QClaw 提示词配置（发送给 QClaw）\n\n在 QClaw 的自定义提示词或系统提示中加入以下规则：\n\n```\n---\n你有一个新的能力：当用户请求的任务需要：\n- 生成长文档、报告、PPT、Excel\n- 深度数据分析或研究\n- 需要访问本地文件的复杂操作\n- 定时自动化任务\n- 批量文件处理\n\n你应主动将任务写入队列文件，格式如下：\n\n任务分发触发条件（满足任一即写入）：\n1. 用户说\"帮我生成/制作/分析/整理...\"\n2. 涉及文件创建、数据处理、多步骤操作\n3. 用户说\"远程执行\"、\"交给 WorkBuddy\"、\"你做不到的事\"\n\n写入命令：\n```bash\npython3 ~/.workbuddy/queue/qclaw_tasks.py add \"任务描述\"\n```\n\n如果任务复杂，先简要总结（100字内），再写入队列。\n\n队列文件路径：~/.workbuddy/queue/qclaw_tasks.json\n队列管理脚本：~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py\n```\n\n### 快速手动测试（QClaw 侧）\n\n```bash\n# 添加一个测试任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add \"帮我查一下今天的天气并生成出行建议\"\n\n# 查看队列\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n\n# 只看待处理任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending\n```\n\n---\n\n## 第三步：在 WorkBuddy 侧配置自动化\n\n### 3.1 创建轮询自动化\n\n在 WorkBuddy 中创建定时自动化：\n\n- **名称**: `qclaw-bridge-poll`\n- **触发频率**: 每 5 分钟一次（FREQ=MINUTELY;INTERVAL=5）\n- **执行内容**: 见下方自动化脚本\n\n### 3.2 自动化执行脚本\n\n创建自动化时，在 prompt 中填入：\n\n```\n检查任务队列 ~/.workbuddy/queue/qclaw_tasks.json 中是否有 status=\"pending\" 的任务。\n\n如果有，按以下步骤处理：\n\n1. 先运行：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py poll --once\n\n2. 读取返回的 JSON 任务内容，提取 input.description 作为任务描述\n\n3. 自主执行任务（调用所有需要的工具、Skill 完成工作）\n\n4. 任务完成后，将结果写入队列：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py done <task_id> - << 'EOF'\n   {\"summary\": \"一句话结果描述\", \"details\": \"详细说明\", \"files\": [\"文件路径列表\"]}\n   EOF\n\n5. 如果执行失败：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py error <task_id> \"失败原因\"\n\n如果队列为空，不做任何操作，直接退出。\n```\n\n---\n\n## 第四步：QClaw 读取结果并推送\n\n### 自动化推送脚本（WorkBuddy 端）\n\n任务完成后，WorkBuddy 可以主动将结果写入一个结果文件：\n\n```bash\n# 在 WorkBuddy 自动化中，完成任务后调用：\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py result <task_id>\n```\n\n### QClaw 读取结果（轮询模式）\n\nQClaw 可以设置一个定期检查结果的逻辑：\n\n```\n定期检查结果：\n每 5 分钟检查一次 ~/.workbuddy/queue/qclaw_tasks.json\n找出所有 status=\"done\" 且尚未推送的任务\n将 result.summary 通过微信消息发送给用户\n然后将任务 status 改为 \"pushed\"\n```\n\n---\n\n## 队列任务数据结构\n\n```json\n{\n  \"version\": \"1.0\",\n  \"tasks\": [\n    {\n      \"id\": \"a1b2c3d4\",\n      \"created_at\": \"2026-04-15T08:30:00+08:00\",\n      \"status\": \"pending\",\n      \"input\": {\n        \"description\": \"帮我生成一份本周的工作周报\",\n        \"intent\": \"用户原始意图描述\",\n        \"context\": {\n          \"user\": \"刘博\",\n          \"project\": \"ITS系统\"\n        }\n      },\n      \"result\": {\n        \"summary\": \"周报已生成，共5个工作项\",\n        \"details\": \"...\",\n        \"files\": [\"/path/to/weekly_report.md\"]\n      },\n      \"done_at\": null,\n      \"error\": null\n    }\n  ]\n}\n```\n\n## 队列操作命令速查\n\n| 操作 | 命令 |\n|------|------|\n| 添加任务 | `python3 .../qclaw_queue.py add \"任务描述\" [--intent \"意图\"]` |\n| 查看队列 | `python3 .../qclaw_queue.py list [--status pending]` |\n| 等待任务 | `python3 .../qclaw_queue.py poll --once` |\n| 获取结果 | `python3 .../qclaw_queue.py result <task_id>` |\n| 标记完成 | `python3 .../qclaw_queue.py done <task_id> <result.json>` |\n| 标记失败 | `python3 .../qclaw_queue.py error <task_id> \"原因\"` |\n| 更新状态 | `python3 .../qclaw_queue.py status <task_id> <new_status>` |\n\n---\n\n## 场景示例\n\n### 场景 1：微信说\"帮我生成周报\"\n\n**QClaw 侧**:\n```\n用户: 帮我生成本周的工作周报\n→ QClaw 识别为复杂任务，写入队列\n→ python3 .../qclaw_queue.py add \"生成本周工作周报，包含ITS系统进展和下周计划\"\n```\n\n**WorkBuddy 侧**（自动化触发）:\n```\n→ 读取任务，识别为\"生成周报\"\n→ 询问/查找本周的工作内容\n→ 调用 Word/DOCX Skill 生成周报文档\n→ 完成后写入结果\n```\n\n**结果推送**:\n```\n✅ 周报已生成！\n📄 文件: ~/weekly_report_2026-04-15.docx\n📝 摘要: 包含ITS系统、配置管理、问题管理等5个工作项\n```\n\n### 场景 2：微信说\"帮我分析这份Excel\"\n\n**QClaw 侧**:\n```\n用户: 帮我分析一下这份销售数据\n→ QClaw 询问用户文件路径\n→ 用户提供路径后，写入队列\n→ python3 .../qclaw_queue.py add \"分析销售数据，生成可视化图表和关键洞察\" --ctx '{\"file\": \"/path/to/sales.xlsx\"}'\n```\n\n---\n\n## 进阶：多用户支持\n\n如果需要支持多用户场景，可以在队列中加入 `user_id` 字段：\n\n```json\n{\n  \"input\": {\n    \"description\": \"...\",\n    \"user_id\": \"liubo\",\n    \"reply_to\": \"wechat\"\n  }\n}\n```\n\nWorkBuddy 在处理时根据 `user_id` 区分用户，结果通过对应渠道推送。\n\n---\n\n## 故障排查\n\n| 问题 | 原因 | 解决方法 |\n|------|------|----------|\n| 队列文件不存在 | 首次未初始化 | 运行 `qclaw_queue.py list` 自动创建 |\n| 自动化没触发 | 频率太低/自动化暂停 | 改为每 1 分钟或手动触发一次 |\n| 结果未推送 | QClaw 未轮询结果 | 检查 QClaw 侧结果读取逻辑 |\n| 权限错误 | 队列文件无读写权限 | `chmod 600 ~/.workbuddy/queue/qclaw_tasks.json` |\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"qclaw-workbuddy-bridge\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1776217225484\n}","readmeExcerpt":"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命令自","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"微信消息\n    ↓\nQClaw（解析意图） → 写入任务到队列文件\n    ↓\nWorkBuddy（自动化轮询） → 读取任务 → 执行 → 写回结果\n    ↓\nQClaw（读取结果） → 微信推送回复给用户"},{"language":"bash","snippet":"# 确认 Python 3 已安装\npython3 --version\n\n# 确认队列目录存在\nls ~/.workbuddy/queue/\n# 首次运行会自动创建"},{"language":"bash","snippet":"python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list"},{"language":"text","snippet":"---\n你有一个新的能力：当用户请求的任务需要：\n- 生成长文档、报告、PPT、Excel\n- 深度数据分析或研究\n- 需要访问本地文件的复杂操作\n- 定时自动化任务\n- 批量文件处理\n\n你应主动将任务写入队列文件，格式如下：\n\n任务分发触发条件（满足任一即写入）：\n1. 用户说\"帮我生成/制作/分析/整理...\"\n2. 涉及文件创建、数据处理、多步骤操作\n3. 用户说\"远程执行\"、\"交给 WorkBuddy\"、\"你做不到的事\"\n\n写入命令："},{"language":"text","snippet":"如果任务复杂，先简要总结（100字内），再写入队列。\n\n队列文件路径：~/.workbuddy/queue/qclaw_tasks.json\n队列管理脚本：~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py"},{"language":"bash","snippet":"# 添加一个测试任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add \"帮我查一下今天的天气并生成出行建议\"\n\n# 查看队列\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n\n# 只看待处理任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: qclaw-workbuddy-bridge\ndescription: |\n  QClaw 与 WorkBuddy 任务分发集成桥。当用户想要：\n  - 通过微信让 QClaw 发送任务给 WorkBuddy 执行\n  - QClaw 写任务 → WorkBuddy 执行 → 微信推送结果\n  - 打通 QClaw（微信入口）和 WorkBuddy（执行引擎）\n  - 远程任务分发、跨客户端任务执行\n  触发词：QClaw发任务、微信转WorkBuddy、QClaw工作流、远程任务、任务分发\nversion: 1.0.0\n---\n\n# QClaw ↔ WorkBuddy 任务分发桥\n\n通过共享 JSON 队列文件，实现 QClaw（微信入口）和 WorkBuddy（执行引擎）的双向打通。\n\n## 架构概览\n\n```\n微信消息\n    ↓\nQClaw（解析意图） → 写入任务到队列文件\n    ↓\nWorkBuddy（自动化轮询） → 读取任务 → 执行 → 写回结果\n    ↓\nQClaw（读取结果） → 微信推送回复给用户\n```\n\n- **队列文件**: `~/.workbuddy/queue/qclaw_tasks.json`\n- **队列管理器**: `~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py`\n- **轮询方式**: WorkBuddy 自动化（recurring）定期检查队列\n\n---\n\n## 第一步：安装与初始化\n\n### 1.1 验证依赖\n\n```bash\n# 确认 Python 3 已安装\npython3 --version\n\n# 确认队列目录存在\nls ~/.workbuddy/queue/\n# 首次运行会自动创建\n```\n\n### 1.2 初始化队列文件\n\n```bash\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n```\n\n---\n\n## 第二步：在 QClaw 侧配置\n\nQClaw 通过对话解析用户意图，将需要 WorkBuddy 执行的任务写入队列。\n\n### QClaw 提示词配置（发送给 QClaw）\n\n在 QClaw 的自定义提示词或系统提示中加入以下规则：\n\n```\n---\n你有一个新的能力：当用户请求的任务需要：\n- 生成长文档、报告、PPT、Excel\n- 深度数据分析或研究\n- 需要访问本地文件的复杂操作\n- 定时自动化任务\n- 批量文件处理\n\n你应主动将任务写入队列文件，格式如下：\n\n任务分发触发条件（满足任一即写入）：\n1. 用户说\"帮我生成/制作/分析/整理...\"\n2. 涉及文件创建、数据处理、多步骤操作\n3. 用户说\"远程执行\"、\"交给 WorkBuddy\"、\"你做不到的事\"\n\n写入命令：\n```bash\npython3 ~/.workbuddy/queue/qclaw_tasks.py add \"任务描述\"\n```\n\n如果任务复杂，先简要总结（100字内），再写入队列。\n\n队列文件路径：~/.workbuddy/queue/qclaw_tasks.json\n队列管理脚本：~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py\n```\n\n### 快速手动测试（QClaw 侧）\n\n```bash\n# 添加一个测试任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py add \"帮我查一下今天的天气并生成出行建议\"\n\n# 查看队列\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list\n\n# 只看待处理任务\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py list --status pending\n```\n\n---\n\n## 第三步：在 WorkBuddy 侧配置自动化\n\n### 3.1 创建轮询自动化\n\n在 WorkBuddy 中创建定时自动化：\n\n- **名称**: `qclaw-bridge-poll`\n- **触发频率**: 每 5 分钟一次（FREQ=MINUTELY;INTERVAL=5）\n- **执行内容**: 见下方自动化脚本\n\n### 3.2 自动化执行脚本\n\n创建自动化时，在 prompt 中填入：\n\n```\n检查任务队列 ~/.workbuddy/queue/qclaw_tasks.json 中是否有 status=\"pending\" 的任务。\n\n如果有，按以下步骤处理：\n\n1. 先运行：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py poll --once\n\n2. 读取返回的 JSON 任务内容，提取 input.description 作为任务描述\n\n3. 自主执行任务（调用所有需要的工具、Skill 完成工作）\n\n4. 任务完成后，将结果写入队列：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py done <task_id> - << 'EOF'\n   {\"summary\": \"一句话结果描述\", \"details\": \"详细说明\", \"files\": [\"文件路径列表\"]}\n   EOF\n\n5. 如果执行失败：\n   python3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py error <task_id> \"失败原因\"\n\n如果队列为空，不做任何操作，直接退出。\n```\n\n---\n\n## 第四步：QClaw 读取结果并推送\n\n### 自动化推送脚本（WorkBuddy 端）\n\n任务完成后，WorkBuddy 可以主动将结果写入一个结果文件：\n\n```bash\n# 在 WorkBuddy 自动化中，完成任务后调用：\npython3 ~/.workbuddy/skills/qclaw-workbuddy-bridge/scripts/qclaw_queue.py result <task_id>\n```\n\n### QClaw 读取结果（轮询模式）\n\nQClaw 可以设置一个定期检查结果的逻辑：\n\n```\n定期检查结果：\n每 5 分钟检查一次 ~/.workbuddy/queue/qclaw_tasks.json\n找出所有 status=\"done\" 且尚未推送的任务\n将 result.summary 通过微信消息发送给用户\n然后将任"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn73qbrbqs4s8t2nh8pm22wxbd84vm7r\",\n  \"slug\": \"qclaw-workbuddy-bridge\",\n  \"version\": \"1.2.0\",\n  \"publishedAt\": 1776220378509\n}"},{"path":"skill-card.md","content":"## Description:\n\nQclaw Workbuddy Bridge connects QClaw or WeChat-originated requests to WorkBuddy execution through a local JSON task queue.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[liuboacean](https://clawhub.ai/user/liuboacean)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Broad QClaw or WeChat requests can be forwarded into autonomous WorkBuddy execution through the shared queue.\n\nMitigation: Narrow dispatch triggers and require explicit confirmation before file access or other side-effecting work.\n\nRisk: The persistent local queue can contain sensitive personal, business, or task context data.\n\nMitigation: Avoid placing secrets or sensitive data in the queue and enforce owner-only permissions on queue files.\n\nRisk: A shared JSON queue has weak coordination controls for concurrent readers and writers.\n\nMitigation: Add file locking or replace the JSON queue with SQLite for stronger consistency.\n\nRisk: WorkBuddy may execute queued tasks with more local access than intended.\n\nMitigation: Run WorkBuddy in a sandboxed, low-privilege environment.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/liuboacean/skills/qclaw-workbuddy-bridge)\n- [Skill Definition](artifact/SKILL.md)\n- [Queue Manager Script](artifact/scripts/qclaw_queue.py)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, JSON, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON task records]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Produces local queue operations for adding, polling, completing, failing, and reading tasks.]\n\n## Skill Version(s):\n\n1.2.0 (source: server release evidence and target metadata; artifact frontmatter says 1.0.0)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"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命令自","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":744,"uniquenessScore":57,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T01:16:49.014Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T14:25:16.933Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}