Plugins · Registry · Plugin model
Bundled providers
Bundled providers are on-disk OpenAPI / Discovery / GraphQL specs under providers/. They power search and execute — they are not MCP plugins and have no Plugin.onRegister hook.
Available by default, loaded only when opted in — same spirit as horizontal MCP plugins.
No-config default
Fresh install with no provider selection loads nothing from the catalog (native GraphQL/gRPC only when configured). Core MCP tools (search, execute, audit, cache) still register.
Opt-in (preferred)
| Mechanism | Example |
|---|---|
Instance providers.pack | CLAWQL_INSTANCE_SPEC=\{"providers":\{"pack":"default"\}\} |
Instance providers.enabled | \{"providers":\{"enabled":["github","linear"]\}\} |
| Helm | providers.pack: default (chart default is none) |
Curated pack default
| Provider | Notes |
|---|---|
| Cloudflare | Edge/DNS/Workers APIs |
| GitHub | REST automation |
| Slack | Web API (powers optional notify when enabled) |
| Linear | Bundled GraphQL-only vendor |
| Notion | Official REST OpenAPI |
| Onyx | Enterprise search spec (pair with Onyx MCP tool when enabled) |
Other packs
pack / CLAWQL_PROVIDER | Behavior |
|---|---|
none | Explicit empty (same as no-config) |
default / default-providers | Curated six-vendor pack above |
all-providers | Every bundled vendor + Google top-50 + AWS top-50 |
google, aws, atlassian | Focused merged presets |
CLAWQL_BUNDLED_PROVIDERS=a,b,… | Custom explicit subset |
Only CLAWQL_ENABLE_DOCUMENTS=0 trims the document/IDP vendor set from all-providers.
Deprecated env flags
CLAWQL_ENABLE_GOOGLE / CLAWQL_ENABLE_AWS / CLAWQL_ENABLE_CLOUDFLARE no longer select the provider stack. Use providers.enabled: ["google"] or pack: "google" / all-providers instead.
Precedence
CLAWQL_SPEC_PATHSCLAWQL_BUNDLED_PROVIDERS- Instance
providers(CLAWQL_INSTANCE_SPEC) CLAWQL_PROVIDER(merged pack or single vendor)- Empty stack when nothing else is set
Single-spec mode (CLAWQL_SPEC_PATH, CLAWQL_PROVIDER=cloudflare, …) bypasses the merge rules above.