StepFun

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

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

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

安装插件

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
Step Plan

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

选择端点区域

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

运行新手引导

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

中国端点：

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

非交互式替代方案

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

验证模型是否可用

openclaw models list --provider stepfun

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

最适合 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`	中国

运行新手引导

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

中国端点：

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

非交互式替代方案

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

验证模型是否可用

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 写入与区域匹配的配置文件，因此完成一次新手引导后即可同时发现这两个接口。

高级配置

完整配置：Standard 提供商

{
  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,
          },
        ],
      },
    },
  },
}

完整配置：Step Plan 提供商

{
  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,
          },
        ],
      },
    },
  },
}

说明

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> 查看或切换模型。

模型提供商

所有提供商、模型引用和故障转移行为的概览。

配置参考

提供商、模型和插件的完整配置架构。

模型 CLI

如何选择和配置模型。

StepFun 平台

StepFun API 密钥管理和文档。

概览

模型概念

提供商

安装插件

区域和端点概览

内置目录

入门指南

高级配置

相关内容

模型提供商

配置参考

模型 CLI

StepFun 平台

​安装插件

​区域和端点概览

​内置目录

​入门指南

​高级配置

​相关内容

模型提供商

配置参考

模型 CLI

StepFun 平台

安装插件

区域和端点概览

内置目录

入门指南

高级配置

相关内容