Skip to content

LeoYeAI/agent-master-skills / skills/bengii-gemini-fix

openclaw

Flagged

Comprehensive 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.

FileKindSize
README.mdmarkdown7.5 KB
README_CN.mdmarkdown7.3 KB
SKILL.mdskill md18.7 KB
_meta.jsonconfig286 B
references/acp_agents.mdmarkdown12.6 KB
references/agent_runtime.mdmarkdown5.6 KB
references/architecture.mdmarkdown3.8 KB
references/automation.mdmarkdown5.8 KB
references/bonjour.mdmarkdown3.3 KB
references/browser.mdmarkdown8.5 KB
references/channel_routing.mdmarkdown4.0 KB
references/channel_troubleshooting.mdmarkdown11.6 KB
references/channels.mdmarkdown6.2 KB
references/clawhub.mdmarkdown3.6 KB
references/config_reference.mdmarkdown11.2 KB
references/diffs_firecrawl.mdmarkdown3.3 KB
references/elevated.mdmarkdown2.8 KB
references/exec.mdmarkdown6.5 KB
references/exec_approvals.mdmarkdown3.1 KB
references/gateway_internals.mdmarkdown7.7 KB
references/gateway_ops.mdmarkdown9.6 KB
references/heartbeat.mdmarkdown4.9 KB
references/hooks.mdmarkdown14.6 KB
references/install.mdmarkdown4.1 KB
references/llm_task.mdmarkdown2.6 KB
references/lobster.mdmarkdown7.8 KB
references/media.mdmarkdown4.2 KB
references/memory.mdmarkdown11.9 KB
references/model_failover.mdmarkdown3.1 KB
references/multi_agent.mdmarkdown4.4 KB
references/nodes.mdmarkdown8.8 KB
references/openprose.mdmarkdown2.6 KB
references/pairing.mdmarkdown3.1 KB
references/pdf_tool.mdmarkdown3.5 KB
references/platforms.mdmarkdown2.7 KB
references/plugins.mdmarkdown6.9 KB
references/polls.mdmarkdown2.2 KB
references/presence_discovery.mdmarkdown2.2 KB
references/providers.mdmarkdown6.0 KB
references/queue.mdmarkdown2.1 KB
references/remote_access.mdmarkdown4.7 KB
references/sandboxing.mdmarkdown5.6 KB
references/secrets.mdmarkdown5.4 KB
references/security.mdmarkdown24.5 KB
references/sessions.mdmarkdown8.9 KB
references/skills.mdmarkdown4.4 KB
references/slash_commands.mdmarkdown5.1 KB
references/streaming.mdmarkdown1.8 KB
references/subagents.mdmarkdown12.3 KB
references/thinking.mdmarkdown2.8 KB
references/tools.mdmarkdown13.3 KB
references/tui.mdmarkdown4.0 KB
references/voice.mdmarkdown2.7 KB
references/web_tools.mdmarkdown2.7 KB
references/web_ui.mdmarkdown4.5 KB

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.
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall