跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
前置条件

在配置 OpenClaw 之前，确保你已经

​
安装 OpenClaw

如果你尚未安装 OpenClaw，请先完成安装。 在终端中运行以下命令： 
curl -fsSL https://openclaw.ai/install.sh | bash

​
配置阶跃模型

安装后会启动 Onboard 引导。如果已安装过 OpenClaw，可以通过以下命令重新启动 Onboard 引导： 
openclaw onboard

​
配置模型 API key

使用以下配置：
  • 在 Model/auth provider 中选择 StepFun。
  • 在 StepFun auth method 中选择 StepFun Step Plan API key (China)。
  • 在 Enter StepFun API key 中粘贴你的 API key。
  • Model configured 会显示该认证方式下默认模型。
  • 在 Default model 列表中，你可以选择保持默认或者选择另外的模型。

​
完成其他配置

接下来您可以根据自己的需求配置 channel、search、skills、hooks。 配置完成后可以选择在终端(TUI) 或者 Web UI 中启动。

​
验证

启动后你可以随便问一个问题，看界面中是否有 OpenClaw 的回应。

​
其他配置方式

​
macOS / Linux（Bash）

curl -fsSL https://raw.githubusercontent.com/Zgh332358/openclaw-stepfun-installer/main/add_stepfun_smart.sh | bash

​
Windows（PowerShell 管理员模式）

注意：必须在管理员模式的 PowerShell 下运行，否则脚本会提示并退出。
  1. 右键点击 Windows 开始菜单，选择「终端管理员」或「Windows PowerShell (管理员)」
  2. 执行以下命令： 
irm https://raw.githubusercontent.com/Zgh332358/openclaw-stepfun-installer/main/add_stepfun_smart.ps1 | iex

​
常见问题

如果你设置了 agents.defaults.models（模型允许列表），需要确保 stepfun/<model_id> 也被加入到该列表中，否则模型会被拦截。解决方法：
{
  "agents": {
    "defaults": {
      "models": {
        "stepfun/<model_id>": {
          "alias": "Step Model"
        }
      }
    }
  }
}
或者直接移除 agents.defaults.models 配置项以取消白名单限制。
StepFun API 完整兼容 OpenAI 的 Chat Completions 请求格式。OpenClaw 在配置自定义 Provider 时支持两种 API 类型：
  • openai-completions：适用于兼容 OpenAI 格式的提供商（绝大多数第三方提供商）
  • anthropic-messages：适用于兼容 Anthropic Messages 格式的提供商
StepFun 属于前者。
不推荐。OpenClaw 依赖 Linux 工具链（make、g++ 等）和 systemd 服务管理，原生 Windows 环境会遇到诸多兼容性问题。WSL2 是官方推荐的 Windows 使用方式。

​
参考链接