OpenClawDocs
本页内容

本页内容

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

提供商

StepFun

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

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

安装插件

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

    高级配置

    完整配置：Standard 提供商
    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,          },        ],      },    },  },}
    完整配置：Step Plan 提供商
    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,          },        ],      },    },  },}
    说明
    • 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 密钥管理和文档。
    Was this useful?