Bundled specs

The npm package ships providers/—optional on-disk API descriptions so cold start avoids downloading multi‑MB specs. Most native GraphQL / gRPC upstreams are configured only via CLAWQL_GRAPHQL_SOURCES / CLAWQL_GRPC_SOURCES (Spec configuration). Exception: Linear is a bundled GraphQL-only vendor (providers/linear/schema.graphql).

Default install (no provider env): empty catalog — opt in with CLAWQL_PROVIDER=default (Cloudflare, GitHub, Slack, Linear, Notion, Onyx) or Helm providers.pack=default (chart default none). See Bundled providers plugin. CLAWQL_PROVIDER=all-providers loads literally every bundled vendor plus Google top-50 and AWS top-50. Custom subsets: CLAWQL_BUNDLED_PROVIDERS, CLAWQL_SPEC_PATHS, or merged presets (google, atlassian, default, …).

Learn walkthrough (Nextcloud → anydoc/pdf-inspector → Docling → Tika → Gotenberg → Stirling → Paperless → Onyx → Coneshare): Document pipeline · IDP pipeline hub (repo).

Canonical REST-forward matrix (document stack + SaaS defaults)

Use this as the default-bundle reference for REST / OpenAPI–heavy workflows. The table includes the eight-vendor IDP stack (plus in-process anydoc via MCP convert_document and pdf-inspector via inspect_pdf) and common SaaS presets; google is a merged Discovery preset, not a single file.

Provider id (`CLAWQL_PROVIDER` / `CLAWQL_BUNDLED_PROVIDERS`)	Primary auth env(s)	Typical use in workflows
`cloudflare`	`CLAWQL_CLOUDFLARE_API_TOKEN`	Edge and DNS operations, Workers deploy/debug paths, docs-site operations
`github`	`CLAWQL_GITHUB_TOKEN`	Issues/PR/repo automation and release workflow actions
`slack`	`CLAWQL_SLACK_TOKEN` / `SLACK_BOT_TOKEN`	Team notifications; in pack `default`; powers optional `notify`
`notion`	`NOTION_API_TOKEN` (+ `Notion-Version`)	Notion workspace automation; in pack `default`
`paperless`	`PAPERLESS_API_TOKEN` (+ `PAPERLESS_BASE_URL`)	Document archive lookup and ingestion workflows
`stirling`	`STIRLING_API_KEY` (+ `STIRLING_BASE_URL`)	PDF conversion/splitting/merge operations
`tika`	`CLAWQL_BEARER_TOKEN` (+ `TIKA_BASE_URL`)	Text/metadata extraction from many file types
`gotenberg`	`CLAWQL_BEARER_TOKEN` (+ `GOTENBERG_BASE_URL`)	HTML/office/markdown to PDF conversion
`onyx`	`ONYX_API_TOKEN` (+ `ONYX_BASE_URL`)	Enterprise search; in pack `default`; MCP `knowledge_search_onyx` when `CLAWQL_ENABLE_ONYX=1`
`nextcloud`	`NEXTCLOUD_USERNAME`, `NEXTCLOUD_APP_PASSWORD`	WebDAV intake/outbox, OCS shares for IDP
`coneshare`	`CONESHARE_API_TOKEN` (+ `CONESHARE_BASE_URL`)	Secure share links, VDR; webhook `POST /idp/coneshare/webhook` when `CLAWQL_ENABLE_CONESHARE=1`
`google`	`CLAWQL_GOOGLE_ACCESS_TOKEN` / `GOOGLE_ACCESS_TOKEN`	Bundled Google Cloud Discovery merge (multiple APIs); part of default cross-provider search and execute flows

Bundled GraphQL-only: `linear`

Provider id	Primary auth env(s)	Notes
`linear`	`LINEAR_API_KEY` / `CLAWQL_LINEAR_API_KEY`	GraphQL at `https://api.linear.app/graphql`. SDL vendored from Linear’s open-source SDK (`providers/linear/schema.graphql`). Refresh: `npm run fetch-linear-schema`.

Presets and additional bundled ids

Selection	Notes
`default` / `default-providers`	Opt-in curated pack — Cloudflare, GitHub, Slack, Linear, Notion, Onyx
`CLAWQL_BUNDLED_PROVIDERS=` a,b,…	Explicit custom merge by id (including optional `google` / `aws`)
`all-providers`	Literally every bundled vendor + Google top-50 + AWS top-50
`atlassian`	Merged Jira + Bitbucket
`sentry`, `n8n`, `jira`, `bitbucket`, `linear`	Additional single bundled provider ids (`linear` is GraphQL-only; see above)

Aliases: jira / bitbucket map to their standalone bundles; atlassian merges both. Deprecated merged id: google-top50 -> google.

Flink connector sync and full-stack deployment topology are intentionally documented separately from the provider matrix: #119 (Flink connector pipeline) and Helm + #113 (full-stack deployment pointers).

Offline and refresh

Bundled files are read from disk first. If a file is missing, the registry may fetch a fallback URL unless CLAWQL_BUNDLED_OFFLINE=1.

Maintainers refresh specs with npm run fetch-provider-specs (see providers/README.md). Optional GraphQL artifacts: npm run pregenerate-graphql (Bun recommended).

Default first run