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

Providers

StepFun

StepFun se distribuye como un plugin oficial externo (@openclaw/stepfun-provider) con dos identificadores de proveedor:

  • stepfun para el endpoint estándar
  • stepfun-plan para el endpoint de Step Plan

Instalar el plugin

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

Resumen de regiones y endpoints

Endpoint China (.com) Global (.ai)
Estándar 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

Variable de entorno de autenticación: STEPFUN_API_KEY

Catálogo integrado

Estándar (stepfun):

Referencia del modelo Contexto Salida máxima Notas
stepfun/step-3.5-flash 262,144 65,536 Modelo estándar predeterminado
stepfun/step-3.7-flash 262,144 262,144 Admite imágenes como entrada multimodal

Step Plan (stepfun-plan):

Referencia del modelo Contexto Salida máxima Notas
stepfun-plan/step-3.5-flash 262,144 65,536 Modelo Step Plan predeterminado
stepfun-plan/step-3.7-flash 262,144 262,144 Admite imágenes como entrada multimodal
stepfun-plan/step-3.5-flash-2603 262,144 65,536 Modelo Step Plan adicional

Primeros pasos

Estándar

La mejor opción para uso general mediante el endpoint estándar de StepFun.

  • Elige la región del endpoint

    Opción de autenticación Endpoint Región
    stepfun-standard-api-key-intl https://api.stepfun.ai/v1 Internacional
    stepfun-standard-api-key-cn https://api.stepfun.com/v1 China

  • Ejecuta la incorporación

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

    Endpoint de China:

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

  • Alternativa no interactiva

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

  • Comprueba que los modelos estén disponibles

    bash
    openclaw models list --provider stepfun

    • Modelo predeterminado: stepfun/step-3.5-flash Modelo alternativo: stepfun/step-3.7-flash

    Step Plan

    La mejor opción para el endpoint de razonamiento de Step Plan.

  • Elige la región del endpoint

    Opción de autenticación Endpoint Región
    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

  • Ejecuta la incorporación

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

    Endpoint de China:

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

  • Alternativa no interactiva

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

  • Comprueba que los modelos estén disponibles

    bash
    openclaw models list --provider stepfun-plan

    • Modelo predeterminado: stepfun-plan/step-3.5-flash Modelos alternativos: stepfun-plan/step-3.7-flash, stepfun-plan/step-3.5-flash-2603

    Un único flujo de autenticación escribe perfiles correspondientes a la región tanto para stepfun como para stepfun-plan, por lo que ambas superficies se detectan juntas después de una sola ejecución de la incorporación.

    Configuración avanzada

    Configuración completa: proveedor estándar
    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,          },        ],      },    },  },}
    Configuración completa: proveedor 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,          },        ],      },    },  },}
    Notas
    • step-3.7-flash acepta texto e imágenes como entrada a través de OpenClaw. La API de StepFun también admite vídeo, que aún no es una modalidad de entrada de modelos en OpenClaw.
    • Step 3.7 admite niveles de esfuerzo de razonamiento low, medium y high. Como el modelo no tiene un modo sin razonamiento, /think off se asigna a low.
    • Actualmente, step-3.5-flash-2603 solo está disponible en stepfun-plan.
    • Usa openclaw models list y openclaw models set <provider/model> para consultar o cambiar de modelo.

    Contenido relacionado

    Proveedores de modelos

    Resumen de todos los proveedores, las referencias de modelos y el comportamiento de conmutación por error.
    Referencia de configuración

    Esquema de configuración completo para proveedores, modelos y plugins.
    CLI de modelos

    Cómo elegir y configurar modelos.
    Plataforma StepFun

    Gestión de claves de API y documentación de StepFun.
    Was this useful?
    On this page

    On this page