---
read_when:
- 您想在 OpenClaw 中使用 StepFun 模型
- 你需要 StepFun 設定指南
summary: 搭配 OpenClaw 使用 StepFun 模型
title: 階躍星辰
x-i18n:
generated_at: "2026-07-11T21:43:58Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: c65e6d395f4ea890efc0e4847ec21dc1c2796fa240d20ca3e6d40eea480ed9f4
source_path: providers/stepfun.md
workflow: 16
---
StepFun 以外部官方外掛（`@openclaw/stepfun-provider`）形式提供，包含兩個供應商 ID：
- `stepfun` 用於標準端點
- `stepfun-plan` 用於 Step Plan 端點
標準供應商與 Step Plan 是使用不同端點和模型參照前綴（`stepfun/...` 與 `stepfun-plan/...`）的**獨立供應商**。中國金鑰應搭配 `.com` 端點使用，全球金鑰則應搭配 `.ai` 端點使用。
## 安裝外掛
```bash
openclaw plugins install @openclaw/stepfun-provider
openclaw gateway restart
```
## 區域與端點概覽
| 端點 | 中國（`.com`） | 全球（`.ai`） |
| --------- | -------------------------------------- | ------------------------------------- |
| 標準 | `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` |
驗證環境變數：`STEPFUN_API_KEY`
## 內建目錄
標準（`stepfun`）：
| 模型參照 | 上下文 | 最大輸出量 | 備註 |
| ------------------------ | ------- | ---------- | ---------------------------- |
| `stepfun/step-3.5-flash` | 262,144 | 65,536 | 預設標準模型 |
| `stepfun/step-3.7-flash` | 262,144 | 262,144 | 支援多模態圖片輸入 |
Step Plan（`stepfun-plan`）：
| 模型參照 | 上下文 | 最大輸出量 | 備註 |
| ---------------------------------- | ------- | ---------- | ---------------------------- |
| `stepfun-plan/step-3.5-flash` | 262,144 | 65,536 | 預設 Step Plan 模型 |
| `stepfun-plan/step-3.7-flash` | 262,144 | 262,144 | 支援多模態圖片輸入 |
| `stepfun-plan/step-3.5-flash-2603` | 262,144 | 65,536 | 其他 Step Plan 模型 |
## 開始使用
最適合透過標準 StepFun 端點進行一般用途的操作。
| 驗證方式 | 端點 | 區域 |
| -------------------------------- | ----------------------------- | -------------- |
| `stepfun-standard-api-key-intl` | `https://api.stepfun.ai/v1` | 國際 |
| `stepfun-standard-api-key-cn` | `https://api.stepfun.com/v1` | 中國 |
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl
```
中國端點：
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-cn
```
```bash
openclaw onboard --auth-choice stepfun-standard-api-key-intl \
--stepfun-api-key "$STEPFUN_API_KEY"
```
```bash
openclaw models list --provider stepfun
```
預設模型：`stepfun/step-3.5-flash`
替代模型：`stepfun/step-3.7-flash`
最適合 Step Plan 推理端點。
| 驗證方式 | 端點 | 區域 |
| ------------------------------ | ------------------------------------------ | -------------- |
| `stepfun-plan-api-key-intl` | `https://api.stepfun.ai/step_plan/v1` | 國際 |
| `stepfun-plan-api-key-cn` | `https://api.stepfun.com/step_plan/v1` | 中國 |
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl
```
中國端點：
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-cn
```
```bash
openclaw onboard --auth-choice stepfun-plan-api-key-intl \
--stepfun-api-key "$STEPFUN_API_KEY"
```
```bash
openclaw models list --provider stepfun-plan
```
預設模型：`stepfun-plan/step-3.5-flash`
替代模型：`stepfun-plan/step-3.7-flash`、`stepfun-plan/step-3.5-flash-2603`
單次驗證流程會同時為 `stepfun` 和 `stepfun-plan` 寫入與區域相符的設定檔，因此執行一次新手設定後，便可同時探索這兩個介面。
## 進階設定
```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,
},
],
},
},
},
}
```
```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,
},
],
},
},
},
}
```
- `step-3.7-flash` 可透過 OpenClaw 接受文字和圖片輸入。StepFun 的 API 也支援影片，但 OpenClaw 尚未將影片納入模型輸入模態。
- Step 3.7 支援 `low`、`medium` 和 `high` 推理強度。由於此模型沒有非推理模式，`/think off` 會對應至 `low`。
- `step-3.5-flash-2603` 目前僅透過 `stepfun-plan` 提供。
- 使用 `openclaw models list` 和 `openclaw models set ` 檢視或切換模型。
## 相關內容
所有供應商、模型參照和容錯移轉行為的概覽。
供應商、模型和外掛的完整設定結構描述。
如何選擇及設定模型。
StepFun API 金鑰管理與文件。