OpenClaw

​

前提条件

​

步骤一：安装 OpenClaw

• macOS：按 Command + Space，搜索“终端”并按回车。
• Linux：按 Ctrl + Alt + T。
• Windows（WSL2）：按 Win 键，搜索“Ubuntu”或“WSL”，打开终端。

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Windows 用户请从安装到配置始终使用同一个环境。本页后续的 nano 命令和 ~/.openclaw 路径按 WSL2（Ubuntu）编写；如果使用 PowerShell 原生安装，请不要切换到 WSL2 继续操作，两套环境的配置文件彼此独立。

如果中途选错了，不用担心。先继续完成当前流程，结束后重新运行 openclaw onboard 即可再次进入初始化引导。需要修改单个配置项时，可以运行 openclaw config。

1. 出现欢迎界面后，选择 Yes 继续。

2. Setup mode 选择 QuickStart。

3. Model/auth provider 选择 Skip for now。这里可以跳过，后面会在 openclaw.json 中手动添加 SenseAudio。

4. 如果出现 Filter models by provider，选择 All providers（默认选项），按回车确认；未出现时直接继续。

5. Default model 选择 Keep current（默认选项），直接按回车确认。后面会把默认模型改成 senseaudio/senseaudio-s2。

6. Select channel (QuickStart) 选择 Skip for now。Telegram、Discord、飞书等外部渠道可以稍后配置，不影响 SenseAudio 模型调用。

7. Search provider 选择 Skip for now。联网搜索需要额外的服务和 API Key，可以稍后按需配置，不影响模型对话。

8. Configure skills now? (recommended) 选择 No；如果版本提供 Skip for now，选择该项。Skill 是可选扩展，不影响接入 SenseAudio。
9. 如果出现 Install missing skill dependencies，选择 Skip for now；未出现时直接继续。只有使用对应 Skill 时，才需要稍后运行 openclaw config 安装依赖。
10. 如果出现以下第三方 API Key 配置，都选择 No。这些服务与 SenseAudio 接入无关，以后需要时可以重新运行引导再补充：
    • Set GOOGLE_PLACES_API_KEY for goplaces? 选择 No
    • Set NOTION_API_KEY for notion? 选择 No
    • Set OPENAI_API_KEY for openai-whisper-api? 选择 No
    • Set ELEVENLABS_API_KEY for sag? 选择 No
11. Enable hooks? 用方向键定位 Skip for now，按空格键勾选，再按回车确认。Hooks 是可选自动化能力，不影响模型调用。

12. 如果提示 Gateway service already installed，选择 Restart，让网关使用最新配置重新启动。
13. 如果出现 How do you want to hatch your bot?，选择 Do this later，先完成初始化，后续再配置 SenseAudio 并启动对话。如果版本显示 Skip for now，选择该项即可。

​

步骤二：配置 SenseAudio API

open 是 macOS 命令，Windows PowerShell 或 CMD 默认不支持。Windows 原生环境也不默认安装 nano；本页 Windows 按 WSL2（Ubuntu）终端操作。

nano ~/.openclaw/openclaw.json

​

选择配置方式

• 从零安装 / 只有默认配置
• 已经配置其他模型

下面只展示需要合并的模型字段，不是完整配置文件。将它们合并到初始化生成的配置中：已有 agents、defaults、models 或 providers 对象时，在对应对象内补充字段，不要重复添加同名对象或覆盖其他字段。将 agents.defaults.model.primary 设为下方的值，并添加 models.providers.senseaudio。替换 API Key 后，按本节末尾的说明保存。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "senseaudio/senseaudio-s2"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "senseaudio": {
        "baseUrl": "https://api.senseaudio.cn/v1",
        "api": "openai-responses",
        "apiKey": "<SENSEAUDIO_API_KEY>",
        "models": [
          {
            "id": "senseaudio-s2",
            "name": "senseaudio-s2",
            "reasoning": true,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 128000,
            "compat": {
              "supportsStore": false,
              "supportsReasoningEffort": true
            }
          }
        ]
      }
    }
  }
}

截图中的 ${SENSEAUDIO_API_KEY} 是环境变量引用，需要提前配置对应变量；不是 API Key 本身。

先在同一环境中新开一个终端窗口，运行下面的备份命令，再回到已打开的 nano 修改两处。这样原有 Provider、模型和其他设置都会保留。

macOS、Linux、Windows WSL2

Windows PowerShell

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

1. 搜索 agents.defaults.model.primary，只把值改为 senseaudio/senseaudio-s2。如果字段不存在，在现有 agents.defaults 中补上：
   "model": {
     "primary": "senseaudio/senseaudio-s2"
   }
   
2. 搜索 models.providers，在其中追加下面的 senseaudio 对象。不要删除其他 Provider；如果前面已有对象，记得在前一个对象后补逗号：
   "senseaudio": {
     "baseUrl": "https://api.senseaudio.cn/v1",
     "api": "openai-responses",
     "apiKey": "<SENSEAUDIO_API_KEY>",
     "models": [
       {
         "id": "senseaudio-s2",
         "name": "senseaudio-s2",
         "reasoning": true,
         "input": ["text", "image"],
         "cost": {
           "input": 0,
           "output": 0,
           "cacheRead": 0,
           "cacheWrite": 0
         },
         "contextWindow": 1000000,
         "maxTokens": 128000,
         "compat": {
           "supportsStore": false,
           "supportsReasoningEffort": true
         }
       }
     ]
   }
   

图中以 OpenRouter 的 openrouter/free 为例，展示保留其他 Provider 后追加 SenseAudio 的配置结构。请保留你实际使用的 Provider。${OPENROUTER_API_KEY} 和 ${SENSEAUDIO_API_KEY} 是需要提前配置的环境变量引用；此示例未验证 OpenRouter 调用。

openclaw gateway restart

​

步骤三：开始使用 S2 模型

​

方式一：在 Web UI 中使用

openclaw dashboard

​

方式二：在终端 TUI 中使用

openclaw tui

请用一句话介绍你自己，并说明你当前使用的模型。

​

常见问题

​

初始化时选错了怎么办

openclaw onboard

​

安装后无法使用 senseaudio-s2

openclaw gateway restart
openclaw doctor

​

如何检查 OpenClaw 状态

openclaw doctor
openclaw status

​

相关资源