@karmaniverous/jeeves-watcher-openclaw

OpenClaw plugin for jeeves-watcher — semantic search and metadata enrichment tools for your AI agent.

Prerequisites

A running jeeves-watcher service with its REST API accessible.

Installation

Standard (OpenClaw CLI)

openclaw plugins install @karmaniverous/jeeves-watcher-openclaw

Self-Installer (Windows workaround)

OpenClaw's plugins install command has a known spawn EINVAL bug on Windows. This package includes a self-installer that bypasses the issue:

npx @karmaniverous/jeeves-watcher-openclaw install

This copies the plugin into OpenClaw's extensions directory and patches the config. To remove:

npx @karmaniverous/jeeves-watcher-openclaw uninstall

Non-default installations: Set OPENCLAW_CONFIG (path to openclaw.json) or OPENCLAW_HOME (path to .openclaw directory) if OpenClaw is not installed at the default location.

After install or uninstall, restart the OpenClaw gateway to apply changes.

Configuration

Set the apiUrl in the plugin configuration to point at your jeeves-watcher service:

{
  "apiUrl": "http://127.0.0.1:1936"
}

Dynamic TOOLS.md Injection

On startup, the plugin writes a ## Watcher section to TOOLS.md in the agent's workspace, providing a live menu of indexed content, score thresholds, and escalation rules. This refreshes every 60 seconds. On uninstall, the CLI removes the section.

Tools

| Tool | Description | |------|-------------| | watcher_status | Service health, uptime, and collection stats | | watcher_search | Semantic search across indexed documents | | watcher_enrich | Enrich document metadata via rules engine | | watcher_query | Query the merged virtual document via JSONPath | | watcher_validate | Validate a watcher configuration | | watcher_config_apply | Apply a new configuration | | watcher_reindex | Trigger a full reindex | | watcher_scan | Filter-only point query with cursor pagination | | watcher_issues | List indexing issues and errors |

Documentation

Full docs for the jeeves-watcher service and this plugin:

docs.karmanivero.us/jeeves-watcher

License

BSD-3-Clause