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

# StepFun

StepFun 作为外部官方插件（`@openclaw/stepfun-provider`）发布，包含两个提供商 ID：

* `stepfun` 用于标准端点
* `stepfun-plan` 用于 Step Plan 端点

<Warning>
  标准端点和 Step Plan 是**独立的提供商**，使用不同的端点和模型引用前缀（`stepfun/...` 与 `stepfun-plan/...`）。`.com` 端点请使用中国区密钥，`.ai` 端点请使用全球区密钥。
</Warning>

## 安装插件

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

## 区域和端点概览

| 端点        | 中国（`.com`）                             | 全球（`.ai`）                             |
| --------- | -------------------------------------- | ------------------------------------- |
| 标准        | `https://api.stepfun.com/v1`           | `https://api.stepfun.ai/v1`           |
| Step Plan | `https://api.stepfun.com/step_plan/v1` | `https://api.stepfun.ai/step_plan/v1` |

凭证环境变量：`STEPFUN_API_KEY`

## 内置目录

标准（`stepfun`）：

| 模型引用                     | 上下文     | 最大输出   | 说明     |
| ------------------------ | ------- | ------ | ------ |
| `stepfun/step-3.5-flash` | 262,144 | 65,536 | 默认标准模型 |

Step Plan（`stepfun-plan`）：

| 模型引用                               | 上下文     | 最大输出   | 说明              |
| ---------------------------------- | ------- | ------ | --------------- |
| `stepfun-plan/step-3.5-flash`      | 262,144 | 65,536 | 默认 Step Plan 模型 |
| `stepfun-plan/step-3.5-flash-2603` | 262,144 | 65,536 | 其他 Step Plan 模型 |

## 入门指南

<Tabs>
  <Tab title="Standard">
    最适合通过标准 StepFun 端点进行通用用途使用。

    <Steps>
      <Step title="Choose your endpoint region">
        | 凭证选择                            | 端点                           | 区域 |
        | ------------------------------- | ---------------------------- | -- |
        | `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1`  | 国际 |
        | `stepfun-standard-api-key-cn`   | `https://api.stepfun.com/v1` | 中国 |
      </Step>

      <Step title="Run onboarding">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-standard-api-key-intl
        ```

        中国端点：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-standard-api-key-cn
        ```
      </Step>

      <Step title="Non-interactive alternative">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-standard-api-key-intl \
          --stepfun-api-key "$STEPFUN_API_KEY"
        ```
      </Step>

      <Step title="Verify models are available">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider stepfun
        ```
      </Step>
    </Steps>

    默认模型：`stepfun/step-3.5-flash`
  </Tab>

  <Tab title="Step Plan">
    最适合 Step Plan 推理端点。

    <Steps>
      <Step title="Choose your endpoint region">
        | 凭证选择                        | 端点                                     | 区域 |
        | --------------------------- | -------------------------------------- | -- |
        | `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1`  | 国际 |
        | `stepfun-plan-api-key-cn`   | `https://api.stepfun.com/step_plan/v1` | 中国 |
      </Step>

      <Step title="Run onboarding">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-plan-api-key-intl
        ```

        中国端点：

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-plan-api-key-cn
        ```
      </Step>

      <Step title="Non-interactive alternative">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --auth-choice stepfun-plan-api-key-intl \
          --stepfun-api-key "$STEPFUN_API_KEY"
        ```
      </Step>

      <Step title="Verify models are available">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw models list --provider stepfun-plan
        ```
      </Step>
    </Steps>

    默认模型：`stepfun-plan/step-3.5-flash`
    备用模型：`stepfun-plan/step-3.5-flash-2603`
  </Tab>
</Tabs>

单个凭证流程会为 `stepfun` 和 `stepfun-plan` 写入区域匹配的配置档案，因此一次新手引导运行后即可同时发现这两个使用面。

## 高级配置

<AccordionGroup>
  <Accordion title="Full config: Standard provider">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      env: { STEPFUN_API_KEY: "your-key" },
      agents: { defaults: { model: { primary: "stepfun/step-3.5-flash" } } },
      models: {
        mode: "merge",
        providers: {
          stepfun: {
            baseUrl: "https://api.stepfun.ai/v1",
            api: "openai-completions",
            apiKey: "${STEPFUN_API_KEY}",
            models: [
              {
                id: "step-3.5-flash",
                name: "Step 3.5 Flash",
                reasoning: true,
                input: ["text"],
                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
                contextWindow: 262144,
                maxTokens: 65536,
              },
            ],
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Full config: Step Plan provider">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      env: { STEPFUN_API_KEY: "your-key" },
      agents: { defaults: { model: { primary: "stepfun-plan/step-3.5-flash" } } },
      models: {
        mode: "merge",
        providers: {
          "stepfun-plan": {
            baseUrl: "https://api.stepfun.ai/step_plan/v1",
            api: "openai-completions",
            apiKey: "${STEPFUN_API_KEY}",
            models: [
              {
                id: "step-3.5-flash",
                name: "Step 3.5 Flash",
                reasoning: true,
                input: ["text"],
                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
                contextWindow: 262144,
                maxTokens: 65536,
              },
              {
                id: "step-3.5-flash-2603",
                name: "Step 3.5 Flash 2603",
                reasoning: true,
                input: ["text"],
                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
                contextWindow: 262144,
                maxTokens: 65536,
              },
            ],
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Notes">
    * `step-3.5-flash-2603` 当前仅在 `stepfun-plan` 上暴露。
    * 使用 `openclaw models list` 和 `openclaw models set <provider/model>` 来检查或切换模型。
  </Accordion>
</AccordionGroup>

## 相关

<CardGroup cols={2}>
  <Card title="Model providers" href="/zh-CN/concepts/model-providers" icon="layers">
    所有提供商、模型引用和故障转移行为的概览。
  </Card>

  <Card title="Configuration reference" href="/zh-CN/gateway/configuration-reference" icon="gear">
    提供商、模型和插件的完整配置架构。
  </Card>

  <Card title="Models CLI" href="/zh-CN/concepts/models" icon="brain">
    如何选择和配置模型。
  </Card>

  <Card title="StepFun Platform" href="https://platform.stepfun.com" icon="globe">
    StepFun API 密钥管理和文档。
  </Card>
</CardGroup>