diff --git a/docs/concepts/model-providers.md b/docs/concepts/model-providers.md index 455f04a0e68c..0601a0f554ad 100644 --- a/docs/concepts/model-providers.md +++ b/docs/concepts/model-providers.md @@ -288,6 +288,7 @@ messages and normalizes `stats.cached` into `cacheRead`; legacy | Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-03-2025` | | DeepInfra | `deepinfra` | `DEEPINFRA_API_KEY` | `deepinfra/deepseek-ai/DeepSeek-V4-Flash` | | DeepSeek | `deepseek` | `DEEPSEEK_API_KEY` | `deepseek/deepseek-v4-flash` | +| Featherless AI | `featherless` | `FEATHERLESS_API_KEY` | `featherless/Qwen/Qwen3-32B` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | GMI Cloud | `gmi` | `GMI_API_KEY` | `gmi/google/gemini-3.1-flash-lite` | | Groq | `groq` | `GROQ_API_KEY` | `groq/llama-3.3-70b-versatile` | diff --git a/docs/docs.json b/docs/docs.json index 1f261af5965d..e6bc4d968ddc 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -1469,6 +1469,7 @@ "providers/ds4", "providers/elevenlabs", "providers/fal", + "providers/featherless", "providers/fireworks", "providers/github-copilot", "providers/gmi", diff --git a/docs/plugins/plugin-inventory.md b/docs/plugins/plugin-inventory.md index bd9352fd2f0c..f92c09a5dd61 100644 --- a/docs/plugins/plugin-inventory.md +++ b/docs/plugins/plugin-inventory.md @@ -177,7 +177,7 @@ Each entry lists the package, distribution route, and description. ## Official external packages -69 plugins +70 plugins - **[acpx](/plugins/reference/acpx)** (`@openclaw/acpx`) - npm; ClawHub. OpenClaw ACP runtime backend with plugin-owned session and transport management. @@ -219,6 +219,8 @@ Each entry lists the package, distribution route, and description. - **[exa](/plugins/reference/exa)** (`@openclaw/exa-plugin`) - npm; ClawHub: `clawhub:@openclaw/exa-plugin`. Adds web search provider support. +- **[featherless](/plugins/reference/featherless)** (`@openclaw/featherless-provider`) - npm; ClawHub: `clawhub:@openclaw/featherless-provider`. OpenClaw Featherless AI provider plugin. + - **[feishu](/plugins/reference/feishu)** (`@openclaw/feishu`) - npm; ClawHub. OpenClaw Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng). - **[firecrawl](/plugins/reference/firecrawl)** (`@openclaw/firecrawl-plugin`) - npm; ClawHub: `clawhub:@openclaw/firecrawl-plugin`. Adds agent-callable tools. Adds web fetch provider support. Adds web search provider support. @@ -295,7 +297,7 @@ Each entry lists the package, distribution route, and description. - **[tavily](/plugins/reference/tavily)** (`@openclaw/tavily-plugin`) - npm; ClawHub: `clawhub:@openclaw/tavily-plugin`. Adds agent-callable tools. Adds web search provider support. -- **[tencent](/plugins/reference/tencent)** (`@openclaw/tencent-provider`) - npm; ClawHub: `clawhub:@openclaw/tencent-provider`. Adds Tencent TokenHub and TokenPlan model provider support to OpenClaw. +- **[tencent](/plugins/reference/tencent)** (`@openclaw/tencent-provider`) - npm; ClawHub: `clawhub:@openclaw/tencent-provider`. Adds Tencent TokenHub, Tencent Tokenplan model provider support to OpenClaw. - **[tlon](/plugins/reference/tlon)** (`@openclaw/tlon`) - npm; ClawHub. OpenClaw Tlon/Urbit channel plugin for chat workflows. diff --git a/docs/plugins/reference.md b/docs/plugins/reference.md index 2a587a3c9199..329a9b9100d7 100644 --- a/docs/plugins/reference.md +++ b/docs/plugins/reference.md @@ -15,5 +15,5 @@ This page is generated from `extensions/*/package.json` and pnpm plugins:inventory:gen ``` -Use [Plugin inventory](/plugins/plugin-inventory) to browse all 132 +Use [Plugin inventory](/plugins/plugin-inventory) to browse all 133 generated plugin reference pages by distribution, package, and description. diff --git a/docs/plugins/reference/anthropic.md b/docs/plugins/reference/anthropic.md index 01367929bf93..3c6a0d04d3c3 100644 --- a/docs/plugins/reference/anthropic.md +++ b/docs/plugins/reference/anthropic.md @@ -16,7 +16,7 @@ Adds Anthropic model provider support to OpenClaw. ## Surface -providers: anthropic; contracts: mediaUnderstandingProviders +providers: anthropic; contracts: mediaUnderstandingProviders, usageProviders ## Related docs diff --git a/docs/plugins/reference/clawrouter.md b/docs/plugins/reference/clawrouter.md index 0abac662b08f..ab5b05fb40a9 100644 --- a/docs/plugins/reference/clawrouter.md +++ b/docs/plugins/reference/clawrouter.md @@ -16,7 +16,7 @@ Adds ClawRouter model provider support to OpenClaw. ## Surface -providers: clawrouter +providers: clawrouter; contracts: usageProviders ## Related docs diff --git a/docs/plugins/reference/deepseek.md b/docs/plugins/reference/deepseek.md index 7488c851f22f..679b8a5517af 100644 --- a/docs/plugins/reference/deepseek.md +++ b/docs/plugins/reference/deepseek.md @@ -16,7 +16,7 @@ Adds DeepSeek model provider support to OpenClaw. ## Surface -providers: deepseek +providers: deepseek; contracts: usageProviders ## Related docs diff --git a/docs/plugins/reference/featherless.md b/docs/plugins/reference/featherless.md new file mode 100644 index 000000000000..b7a829ccf26c --- /dev/null +++ b/docs/plugins/reference/featherless.md @@ -0,0 +1,23 @@ +--- +summary: "OpenClaw Featherless AI provider plugin." +read_when: + - You are installing, configuring, or auditing the featherless plugin +title: "Featherless plugin" +--- + +# Featherless plugin + +OpenClaw Featherless AI provider plugin. + +## Distribution + +- Package: `@openclaw/featherless-provider` +- Install route: npm; ClawHub: `clawhub:@openclaw/featherless-provider` + +## Surface + +providers: featherless + +## Related docs + +- [featherless](/providers/featherless) diff --git a/docs/plugins/reference/github-copilot.md b/docs/plugins/reference/github-copilot.md index 2d4091132981..569c73a73ac6 100644 --- a/docs/plugins/reference/github-copilot.md +++ b/docs/plugins/reference/github-copilot.md @@ -16,7 +16,7 @@ Adds GitHub Copilot model provider support to OpenClaw. ## Surface -providers: github-copilot; contracts: memoryEmbeddingProviders +providers: github-copilot; contracts: memoryEmbeddingProviders, usageProviders ## Related docs diff --git a/docs/plugins/reference/google.md b/docs/plugins/reference/google.md index 31b8e1c17210..d565a7df0573 100644 --- a/docs/plugins/reference/google.md +++ b/docs/plugins/reference/google.md @@ -16,7 +16,7 @@ Adds Google, Google Gemini CLI, Google Vertex model provider support to OpenClaw ## Surface -providers: google, google-gemini-cli, google-vertex; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, musicGenerationProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders, webSearchProviders +providers: google, google-gemini-cli, google-vertex; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, musicGenerationProviders, realtimeVoiceProviders, speechProviders, usageProviders, videoGenerationProviders, webSearchProviders ## Related docs diff --git a/docs/plugins/reference/minimax.md b/docs/plugins/reference/minimax.md index eef1caa8d601..35d7a8ff046f 100644 --- a/docs/plugins/reference/minimax.md +++ b/docs/plugins/reference/minimax.md @@ -16,7 +16,7 @@ Adds MiniMax, MiniMax Portal model provider support to OpenClaw. ## Surface -providers: minimax, minimax-portal; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders, webSearchProviders +providers: minimax, minimax-portal; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, usageProviders, videoGenerationProviders, webSearchProviders ## Related docs diff --git a/docs/plugins/reference/openai.md b/docs/plugins/reference/openai.md index c22d97c9b0ea..b852259f3a72 100644 --- a/docs/plugins/reference/openai.md +++ b/docs/plugins/reference/openai.md @@ -16,7 +16,7 @@ Adds OpenAI model provider support to OpenClaw. ## Surface -providers: openai; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders +providers: openai; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders, realtimeVoiceProviders, speechProviders, usageProviders, videoGenerationProviders ## Related docs diff --git a/docs/plugins/reference/openrouter.md b/docs/plugins/reference/openrouter.md index 3dc2ae14cddd..673820316875 100644 --- a/docs/plugins/reference/openrouter.md +++ b/docs/plugins/reference/openrouter.md @@ -16,7 +16,7 @@ Adds OpenRouter model provider support to OpenClaw. ## Surface -providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders +providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, usageProviders, videoGenerationProviders ## Related docs diff --git a/docs/plugins/reference/tencent.md b/docs/plugins/reference/tencent.md index 5324bc01503b..51d5c16873bf 100644 --- a/docs/plugins/reference/tencent.md +++ b/docs/plugins/reference/tencent.md @@ -1,5 +1,5 @@ --- -summary: "Adds Tencent Hy3 model provider support (TokenHub and TokenPlan) to OpenClaw." +summary: "Adds Tencent TokenHub, Tencent Tokenplan model provider support to OpenClaw." read_when: - You are installing, configuring, or auditing the tencent plugin title: "Tencent plugin" @@ -7,7 +7,7 @@ title: "Tencent plugin" # Tencent plugin -Adds Tencent TokenHub and TokenPlan model provider support to OpenClaw. +Adds Tencent TokenHub, Tencent Tokenplan model provider support to OpenClaw. ## Distribution diff --git a/docs/plugins/reference/venice.md b/docs/plugins/reference/venice.md index 389d639b088a..20f6c8868dc5 100644 --- a/docs/plugins/reference/venice.md +++ b/docs/plugins/reference/venice.md @@ -16,7 +16,7 @@ Adds Venice model provider support to OpenClaw. ## Surface -providers: venice +providers: venice; contracts: usageProviders ## Related docs diff --git a/docs/plugins/reference/xiaomi.md b/docs/plugins/reference/xiaomi.md index f3ea6c9cb9d3..d02ccf21c155 100644 --- a/docs/plugins/reference/xiaomi.md +++ b/docs/plugins/reference/xiaomi.md @@ -16,7 +16,7 @@ Adds Xiaomi, Xiaomi Token Plan model provider support to OpenClaw. ## Surface -providers: xiaomi, xiaomi-token-plan; contracts: speechProviders +providers: xiaomi, xiaomi-token-plan; contracts: speechProviders, usageProviders ## Related docs diff --git a/docs/plugins/reference/zai.md b/docs/plugins/reference/zai.md index b89cbf93beb4..6f13c365a5bd 100644 --- a/docs/plugins/reference/zai.md +++ b/docs/plugins/reference/zai.md @@ -16,7 +16,7 @@ Adds Z.AI model provider support to OpenClaw. ## Surface -providers: zai; contracts: mediaUnderstandingProviders +providers: zai; contracts: mediaUnderstandingProviders, usageProviders ## Related docs diff --git a/docs/providers/featherless.md b/docs/providers/featherless.md new file mode 100644 index 000000000000..be0173edb472 --- /dev/null +++ b/docs/providers/featherless.md @@ -0,0 +1,139 @@ +--- +summary: "Featherless AI setup, model selection, and tool calling" +title: "Featherless AI" +read_when: + - You want to use Featherless AI with OpenClaw + - You need the Featherless API key env var or model ref format +--- + +[Featherless AI](https://featherless.ai) serves open models through an +OpenAI-compatible API. OpenClaw installs Featherless as an official external +provider plugin and keeps the built-in catalog small while accepting exact +model ids from Featherless at runtime. + +| Property | Value | +| --------------- | ---------------------------------------- | +| Provider id | `featherless` | +| Package | `@openclaw/featherless-provider` | +| Auth env var | `FEATHERLESS_API_KEY` | +| Onboarding flag | `--auth-choice featherless-api-key` | +| Direct CLI flag | `--featherless-api-key ` | +| API | OpenAI-compatible (`openai-completions`) | +| Base URL | `https://api.featherless.ai/v1` | +| Default model | `featherless/Qwen/Qwen3-32B` | + +## Setup + +Install the plugin and restart the Gateway: + +```bash +openclaw plugins install @openclaw/featherless-provider +openclaw gateway restart +``` + +Run onboarding: + +```bash +openclaw onboard --auth-choice featherless-api-key +``` + +For non-interactive setup: + +```bash +openclaw onboard --non-interactive \ + --mode local \ + --auth-choice featherless-api-key \ + --featherless-api-key "$FEATHERLESS_API_KEY" +``` + +Or expose the key to the Gateway process: + +```bash +export FEATHERLESS_API_KEY="" # pragma: allowlist secret +``` + +Verify the provider: + +```bash +openclaw models list --provider featherless +``` + +## Default model + +The plugin uses `Qwen/Qwen3-32B` as the setup default because Featherless +documents native tool calling for the Qwen 3 family. OpenClaw configures its +32,768-token context window, a conservative 4,096-token output limit, and +Qwen chat-template thinking controls. + +The catalog cost fields are zero because Featherless supports multiple billing +modes and OpenClaw does not embed account-specific plan or request-pricing +rates. + +## Other Featherless models + +Use the exact Featherless model id after the `featherless/` provider prefix: + +```json5 +{ + agents: { + defaults: { + model: { + primary: "featherless/moonshotai/Kimi-K2-Instruct", + }, + }, + }, +} +``` + +OpenClaw deliberately does not copy Featherless's full public model index into +the picker. The index is large and does not expose enough structured capability +metadata to classify every text, vision, embedding, and reasoning model safely. +Unknown ids therefore resolve with conservative text-only, non-reasoning +defaults: a 4,096-token context window and 1,024-token output limit. + +Add an explicit provider model entry when a model needs different metadata: + +```json5 +{ + models: { + mode: "merge", + providers: { + featherless: { + baseUrl: "https://api.featherless.ai/v1", + apiKey: "${FEATHERLESS_API_KEY}", + api: "openai-completions", + models: [ + { + id: "google/gemma-3-27b-it", + name: "Gemma 3 27B", + input: ["text", "image"], + reasoning: false, + contextWindow: 32768, + maxTokens: 4096, + }, + ], + }, + }, + }, +} +``` + +Check Featherless's model catalog for current model availability and capability +tags before adding custom metadata. + +## Troubleshooting + +- `401` or `403`: confirm `FEATHERLESS_API_KEY` is visible to the Gateway + process, or run onboarding again. +- Unknown model: use the exact case-sensitive id from Featherless after the + `featherless/` prefix. +- Tool calls returned as text: choose a model family Featherless documents for + native function calling, such as Qwen 3. +- Managed Gateway cannot see the key: put it in `~/.openclaw/.env` or another + environment source loaded by the service, then restart the Gateway. + +## Related + +- [Model providers](/concepts/model-providers) +- [All providers](/providers/index) +- [Thinking modes](/tools/thinking) diff --git a/docs/providers/index.md b/docs/providers/index.md index 9fc1e247387a..707208707ed7 100644 --- a/docs/providers/index.md +++ b/docs/providers/index.md @@ -41,6 +41,7 @@ Looking for chat channel docs (WhatsApp/Telegram/Discord/Slack/Mattermost (plugi - [ds4 (local DeepSeek V4)](/providers/ds4) - [ElevenLabs](/providers/elevenlabs) - [fal](/providers/fal) +- [Featherless AI](/providers/featherless) - [Fireworks](/providers/fireworks) - [GitHub Copilot](/providers/github-copilot) - [GMI Cloud](/providers/gmi)