On this page
On this page
Providers
Baseten
Baseten Model APIs provide hosted, OpenAI-compatible access to frontier models. The official external plugin uses authenticated discovery, so OpenClaw follows the complete model set enabled for your Baseten account. Its offline fallback contains the current curated models listed below.
| Property | Value |
|---|---|
| Provider id | baseten |
| Plugin | official external package (@openclaw/baseten-provider) |
| Auth env var | BASETEN_API_KEY |
| Onboarding flag | --auth-choice baseten-api-key |
| Direct CLI flag | --baseten-api-key <key> |
| API | OpenAI-compatible (openai-completions) |
| Base URL | https://inference.baseten.co/v1 |
| Default model | baseten/deepseek-ai/DeepSeek-V4.1-Flash |
Install plugin
Installation applies to a running Gateway automatically; otherwise it takes effect on the next startup. See Apply changes and inspect.
Getting started
Create a Baseten account and API key
Baseten's Basic plan has no monthly platform fee. Model API calls are usage-priced. Create a key in Baseten API key settings and check current rates on the pricing page.
Run onboarding
Onboarding saves the connection settings without copying the generated catalog into your config. Existing model rows, aliases, and an explicit primary model stay unchanged. If you use models.mode: "replace", onboarding also adds the bundled catalog because that mode disables implicit discovery.
Verify the live catalog
With usable auth, the plugin requests GET /v1/models and lists every model returned for the account. Without auth, it stays offline and uses the bundled fallback.
Default model
DeepSeek V4.1 Flash is the default for new Baseten setups. It supports text and image input, tool calling, a 1,048,576-token context window, and up to 262,144 output tokens:
Use /model baseten/deepseek-ai/DeepSeek-V4.1-Flash -s to switch the current session.
Its thinking choices are off, low, high, and max, with high as the native default. OpenClaw sends off as reasoning_effort: "none". See Baseten's reasoning controls.
Saved explicit selections such as baseten/thinkingmachines/inkling are not redirected to the new default. If a previously selected model is no longer available, list the current catalog and choose a replacement explicitly. Reconnecting the API key preserves the saved primary model.
Bundled fallback catalog
The authenticated live catalog is authoritative. This curated fallback covers current Model APIs; live discovery can include additional models. Removing a retired row from this fallback does not delete an explicitly authored row from your config:
| Model ref | Input | Context | Max output |
|---|---|---|---|
baseten/deepseek-ai/DeepSeek-V4-Pro-0813 |
text | 1.048M | 262k |
baseten/deepseek-ai/DeepSeek-V4.1-Flash |
text, image | 1.048M | 262k |
baseten/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B |
text | 202k | 202k |
baseten/openai/gpt-oss-120b |
text | 128k | 128k |
baseten/zai-org/GLM-5.2 |
text, image | 1.048M | 262k |
baseten/zai-org/GLM-5.2-Fast |
text, image | 1.048M | 262k |
All bundled models support tool calling and reasoning. OpenClaw maps its thinking levels to models with native reasoning_effort. Its opt-in GLM and Nemotron routes default to thinking off. Nemotron exposes a binary off/on control; the bundled GLM 5.2 definitions expose off, high, and max. These routes use Baseten's chat_template_args.enable_thinking control. GLM's scalar effort and image input depend on discovery advertising those capabilities; sparse live GLM rows currently omit them.
The same thinking controls apply to agent turns and standalone model completions. Current DeepSeek V4 Pro 0813 and explicitly configured older Pro references preserve replayed reasoning metadata while thinking is enabled and remove it for explicit off requests. The current Pro endpoint additionally receives the required thinking envelope when scalar effort is sent.
Decision models
The plugin also supports Base Labs' joey-1 (2B), elephant-1 (9B), and mammoth-1 (27B) through Baseten's native System One API. These are decision-only models, not chat completions. Select them in the Decision picker or set the separate model role:
| Model | Decision model reference |
|---|---|
| joey-1 (2B) | baseten/decision-models/baseten-joey-2b-latest |
| elephant-1 (9B) | baseten/decision-models/baseten-elephant-9b-latest |
| mammoth-1 (27B) | baseten/decision-models/baseten-mammoth-27b-latest |
They reuse your Baseten API key and support Boolean probabilities, multiple-choice questions, and ordered rubric scores. Text is sent directly; structured JSON state and rubric entries are serialized to text. Image input, sorting, tags, bounding boxes, and reasoning toggles are not supported by this adapter. Your primary chat model and the Baseten onboarding default are unchanged.
Requests use POST /v1/systemone, not /chat/completions. The response preserves
the backend model identity (which may differ from the public slug), per-option
probabilities, fractional scores, and reported token usage. Baseten reports one
output token per question. Its confidence field measures distribution concentration,
not the probability that an answer is correct; use the selected option's
probability when applying a probability threshold.
Baseten's hosted Decision models have a 16,384-token context limit per question, including shared state, instructions, criteria, and prompt formatting. Oversized requests are rejected, not truncated. Dedicated deployments can have different limits; this catalog describes Model APIs.
As checked on October 30, 2026, the joey-1 model card
lists Model API pricing at $0.01 per million input tokens. The earlier
launch promotion has ended. OpenClaw preserves reported usage rather than
assuming these aliases are free or manufacturing a billing estimate. Check
current pricing before use; prices and the
latest aliases can change independently of OpenClaw. Probabilities and confidence
are model estimates, not safety guarantees or permission to take an action.
Selecting a decision model authorizes supported evaluation consumers to send their supplied evidence to Baseten; it does not start background work. This integration requires a host/plugin release containing the prepared Decision V2 interface. See Decision models for the role and evaluation tool.
Prompt caching
For the native https://inference.baseten.co/v1 endpoint, OpenClaw sends a stable
x-session-affinity header for related requests to improve prefix cache reuse.
It uses an explicit request cache key when present, otherwise the session ID.
An explicitly configured affinity header takes precedence. Setting
cacheRetention: "none" suppresses the generated header; it does not disable
Baseten's automatic cache. Custom endpoints retain their configured behavior.
See Baseten session affinity.
Manual config
Most setups only need the API key. To pin the provider explicitly: