LeoYeAI/agent-master-skills / skills/bengii-gemini-fix
openclaw
FlaggedComprehensive guide for installing, configuring, operating, and troubleshooting OpenClaw — a self-hosted, multi-channel AI agent gateway. Use when the user asks about OpenClaw setup, configuration, channel management (WhatsApp/Telegram/Discord/Slack/iMessage/etc.), model provider setup, Gateway operations, multi-agent routing, security hardening, troubleshooting, or any maintenance task related to their local OpenClaw installation. Also use when encountering errors from `openclaw` CLI commands or the Gateway daemon.
references/plugins.md
View on GitHub# Plugins (Extensions) Reference
Plugins extend OpenClaw with new channels, tools, CLI commands, RPC methods, background services, and skills.
## Quick Start
```bash
openclaw plugins list # List loaded plugins
openclaw plugins install @openclaw/voice-call # Install from npm
# Restart the Gateway, then configure under plugins.entries.<id>.config.
```
## Available Plugins (Official)
| Plugin | Package | Description |
|---|---|---|
| Memory (Core) | bundled | Memory search plugin (enabled by default via `plugins.slots.memory`) |
| Memory (LanceDB) | bundled | Long-term memory with auto-recall/capture (`plugins.slots.memory = "memory-lancedb"`) |
| [Voice Call](https://docs.openclaw.ai/plugins/voice-call) | `@openclaw/voice-call` | Voice calls via Twilio |
| [Zalo Personal](https://docs.openclaw.ai/plugins/zalouser) | `@openclaw/zalouser` | Zalo personal messaging |
| [Matrix](https://docs.openclaw.ai/channels/matrix) | `@openclaw/matrix` | Matrix channel |
| [Nostr](https://docs.openclaw.ai/channels/nostr) | `@openclaw/nostr` | Nostr channel |
| [Zalo](https://docs.openclaw.ai/channels/zalo) | `@openclaw/zalo` | Zalo channel |
| [Microsoft Teams](https://docs.openclaw.ai/channels/msteams) | `@openclaw/msteams` | MS Teams (plugin-only since 2026.1.15) |
| Google Antigravity OAuth | bundled (`google-antigravity-auth`) | Provider auth (disabled by default) |
| Gemini CLI OAuth | bundled (`google-gemini-cli-auth`) | Provider auth (disabled by default) |
| Qwen OAuth | bundled (`qwen-portal-auth`) | Provider auth (disabled by default) |
| Copilot Proxy | bundled | Local VS Code Copilot Proxy bridge (disabled by default) |
## Plugin Capabilities
Plugins can register:
- Gateway RPC methods
- Gateway HTTP handlers
- Agent tools
- CLI commands
- Background services
- Optional config validation
- Skills (via plugin manifest `skills` directories)
- Auto-reply commands (execute without invoking AI agent)
## Plugin IDs
- **Package packs**: `package.json` `name` field
- **Standalone file**: file base name (`~/.../voice-call.ts` → `voice-call`)
## Config
```json5
{
plugins: {
enabled: true, // master toggle (default: true)
allow: ["voice-call"], // allowlist (optional)
deny: ["untrusted-plugin"], // denylist (deny wins)
load: {
paths: ["~/Projects/oss/voice-call-extension"], // extra plugin paths
},
entries: {
"voice-call": {
enabled: true,
config: { provider: "twilio" },
},
},
},
}
```
Notes:
- Unknown plugin ids in `entries`, `allow`, `deny`, or `slots` are errors.
- Unknown `channels.<id>` keys are errors unless a plugin manifest declares the channel id.
- Plugin config is validated using the JSON Schema in `openclaw.plugin.json` (`configSchema`).
- If a plugin is disabled, its config is preserved and a warning is emitted.
## Plugin Slots (Exclusive Categories)
```json5
{
plugins: {
slots: {
memory: "memory-core", // or "none" to disable memory plugins
},
},
}
```
Only one plugin per slot. Plugins declare their slot via `kind: "memory"` in the manifest.
## Control UI (Schema + Labels)
Plugins can provide `uiHints` for the Control UI:
```json5
{
"id": "my-plugin",
"configSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"apiKey": { "type": "string" },
"region": { "type": "string" }
}
},
"uiHints": {
"apiKey": { "label": "API Key", "sensitive": true },
"region": { "label": "Region", "placeholder": "us-east-1" }
}
}
```
## CLI
```bash
openclaw plugins list # List loaded plugins
openclaw plugins info <id> # Plugin details
openclaw plugins install <path> # Install from local path
openclaw plugins install ./extensions/voice-call # Relative path
openclaw plugins install ./plugin.tgz # From tarball
openclaw plugins install ./plugin.zip # From zip
openclaw plugins install -l ./extensions/voice-call # Link (no copy) for dev
openclaw plugins install @openclaw/voice-call # Install from npm
openclaw plugins install @openclaw/voice-call --pin # Pin exact version
openclaw plugins update <id> # Update single plugin
openclaw plugins update --all # Update all
openclaw plugins enable <id> # Enable plugin
openclaw plugins disable <id> # Disable plugin
openclaw plugins doctor # Check plugin health
```
`plugins update` writes to `plugins.installs`. Use `--yes` for non-interactive.
## Plugin API (Overview)
A plugin can be:
- A function: `(api) => { ... }`
- An object: `{ id, name, configSchema, register(api) { ... } }`
## Runtime Helpers
```javascript
const result = await api.runtime.tts.textToSpeechTelephony({
text: "Hello from OpenClaw",
cfg: api.config,
});
```
- Uses core `messages.tts` configuration (OpenAI or ElevenLabs).
- Returns PCM audio buffer + sample rate.
- Edge TTS is not supported for telephony.
## Naming Conventions
- Gateway methods: `pluginId.action` (e.g., `voicecall.status`)
- Tools: `snake_case` (e.g., `voice_call`)
- CLI commands: kebab or camel, avoid clashing with core commands
## Skills in Plugins
Plugins can declare skills via `skills/<name>/SKILL.md` in the plugin directory. Skills are loaded/unloaded with `plugins.entries.<id>.enabled`.
## Distribution (npm)
- Main package: `openclaw` (this repo)
- Plugins: separate npm packages under `@openclaw/*` (e.g., `@openclaw/voice-call`)
Requirements:
- `package.json` must include `openclaw.extensions` with entry files.
- Entry files can be `.js` or `.ts` (jiti loads at runtime).
- `openclaw plugins install <npm-spec>` uses `npm pack`, extracts to `~/.openclaw/extensions/<id>/`.
- Scoped packages are normalized to the unscoped id for `plugins.entries.*`.
## Plugin Manifest (`openclaw.plugin.json`)
A required manifest file for directory plugins:
### Required Fields
- `id` — unique plugin identifier
- `name` — human-readable name
- `version` — semver version
### Optional
- `configSchema` — JSON Schema for plugin config
- `uiHints` — UI labels and hints for config fields
- Plugin slot declaration (`kind`)
## Example Plugin: Voice Call
- Source: `extensions/voice-call`
- Skill: `skills/voice-call`
- CLI: `openclaw voicecall start|status`
- Tool: `voice_call`
- RPC: `voicecall.start`, `voicecall.status`
- Config (twilio): `provider: "twilio"` + `twilio.accountSid/authToken/from`
- Config (dev): `provider: "log"` (no network)
## Safety Notes
- Only install plugins you trust.
- Prefer `plugins.allow` allowlists.
- Restart the Gateway after changes.
## Testing Plugins
- In-repo plugins: Vitest tests under `src/**` (e.g., `src/plugins/voice-call.plugin.test.ts`).
- Published plugins: Run their own CI (lint/build/test) and validate `openclaw.extensions` points at the built entrypoint.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |