vilvona 1.0.0

package/docs/plugins/plugin-inventory.md

@@ -0,0 +1,318 @@
+---
+summary: "Generated inventory of OpenClaw plugins shipped in core, published externally, or kept source-only"
+read_when:
+  - You are deciding whether a plugin ships in the core npm package or installs separately
+  - You are updating bundled plugin package metadata or release automation
+  - You need the canonical internal vs external plugin list
+title: "Plugin inventory"
+---
+
+# Plugin inventory
+
+This page is generated from `extensions/*/package.json`, `openclaw.plugin.json`,
+and the root npm package `files` exclusions. Regenerate it with:
+
+```bash
+pnpm plugins:inventory:gen
+```
+
+## Definitions
+
+- **Core npm package:** built into the `openclaw` npm package and available without a separate plugin install.
+- **Official external package:** OpenClaw-maintained plugin omitted from the core npm package, kept in this official inventory, and installed on demand through ClawHub and/or npm.
+- **Source checkout only:** repo-local plugin omitted from published npm artifacts and not advertised as an installable package.
+
+Source checkouts are different from npm installs: after `pnpm install`, bundled
+plugins load from `extensions/<id>` so local edits and package-local workspace
+dependencies are available.
+
+## Install a plugin
+
+Use the install route in each entry to decide whether install is needed. Plugins
+that say `included in OpenClaw` are already present in the core package.
+Official external packages need one install, then a Gateway restart.
+
+For example, Discord is an official external package:
+
+```bash
+openclaw plugins install @openclaw/discord
+openclaw gateway restart
+openclaw plugins inspect discord --runtime --json
+```
+
+During the launch cutover, ordinary bare package specs still install from npm.
+Use `clawhub:@openclaw/discord` or `npm:@openclaw/discord` when you need an
+explicit source. After install, follow the plugin's setup doc, such as
+[Discord](/channels/discord), to add credentials and channel config. See
+[Manage plugins](/plugins/manage-plugins) for update, uninstall, and publishing
+commands.
+
+Each entry lists the package, distribution route, and description.
+
+## Core npm package
+
+90 plugins
+
+- **[admin-http-rpc](/plugins/reference/admin-http-rpc)** (`@openclaw/admin-http-rpc`) - included in OpenClaw. OpenClaw admin HTTP RPC endpoint.
+
+- **[alibaba](/plugins/reference/alibaba)** (`@openclaw/alibaba-provider`) - included in OpenClaw. Adds video generation provider support.
+
+- **[anthropic](/plugins/reference/anthropic)** (`@openclaw/anthropic-provider`) - included in OpenClaw. Adds Anthropic model provider support to OpenClaw.
+
+- **[arcee](/plugins/reference/arcee)** (`@openclaw/arcee-provider`) - included in OpenClaw. Adds Arcee model provider support to OpenClaw.
+
+- **[azure-speech](/plugins/reference/azure-speech)** (`@openclaw/azure-speech`) - included in OpenClaw. Azure AI Speech text-to-speech (MP3, native Ogg/Opus voice notes, PCM telephony).
+
+- **[bonjour](/plugins/reference/bonjour)** (`@openclaw/bonjour`) - included in OpenClaw. Advertise the local OpenClaw gateway over Bonjour/mDNS.
+
+- **[browser](/plugins/reference/browser)** (`@openclaw/browser-plugin`) - included in OpenClaw. Adds agent-callable tools.
+
+- **[byteplus](/plugins/reference/byteplus)** (`@openclaw/byteplus-provider`) - included in OpenClaw. Adds BytePlus, BytePlus Plan model provider support to OpenClaw.
+
+- **[canvas](/plugins/reference/canvas)** (`@openclaw/canvas-plugin`) - included in OpenClaw. Experimental Canvas control and A2UI rendering surfaces for paired nodes.
+
+- **[cerebras](/plugins/reference/cerebras)** (`@openclaw/cerebras-provider`) - included in OpenClaw. Adds Cerebras model provider support to OpenClaw.
+
+- **[chutes](/plugins/reference/chutes)** (`@openclaw/chutes-provider`) - included in OpenClaw. Adds Chutes model provider support to OpenClaw.
+
+- **[clickclack](/plugins/reference/clickclack)** (`@openclaw/clickclack`) - included in OpenClaw. Adds the Clickclack channel surface for sending and receiving OpenClaw messages.
+
+- **[cloudflare-ai-gateway](/plugins/reference/cloudflare-ai-gateway)** (`@openclaw/cloudflare-ai-gateway-provider`) - included in OpenClaw. Adds Cloudflare AI Gateway model provider support to OpenClaw.
+
+- **[codex-supervisor](/plugins/reference/codex-supervisor)** (`@openclaw/codex-supervisor`) - included in OpenClaw. Supervise Codex app-server sessions from OpenClaw.
+
+- **[comfy](/plugins/reference/comfy)** (`@openclaw/comfy-provider`) - included in OpenClaw. Adds ComfyUI model provider support to OpenClaw.
+
+- **[copilot-proxy](/plugins/reference/copilot-proxy)** (`@openclaw/copilot-proxy`) - included in OpenClaw. Adds Copilot Proxy model provider support to OpenClaw.
+
+- **[deepgram](/plugins/reference/deepgram)** (`@openclaw/deepgram-provider`) - included in OpenClaw. Adds media understanding provider support. Adds realtime transcription provider support.
+
+- **[deepinfra](/plugins/reference/deepinfra)** (`@openclaw/deepinfra-provider`) - included in OpenClaw. Adds DeepInfra model provider support to OpenClaw.
+
+- **[deepseek](/plugins/reference/deepseek)** (`@openclaw/deepseek-provider`) - included in OpenClaw. Adds DeepSeek model provider support to OpenClaw.
+
+- **[document-extract](/plugins/reference/document-extract)** (`@openclaw/document-extract-plugin`) - included in OpenClaw. Extract text and fallback page images from local document attachments.
+
+- **[duckduckgo](/plugins/reference/duckduckgo)** (`@openclaw/duckduckgo-plugin`) - included in OpenClaw. Adds web search provider support.
+
+- **[elevenlabs](/plugins/reference/elevenlabs)** (`@openclaw/elevenlabs-speech`) - included in OpenClaw. Adds media understanding provider support. Adds realtime transcription provider support. Adds text-to-speech provider support.
+
+- **[exa](/plugins/reference/exa)** (`@openclaw/exa-plugin`) - included in OpenClaw. Adds web search provider support.
+
+- **[fal](/plugins/reference/fal)** (`@openclaw/fal-provider`) - included in OpenClaw. Adds fal model provider support to OpenClaw.
+
+- **[file-transfer](/plugins/reference/file-transfer)** (`@openclaw/file-transfer`) - included in OpenClaw. Fetch, list, and write files on paired nodes via dedicated node commands. Bypasses bash stdout truncation by using base64 over node.invoke for binaries up to 16 MB.
+
+- **[firecrawl](/plugins/reference/firecrawl)** (`@openclaw/firecrawl-plugin`) - included in OpenClaw. Adds agent-callable tools. Adds web fetch provider support. Adds web search provider support.
+
+- **[fireworks](/plugins/reference/fireworks)** (`@openclaw/fireworks-provider`) - included in OpenClaw. Adds Fireworks model provider support to OpenClaw.
+
+- **[github-copilot](/plugins/reference/github-copilot)** (`@openclaw/github-copilot-provider`) - included in OpenClaw. Adds GitHub Copilot model provider support to OpenClaw.
+
+- **[gmi](/plugins/reference/gmi)** (`@openclaw/gmi-provider`) - included in OpenClaw. Adds Gmi, Gmi Cloud, Gmicloud model provider support to OpenClaw.
+
+- **[google](/plugins/reference/google)** (`@openclaw/google-plugin`) - included in OpenClaw. Adds Google, Google Gemini CLI, Google Vertex model provider support to OpenClaw.
+
+- **[gradium](/plugins/reference/gradium)** (`@openclaw/gradium-speech`) - included in OpenClaw. Adds text-to-speech provider support.
+
+- **[groq](/plugins/reference/groq)** (`@openclaw/groq-provider`) - included in OpenClaw. Adds Groq model provider support to OpenClaw.
+
+- **[huggingface](/plugins/reference/huggingface)** (`@openclaw/huggingface-provider`) - included in OpenClaw. Adds Hugging Face model provider support to OpenClaw.
+
+- **[imessage](/plugins/reference/imessage)** (`@openclaw/imessage`) - included in OpenClaw. Adds the iMessage channel surface for sending and receiving OpenClaw messages.
+
+- **[inworld](/plugins/reference/inworld)** (`@openclaw/inworld-speech`) - included in OpenClaw. Inworld streaming text-to-speech (MP3, OGG_OPUS, PCM telephony).
+
+- **[irc](/plugins/reference/irc)** (`@openclaw/irc`) - included in OpenClaw. Adds the IRC channel surface for sending and receiving OpenClaw messages.
+
+- **[kilocode](/plugins/reference/kilocode)** (`@openclaw/kilocode-provider`) - included in OpenClaw. Adds Kilocode model provider support to OpenClaw.
+
+- **[kimi](/plugins/reference/kimi)** (`@openclaw/kimi-provider`) - included in OpenClaw. Adds Kimi, Kimi Coding model provider support to OpenClaw.
+
+- **[litellm](/plugins/reference/litellm)** (`@openclaw/litellm-provider`) - included in OpenClaw. Adds LiteLLM model provider support to OpenClaw.
+
+- **[llm-task](/plugins/reference/llm-task)** (`@openclaw/llm-task`) - included in OpenClaw. Generic JSON-only LLM tool for structured tasks callable from workflows.
+
+- **[lmstudio](/plugins/reference/lmstudio)** (`@openclaw/lmstudio-provider`) - included in OpenClaw. Adds LM Studio model provider support to OpenClaw.
+
+- **[mattermost](/plugins/reference/mattermost)** (`@openclaw/mattermost`) - included in OpenClaw. Adds the Mattermost channel surface for sending and receiving OpenClaw messages.
+
+- **[memory-core](/plugins/reference/memory-core)** (`@openclaw/memory-core`) - included in OpenClaw. Adds agent-callable tools.
+
+- **[memory-wiki](/plugins/reference/memory-wiki)** (`@openclaw/memory-wiki`) - included in OpenClaw. Persistent wiki compiler and Obsidian-friendly knowledge vault for OpenClaw.
+
+- **[microsoft](/plugins/reference/microsoft)** (`@openclaw/microsoft-speech`) - included in OpenClaw. Adds text-to-speech provider support.
+
+- **[microsoft-foundry](/plugins/reference/microsoft-foundry)** (`@openclaw/microsoft-foundry`) - included in OpenClaw. Adds Microsoft Foundry model provider support to OpenClaw.
+
+- **[migrate-claude](/plugins/reference/migrate-claude)** (`@openclaw/migrate-claude`) - included in OpenClaw. Imports Claude Code and Claude Desktop instructions, MCP servers, skills, and safe configuration into OpenClaw.
+
+- **[migrate-hermes](/plugins/reference/migrate-hermes)** (`@openclaw/migrate-hermes`) - included in OpenClaw. Imports Hermes configuration, memories, skills, and supported credentials into OpenClaw.
+
+- **[minimax](/plugins/reference/minimax)** (`@openclaw/minimax-provider`) - included in OpenClaw. Adds MiniMax, MiniMax Portal model provider support to OpenClaw.
+
+- **[mistral](/plugins/reference/mistral)** (`@openclaw/mistral-provider`) - included in OpenClaw. Adds Mistral model provider support to OpenClaw.
+
+- **[moonshot](/plugins/reference/moonshot)** (`@openclaw/moonshot-provider`) - included in OpenClaw. Adds Moonshot model provider support to OpenClaw.
+
+- **[novita](/plugins/reference/novita)** (`@openclaw/novita-provider`) - included in OpenClaw. Adds Novita, Novita AI, Novitaai model provider support to OpenClaw.
+
+- **[nvidia](/plugins/reference/nvidia)** (`@openclaw/nvidia-provider`) - included in OpenClaw. Adds NVIDIA model provider support to OpenClaw.
+
+- **[oc-path](/plugins/reference/oc-path)** (`@openclaw/oc-path`) - included in OpenClaw. Adds the openclaw path CLI for oc:// workspace file addressing.
+
+- **[ollama](/plugins/reference/ollama)** (`@openclaw/ollama-provider`) - included in OpenClaw. Adds Ollama, Ollama Cloud model provider support to OpenClaw.
+
+- **[open-prose](/plugins/reference/open-prose)** (`@openclaw/open-prose`) - included in OpenClaw. OpenProse VM skill pack with a /prose slash command.
+
+- **[openai](/plugins/reference/openai)** (`@openclaw/openai-provider`) - included in OpenClaw. Adds OpenAI model provider support to OpenClaw.
+
+- **[opencode](/plugins/reference/opencode)** (`@openclaw/opencode-provider`) - included in OpenClaw. Adds OpenCode model provider support to OpenClaw.
+
+- **[opencode-go](/plugins/reference/opencode-go)** (`@openclaw/opencode-go-provider`) - included in OpenClaw. Adds OpenCode Go model provider support to OpenClaw.
+
+- **[openrouter](/plugins/reference/openrouter)** (`@openclaw/openrouter-provider`) - included in OpenClaw. Adds OpenRouter model provider support to OpenClaw.
+
+- **[parallel](/tools/parallel-search)** (`@openclaw/parallel-plugin`) - included in OpenClaw. Adds web search provider support.
+
+- **[perplexity](/plugins/reference/perplexity)** (`@openclaw/perplexity-plugin`) - included in OpenClaw. Adds web search provider support.
+
+- **[policy](/plugins/reference/policy)** (`@openclaw/policy`) - included in OpenClaw. Adds policy-backed doctor checks for workspace conformance.
+
+- **[qianfan](/plugins/reference/qianfan)** (`@openclaw/qianfan-provider`) - included in OpenClaw. Adds Qianfan model provider support to OpenClaw.
+
+- **[qwen](/plugins/reference/qwen)** (`@openclaw/qwen-provider`) - included in OpenClaw. Adds Qwen, Qwen Cloud, Model Studio, DashScope, Qwen Oauth, Qwen Portal, Qwen CLI model provider support to OpenClaw.
+
+- **[runway](/plugins/reference/runway)** (`@openclaw/runway-provider`) - included in OpenClaw. Adds video generation provider support.
+
+- **[searxng](/plugins/reference/searxng)** (`@openclaw/searxng-plugin`) - included in OpenClaw. Adds web search provider support.
+
+- **[senseaudio](/plugins/reference/senseaudio)** (`@openclaw/senseaudio-provider`) - included in OpenClaw. Adds media understanding provider support.
+
+- **[sglang](/plugins/reference/sglang)** (`@openclaw/sglang-provider`) - included in OpenClaw. Adds SGLang model provider support to OpenClaw.
+
+- **[signal](/plugins/reference/signal)** (`@openclaw/signal`) - included in OpenClaw. Adds the Signal channel surface for sending and receiving OpenClaw messages.
+
+- **[sms](/plugins/reference/sms)** (`@openclaw/sms`) - included in OpenClaw. Twilio SMS channel plugin for OpenClaw text messages.
+
+- **[stepfun](/plugins/reference/stepfun)** (`@openclaw/stepfun-provider`) - included in OpenClaw. Adds StepFun, StepFun Plan model provider support to OpenClaw.
+
+- **[synthetic](/plugins/reference/synthetic)** (`@openclaw/synthetic-provider`) - included in OpenClaw. Adds Synthetic model provider support to OpenClaw.
+
+- **[tavily](/plugins/reference/tavily)** (`@openclaw/tavily-plugin`) - included in OpenClaw. Adds agent-callable tools. Adds web search provider support.
+
+- **[telegram](/plugins/reference/telegram)** (`@openclaw/telegram`) - included in OpenClaw. Adds the Telegram channel surface for sending and receiving OpenClaw messages.
+
+- **[tencent](/plugins/reference/tencent)** (`@openclaw/tencent-provider`) - included in OpenClaw. Adds Tencent TokenHub model provider support to OpenClaw.
+
+- **[together](/plugins/reference/together)** (`@openclaw/together-provider`) - included in OpenClaw. Adds Together model provider support to OpenClaw.
+
+- **[tts-local-cli](/plugins/reference/tts-local-cli)** (`@openclaw/tts-local-cli`) - included in OpenClaw. Adds text-to-speech provider support.
+
+- **[venice](/plugins/reference/venice)** (`@openclaw/venice-provider`) - included in OpenClaw. Adds Venice model provider support to OpenClaw.
+
+- **[vercel-ai-gateway](/plugins/reference/vercel-ai-gateway)** (`@openclaw/vercel-ai-gateway-provider`) - included in OpenClaw. Adds Vercel AI Gateway model provider support to OpenClaw.
+
+- **[vllm](/plugins/reference/vllm)** (`@openclaw/vllm-provider`) - included in OpenClaw. Adds vLLM model provider support to OpenClaw.
+
+- **[volcengine](/plugins/reference/volcengine)** (`@openclaw/volcengine-provider`) - included in OpenClaw. Adds Volcengine, Volcengine Plan model provider support to OpenClaw.
+
+- **[voyage](/plugins/reference/voyage)** (`@openclaw/voyage-provider`) - included in OpenClaw. Adds memory embedding provider support.
+
+- **[vydra](/plugins/reference/vydra)** (`@openclaw/vydra-provider`) - included in OpenClaw. Adds Vydra model provider support to OpenClaw.
+
+- **[web-readability](/plugins/reference/web-readability)** (`@openclaw/web-readability-plugin`) - included in OpenClaw. Extract readable article content from local HTML web fetch responses.
+
+- **[webhooks](/plugins/reference/webhooks)** (`@openclaw/webhooks`) - included in OpenClaw. Authenticated inbound webhooks that bind external automation to OpenClaw TaskFlows.
+
+- **[workboard](/plugins/reference/workboard)** (`@openclaw/workboard`) - included in OpenClaw. Dashboard workboard for agent-owned issues and sessions.
+
+- **[xai](/plugins/reference/xai)** (`@openclaw/xai-plugin`) - included in OpenClaw. Adds xAI model provider support to OpenClaw.
+
+- **[xiaomi](/plugins/reference/xiaomi)** (`@openclaw/xiaomi-provider`) - included in OpenClaw. Adds Xiaomi, Xiaomi Token Plan model provider support to OpenClaw.
+
+- **[zai](/plugins/reference/zai)** (`@openclaw/zai-provider`) - included in OpenClaw. Adds Z.AI model provider support to OpenClaw.
+
+## Official external packages
+
+35 plugins
+
+- **[acpx](/plugins/reference/acpx)** (`@openclaw/acpx`) - npm; ClawHub. OpenClaw ACP runtime backend with plugin-owned session and transport management.
+
+- **[amazon-bedrock](/plugins/reference/amazon-bedrock)** (`@openclaw/amazon-bedrock-provider`) - npm; ClawHub. OpenClaw Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support.
+
+- **[amazon-bedrock-mantle](/plugins/reference/amazon-bedrock-mantle)** (`@openclaw/amazon-bedrock-mantle-provider`) - npm; ClawHub. OpenClaw Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing.
+
+- **[anthropic-vertex](/plugins/reference/anthropic-vertex)** (`@openclaw/anthropic-vertex-provider`) - npm; ClawHub. OpenClaw Anthropic Vertex provider plugin for Claude models on Google Vertex AI.
+
+- **[brave](/plugins/reference/brave)** (`@openclaw/brave-plugin`) - npm; ClawHub. OpenClaw Brave Search provider plugin for web search.
+
+- **[codex](/plugins/reference/codex)** (`@openclaw/codex`) - npm; ClawHub. OpenClaw Codex app-server harness and model provider plugin with a Codex-managed GPT catalog.
+
+- **[copilot](/plugins/reference/copilot)** (`@openclaw/copilot`) - npm; ClawHub: `clawhub:@openclaw/copilot`. Registers the GitHub Copilot agent runtime.
+
+- **[diagnostics-otel](/plugins/reference/diagnostics-otel)** (`@openclaw/diagnostics-otel`) - npm; ClawHub: `clawhub:@openclaw/diagnostics-otel`. OpenClaw diagnostics OpenTelemetry exporter for metrics and traces.
+
+- **[diagnostics-prometheus](/plugins/reference/diagnostics-prometheus)** (`@openclaw/diagnostics-prometheus`) - npm; ClawHub: `clawhub:@openclaw/diagnostics-prometheus`. OpenClaw diagnostics Prometheus exporter for runtime metrics.
+
+- **[diffs](/plugins/reference/diffs)** (`@openclaw/diffs`) - npm; ClawHub. OpenClaw read-only diff viewer plugin and file renderer for agents.
+
+- **[diffs-language-pack](/plugins/reference/diffs-language-pack)** (`@openclaw/diffs-language-pack`) - npm; ClawHub: `clawhub:@openclaw/diffs-language-pack`. Adds syntax highlighting for languages outside the default diffs viewer set.
+
+- **[discord](/plugins/reference/discord)** (`@openclaw/discord`) - npm; ClawHub. OpenClaw Discord channel plugin for channels, DMs, commands, and app events.
+
+- **[feishu](/plugins/reference/feishu)** (`@openclaw/feishu`) - npm; ClawHub. OpenClaw Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng).
+
+- **[google-meet](/plugins/reference/google-meet)** (`@openclaw/google-meet`) - npm; ClawHub. OpenClaw Google Meet participant plugin for joining calls through Chrome or Twilio transports.
+
+- **[googlechat](/plugins/reference/googlechat)** (`@openclaw/googlechat`) - npm; ClawHub. OpenClaw Google Chat channel plugin for spaces and direct messages.
+
+- **[line](/plugins/reference/line)** (`@openclaw/line`) - npm; ClawHub. OpenClaw LINE channel plugin for LINE Bot API chats.
+
+- **[llama-cpp](/plugins/reference/llama-cpp)** (`@openclaw/llama-cpp-provider`) - npm; ClawHub. Local GGUF embeddings through node-llama-cpp.
+
+- **[lobster](/plugins/reference/lobster)** (`@openclaw/lobster`) - npm; ClawHub. Lobster workflow tool plugin for typed pipelines and resumable approvals.
+
+- **[matrix](/plugins/reference/matrix)** (`@openclaw/matrix`) - ClawHub: `clawhub:@openclaw/matrix`; npm. OpenClaw Matrix channel plugin for rooms and direct messages.
+
+- **[memory-lancedb](/plugins/reference/memory-lancedb)** (`@openclaw/memory-lancedb`) - npm; ClawHub. OpenClaw LanceDB-backed long-term memory plugin with auto-recall, auto-capture, and vector search.
+
+- **[msteams](/plugins/reference/msteams)** (`@openclaw/msteams`) - npm; ClawHub. OpenClaw Microsoft Teams channel plugin for bot conversations.
+
+- **[nextcloud-talk](/plugins/reference/nextcloud-talk)** (`@openclaw/nextcloud-talk`) - npm; ClawHub. OpenClaw Nextcloud Talk channel plugin for conversations.
+
+- **[nostr](/plugins/reference/nostr)** (`@openclaw/nostr`) - npm; ClawHub. OpenClaw Nostr channel plugin for NIP-04 encrypted direct messages.
+
+- **[openshell](/plugins/reference/openshell)** (`@openclaw/openshell-sandbox`) - npm; ClawHub. OpenClaw sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution.
+
+- **[pixverse](/plugins/reference/pixverse)** (`@openclaw/pixverse-provider`) - npm; ClawHub: `clawhub:@openclaw/pixverse-provider`. OpenClaw PixVerse video generation provider plugin.
+
+- **[qqbot](/plugins/reference/qqbot)** (`@openclaw/qqbot`) - npm; ClawHub. OpenClaw QQ Bot channel plugin for group and direct-message workflows.
+
+- **[slack](/plugins/reference/slack)** (`@openclaw/slack`) - npm; ClawHub. OpenClaw Slack channel plugin for channels, DMs, commands, and app events.
+
+- **[synology-chat](/plugins/reference/synology-chat)** (`@openclaw/synology-chat`) - npm; ClawHub. Synology Chat channel plugin for OpenClaw channels and direct messages.
+
+- **[tlon](/plugins/reference/tlon)** (`@openclaw/tlon`) - npm; ClawHub. OpenClaw Tlon/Urbit channel plugin for chat workflows.
+
+- **[tokenjuice](/plugins/reference/tokenjuice)** (`@openclaw/tokenjuice`) - npm; ClawHub: `clawhub:@openclaw/tokenjuice`. Compacts exec and bash tool results with tokenjuice reducers.
+
+- **[twitch](/plugins/reference/twitch)** (`@openclaw/twitch`) - npm; ClawHub. OpenClaw Twitch channel plugin for chat and moderation workflows.
+
+- **[voice-call](/plugins/reference/voice-call)** (`@openclaw/voice-call`) - npm; ClawHub. OpenClaw voice-call plugin for Twilio, Telnyx, and Plivo phone calls.
+
+- **[whatsapp](/plugins/reference/whatsapp)** (`@openclaw/whatsapp`) - ClawHub: `clawhub:@openclaw/whatsapp`; npm. OpenClaw WhatsApp channel plugin for WhatsApp Web chats.
+
+- **[zalo](/plugins/reference/zalo)** (`@openclaw/zalo`) - npm; ClawHub. OpenClaw Zalo channel plugin for bot and webhook chats.
+
+- **[zalouser](/plugins/reference/zalouser)** (`@openclaw/zalouser`) - npm; ClawHub. OpenClaw Zalo Personal Account plugin via native zca-js integration.
+
+## Source checkout only
+
+3 plugins
+
+- **[qa-channel](/plugins/reference/qa-channel)** (`@openclaw/qa-channel`) - source checkout only. Adds the QA Channel surface for sending and receiving OpenClaw messages.
+
+- **[qa-lab](/plugins/reference/qa-lab)** (`@openclaw/qa-lab`) - source checkout only. OpenClaw QA lab plugin with private debugger UI and scenario runner.
+
+- **[qa-matrix](/plugins/reference/qa-matrix)** (`@openclaw/qa-matrix`) - source checkout only. Matrix QA transport runner and substrate.

package/docs/plugins/plugin-permission-requests.md

@@ -0,0 +1,193 @@
+---
+summary: "Ask users to approve plugin tool calls and plugin-owned permission prompts"
+title: "Plugin permission requests"
+sidebarTitle: "Permission requests"
+read_when:
+  - You need a plugin hook or tool to ask before a side effect runs
+  - You need to configure where plugin approval prompts are delivered
+  - You are deciding between optional tools, exec approvals, and plugin approvals
+---
+
+Plugin permission requests let plugin code pause a tool call or plugin-owned
+operation until a user approves or denies it. They use the Gateway
+`plugin.approval.*` flow and the same approval UI surfaces that handle chat
+approval buttons and `/approve` commands.
+
+Use plugin permission requests for plugin/app permissions. They do not replace
+host exec approvals, optional tool allowlists, or Codex's native permission
+review.
+
+## Choose the right gate
+
+Pick the gate that matches the decision point you need:
+
+| Gate                             | Use it when                                                              | What it controls                                                                                                  |
+| -------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
+| Optional tools                   | A tool should not be visible to the model until the user opts in.        | Tool exposure through `tools.allow`.                                                                              |
+| Plugin permission requests       | A plugin hook or plugin-owned operation must ask before one action runs. | Runtime approval through `plugin.approval.*`.                                                                     |
+| Exec approvals                   | A host command or shell-like tool needs operator approval.               | Host exec policy and durable exec allowlists.                                                                     |
+| Codex native permission requests | Codex asks before native shell, file, MCP, or app-server actions.        | Codex app-server or native hook approval handling, routed through plugin approvals when OpenClaw owns the prompt. |
+| MCP approval elicitations        | A Codex MCP server requests approval for a tool call.                    | MCP approval responses bridged through OpenClaw plugin approvals.                                                 |
+
+Optional tools are a discovery-time gate. Plugin permission requests are a
+per-call gate. Use both when a sensitive tool should require explicit opt-in
+before the model can see it and approval before the action runs.
+
+## Request approval before a tool call
+
+Most plugin-authored prompts should start in a `before_tool_call` hook. The hook
+runs after the model selects a tool and before OpenClaw executes it:
+
+```typescript
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+
+export default definePluginEntry({
+  id: "deploy-policy",
+  name: "Deploy Policy",
+  register(api) {
+    api.on("before_tool_call", async (event) => {
+      if (event.toolName !== "deploy_service") {
+        return;
+      }
+
+      const environment =
+        typeof event.params.environment === "string" ? event.params.environment : "unknown";
+
+      return {
+        requireApproval: {
+          title: "Deploy service",
+          description: `Deploy service to ${environment}.`,
+          severity: environment === "production" ? "critical" : "warning",
+          allowedDecisions:
+            environment === "production"
+              ? ["allow-once", "deny"]
+              : ["allow-once", "allow-always", "deny"],
+          timeoutMs: 120_000,
+          timeoutBehavior: "deny",
+          onResolution(decision) {
+            console.log(`deploy approval resolved: ${decision}`);
+          },
+        },
+      };
+    });
+  },
+});
+```
+
+Write prompt text for the person who will approve the action:
+
+- Keep `title` short and action-focused. The Gateway accepts up to 80
+  characters.
+- Keep `description` specific and bounded. The Gateway accepts up to 256
+  characters.
+- Include the action, target, and risk. Do not include secrets, tokens, or
+  private payloads that should not appear in chat approval surfaces.
+- Use `severity: "critical"` only for actions where the wrong decision could
+  cause production damage or data loss.
+- Use `allowedDecisions: ["allow-once", "deny"]` when persistent trust is
+  unsafe for that action.
+
+## Decision behavior
+
+OpenClaw creates a pending approval with a `plugin:` ID, delivers it to the
+available approval surfaces, and waits for a decision.
+
+| Decision          | Result                                                                    |
+| ----------------- | ------------------------------------------------------------------------- |
+| `allow-once`      | The current call continues.                                               |
+| `allow-always`    | The current call continues and the decision is passed to the plugin.      |
+| `deny`            | The call is blocked with a denied tool result.                            |
+| Timeout           | The call is blocked unless `timeoutBehavior` is `"allow"`.                |
+| Cancellation      | The call is blocked when the run is aborted.                              |
+| No approval route | The call is blocked because no connected approval surface can resolve it. |
+
+`allow-always` is only durable when the requesting plugin or runtime implements
+that persistence. For ordinary `before_tool_call.requireApproval` hooks,
+OpenClaw treats `allow-once` and `allow-always` as approval decisions for the
+current call and passes the resolved value to `onResolution`. If your plugin
+offers `allow-always`, document and implement exactly what future calls it
+trusts.
+
+If the hook also returns `params`, OpenClaw applies those parameter changes only
+after the approval succeeds. A lower-priority hook can still block after a
+higher-priority hook requested approval.
+
+`allowedDecisions` limits the buttons and commands shown to the user. The
+Gateway rejects a resolve attempt for any decision the request did not offer.
+
+## Route approval prompts
+
+Approval prompts can resolve in local UI surfaces or in chat channels that
+support approval handling. To forward plugin approval prompts to explicit chat
+targets, configure `approvals.plugin`:
+
+```json5
+{
+  approvals: {
+    plugin: {
+      enabled: true,
+      mode: "targets",
+      agentFilter: ["main"],
+      targets: [{ channel: "slack", to: "U12345678" }],
+    },
+  },
+}
+```
+
+`approvals.plugin` is independent from `approvals.exec`. Enabling exec approval
+forwarding does not route plugin approval prompts, and enabling plugin approval
+forwarding does not change host exec policy.
+
+When a prompt includes manual approval text, resolve it with one of the offered
+decisions:
+
+```text
+/approve <id> allow-once
+/approve <id> allow-always
+/approve <id> deny
+```
+
+See [Advanced exec approvals](/tools/exec-approvals-advanced#plugin-approval-forwarding)
+for the full forwarding model, same-chat approval behavior, native channel
+delivery, and channel-specific approver rules.
+
+## Codex native permissions
+
+Codex native permission prompts can also travel through plugin approvals, but
+they have different ownership than plugin-authored hooks.
+
+- Codex app-server approval requests route through OpenClaw after Codex review.
+- The native hook `permission_request` relay can ask through
+  `plugin.approval.request` when that relay is enabled.
+- MCP tool approval elicitations route through plugin approvals when Codex marks
+  `_meta.codex_approval_kind` as `"mcp_tool_call"`.
+
+See [Codex harness runtime](/plugins/codex-harness-runtime#native-permissions-and-mcp-elicitations)
+for the Codex-specific behavior and fallback rules.
+
+## Troubleshooting
+
+**The tool says plugin approvals are unavailable.** No approval UI or configured
+approval route accepted the request. Connect an approval-capable client, use a
+channel that supports same-chat `/approve`, or configure `approvals.plugin`.
+
+**`allow-always` appears but the next call prompts again.** The generic plugin
+approval flow does not automatically persist trust for arbitrary hooks. Persist
+plugin-owned trust in your plugin after `onResolution("allow-always")`, or
+offer only `allow-once` and `deny`.
+
+**`/approve` rejects the decision.** The request restricted
+`allowedDecisions`. Use one of the decisions printed in the prompt.
+
+**A Slack, Discord, Telegram, or Matrix prompt routes differently from exec
+approvals.** Plugin approvals and exec approvals use separate config and may use
+different authorization checks. Verify `approvals.plugin` and the channel's
+plugin approval support instead of only checking `approvals.exec`.
+
+## Related
+
+- [Plugin hooks](/plugins/hooks#tool-call-policy)
+- [Building plugins](/plugins/building-plugins#registering-agent-tools)
+- [Advanced exec approvals](/tools/exec-approvals-advanced#plugin-approval-forwarding)
+- [Gateway protocol](/gateway/protocol)
+- [Codex harness runtime](/plugins/codex-harness-runtime#native-permissions-and-mcp-elicitations)

package/docs/plugins/reference/acpx.md

@@ -0,0 +1,23 @@
+---
+summary: "OpenClaw ACP runtime backend with plugin-owned session and transport management."
+read_when:
+  - You are installing, configuring, or auditing the acpx plugin
+title: "ACPx plugin"
+---
+
+# ACPx plugin
+
+OpenClaw ACP runtime backend with plugin-owned session and transport management.
+
+## Distribution
+
+- Package: `@openclaw/acpx`
+- Install route: npm; ClawHub
+
+## Surface
+
+skills
+
+## Related docs
+
+- [acpx](/tools/acp-agents-setup)

package/docs/plugins/reference/admin-http-rpc.md

@@ -0,0 +1,23 @@
+---
+summary: "OpenClaw admin HTTP RPC endpoint."
+read_when:
+  - You are installing, configuring, or auditing the admin-http-rpc plugin
+title: "Admin Http Rpc plugin"
+---
+
+# Admin Http Rpc plugin
+
+OpenClaw admin HTTP RPC endpoint.
+
+## Distribution
+
+- Package: `@openclaw/admin-http-rpc`
+- Install route: included in OpenClaw
+
+## Surface
+
+contracts: gatewayMethodDispatch
+
+## Related docs
+
+- [admin-http-rpc](/plugins/admin-http-rpc)

package/docs/plugins/reference/alibaba.md

@@ -0,0 +1,23 @@
+---
+summary: "Adds video generation provider support."
+read_when:
+  - You are installing, configuring, or auditing the alibaba plugin
+title: "Alibaba plugin"
+---
+
+# Alibaba plugin
+
+Adds video generation provider support.
+
+## Distribution
+
+- Package: `@openclaw/alibaba-provider`
+- Install route: included in OpenClaw
+
+## Surface
+
+contracts: videoGenerationProviders
+
+## Related docs
+
+- [alibaba](/providers/alibaba)

package/docs/plugins/reference/amazon-bedrock-mantle.md

@@ -0,0 +1,23 @@
+---
+summary: "OpenClaw Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing."
+read_when:
+  - You are installing, configuring, or auditing the amazon-bedrock-mantle plugin
+title: "Amazon Bedrock Mantle plugin"
+---
+
+# Amazon Bedrock Mantle plugin
+
+OpenClaw Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing.
+
+## Distribution
+
+- Package: `@openclaw/amazon-bedrock-mantle-provider`
+- Install route: npm; ClawHub
+
+## Surface
+
+providers: amazon-bedrock-mantle
+
+## Related docs
+
+- [amazon-bedrock-mantle](/providers/bedrock-mantle)

package/docs/plugins/reference/amazon-bedrock.md

@@ -0,0 +1,23 @@
+---
+summary: "OpenClaw Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support."
+read_when:
+  - You are installing, configuring, or auditing the amazon-bedrock plugin
+title: "Amazon Bedrock plugin"
+---
+
+# Amazon Bedrock plugin
+
+OpenClaw Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support.
+
+## Distribution
+
+- Package: `@openclaw/amazon-bedrock-provider`
+- Install route: npm; ClawHub
+
+## Surface
+
+providers: amazon-bedrock; contracts: memoryEmbeddingProviders
+
+## Related docs
+
+- [amazon-bedrock](/providers/bedrock)