Saltar al contenido principal
StepFun se distribuye como un Plugin oficial externo (@openclaw/stepfun-provider) con dos ids de proveedor:
  • stepfun para el endpoint estándar
  • stepfun-plan para el endpoint Step Plan
Estándar y Step Plan son proveedores separados con endpoints y prefijos de referencia de modelo distintos (stepfun/... frente a stepfun-plan/...). Usa una clave de China con los endpoints .com y una clave global con los endpoints .ai.

​
Instalar Plugin

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

​
Resumen de región y endpoint

EndpointChina (.com)Global (.ai)
Estándarhttps://api.stepfun.com/v1https://api.stepfun.ai/v1
Step Planhttps://api.stepfun.com/step_plan/v1https://api.stepfun.ai/step_plan/v1
Variable de entorno de autenticación: STEPFUN_API_KEY

​
Catálogo integrado

Estándar (stepfun):
Referencia de modeloContextoSalida máximaNotas
stepfun/step-3.5-flash262,14465,536Modelo estándar predeterminado
Step Plan (stepfun-plan):
Referencia de modeloContextoSalida máximaNotas
stepfun-plan/step-3.5-flash262,14465,536Modelo Step Plan predeterminado
stepfun-plan/step-3.5-flash-2603262,14465,536Modelo Step Plan adicional

​
Primeros pasos

Ideal para uso de propósito general mediante el endpoint estándar de StepFun.
1

Elige la región de tu endpoint

Opción de autenticaciónEndpointRegión
stepfun-standard-api-key-intlhttps://api.stepfun.ai/v1Internacional
stepfun-standard-api-key-cnhttps://api.stepfun.com/v1China
2

Ejecuta la incorporación

openclaw onboard --auth-choice stepfun-standard-api-key-intl
Endpoint de China:
openclaw onboard --auth-choice stepfun-standard-api-key-cn
3

Alternativa no interactiva

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

Verifica que los modelos estén disponibles

openclaw models list --provider stepfun
Modelo predeterminado: stepfun/step-3.5-flash
Un único flujo de autenticación escribe perfiles que coinciden con la región tanto para stepfun como para stepfun-plan, de modo que ambas superficies se descubren juntas después de una ejecución de incorporación.

​
Configuración avanzada

{
  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 actualmente solo se expone en stepfun-plan.
  • Usa openclaw models list y openclaw models set <provider/model> para inspeccionar o cambiar modelos.

​
Relacionado

Proveedores de modelos

Resumen de todos los proveedores, referencias de modelo y 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 de StepFun y documentación.