clawaid 1.0.0 → 1.0.1

package/README.md

@@ -1,117 +1,40 @@
-# 🩺 OpenClaw Doctor
+# 🦞🩹 ClawAid
 
 AI-powered diagnostic and repair tool for [OpenClaw](https://github.com/openclaw/openclaw).
 
-## What it does
-
-1. **Scans** your OpenClaw installation (read-only, zero risk)
-2. **Analyzes** the system data with Claude Opus (via OpenRouter)
-3. **Shows** you what's wrong and the repair plan
-4. **Fixes** it with one click, in real-time
-5. **Verifies** the fix worked
-6. If not fixed: **meta-thinks** and tries a different approach (up to 9 attempts)
-
 ## Usage
 
 ```bash
-npx openclaw-doctor
+npx clawaid
 ```
 
-This opens a clean web interface in your browser. No terminal interaction needed.
+Opens a clean web UI in your browser. No config, no API key needed — just run it.
 
-## How it works
-
-### Three-Layer Loop Architecture
-
-```
-Initial Diagnosis → Fix → Verify
-     ↓ (if not fixed)
-Meta-Think #1 → Fix → Verify
-     ↓ (if not fixed)
-Meta-Think #2 → Fix → Verify
-     ↓ (if not fixed)
-Meta-Think #3 → Fix → Verify
-     ↓ (if still not fixed)
-Show diagnostic report + ask for help
-```
-
-Each "Fix" phase runs up to 3 rounds of: Observe → AI Diagnose → Execute → Verify
-
-Total maximum: 9 automated repair attempts with 3 strategy changes.
-
-### AI Integration
-
-- Uses **Claude Opus** (`anthropic/claude-opus-4-6`) via OpenRouter
-- Looks for your OpenRouter API key in `~/.openclaw/openclaw.json` automatically
-- If not found, asks you to enter it in the UI (with clear trust indicators)
-
-### Real-time Updates
-
-The web UI receives live progress via SSE (Server-Sent Events). You watch the diagnosis and repair happen in real time.
-
-## Trust & Privacy
+## What it does
 
-- **No data sent to any server except OpenRouter** (for AI analysis)
-- **API key used only in-session**, never stored to disk
-- **All fixes run locally** on your machine
-- **Open source** — you can verify everything
+1. **Scans** your OpenClaw installation (read-only, zero risk)
+2. **Analyzes** with AI to find what's wrong
+3. **Shows** the diagnosis + repair plan clearly
+4. **Fixes** with one click, in real-time
+5. **Verifies** the fix worked
+6. If not fixed: retries with a different strategy (up to 9 attempts)
 
 ## What it diagnoses
 
 - Gateway not running or crashed
-- Port 18789 conflicts
-- Config file validation errors (invalid JSON5, unknown fields)
-- Missing `gateway.mode: "local"` in config
-- LaunchAgent plist with broken Node.js paths (nvm/fnm/volta)
-- Proxy environment variables interfering
-- Stale launchd service needing reinstall
-- Channel connectivity issues
-- Log file errors (auth failures, rate limits, etc.)
-- And anything else Claude Opus can reason about from system state
-
-## Repair Actions (in priority order)
-
-1. **Official CLI**: `openclaw gateway restart`, `openclaw doctor --yes`, etc.
-2. **System commands**: `kill`, `lsof`, `launchctl`
-3. **File edits**: Config fixes (always backed up first)
-
-## Development
-
-```bash
-git clone <this-repo>
-cd openclaw-doctor
-npm install
-npm run build    # compile TypeScript
-npm start        # run the compiled version
-```
-
-For development with auto-recompile:
-
-```bash
-npm run dev      # uses ts-node directly
-```
-
-## Structure
-
-```
-openclaw-doctor/
-├── src/
-│   ├── index.ts      # Entry: find port, start server, open browser
-│   ├── server.ts     # Express + SSE endpoints
-│   ├── observe.ts    # Read-only system checks
-│   ├── diagnose.ts   # OpenRouter/Claude Opus integration
-│   ├── execute.ts    # Execute repair actions
-│   ├── verify.ts     # Verify fix worked
-│   └── loop.ts       # Three-layer loop controller
-├── web/
-│   └── index.html    # Single-page UI (inline CSS+JS)
-├── context/
-│   ├── openclaw-arch.md    # OpenClaw architecture knowledge
-│   ├── cli-reference.md    # CLI commands reference
-│   ├── log-guide.md        # Log locations and formats
-│   └── config-schema.md    # Config file schema
-└── dist/             # Compiled JS (generated by `npm run build`)
-```
+- Port conflicts
+- Config file errors (invalid JSON, unknown fields)
+- Proxy environment variables blocking connections
+- Wrong model IDs causing HTTP 400
+- Stale LaunchAgent needing reinstall
+- And more — AI reasons from real system state
+
+## Privacy
+
+- Your OpenClaw config is **partially redacted** before analysis
+- Data sent only to our diagnostic service for analysis, **nothing stored**
+- All fixes run **locally on your machine**
+- Open source — verify everything
 
 ## License
 

package/package.json

@@ -1,22 +1,36 @@
 {
   "name": "clawaid",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI-powered diagnostic and repair tool for OpenClaw",
   "main": "dist/index.js",
   "bin": {
-    "clawaid": "./dist/index.js"
+    "clawaid": "dist/index.js"
   },
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "ts-node src/index.ts"
   },
-  "keywords": ["openclaw", "diagnostics", "repair", "ai", "clawaid"],
+  "keywords": [
+    "openclaw",
+    "diagnostics",
+    "repair",
+    "ai",
+    "clawaid"
+  ],
   "author": "clawaid",
   "license": "MIT",
-  "files": ["dist", "web"],
-  "engines": { "node": ">=18" },
-  "repository": { "type": "git", "url": "https://github.com/jjj5666/clawaid" },
+  "files": [
+    "dist",
+    "web"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jjj5666/clawaid.git"
+  },
   "dependencies": {
     "express": "^4.18.2",
     "axios": "^1.6.2",

package/web/index.html

@@ -749,7 +749,7 @@
   </div>
 
   <div class="footer">
-    <p>ClawAid v1.0.0 · <a href="https://github.com/openclaw" target="_blank">GitHub</a></p>
+    <p>ClawAid v1.0.0 · <a href="https://github.com/jjj5666/clawaid" target="_blank">GitHub</a></p>
   </div>
 
 </div>