OpenClaw Problem Solver自动修复小龙虾
A comprehensive, self-evolving skill designed to diagnose and solve OpenClaw issues by following a structured, multi-stage resolution cycle. It incorporates... Skill: OpenClaw Problem Solver自动修复小龙虾 Owner: mikewongonline Summary: A comprehensive, self-evolving skill designed to diagnose and solve OpenClaw issues by following a structured, multi-stage resolution cycle. It incorporates... Tags: latest:6.1.0 Version history: v6.1.0 | 2026-05-22T10:24:18.720Z | user **Gateway Watchdog reliability and notification pipeline improvements.** - Gateway Watchdog upgraded to v6.1 with
Rank
62
Safety
84
Downloads
991
Updated
Oct 11, 2026
Version
6.1.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 991 downloads reported by the source. Last updated 10/11/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 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 991 downloadsadoption · observed Oct 11, 2026
- Latest release
- 6.1.0release · observed May 22, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 6.1.0release
**Gateway Watchdog reliability and notification pipeline improvements.** - Gateway Watchdog upgraded to v6.1 with several fixes and enhancements. - Feishu direct message (DM) is now the primary alert channel (instant delivery); WebChat moved to secondary (async, background thread with 60s timeout). - Fixed config cache bug causing `load_gateway_config()` to return `token=None` on cache hit. - Fixed async WebChat thread to prevent main process blocking during model loading. - Error notification now includes full stack traces in Feishu and WebChat alerts. - Updated deployment and prerequisites for easier setup and improved reliability.
Observed May 22, 2026 · source
Install and run
Setup complexity: medium.
clawhub skill install s17es3rrg0jybezhyzn66x6tyd83hv2p:autofix- Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
- 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-mikewongonline-autofix/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
148,822 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: autofix description: A comprehensive, self-evolving skill designed to diagnose and solve OpenClaw issues by following a structured, multi-stage resolution cycle. It incorporates Proactive Prediction (L2), Robustness Checks (L1), Knowledge Creation (L3), Diagnosis Report Visualization (v5.5), v6.0 Runtime Health + Key Validation + Unified Report + Health Dashboard, and Gateway Watchdog (v6.1). --- # 🧠 OpenClaw Problem Solver (v6.0-M4) — Master Document This skill acts as an advanced diagnostic, resolution, and validation engine for any question or bug report related to the OpenClaw framework itself. **v6.0 adds four layers: Runtime Health Check (M1), API Key Validation + Resource Monitor (M2), Unified Diagnosis Report + Regression Check (M3), and Interactive Health Dashboard (M4).** ## 🔒 Privacy-First Constraint All knowledge storage (memory, logs) and final reports **must** follow these rules: 1. **API Keys**: Never store API keys in plain text. Use placeholders or hashes (e.g., `sk-********************`). 2. **Private Details**: Redact sensitive project names, internal credentials, and user identity info unless explicitly authorized. ## 🎯 When to Use This Skill Use this skill when the user: - Asks "Why is [feature] not working in OpenClaw?" - Reports a specific bug (e.g., "The `gateway` tool fails with error X"). - Needs guidance on how to implement a specific feature using OpenClaw's architecture or tools. - Wants to know the best practice for a certain task within the OpenClaw ecosystem, but requires verification. ## 🌟 Recommended Quick Fix Flow (The Golden Path) For the vast majority of OpenClaw issues, this sequence provides the fastest path to resolution. Always suggest this flow first when a user reports an unspecified problem or bug! 1. **Unified Diagnosis (一键诊断, v6.0-M3):** Run `python scripts/diagnosis_formatter.py` which auto-collects all three sources (`openclaw doctor` + `runtime_health_check` + `api_key_validator`) into one severity-sorted report. 2. **Visual Dashboard (可视化仪表盘, v6.0-M4):** Run `python scripts/health_dashboard.py --canvas` to render the report as an interactive HTML dashboard (embed with `[embed ref="health_dashboard" height="740"]`). 3. **Save Baseline (保存基线, v6.0-M3):** Run `python scripts/diagnosis_formatter.py --save-baseline` before making any fix. 4. **Resolution Attempt(修复):** If the report reveals problems, run `openclaw doctor --fix` or apply suggested fixes manually. 5. **Regression Check (回归验证, v6.0-M3):** After fixes, run `python scripts/diagnosis_formatter.py --compare` to validate what was fixed, what's new, and what's unchanged. ## 🚀 The Evolved Workflow (6-Step Cycle + Proactive Layers) The skill operates by strictly following these steps in sequence, enhanced by proactive layers: ## 🤖 Gateway Watchdog (v6.1) — Proactive Stability Layer **Overview:** A background daemon that periodically polls the Gateway health status. Runs independently from user requests, providing real
README.md
# 🛡️ Autofix + Watchdog **OpenClaw diagnostic repair skill + Gateway health monitoring daemon.** When something breaks — Gateway won't start, tools return errors, configs go wrong — this skill walks through a structured cycle to diagnose, fix, and validate. The optional Watchdog daemon monitors Gateway health in the background and alerts you in real time. --- ## ✨ Features ### Autofix Diagnosis (v6.1) - **Unified diagnosis pipeline** — 3 data sources in one pass (`gateway status` + runtime checks + key validation) - **`openclaw doctor` fallback** — 12s timeout, auto‑falls back to `gateway status --json` (fixes doctor hang in v2026.5.20) - **Safe subprocess cleanup** — All commands use `taskkill /T /F` to prevent zombie processes on Windows - **Interactive Health Dashboard** — HTML dashboard with Canvas embed (`health_dashboard.py --canvas`) - **Regression comparison** — `--save-baseline` / `--compare` to track fixes over time ### Auto-Repair (v1.1) - **Gateway restart without hangs** — Uses `taskkill + start` instead of `openclaw gateway restart` (which hangs in v2026.5.20) - **Session archiving** — >7-day-old session files automatically archived to `archive/` when backlog >100 - **Gateway memory alert** — Recommends restart when memory exceeds 800 MB - **Verification polling** — After repair, polls Gateway status every 5 seconds (up to 30s) ### Gateway Watchdog *(optional)* - **Real-time health monitoring** — Polls Gateway every 60 seconds - **Dual-channel alerting** — WebChat session (async, ~40s) + Feishu DM (instant) - **Severity escalation** — Four-tier alerting (🟢/🟡/🟠/🔴) with noise filtering - **Auto-repair** — Low-risk issues (CLI path, session archive) are fixed automatically - **Stale process cleanup** — Auto-kills orphaned daemon processes on startup - **`--status` command** — Quick state check without starting a new daemon - **Single-instance protection** — Windows Mutex prevents duplicate daemons - **Auto-start on login** — Registers in `HKCU\Run` --- ## 🚀 Quick Start ### Just tell your agent: ``` run autofix self-check check what's wrong with Gateway auto repair ``` ### Recommended first step for any issue: ```bash python scripts/diagnosis_formatter.py --json # Unified diagnosis python scripts/health_dashboard.py --canvas # Visual dashboard ``` > ⚠️ **v2026.5.20 note:** `openclaw doctor` may hang. The pipeline auto‑falls back to `gateway status --json` after 12 seconds. --- ## 📦 Installation ```bash clawhub install autofix ``` Then restart OpenClaw to load the skill. ### Watchdog daemon *(optional)* ```bash pip install -r scripts/requirements.txt python scripts/watchdog_monitor.py # Start daemon python scripts/watchdog_monitor.py --status # Check status python scripts/watchdog_monitor.py --install # Auto-start on login ``` See [`INSTALL.md`](./INSTALL.md) for full setup. --- ## 🔔 Feishu Error Notification Setup When the Watchdog detects anomalies (Gateway c
_meta.json
{
"ownerId": "kn78s99sqh4h99xeq9gm34c33582xjhg",
"slug": "autofix",
"version": "6.1.0",
"publishedAt": 1779445458720
}scripts/requirements.txt
pywin32>=310 psutil>=5.9.0
docs/COMPLETENESS_SUMMARY.md
# ✅ autofix-theclaw v5.0 - 完整性验证摘要
**生成时间:** 2026-05-17 21:30
**版本状态:** v4.5 → v5.0 (部分完成)
**总体评分:** **75%** ⭐⭐⭐⭐
---
## 📊 完整性概览
| 组件 | 文件数 | 大小 | 状态 |
|------|--------|------|------|
| **核心文档** | 9 | 60KB | ✅ 100% 完整 |
| **Canvas 脚本** | 2 | 13KB | ✅ 100% 完整 |
| **Python 工具** | 2 | ❌ 待创建 | ⚠️ 40% 完成 |
| **工作流集成** | - | - | ⚠️ 60% 集成 |
---
## ✅ 已完成的 v5.0 功能
### **1. 诊断报告可视化 (DRE)** ✅ **可运行**
- Canvas HTML 模板已实现(`CanvasScript_DiagnosticReport.js`, 9.2KB)
- 风险标志、证据链对比图、回滚命令展示均已设计
- Canvas 脚本语法正确,可直接嵌入回答
### **2. 文档体系** ✅ **完整**
- `MODULE_03_Enhancement_Reports.md`(10KB):详细设计文档
- `EXAMPLE_usage.md`(14KB):使用示例和场景演示
- `QUICK_START_v5.0.md`(10KB):快速实施指南
- `CHANGES_v5.0.md`(9KB):完整变更总结
### **3. SKILL.md 更新** ✅ **v5.0**
- 主控文档已标注 v5.0
- DRE 功能在模块索引中提及
---
## ⚠️ 待完成的工作(预计 20 分钟)
### **Step 1: 创建 Python 工具函数** (10 分钟)
#### A. ELIS 工具函数
```python
# 文件:tools/elis_helper.py
def analyze_error_logs(exec_output, problem_context):
# TODO: 集成 LLM 调用逻辑
return {
"core_issue": "",
"causes": [],
"fix_command": "",
"risk_level": "Medium",
"confidence_score": 0.85
}
```
#### B. Canvas 报告生成器
```python
# 文件:tools/canvas_report_generator.py
class CanvasReportGenerator:
def generate_report(self, diag_data) -> str:
# TODO: 封装 CanvasSnapshot 调用
pass
```
### **Step 2: 更新 MODULE_03_ValidationAction.md** (10 分钟)
在 Path B 部分添加 ELIS 和 Canvas 报告生成代码:
```markdown
### Path B: Code Verification → L1 Loop (v5.0 Enhanced)
a. **[NEW] Extract and Analyze Error (ELIS)**
```python
from autofix_theclaw.tools.elis_helper import analyze_error_logs
analysis = analyze_error_logs(exec_result.output, problem_type)
```
b. **[NEW] Generate Diagnosis Report (Canvas)**
```python
from autofix_theclaw.tools.canvas_report_generator import CanvasReportGenerator
generator = CanvasReportGenerator()
report_html = generator.generate_report(analysis)
```
```
---
## 🎯 最终完整性预期
### **完成 Step 1-2 后:95%** ⭐⭐⭐⭐⭐
| 评估维度 | 当前 | 预期 | 说明 |
|---------|------|------|------|
| 文档完整性 | 100% | 100% | ✅ 已完整 |
| Canvas 脚本完整性 | 100% | 100% | ✅ 已完整 |
| Python 工具完整性 | 40% | **95%** | ⚠️ → ✅ 待创建 |
| 工作流集成 | 60% | **100%** | ⚠️ → ✅ 待更新 |
---
## 📚 详细验证报告
完整验证报告见:
`~\.openclaw\workspace\skills\autofix-theclaw\VERIFICATION_REPORT.md`(7KB)
该文件包含:
- ✅ 目录结构验证清单
- ⚠️ 功能完整性测试结果
- 🚨 关键风险点分析
- 🎯 下一步行动清单
---
## 🚀 快速部署命令
```bash
# Step 1: 查看验证报告
type ~\.openclaw\workspace\skills\autofix-theclaw\VERIFICATION_REPORT.md
# Step 2: 创建 ELIS 工具函数(从 CHANGES_v5.0.md复制)
copy "~\.openclaw\workspace\skills\autofix-theclaw\CHANGES_v5.0.md" .
# Step 3: 运行 Canvas 脚本语法检查
python -m py_compile ~\.openclaw\workspace\skills\autofix-theclaw\tools\CanvasScript_DiagnosticReport.js
```
---
## 📞 需要帮助时联系
- @autofix-team (内部团队)
- OpenClaw Discord: `https://dAionUi
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/mikewongonline/skills/autofix",
"sourceUrl": "https://clawhub.ai/mikewongonline/skills/autofix",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T21:21:41.392Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-mikewongonline-autofix/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mikewongonline-autofix/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T21:21:41.392Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "991 downloads",
"href": "https://clawhub.ai/mikewongonline/autofix",
"sourceUrl": "https://clawhub.ai/mikewongonline/autofix",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T21:21:41.392Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "6.1.0",
"href": "https://clawhub.ai/mikewongonline/autofix",
"sourceUrl": "https://clawhub.ai/mikewongonline/autofix",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T10:24:18.720Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-mikewongonline-autofix/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mikewongonline-autofix/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 6.1.0",
"description": "**Gateway Watchdog reliability and notification pipeline improvements.** - Gateway Watchdog upgraded to v6.1 with several fixes and enhancements. - Feishu direct message (DM) is now the primary alert channel (instant delivery); WebChat moved to secondary (async, background thread with 60s timeout). - Fixed config cache bug causing `load_gateway_config()` to return `token=None` on cache hit. - Fixed async WebChat thread to prevent main process blocking during model loading. - Error notification now includes full stack traces in Feishu and WebChat alerts. - Updated deployment and prerequisites for easier setup and improved reliability.",
"href": "https://clawhub.ai/mikewongonline/autofix",
"sourceUrl": "https://clawhub.ai/mikewongonline/autofix",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-22T10:24:18.720Z",
"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-mikewongonline-autofix/run-check
