StepFun

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

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

标准版和 Step Plan 是独立的提供方，它们的端点和模型 ref 前缀不同（stepfun/... vs stepfun-plan/...）。.com 端点请使用中国密钥，.ai 端点请使用全球密钥。

安装插件

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	默认标准模型
`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 模型

快速开始

标准
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 写入与区域匹配的配置文件，因此在一次初始化运行后即可同时发现这两个端点。

高级配置

完整配置：标准提供方

{
  env: { vars: { 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.1, output: 0.3, cacheRead: 0.02, cacheWrite: 0 },
            contextWindow: 262144,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

完整配置：Step Plan 提供方

{
  env: { vars: { 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> 来查看或切换模型。

模型提供方

提供方、模型引用以及故障转移行为的概览。

配置参考

提供方、模型和插件的完整配置模式。

Models CLI

如何选择和配置模型。

StepFun 平台

StepFun API 密钥管理和文档。

概览

概念与配置

提供商

安装插件

区域和端点概览

内置目录

快速开始

高级配置

相关

模型提供方

配置参考

Models CLI

StepFun 平台

​安装插件

​区域和端点概览

​内置目录

​快速开始

​高级配置

​相关

模型提供方

配置参考

Models CLI

StepFun 平台

安装插件

区域和端点概览

内置目录

快速开始

高级配置

相关