> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Baseten

[Baseten 模型 API](https://docs.baseten.co/inference/model-apis/overview) 提供对前沿模型的托管式、OpenAI 兼容访问。官方外部插件使用经过身份验证的发现机制，因此 OpenClaw 会遵循你的 Baseten 账户启用的完整模型集。其离线回退列表包含构建此 OpenClaw 版本时可用的每个模型 API。

| 属性        | 值                                     |
| --------- | ------------------------------------- |
| 提供商 ID    | `baseten`                             |
| 插件        | 官方外部软件包（`@openclaw/baseten-provider`） |
| 身份验证环境变量  | `BASETEN_API_KEY`                     |
| 引导标志      | `--auth-choice baseten-api-key`       |
| 直接 CLI 标志 | `--baseten-api-key <key>`             |
| API       | OpenAI 兼容（`openai-completions`）       |
| 基础 URL    | `https://inference.baseten.co/v1`     |
| 默认模型      | `baseten/thinkingmachines/inkling`    |

## 安装插件

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/baseten-provider
openclaw gateway restart
```

## 开始使用

<Steps>
  <Step title="创建 Baseten 账户和 API 密钥">
    Baseten 的 Basic 计划不收取月度平台费用；模型 API 调用按使用量计费。在 [Baseten API 密钥设置](https://app.baseten.co/settings/api_keys) 中创建密钥，并在[定价页面](https://www.baseten.co/pricing)查看当前费率。
  </Step>

  <Step title="运行初始化">
    <CodeGroup>
      ```bash Onboarding theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice baseten-api-key
      ```

      ```bash Direct flag theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive --accept-risk --skip-health \
        --auth-choice baseten-api-key \
        --baseten-api-key "$BASETEN_API_KEY"
      ```

      ```bash Env only theme={"theme":{"light":"min-light","dark":"min-dark"}}
      export BASETEN_API_KEY=...
      ```
    </CodeGroup>
  </Step>

  <Step title="验证在线目录">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider baseten
    ```

    使用可用的身份验证信息时，插件会请求 `GET /v1/models`，并列出该账户返回的所有模型。没有身份验证信息时，插件会保持离线状态并使用捆绑的备用目录。
  </Step>
</Steps>

## Inkling

[Thinking Machines Lab 的 Inkling](https://thinkingmachines.ai/news/introducing-inkling/) 是默认模型。在 OpenClaw 中，它支持文本和图像输入、工具调用、结构化工具模式、可配置的推理强度、1.048M token 的上下文窗口，以及最多 32k 个输出 token：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "baseten/thinkingmachines/inkling" },
    },
  },
}
```

使用 `/model baseten/thinkingmachines/inkling -s` 切换当前会话。

## 捆绑的备用目录

经过身份验证的实时目录具有权威性。在发现成功之前，这些条目可确保设置和模型选择功能可用：

| 模型引用                                               | 输入    |    上下文 | 最大输出 |
| -------------------------------------------------- | ----- | -----: | ---: |
| `baseten/deepseek-ai/DeepSeek-V4-Pro`              | 文本    |   262k | 262k |
| `baseten/zai-org/GLM-4.7`                          | 文本    |   200k | 200k |
| `baseten/zai-org/GLM-5`                            | 文本    |   202k | 202k |
| `baseten/zai-org/GLM-5.1`                          | 文本    |   202k | 202k |
| `baseten/zai-org/GLM-5.2`                          | 文本    |   524k | 262k |
| `baseten/zai-org/GLM-5.2-Fast`                     | 文本    |   524k | 262k |
| `baseten/thinkingmachines/inkling`                 | 文本、图像 | 1.048M |  32k |
| `baseten/moonshotai/Kimi-K2.5`                     | 文本、图像 |   262k | 262k |
| `baseten/moonshotai/Kimi-K2.6`                     | 文本、图像 |   262k | 262k |
| `baseten/moonshotai/Kimi-K2.7-Code`                | 文本、图像 |   262k | 262k |
| `baseten/nvidia/Nemotron-120B-A12B`                | 文本    |   202k | 202k |
| `baseten/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B` | 文本    |   202k | 202k |
| `baseten/openai/gpt-oss-120b`                      | 文本    |   128k | 128k |

所有捆绑模型均支持工具调用和推理。OpenClaw 将其思考级别映射到原生支持 `reasoning_effort` 的模型。Baseten 中选择启用的 GLM、Kimi 和 Nemotron 模型默认关闭思考功能；大多数模型提供二进制的关闭/开启控制，而 GLM 5.2 提供关闭、高和最高三个级别。OpenClaw 通过 Baseten 的 `chat_template_args.enable_thinking` 控制项发送这些选项；对于 GLM 5.2，则通过经过验证的顶层 `reasoning_effort` 参数发送。

<Note>
  Baseten 可以独立于 OpenClaw 的发布版本添加、移除或更改 Model API。该插件会从经过身份验证的 API 刷新模型 ID、上下文限制、输出限制，以及输入、缓存输入和输出定价，同时保留特定于模型的 OpenClaw 传输策略。
</Note>

## 手动配置

大多数设置只需要 API 密钥。若要明确指定提供商：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { vars: { BASETEN_API_KEY: "..." } },
  agents: {
    defaults: {
      model: { primary: "baseten/thinkingmachines/inkling" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      baseten: {
        baseUrl: "https://inference.baseten.co/v1",
        apiKey: "${BASETEN_API_KEY}",
        api: "openai-completions",
        models: [
          {
            id: "thinkingmachines/inkling",
            name: "Inkling",
            reasoning: true,
            input: ["text", "image"],
            contextWindow: 1048000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },
}
```

<Note>
  如果 Gateway 作为守护进程（launchd、systemd、Docker）运行，请确保 `BASETEN_API_KEY` 对该进程可用。仅在交互式 shell 中导出的密钥，对于已经运行的受管理服务不可见。
</Note>

## 相关内容

<CardGroup cols={2}>
  <Card title="模型提供商" href="/concepts/model-providers" icon="layers">
    选择提供商、模型引用和故障转移行为。
  </Card>

  <Card title="思考模式" href="/tools/thinking" icon="brain">
    选择 OpenClaw 推理强度级别。
  </Card>

  <Card title="模型 CLI" href="/cli/models" icon="terminal">
    列出、检查并选择已发现的模型。
  </Card>

  <Card title="模型常见问题" href="/help/faq-models" icon="circle-question">
    身份验证配置和模型选择故障排除。
  </Card>
</CardGroup>