OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

StepFun

O StepFun é distribuído como um plugin oficial externo (@openclaw/stepfun-provider) com dois IDs de provedor:

  • stepfun para o endpoint padrão
  • stepfun-plan para o endpoint Step Plan

Instalar o plugin

bash
openclaw plugins install @openclaw/stepfun-provideropenclaw gateway restart

Visão geral das regiões e dos endpoints

Endpoint China (.com) Global (.ai)
Padrão 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

Variável de ambiente de autenticação: STEPFUN_API_KEY

Catálogo integrado

Padrão (stepfun):

Referência do modelo Contexto Saída máxima Observações
stepfun/step-3.5-flash 262,144 65,536 Modelo padrão do provedor padrão
stepfun/step-3.7-flash 262,144 262,144 Compatível com entrada de imagem multimodal

Step Plan (stepfun-plan):

Referência do modelo Contexto Saída máxima Observações
stepfun-plan/step-3.5-flash 262,144 65,536 Modelo padrão do Step Plan
stepfun-plan/step-3.7-flash 262,144 262,144 Compatível com entrada de imagem multimodal
stepfun-plan/step-3.5-flash-2603 262,144 65,536 Modelo adicional do Step Plan

Primeiros passos

Padrão

Ideal para uso geral por meio do endpoint padrão do StepFun.

  • Escolha a região do endpoint

    Opção de autenticação Endpoint Região
    stepfun-standard-api-key-intl https://api.stepfun.ai/v1 Internacional
    stepfun-standard-api-key-cn https://api.stepfun.com/v1 China

  • Execute a integração inicial

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

    Endpoint da China:

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

  • Alternativa não interativa

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

  • Verifique se os modelos estão disponíveis

    bash
    openclaw models list --provider stepfun

    • Modelo padrão: stepfun/step-3.5-flash Modelo alternativo: stepfun/step-3.7-flash

    Step Plan

    Ideal para o endpoint de raciocínio Step Plan.

  • Escolha a região do endpoint

    Opção de autenticação Endpoint Região
    stepfun-plan-api-key-intl https://api.stepfun.ai/step_plan/v1 Internacional
    stepfun-plan-api-key-cn https://api.stepfun.com/step_plan/v1 China

  • Execute a integração inicial

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

    Endpoint da China:

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

  • Alternativa não interativa

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

  • Verifique se os modelos estão disponíveis

    bash
    openclaw models list --provider stepfun-plan

    • Modelo padrão: stepfun-plan/step-3.5-flash Modelos alternativos: stepfun-plan/step-3.7-flash, stepfun-plan/step-3.5-flash-2603

    Um único fluxo de autenticação grava perfis correspondentes à região para stepfun e stepfun-plan; assim, as duas interfaces são descobertas juntas após uma única execução da integração inicial.

    Configuração avançada

    Configuração completa: provedor padrão
    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,          },        ],      },    },  },}
    Configuração completa: provedor 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,          },        ],      },    },  },}
    Observações
    • step-3.7-flash aceita entradas de texto e imagem por meio do OpenClaw. A API do StepFun também aceita vídeo, que ainda não é uma modalidade de entrada de modelo no OpenClaw.
    • O Step 3.7 aceita níveis de esforço de raciocínio low, medium e high. Como o modelo não tem um modo sem raciocínio, /think off é mapeado para low.
    • step-3.5-flash-2603 está disponível atualmente apenas em stepfun-plan.
    • Use openclaw models list e openclaw models set <provider/model> para inspecionar ou trocar de modelo.

    Relacionados

    Provedores de modelos

    Visão geral de todos os provedores, referências de modelos e comportamento de failover.
    Referência de configuração

    Esquema de configuração completo para provedores, modelos e plugins.
    CLI de modelos

    Como escolher e configurar modelos.
    Plataforma StepFun

    Gerenciamento de chaves da API e documentação do StepFun.
    Was this useful?
    On this page

    On this page