StepFun Provider Plugin for OpenClaw: Setup and Usage

StepFun is available as an external official plugin (@openclaw/stepfun-provider) and exposes two provider ids:

• stepfun for the standard endpoint
• stepfun-plan for the Step Plan endpoint

Warning

Standard and Step Plan are separate providers with different endpoints and model ref prefixes (stepfun/... vs stepfun-plan/...). Use a China key with the .com endpoints and a global key with the .ai endpoints.

Install plugin

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

Region and endpoint overview

Auth env var: STEPFUN_API_KEY

Built-in catalog

Standard (stepfun):

Step Plan (stepfun-plan):

Getting started

Standard

Best suited for general-purpose tasks through the standard StepFun endpoint.

Choose your endpoint region

Run onboarding

openclaw onboard --auth-choice stepfun-standard-api-key-intl

China endpoint:

openclaw onboard --auth-choice stepfun-standard-api-key-cn

Non-interactive alternative

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

Verify models are available

openclaw models list --provider stepfun

Default model: stepfun/step-3.5-flash Alternate model: stepfun/step-3.7-flash

Step Plan

Best suited for the Step Plan reasoning endpoint.

Choose your endpoint region

Run onboarding

openclaw onboard --auth-choice stepfun-plan-api-key-intl

China endpoint:

openclaw onboard --auth-choice stepfun-plan-api-key-cn

Non-interactive alternative

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

Verify models are available

openclaw models list --provider stepfun-plan

Default model: stepfun-plan/step-3.5-flash Alternate models: stepfun-plan/step-3.7-flash, stepfun-plan/step-3.5-flash-2603

A single auth flow writes region-matched profiles for both stepfun and stepfun-plan, so both surfaces are discovered together after one onboarding run.

Advanced configuration

Full config: Standard provider

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

Full config: Step Plan provider

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

Notes

• step-3.7-flash accepts text and image input through OpenClaw. StepFun's API also supports video, which is not yet a model input modality in OpenClaw.
• Step 3.7 supports low, medium, and high reasoning effort. Because the model has no non-reasoning mode, /think off maps to low.
• step-3.5-flash-2603 is currently exposed only on stepfun-plan.
• Use openclaw models list and openclaw models set <provider/model> to inspect or switch models.

Related

• Model providers, Overview of all providers, model refs, and failover behavior.

• Configuration reference, Full config schema for providers, models, and plugins.

• Models CLI, How to choose and configure models.

• StepFun Platform, StepFun API key management and documentation.