
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.
End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests. Use when Codex needs to run, rerun, debug, or interpret VM-based install, onboarding, gateway smoke tests, latest-release-to-main upgrade checks, fresh snapshot retests, or optional Discord roundtrip verification under Parallels.
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
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).
Capture and automate macOS UI with the Peekaboo CLI.
Discord ops via the message tool (channel=discord).
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.
Local text-to-speech via sherpa-onnx (offline, no cloud)
Route plain-language requests for Pi, Claude Code, Codex, Cursor, Copilot, OpenClaw ACP, OpenCode, Gemini CLI, Qwen, Kiro, Kimi, iFlow, Factory Droid, Kilocode, or ACP harness work into either OpenClaw ACP runtime sessions or direct acpx-driven sessions ("telephone game" flow). For coding-agent thread requests, read this skill first, then use only `sessions_spawn` for thread creation.
Feishu permission management for documents and files. Activate when user mentions sharing, permissions, collaborators.
Local speech-to-text with the Whisper CLI (no API key).
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.
GitHub operations via `gh` CLI: issues, PRs, CI runs, code review, API queries. Use when: (1) checking PR status or CI, (2) creating/commenting on issues, (3) listing/filtering PRs or issues, (4) viewing run logs. NOT for: complex web UI interactions requiring manual browser flows (use browser tooling when available), bulk operations across many repos (script with gh api), or when gh auth is not configured.
QQBot 定时提醒。支持一次性和周期性提醒的创建、查询、取消。当通过 QQ 通道通信且涉及提醒/定时任务时使用。
Control Eight Sleep pods (status, temperature, alarms, schedules).
Fetch GitHub issues, spawn sub-agents to implement fixes and open PRs, then monitor and address PR review comments. Usage: /gh-issues [owner/repo] [--label bug] [--limit 5] [--milestone v1.0] [--assignee @me] [--fork user/repo] [--watch] [--interval 5] [--reviews-only] [--cron] [--dry-run] [--model glm-5] [--notify-channel -1002381931352]
Run the macOS Parallels smoke harness with Discord end-to-end roundtrip verification, including guest send, host verification, host reply, and guest readback.
Feishu document read/write operations. Activate when user mentions Feishu docs, cloud docs, or docx links.
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
Use the diffs tool to produce real, shareable diffs (viewer URL, file artifact, or both) instead of manual edit summaries.
Create, edit, improve, or audit AgentSkills. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory (moving files to references/ or scripts/, removing stale content, validating against the AgentSkills spec). Triggers on phrases like "create a skill", "author a skill", "tidy up a skill", "improve this skill", "review the skill", "clean up the skill", "audit the skill".
Maintainer workflow for reviewing, triaging, preparing, closing, or landing OpenClaw pull requests and related issues. Use when Codex needs to validate bug-fix claims, search for related issues or PRs, apply or recommend close/reason labels, prepare GitHub comments safely, check review-thread follow-up, or perform maintainer-style PR decision making before merge or closure.
Notion API for creating and managing pages, databases, and blocks.
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
QQBot 富媒体收发能力。使用 <qqmedia> 标签,系统根据文件扩展名自动识别类型(图片/语音/视频/文件)。
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
ElevenLabs text-to-speech with mac-style say UX.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
Extract frames or short clips from videos using ffmpeg.
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.
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Start voice calls via the OpenClaw voice-call plugin.
OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.
Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
Manage Apple Reminders via remindctl CLI (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
Create, search, and manage Bear notes via grizzly CLI.
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.
Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
Control Sonos speakers (discover/status/play/volume/group).
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Feishu cloud storage file management. Activate when user mentions cloud space, folders, drive.
Transcribe audio via OpenAI Audio Transcriptions API (Whisper).
Investigate `pnpm test` memory growth, Vitest worker OOMs, and suspicious RSS increases in OpenClaw using the `scripts/test-parallel.mjs` heap snapshot tooling. Use when Codex needs to reproduce test-lane memory growth, collect repeated `.heapsnapshot` files, compare snapshots from the same worker PID, triage likely transformed-module retention versus likely runtime leaks, and fix or reduce the impact by patching cleanup logic or isolating hotspot tests.
Tavily web search, content extraction, and research tools.
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.
Feishu knowledge base navigation. Activate when user mentions knowledge base, wiki, or wiki links.
Capture frames or clips from RTSP/ONVIF cameras.
# Canvas Skill Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android). ## Overview The canvas tool lets you present web content on any connected node's canvas view. Great for: - Displaying games, visualizations, dashboards - Showing generated HTML content - Interactive demos ## How It Works ### Architecture ``` ┌─────────────────┐ ┌──────────────────┐ ┌─────────────┐ │ Canvas Host │────▶│ Node Bridge │────▶│ Node App │ │ (HTTP Server) │ │ (TCP
Gemini CLI for one-shot Q&A, summaries, and generation.
Control Philips Hue lights and scenes via the OpenHue CLI.
Manage Trello boards, lists, and cards via the Trello REST API.
Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.
Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with channel="bluebubbles".
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Triage GitHub security advisories for OpenClaw with high-confidence close/keep decisions, exact tag and commit verification, trust-model checks, optional hardening notes, and a final reply ready to post and copy to clipboard.
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.
Maintain an Obsidian-friendly memory wiki vault with wikilinks, frontmatter, and official Obsidian CLI awareness.
Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
Edit PDFs with natural-language instructions using the nano-pdf CLI.
Host security hardening and risk-tolerance configuration for OpenClaw deployments. Use when a user asks for security audits, firewall/SSH/update hardening, risk posture, exposure review, OpenClaw cron scheduling for periodic checks, or version status checks on a machine running OpenClaw (laptop, workstation, Pi, VPS).
Search and analyze your own session logs (older/parent conversations) using jq.
Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed.
Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps. Use when QR/setup code/manual connect fails, local Wi-Fi works but VPS/tailnet does not, or errors mention pairing required, unauthorized, bootstrap token invalid or expired, gateway.bind, gateway.remote.url, Tailscale, or plugins.entries.device-pair.config.publicUrl.
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
QQ 频道管理技能。查询频道列表、子频道、成员、发帖、公告、日程等操作。使用 qqbot_channel_api 工具代理 QQ 开放平台 HTTP 接口,自动处理 Token 鉴权。当用户需要查看频道、管理子频道、查询成员、发布帖子/公告/日程时使用。
Maintainer workflow for OpenClaw GitHub Security Advisories (GHSA). Use when Codex needs to inspect, patch, validate, or publish a repo advisory, verify private-fork state, prepare advisory Markdown or JSON payloads safely, handle GHSA API-specific publish constraints, or confirm advisory publish success.
Delegate coding tasks to Codex, Claude Code, or Pi agents via background process. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative coding that needs file exploration. NOT for: simple one-liner fixes (just edit), reading code (use read tool), thread-bound ACP harness requests in chat (for example spawn/run Codex or Claude Code in a Discord thread; use sessions_spawn with runtime:"acp"), or any work in ~/clawd workspace (never spawn agents here). Claude Code: use --print --permission-mode bypassPermissions (no PTY). Codex/Pi/OpenCode: pty:true required.
Claude Code-only work routing: delegate implementation, fixing, exploratory subagents, rebasing, and PR merging/landing to Codex CLI while Claude specifies, decides, reviews, and verifies. Direct hands-on delegation requires ANTHROPIC_BASE_URL to be unset or neither loopback nor gorillaclaw.sheep-coho.ts.net. Codex-backed autoreview is always allowed and preferred, independent of environment.
Codex 1M context: direct OpenAI Responses API inference, safe Sol/Terra/Luna input headroom, Keychain delivery, and Mac fleet rollout.
Remote Macs: MacBook, Mac Studio, clawmac, megaclaw, Tailscale, SSH, OpenClaw.
REQUIRED before ANY `op` command or whenever a task needs an API key, token, password, credential, or secret (OPENAI_API_KEY, ANTHROPIC_API_KEY, deploy tokens, live-test keys). Prompt-free 1Password service-account reads; wrong invocations spam macOS dialogs.
Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.
npm registry ops: login, whoami, names, publish; 1Password tmux.
macOS app release: Sparkle, notarization, GitHub Release, Homebrew, closeout.
GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.
Mac fleet upkeep: global packages, safe repo sync, Xcode, disk, Trash, and health.
xurl X API CLI: install, auth, app choice, shortcuts, raw endpoints.
ClawSweeper status: URLs, workflow health, active workers, ops snapshot.
Xcode fleet sync: signed archives, compatibility, install, selection, first launch.
ClickClack ops: chat app, Cloudflare Workers deploy, DNS/docs/app, container rollout.
macOS screenshots, UI inspect, clicks, typing, app/window automation.
Codex/OpenClaw skill audit: live budget, usage, duplicates, compact descriptions.
GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.
GitHub PR/issue agent transcripts: redact, preview, and insert safely.
Existing Chrome automation: Chrome plugin first, mcporter fallback.
OpenClaw session relay: prompts/posts via local/remote acpx over SSH.
Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.
SwiftUI view refactor/review: layout, DI, Observation, view models.
Codex debugging: codex-rs core/tui/exec/cli/app-server/config.
Release tweets: draft/copy/post from changelog, tags, npm/appcast, artifacts.
Discord-backed OpenClaw agent/session relay; not archive search.
yt-dlp downloads: video, audio, subtitles, transcripts, clips, playlists.
SwiftUI Liquid Glass: implement, adopt, refactor, review correctness/perf/design.
Things 3 via things CLI: add, list, search, update, delete, verify.
Obsidian vault: search/read/write notes, backlinks, Bases, Canvas.
DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.
Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.
Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.
Parallels macOS VM lab: GUI automation, Peekaboo, TCC, Ghostty.
Apple Reminders via rem CLI: add, list, search, update, complete, delete.
Speaking ops: invites, keynotes, panels, Gmail/calendar, conferences.
SSH triage: Remote Login, launchd sshd, pre-auth closes, stale sessions.
Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.
Twilio SMS CLI: buy/list/keep numbers, send/check messages, credential routing.
Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.
GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.
Swift concurrency review/fix: compiler errors, Sendable, isolation, remediation.
GitHub contributor context: identity, activity, trust, company/team signal.
OpenAI Images API: batches, prompt sampler, gallery.
Wrangler CLI: Workers, KV, tail, deploy, account routing.
Oracle second-model review: bundle prompts/files, debug, refactor, design.
WhatsApp router: history/search/read/send; wacrawl read, wacli live.
Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.
Frontend UI: pages, apps, components, polished non-generic design.
Native app performance: xctrace, Time Profiler, traces, hotspots.
Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.
Cloudflare platform: Workers, Pages, KV/D1/R2, AI, Tunnel, WAF, IaC.
Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.
Cloudflare Agents SDK: stateful agents, RPC, workflows, queues, WebSockets.
Cloudflare Registrar: domain availability, prices, registration via mcporter.
Cloudflare Email Service: send/routing, Worker bindings, REST, SPF/DKIM/DMARC.
clawpatch release: version/changelog, CI, npm publish, GitHub release, verify.
Auto Review closeout. Codex review is the default when no engine is set and is the recommended reviewer.
Release Peekaboo CLI/Mac app: service-account 1Password notarization, npm/GitHub release, appcast, verification, closeout.
Release signed macOS apps with Sparkle, notarization, GitHub Releases, Homebrew checks, and post-release closeout.
Codex autoreview/code review closeout: local dirty changes, PR branch vs main, parallel tests.
Brave API search/extraction: docs, facts, pages; no browser.
SwiftUI performance: render, scroll, CPU/memory, updates, layout, Instruments.
CLI UX/spec: args, flags, help, output, errors, config, dry-run.
Set up and use 1Password CLI (op, one-password). Use when installing the CLI, enabling desktop app integration, signing in, selecting Peter's multi-account setup, or storing/reading/injecting/running secrets via op. Always use tmux for op commands.
Use when launching Clownfish in GitHub Actions to create or update one guarded GitHub implementation PR from issue/PR refs, a ClawSweeper report, a custom maintainer prompt, or to opt an existing Clownfish PR into ClawSweeper-reviewed cloud automerge.
Diagnose Peter's local Sonos reliability issues on UniFi: discovery, firmware skew, packet loss/latency, AP/radio/client placement, mesh uplinks, multicast/IGMP settings, and safe UniFi read-only audits. Use when asked about Sonos, UniFi Wi-Fi reliability, speakers dropping, grouping/discovery problems, or network tuning for Sonos.