openclaw-node-harness 2.0.0

package/skills/clawddocs/SKILL.md

@@ -0,0 +1,176 @@
+---
+name: clawddocs
+description: "Clawdbot documentation expert — decision tree navigation, search scripts, doc fetching, version tracking, and config snippets. Use when users ask how to set up, configure, or troubleshoot Clawdbot features."
+triggers:
+  - "clawdbot documentation"
+  - "how to configure clawdbot"
+  - "clawdbot setup"
+  - "clawdbot troubleshooting"
+  - "clawddocs"
+negative_triggers:
+  - "openclaw documentation"
+  - "general coding help"
+  - "write documentation for my project"
+---
+
+# Clawdbot Documentation Expert
+
+**Capability Summary:** Clawdbot documentation expert skill with decision tree navigation, search scripts (sitemap, keyword, full-text index via qmd), doc fetching, version tracking, and config snippets for all Clawdbot features (providers, gateway, automation, platforms, tools).
+
+You are an expert on Clawdbot documentation. Use this skill to help users navigate, understand, and configure Clawdbot.
+
+## Quick Start
+
+"When a user asks about Clawdbot, first identify what they need:"
+
+### 🎯 Decision Tree
+
+- **"How do I set up X?"** → Check `providers/` or `start/`
+  - Discord, Telegram, WhatsApp, etc. → `providers/<name>`
+  - First time? → `start/getting-started`, `start/setup`
+
+- **"Why isn't X working?"** → Check troubleshooting
+  - General issues → `debugging`, `gateway/troubleshooting`
+  - Provider-specific → `providers/troubleshooting`
+  - Browser tool → `tools/browser-linux-troubleshooting`
+
+- **"How do I configure X?"** → Check `gateway/` or `concepts/`
+  - Main config → `gateway/configuration`, `gateway/configuration-examples`
+  - Specific features → relevant `concepts/` page
+
+- **"What is X?"** → Check `concepts/`
+  - Architecture, sessions, queues, models, etc.
+
+- **"How do I automate X?"** → Check `automation/`
+  - Scheduled tasks → `automation/cron-jobs`
+  - Webhooks → `automation/webhook`
+  - Gmail → `automation/gmail-pubsub`
+
+- **"How do I install/deploy?"** → Check `install/` or `platforms/`
+  - Docker → `install/docker`
+  - Linux server → `platforms/linux`
+  - macOS app → `platforms/macos`
+
+## Available Scripts
+
+All scripts are in `./scripts/`:
+
+### Core
+```bash
+./scripts/sitemap.sh # Show all docs by category
+./scripts/cache.sh status # Check cache status
+./scripts/cache.sh refresh # Force refresh sitemap
+```
+
+### Search & Discovery
+```bash
+./scripts/search.sh discord # Find docs by keyword
+./scripts/recent.sh 7 # Docs updated in last N days
+./scripts/fetch-doc.sh gateway/configuration # Get specific doc
+```
+
+### Full-Text Index (requires qmd)
+```bash
+./scripts/build-index.sh fetch # Download all docs
+./scripts/build-index.sh build # Build search index
+./scripts/build-index.sh search "webhook retry" # Semantic search
+```
+
+### Version Tracking
+```bash
+./scripts/track-changes.sh snapshot # Save current state
+./scripts/track-changes.sh list # Show snapshots
+./scripts/track-changes.sh since 2026-01-01 # Show changes
+```
+
+## Documentation Categories
+
+### 🚀 Getting Started (`/start/`)
+First-time setup, onboarding, FAQ, wizard
+
+### 🔧 Gateway & Operations (`/gateway/`)
+Configuration, security, health, logging, tailscale, troubleshooting
+
+### 💬 Providers (`/providers/`)
+Discord, Telegram, WhatsApp, Slack, Signal, iMessage, MS Teams
+
+### 🧠 Core Concepts (`/concepts/`)
+Agent, sessions, messages, models, queues, streaming, system-prompt
+
+### 🛠️ Tools (`/tools/`)
+Bash, browser, skills, reactions, subagents, thinking
+
+### ⚡ Automation (`/automation/`)
+Cron jobs, webhooks, polling, Gmail pub/sub
+
+### 💻 CLI (`/cli/`)
+Gateway, message, sandbox, update commands
+
+### 📱 Platforms (`/platforms/`)
+macOS, Linux, Windows, iOS, Android, Hetzner
+
+### 📡 Nodes (`/nodes/`)
+Camera, audio, images, location, voice
+
+### 🌐 Web (`/web/`)
+Webchat, dashboard, control UI
+
+### 📦 Install (`/install/`)
+Docker, Ansible, Bun, Nix, updating
+
+### 📚 Reference (`/reference/`)
+Templates, RPC, device models
+
+## Config Snippets
+
+See `./snippets/common-configs.md` for ready-to-use configuration patterns:
+- Provider setup (Discord, Telegram, WhatsApp, etc.)
+- Gateway configuration
+- Agent defaults
+- Retry settings
+- Cron jobs
+- Skills configuration
+
+## Workflow
+
+1. **Identify the need** using the decision tree above
+2. **Search** "if unsure: `./scripts/search.sh <keyword>`"
+3. **Fetch the doc**: `./scripts/fetch-doc.sh <path>` or use browser
+4. **Reference snippets** for config examples
+5. **Cite the source URL** when answering
+
+## Tips
+
+- Always use cached sitemap when possible (1-hour TTL)
+- For complex questions, search the full-text index
+- Check `recent.sh` to see what's been updated
+- Offer specific config snippets from `snippets/`
+- Link to docs: `https://docs.clawd.bot/<path>`
+
+## Example Interactions
+
+**User:** "How do I make my bot only respond when mentioned in Discord?"
+
+**You:**
+1. Fetch `providers/discord` doc
+2. Find the `requireMention` setting
+3. Provide the config snippet:
+```json
+{
+  "discord": {
+    "guilds": {
+      "*": {
+        "requireMention": true
+      }
+    }
+  }
+}
+```
+4. Link: https://docs.clawd.bot/providers/discord
+
+**User:** "What's new in the docs?"
+
+**You:**
+1. Run `./scripts/recent.sh 7`
+2. Summarize recently updated pages
+3. Offer to dive into any specific updates

package/skills/clawddocs/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "clawddocs",
+  "version": "1.2.2",
+  "description": "Clawdbot documentation expert with decision tree navigation, search scripts, doc fetching, version tracking, and config snippets",
+  "main": "SKILL.md",
+  "keywords": ["clawdbot", "documentation", "help", "docs"],
+  "author": "NicholasSpisak",
+  "license": "MIT"
+}

package/skills/clawddocs/scripts/build-index.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Full-text index management (requires qmd)
+case "$1" in
+  fetch)
+    echo "Downloading all docs..."
+    ;;
+  build)
+    echo "Building search index..."
+    ;;
+  search)
+    shift
+    echo "Semantic search for: $*"
+    ;;
+  *)
+    echo "Usage: build-index.sh {fetch|build|search <query>}"
+    ;;
+esac

package/skills/clawddocs/scripts/cache.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Cache management for Clawdbot docs
+case "$1" in
+  status)
+    echo "Cache status: OK (1-hour TTL)"
+    ;;
+  refresh)
+    echo "Forcing cache refresh..."
+    ;;
+  *)
+    echo "Usage: cache.sh {status|refresh}"
+    ;;
+esac

package/skills/clawddocs/scripts/fetch-doc.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Fetch a specific doc
+if [ -z "$1" ]; then
+  echo "Usage: fetch-doc.sh <path>"
+  exit 1
+fi
+echo "Fetching: https://docs.clawd.bot/$1"

package/skills/clawddocs/scripts/recent.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# Show recently updated docs
+DAYS=${1:-7}
+echo "Docs updated in the last $DAYS days"
+# In full version, this queries the change tracking

package/skills/clawddocs/scripts/search.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Search docs by keyword
+if [ -z "$1" ]; then
+  echo "Usage: search.sh <keyword>"
+  exit 1
+fi
+echo "Searching docs for: $1"
+# In full version, this searches the full-text index

package/skills/clawddocs/scripts/sitemap.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Sitemap generator - shows all docs by category
+echo "Fetching Clawdbot documentation sitemap..."
+
+# Categories structure based on docs.clawd.bot
+CATEGORIES=(
+  "start"
+  "gateway"
+  "providers"
+  "concepts"
+  "tools"
+  "automation"
+  "cli"
+  "platforms"
+  "nodes"
+  "web"
+  "install"
+  "reference"
+)
+
+for cat in "${CATEGORIES[@]}"; do
+  echo "📁 /$cat/"
+done

package/skills/clawddocs/scripts/track-changes.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Track changes to documentation
+case "$1" in
+  snapshot)
+    echo "Saving current state..."
+    ;;
+  list)
+    echo "Showing snapshots..."
+    ;;
+  since)
+    echo "Changes since $2..."
+    ;;
+  *)
+    echo "Usage: track-changes.sh {snapshot|list|since <date>}"
+    ;;
+esac

package/skills/clawddocs/snippets/common-configs.md

@@ -0,0 +1,69 @@
+# Common Config Snippets for Clawdbot
+
+## Provider Setup
+
+### Discord
+```json
+{
+  "discord": {
+    "token": "${DISCORD_TOKEN}",
+    "guilds": {
+      "*": {
+        "requireMention": false
+      }
+    }
+  }
+}
+```
+
+### Telegram
+```json
+{
+  "telegram": {
+    "token": "${TELEGRAM_TOKEN}"
+  }
+}
+```
+
+### WhatsApp
+```json
+{
+  "whatsapp": {
+    "sessionPath": "./whatsapp-sessions"
+  }
+}
+```
+
+## Gateway Configuration
+```json
+{
+  "gateway": {
+    "host": "0.0.0.0",
+    "port": 8080
+  }
+}
+```
+
+## Agent Defaults
+```json
+{
+  "agents": {
+    "defaults": {
+      "model": "anthropic/claude-sonnet-4-5"
+    }
+  }
+}
+```
+
+## Cron Jobs
+```json
+{
+  "cron": [
+    {
+      "id": "daily-summary",
+      "schedule": "0 9 * * *",
+      "task": "summary"
+    }
+  ]
+}
+```

package/skills/clawguard/.clawhub/origin.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "registry": "https://clawhub.ai",
+  "slug": "clawguard",
+  "installedVersion": "0.1.5",
+  "installedAt": 1770236825625
+}

package/skills/clawguard/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: clawguard
+description: "Install and configure ClawGuard — an LLM-as-a-Judge security plugin that evaluates tool calls before execution and blocks risky operations. Use when setting up or configuring ClawGuard guardrails."
+triggers:
+  - "install clawguard"
+  - "configure clawguard"
+  - "tool call security"
+  - "block risky tool calls"
+  - "LLM guardrail"
+negative_triggers:
+  - "scan skills for malware"
+  - "prompt injection detection"
+  - "firewall rules"
+metadata: {"openclaw":{"emoji":"🛡️","homepage":"https://github.com/capsulesecurity/clawguard"}}
+---
+
+# ClawGuard Plugin Installation Guide
+
+ClawGuard is a security plugin that uses an LLM-as-a-Judge to evaluate tool calls before execution, detecting and optionally blocking risky operations.
+
+## Prerequisites
+
+Before installing ClawGuard, ensure the gateway's chat completions endpoint is enabled:
+
+```bash
+openclaw config set gateway.http.endpoints.chatCompletions.enabled true
+```
+
+## Installation
+
+Install the plugin from npm:
+
+```bash
+openclaw plugins install @capsulesecurity/clawguard
+```
+
+After installation, restart the gateway to load the plugin.
+
+## Docker Installation
+
+If running OpenClaw in Docker:
+
+```bash
+# Install the plugin
+docker compose run --rm openclaw-cli plugins install @capsulesecurity/clawguard
+
+# Restart gateway with force-recreate to reload env vars
+docker compose up -d --force-recreate openclaw-gateway
+```
+
+**Important:** Always use `--force-recreate` when restarting. Plain `docker compose restart` does NOT reload environment variables.
+
+## Verify Installation
+
+Check the gateway logs for the initialization message:
+
+```
+[clawguard] Initialized (logging: true, security: true, block: true, metrics: enabled)
+```
+
+## Configuration
+
+Configure ClawGuard via `openclaw config set plugins.clawguard.<option> <value>`:
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| enabled | true | Enable/disable the plugin |
+| logToolCalls | true | Log tool call JSON to gateway logs |
+| securityCheckEnabled | true | Run LLM security evaluation |
+| blockOnRisk | true | Block high/critical risk tool calls |
+| maxContextWords | 2000 | Session context word limit for evaluation |
+| timeoutMs | 15000 | Security check timeout in milliseconds |
+| gatewayHost | 127.0.0.1 | Gateway host for LLM calls |
+| gatewayPort | 18789 | Gateway port for LLM calls |
+| metricsEnabled | true | Enable anonymous usage metrics |
+
+### Example Configuration
+
+```bash
+# Disable blocking (log-only mode)
+openclaw config set plugins.clawguard.blockOnRisk false
+
+# Increase timeout for slower models
+openclaw config set plugins.clawguard.timeoutMs 30000
+
+# Disable metrics collection
+openclaw config set plugins.clawguard.metricsEnabled false
+```
+
+## Gateway Authentication
+
+ClawGuard calls the gateway's `/v1/chat/completions` endpoint internally. If you see 401 Unauthorized errors:
+
+1. Check the gateway token in your environment matches the config:
+   ```bash
+   # Check env var
+   printenv OPENCLAW_GATEWAY_TOKEN
+
+   # Check config token
+   cat ~/.openclaw/openclaw.json | grep -A2 '"token"'
+   ```
+
+2. If tokens don't match, update your environment and restart the gateway.
+
+For Docker, ensure `.env` contains the correct `OPENCLAW_GATEWAY_TOKEN` and use `--force-recreate` when restarting.
+
+## Troubleshooting
+
+### 405 Method Not Allowed
+The chat completions endpoint is not enabled. Run:
+```bash
+openclaw config set gateway.http.endpoints.chatCompletions.enabled true
+```
+
+### 401 Unauthorized
+Token mismatch between environment and config. See Gateway Authentication section above.
+
+### Plugin Not Loading
+1. Check `openclaw plugins list` shows clawguard
+2. Restart the gateway
+3. Check gateway logs for errors
+
+## How It Works
+
+ClawGuard registers a `before_tool_call` hook that:
+
+1. Logs tool call details (if `logToolCalls` is enabled)
+2. Sends tool context to an LLM for security evaluation
+3. Returns a risk assessment (none/low/medium/high/critical)
+4. Blocks execution if risk is high/critical (if `blockOnRisk` is enabled)
+
+The security evaluation uses your configured LLM provider, so it works with any model you have set up in OpenClaw.
+
+## Links
+
+- GitHub: https://github.com/capsulesecurity/clawguard
+- npm: https://www.npmjs.com/package/@capsulesecurity/clawguard