快速开始

阶跃星辰

StepFun 以外部官方插件(@openclaw/stepfun-provider)形式提供,包含两个提供商 ID:

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

安装插件

bash
openclaw plugins install @openclaw/stepfun-provideropenclaw 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 模型

入门指南

标准

最适合通过标准 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-flashstepfun-plan/step-3.5-flash-2603

    单次身份验证流程会为 stepfunstepfun-plan 写入与区域匹配的配置文件,因此运行一次新手引导后即可同时发现这两个提供商。

    高级配置

    完整配置:标准提供商
    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,            compat: {              supportsStore: false,              supportsDeveloperRole: false,              supportsUsageInStreaming: false,              supportsReasoningEffort: true,              supportsStrictMode: false,              supportedReasoningEfforts: ["low", "medium", "high"],              maxTokensField: "max_tokens",              reasoningEffortMap: {                off: "low",                none: "low",                minimal: "low",                low: "low",                medium: "medium",                high: "high",                xhigh: "high",                adaptive: "high",                max: "high",              },            },          },          {            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,            compat: {              supportsStore: false,              supportsDeveloperRole: false,              supportsUsageInStreaming: false,              supportsReasoningEffort: true,              supportsStrictMode: false,              supportedReasoningEfforts: ["low", "medium", "high"],              maxTokensField: "max_tokens",              reasoningEffortMap: {                off: "low",                none: "low",                minimal: "low",                low: "low",                medium: "medium",                high: "high",                xhigh: "high",                adaptive: "high",                max: "high",              },            },          },          {            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 支持 lowmediumhigh 推理强度。由于该模型没有非推理模式,/think off 会映射为 low
    • step-3.5-flash-2603 目前仅在 stepfun-plan 上提供。
    • 使用 openclaw models listopenclaw models set <provider/model> 检查或切换模型。

    相关内容

    Was this useful?
    On this page

    On this page