OpenClaw 内置 StepFun Provider，支持标准端点和 Step Plan 端点，两者为独立 Provider，模型引用前缀不同（stepfun/ 与 stepfun-plan/）。配置时需根据 API Key 所属地区选择中国区（.com）或国际区（.ai）端点，通过 openclaw onboard 交互式向导或 --auth-choice 参数快速完成；使用 openclaw models list --provider stepfun 验证模型是否可用。单次认证可同时写入两个 Provider 配置。

OpenClaw 接入阶跃星辰（StepFun）：标准版和 Step Plan 双端配置

OpenClaw 内置 StepFun Provider 插件，包含两个独立的 Provider ID：

• stepfun – 标准端点
• stepfun-plan – Step Plan 端点

重要提醒： 标准端点和 Step Plan 端点是 两个独立的 Provider，拥有不同的请求地址和模型引用前缀（stepfun/... 与 stepfun-plan/...）。中国区 Key 只能用于 .com 端点，国际区 Key 只能用于 .ai 端点。

区域与端点总览

端点类型	中国区 (.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：

模型引用	Context	最大输出	备注
stepfun/step-3.5-flash	262,144	65,536	默认标准模型

Step Plan stepfun-plan：

模型引用	Context	最大输出	备注
stepfun-plan/step-3.5-flash	262,144	65,536	默认 Step Plan 模型
stepfun-plan/step-3.5-flash-2603	262,144	65,536	附加 Step Plan 模型

step-3.5-flash-2603 目前仅在 stepfun-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 --auth-choice stepfun-standard-api-key-intl \
     --stepfun-api-key "$STEPFUN_API_KEY"

4. 验证模型可用性

   openclaw models list --provider stepfun

默认模型引用： stepfun/step-3.5-flash

Step Plan 配置步骤

适用于需要推理/计划能力的场景，使用 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 --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.5-flash-2603

手动配置示例

标准版完整配置

{
  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.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.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,
          },
        ],
      },
    },
  },
}

注意事项

• StepFun Provider 已内置于 OpenClaw，无需单独安装插件。
• step-3.5-flash-2603 当前仅在 stepfun-plan 端点暴露。
• 单次认证流程会同时为 stepfun 和 stepfun-plan 两个 Provider 写入地区匹配的配置文件，因此两个端面可同时被发现。
• 使用 openclaw models list 查看 Provider 下所有模型，使用 openclaw models set <provider/model> 切换默认模型。

关于 Provider 的完整概览，参见 模型提供者。

相关文档

• 模型选择 – 各 Provider 的模型引用及故障切换行为。
• 配置参考 – Provider、模型和插件配置的完整 schema。
• StepFun 平台 – API Key 管理和官方文档。

常见问题

标准端点还是 Step Plan 端点？怎么选？

标准端点（stepfun）适合通用对话和任务，模型引用前缀为 stepfun/。Step Plan 端点（stepfun-plan）提供推理/计划能力，前缀为 stepfun-plan/。两者需要分别配置 Provider ID，但可以同时启用。

中国区 Key 能用国际端点吗？

不能。中国区 STEPFUN_API_KEY 必须使用 .com 端点（stepfun-standard-api-key-cn 或 stepfun-plan-api-key-cn），国际区 Key 必须使用 .ai 端点。认证时需选择对应的 --auth-choice，否则 API 请求会失败。

为什么 openclaw models list --provider stepfun-plan 看不到任何模型？

确认已执行 openclaw onboard 并选择了正确的 stepfun-plan-* 认证选项，且环境变量 STEPFUN_API_KEY 已设置并有效。Step Plan 端点与标准端点是独立的 Provider，需要单独认证才能发现模型。使用 openclaw models list --provider stepfun 可同时检查标准端面是否正常。