ClosedClaw

Guide for implementing new agent tools for ClosedClaw's AI assistant. Use when adding capabilities like web search, file operations, API integrations, or custom actions. Covers tool factory pattern, parameter validation, registration, and testing.

Guide for creating new messaging channel plugins/extensions for ClosedClaw. Use when adding support for new messaging platforms (e.g., Matrix, Teams, BlueBubbles). Covers plugin structure, CliDeps extension, routing setup, and testing.

Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.

Help with config schema changes and migrations in ClosedClaw. Use when updating config types, syncing Zod schemas, creating migrations, or handling breaking config changes. Covers type definitions, validation, and legacy migration patterns.

Guide for writing and maintaining ClosedClaw documentation. Use when creating docs for new features, channels, tools, or updating existing documentation. Covers markdown conventions, link styles, formatting rules, and documentation structure.

Guide for writing e2e tests for ClosedClaw gateway and channels. Use when testing multi-instance gateway behavior, WebSocket/HTTP surfaces, node pairing, agent workflows with real networking. Covers test helpers, assertion patterns, and common scenarios.

Troubleshooting gateway issues in ClosedClaw. Use when debugging gateway startup failures, port conflicts, lock file issues, WebSocket disconnections, or RPC errors. Covers log analysis, diagnostics, and recovery procedures.

Version bumping, changelog updates, and npm publishing workflow for ClosedClaw. Use when preparing releases, updating versions, managing semantic versioning, creating release tags, or publishing to npm. Covers stable, beta, and dev release channels.

Efficient test execution patterns for ClosedClaw. Use when running tests, debugging test failures, checking coverage, or understanding the multi-config test architecture. Covers unit, gateway, extensions, e2e, and live test suites.

Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.

Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks ClosedClaw to add a note, list notes, search notes, or manage note folders.

Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.

Create, search, and manage Bear notes via grizzly CLI.

X/Twitter CLI for reading, searching, posting, and engagement via cookies.

Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.

BluOS CLI (blu) for discovery, playback, grouping, and volume.

Capture frames or clips from RTSP/ONVIF cameras.

Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.

Control Eight Sleep pods (status, temperature, alarms, schedules).

Reorder Foodora orders + track ETA/status with ordercli. Never confirm without explicit user approval. Triggers: order food, reorder, track ETA.

Gemini CLI for one-shot Q&A, summaries, and generation.

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.

CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).

iMessage/SMS CLI for listing chats, history, watch, and sending.

Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.

Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.

Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.

Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).

Edit PDFs with natural-language instructions using the nano-pdf CLI.

Notion API for creating and managing pages, databases, and blocks.

Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.

Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.

Transcribe audio via OpenAI Audio Transcriptions API (Whisper).

Local speech-to-text with the Whisper CLI (no API key).

Control Philips Hue lights/scenes via the OpenHue CLI.

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).