StepFun

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

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

Warning

标准版和 Step Plan 是不同的提供商，具有不同的端点和模型引用前缀（stepfun/... 与 stepfun-plan/...）。请使用中国密钥配合 .com 端点，并使用全球密钥配合 .ai 端点。

安装插件¶

openclaw plugins install @openclaw/stepfun-provider

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

区域和端点概览¶

端点	中国（`.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

内置目录¶

设置会保存连接设置和别名，而不会将生成的目录行复制到您的配置中。显式设置 models.mode: "replace" 会保持目录填充启用；自定义模型行将保持完整。

标准（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 端点进行通用用途。

1. 选择您的端点区域

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

2. 运行入门引导

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

中国端点：

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

3. 非交互式替代方案

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice stepfun-standard-api-key-intl \
  --stepfun-api-key "$STEPFUN_API_KEY"

4. 验证模型可用

openclaw models list --provider stepfun

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

适用于 Step Plan 推理端点。

1. 选择您的端点区域

认证选择	端点	区域
`stepfun-plan-api-key-intl`	`https://api.stepfun.ai/step_plan/v1`	国际
`stepfun-plan-api-key-cn`	`https://api.stepfun.com/step_plan/v1`	中国

2. 运行入门引导

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

中国端点：

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

3. 非交互式替代方案

openclaw onboard --non-interactive --accept-risk --skip-health \
  --auth-choice stepfun-plan-api-key-intl \
  --stepfun-api-key "$STEPFUN_API_KEY"

4. 验证模型可用

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 未将其声明为 StepFun 模型的输入模态。
Step 3.7 支持 low、medium 和 high 推理强度。由于该模型没有非推理模式，/think off 会映射到 low。
step-3.5-flash-2603 仅在 stepfun-plan 上暴露。
使用 openclaw models list 和 openclaw models set <provider/model> 查看或切换模型。