Skip to main content
StepFun 作为外部官方插件（@openclaw/stepfun-provider）发布，包含两个提供商 ID：
  • stepfun 用于标准端点
  • stepfun-plan 用于 Step Plan 端点
标准端点和 Step Plan 是独立的提供商，使用不同的端点和模型引用前缀（stepfun/... 与 stepfun-plan/...）。.com 端点请使用中国区密钥，.ai 端点请使用全球区密钥。

​
安装插件

openclaw plugins install @openclaw/stepfun-provider
openclaw gateway restart

​
区域和端点概览

端点中国（.com）全球（.ai）
标准https://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

​
内置目录

标准（stepfun）：
模型引用上下文最大输出说明
stepfun/step-3.5-flash262,14465,536默认标准模型
Step Plan（stepfun-plan）：
模型引用上下文最大输出说明
stepfun-plan/step-3.5-flash262,14465,536默认 Step Plan 模型
stepfun-plan/step-3.5-flash-2603262,14465,536其他 Step Plan 模型

​
入门指南

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

Choose your endpoint region

凭证选择端点区域
stepfun-standard-api-key-intlhttps://api.stepfun.ai/v1国际
stepfun-standard-api-key-cnhttps://api.stepfun.com/v1中国
2

Run onboarding

openclaw onboard --auth-choice stepfun-standard-api-key-intl
中国端点：
openclaw onboard --auth-choice stepfun-standard-api-key-cn
3

Non-interactive alternative

openclaw onboard --auth-choice stepfun-standard-api-key-intl \
  --stepfun-api-key "$STEPFUN_API_KEY"
4

Verify models are available

openclaw models list --provider stepfun
默认模型：stepfun/step-3.5-flash
单个凭证流程会为 stepfun 和 stepfun-plan 写入区域匹配的配置档案，因此一次新手引导运行后即可同时发现这两个使用面。

​
高级配置

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

{
  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,
          },
        ],
      },
    },
  },
}
  • step-3.5-flash-2603 当前仅在 stepfun-plan 上暴露。
  • 使用 openclaw models list 和 openclaw models set <provider/model> 来检查或切换模型。

​
相关

Model providers

所有提供商、模型引用和故障转移行为的概览。

Configuration reference

提供商、模型和插件的完整配置架构。

Models CLI

如何选择和配置模型。

StepFun Platform

StepFun API 密钥管理和文档。