vrr/openclaw
2
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-07-09 15:59:30 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 22

docs(provider): document Featherless AI setup

Browse source
This commit is contained in:
Vincent Koc 2026-07-05 22:30:15 -07:00 • committed by Vincent Koc
parent 2c11f11303
commit 8970fa2e83
19 changed files with 183 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

1
docs/concepts/model-providers.md
View file

@ -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` |

1
docs/docs.json
View file

@ -1469,6 +1469,7 @@
"providers/ds4",
"providers/elevenlabs",
"providers/fal",
"providers/featherless",
"providers/fireworks",
"providers/github-copilot",
"providers/gmi",

6
docs/plugins/plugin-inventory.md
View file

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

2
docs/plugins/reference.md
View file

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

2
docs/plugins/reference/anthropic.md
View file

@ -16,7 +16,7 @@ Adds Anthropic model provider support to OpenClaw.
## Surface
providers: anthropic; contracts: mediaUnderstandingProviders
providers: anthropic; contracts: mediaUnderstandingProviders, usageProviders
## Related docs

2
docs/plugins/reference/clawrouter.md
View file

@ -16,7 +16,7 @@ Adds ClawRouter model provider support to OpenClaw.
## Surface
providers: clawrouter
providers: clawrouter; contracts: usageProviders
## Related docs

2
docs/plugins/reference/deepseek.md
View file

@ -16,7 +16,7 @@ Adds DeepSeek model provider support to OpenClaw.
## Surface
providers: deepseek
providers: deepseek; contracts: usageProviders
## Related docs

23
docs/plugins/reference/featherless.md Normal file
View file

@ -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)

2
docs/plugins/reference/github-copilot.md
View file

@ -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

2
docs/plugins/reference/google.md
View file

@ -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

2
docs/plugins/reference/minimax.md
View file

@ -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

2
docs/plugins/reference/openai.md
View file

@ -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

2
docs/plugins/reference/openrouter.md
View file

@ -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

4
docs/plugins/reference/tencent.md
View file

@ -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

2
docs/plugins/reference/venice.md
View file

@ -16,7 +16,7 @@ Adds Venice model provider support to OpenClaw.
## Surface
providers: venice
providers: venice; contracts: usageProviders
## Related docs

2
docs/plugins/reference/xiaomi.md
View file

@ -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

2
docs/plugins/reference/zai.md
View file

@ -16,7 +16,7 @@ Adds Z.AI model provider support to OpenClaw.
## Surface
providers: zai; contracts: mediaUnderstandingProviders
providers: zai; contracts: mediaUnderstandingProviders, usageProviders
## Related docs

139
docs/providers/featherless.md Normal file
View file

@ -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 <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="<your-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)

1
docs/providers/index.md
View file

@ -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)