跳到正文
FunCoding

搜索

搜索文档、文章、Skill 和 MCP

StepFun

通过 OpenClaw 使用 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）
Standardhttps://api.stepfun.com/v1https://api.stepfun.ai/v1
Step Planhttps://api.stepfun.com/step_plan/v1https://api.stepfun.ai/step_plan/v1

身份验证环境变量：STEPFUN_API_KEY

内置目录

Standard（stepfun）：

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

Step Plan（stepfun-plan）：

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

入门指南

Standard

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

选择端点区域

身份验证选项端点区域
stepfun-standard-api-key-intlhttps://api.stepfun.ai/v1国际
stepfun-standard-api-key-cnhttps://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

最适合 Step Plan 推理端点。

选择端点区域

身份验证选项端点区域
stepfun-plan-api-key-intlhttps://api.stepfun.ai/step_plan/v1国际
stepfun-plan-api-key-cnhttps://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> 查看或切换模型。

相关内容