跳轉到主要內容
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 金鑰管理與文件。