# StepFun

> 通过 OpenClaw 使用 StepFun 模型

- 网址：https://funcoding.ai/agents/openclaw/providers/stepfun/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/providers/stepfun

---
StepFun 以外部官方插件（`@openclaw/stepfun-provider`）的形式提供，包含两个提供商 ID：

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

<div class="callout callout-warning">

Standard 和 Step Plan 是使用不同端点和模型引用前缀（`stepfun/...` 与 `stepfun-plan/...`）的**独立提供商**。中国区域的密钥应与 `.com` 端点搭配使用，全局密钥应与 `.ai` 端点搭配使用。

</div>

## 安装插件

```bash
openclaw plugins install @openclaw/stepfun-provider
openclaw gateway restart
```

## 区域和端点概览

| 端点      | 中国（`.com`）                         | 全球（`.ai`）                        |
| --------- | -------------------------------------- | ------------------------------------- |
| Standard  | `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`

## 内置目录

Standard（`stepfun`）：

| 模型引用                 | 上下文  | 最大输出   | 说明                           |
| ------------------------ | ------- | ---------- | ------------------------------ |
| `stepfun/step-3.5-flash` | 262,144 | 65,536     | 默认标准模型                   |
| `stepfun/step-3.7-flash` | 262,144 | 262,144    | 支持多模态图像输入             |

Step Plan（`stepfun-plan`）：

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

## 入门指南

**Standard**

最适合通过标准 StepFun 端点进行通用用途。

**选择端点区域**

| 身份验证选项                   | 端点                          | 区域           |
| -------------------------------- | ----------------------------- | -------------- |
| `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1`  | 国际           |
| `stepfun-standard-api-key-cn`   | `https://api.stepfun.com/v1` | 中国           |

**运行新手引导**

```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl
```

中国端点：

```bash
openclaw onboard --auth-choice stepfun-standard-api-key-cn
```

**非交互式替代方案**

```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl \
  --stepfun-api-key "$STEPFUN_API_KEY"
```

**验证模型是否可用**

```bash
openclaw models list --provider stepfun
```

默认模型：`stepfun/step-3.5-flash`
备选模型：`stepfun/step-3.7-flash`

**Step Plan**

最适合 Step Plan 推理端点。

**选择端点区域**

| 身份验证选项                | 端点                                     | 区域           |
| ------------------------------ | ------------------------------------------ | -------------- |
| `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1`  | 国际           |
| `stepfun-plan-api-key-cn`   | `https://api.stepfun.com/step_plan/v1` | 中国           |

**运行新手引导**

```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl
```

中国端点：

```bash
openclaw onboard --auth-choice stepfun-plan-api-key-cn
```

**非交互式替代方案**

```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl \
  --stepfun-api-key "$STEPFUN_API_KEY"
```

**验证模型是否可用**

```bash
openclaw models list --provider stepfun-plan
```

默认模型：`stepfun-plan/step-3.5-flash`
备选模型：`stepfun-plan/step-3.7-flash`、`stepfun-plan/step-3.5-flash-2603`

单次身份验证流程会为 `stepfun` 和 `stepfun-plan` 写入与区域匹配的配置文件，因此完成一次新手引导后即可同时发现这两个接口。

## 高级配置

<details>
<summary>完整配置：Standard 提供商</summary>

```json5
{
  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.7-flash",
            name: "Step 3.7 Flash",
            reasoning: true,
            input: ["text", "image"],
            thinkingLevelMap: { off: "low", minimal: "low", xhigh: "high", max: "high" },
            cost: { input: 0.2, output: 1.15, cacheRead: 0.04, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            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,
          },
        ],
      },
    },
  },
}
```

</details>

<details>
<summary>完整配置：Step Plan 提供商</summary>

```json5
{
  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.7-flash",
            name: "Step 3.7 Flash",
            reasoning: true,
            input: ["text", "image"],
            thinkingLevelMap: { off: "low", minimal: "low", xhigh: "high", max: "high" },
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 262144,
          },
          {
            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,
          },
        ],
      },
    },
  },
}
```

</details>

<details>
<summary>说明</summary>

- `step-3.7-flash` 通过 OpenClaw 接受文本和图像输入。StepFun 的 API 还支持视频，但 OpenClaw 尚未将视频作为模型输入模态。
- Step 3.7 支持 `low`、`medium` 和 `high` 推理强度。由于该模型没有非推理模式，因此 `/think off` 会映射到 `low`。
- `step-3.5-flash-2603` 目前仅在 `stepfun-plan` 上提供。
- 使用 `openclaw models list` 和 `openclaw models set <provider/model>` 查看或切换模型。

</details>

## 相关内容

- [模型提供商](https://funcoding.ai/agents/openclaw/concepts/model-providers/)：所有提供商、模型引用和故障转移行为的概览。
- [配置参考](https://funcoding.ai/agents/openclaw/gateway/configuration-reference/)：提供商、模型和插件的完整配置架构。
- [模型 CLI](https://funcoding.ai/agents/openclaw/concepts/models/)：如何选择和配置模型。
- [StepFun 平台](https://platform.stepfun.com)：StepFun API 密钥管理和文档。