> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
> 在 OpenClaw 中使用 S2 模型
[OpenClaw](https://github.com/openclaw/openclaw) 是一款开源的本地 AI 网关（Gateway）工具，支持多模型供应商切换、OAuth 登录、会话记忆、命令日志等能力。本页介绍如何在 [OpenClaw](https://docs.openclaw.ai/) 中接入 SenseAudio Token Plan，并使用 `S2` 模型。
更多安装与配置说明请参考 [OpenClaw 官方文档](https://docs.openclaw.ai/)。
## 前提条件
已订阅 SenseAudio [Token Plan](https://senseaudio.cn/tokenplan)
一台可访问终端的电脑（macOS、Linux 或 Windows WSL2）
## 步骤一：安装 OpenClaw
在终端中运行以下命令安装（老用户同样可用此命令更新）：
```bash macOS / Linux theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```
```powershell Windows theme={null}
iwr -useb https://openclaw.ai/install.ps1 | iex
```
安装完成后，终端会自动进入初始化引导。请按界面出现的顺序依次选择下面的选项。
> 如果中途选错了，不用担心。先继续完成当前流程，结束后重新运行 `openclaw onboard` 即可再次进入初始化引导。`openclaw config` 用于修改指定配置项；如果你不熟悉这些选项，建议优先使用 `openclaw onboard`。
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/senseaudio-s2`。
6. `Select channel (QuickStart)` 选择 `Skip for now`，暂时不添加 Telegram、Discord、飞书等外部聊天渠道。如果你确实需要接入某个渠道，可以按界面选择对应渠道，并根据 [OpenClaw 官方文档](https://docs.openclaw.ai/) 补充该渠道需要的配置。
7. `Search provider` 选择 `Skip for now`，暂时不配置联网搜索服务。联网搜索通常需要额外的搜索服务 API Key；如果你需要开启，可以后续参考 [OpenClaw 官方文档](https://docs.openclaw.ai/) 按需配置。
8. `Configure skills now? (recommended)` 可以按需选择。如果你想使用某个 Skill，可以在这里选择对应能力；如果暂时不确定，可以先跳过，后续再通过 `openclaw config` 指定配置。
9. `Install missing skill dependencies` 建议新手先选择 `Skip for now`。如果你需要使用某个 Skill，后续可以运行 `openclaw config`，进入 `Skills (Install/enable workspace skills)`，再按需选择并安装对应 Skill。
10. 后续几个第三方 API Key 配置都可以先选择 `No`：
* `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?`，新手建议选择 `Open the Web UI`，OpenClaw 会自动打开网页界面；如果你更习惯终端，也可以稍后运行 `openclaw tui` 使用终端界面。
如果初始化过程中出现依赖安装失败、网络下载失败、API Key 不知道怎么填等情况，可以先选择 `Skip for now` 或 `No` 完成初始化。只要后续完成 SenseAudio API 配置，就可以正常使用 S2 模型。
***
## 步骤二：配置 SenseAudio API
完成步骤一安装 OpenClaw 后，打开 OpenClaw 的配置文件 `openclaw.json`，在里面修改对应配置，把 SenseAudio API KEY 添加进去。根据你的系统，在终端中运行对应命令打开配置文件：
```bash macOS theme={null}
open ~/.openclaw/openclaw.json
```
```bash Linux theme={null}
xdg-open ~/.openclaw/openclaw.json
```
```powershell Windows theme={null}
notepad $env:USERPROFILE\.openclaw\openclaw.json
```
> 需要在现有配置 `openclaw.json` 中修改或补充以下字段。请先在 [SenseAudio Token Plan](https://senseaudio.cn/tokenplan) 获取 API Key，并把示例中的 `` 替换成你的真实 Key。
将 `agents.defaults` 的默认模型修改为 `senseaudio/senseaudio-s2`；如果没有 `agents` 或 `defaults` 字段，则新增对应配置：
```json theme={null}
{
"agents": {
"defaults": {
"model": {
"primary": "senseaudio/senseaudio-s2"
}
}
}
}
```
如果你的 `openclaw.json` 里已经有 `models` 字段，不要删除原有内容，只需要在 `providers` 里新增 `senseaudio` 这一段配置；如果不确定怎么合并，也可以参考下面的完整示例：
```json theme={null}
{
"models": {
"mode": "merge",
"providers": {
"senseaudio": {
"baseUrl": "https://api.senseaudio.cn/v1",
"api": "openai-responses",
"apiKey": "",
"models": [
{
"id": "senseaudio-s2",
"name": "senseaudio-s2",
"reasoning": true,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 1050000,
"maxTokens": 128000,
"compat": {
"supportsStore": false,
"supportsReasoningEffort": true
}
}
]
}
}
}
}
```
配置完成后，执行以下命令重启 OpenClaw 网关，使配置生效：
```bash macOS / Linux theme={null}
openclaw gateway restart
```
```powershell Windows theme={null}
openclaw gateway restart
```
***
## 步骤三：开始使用 S2 模型
配置完成后，可以选择以下任意一种方式开始使用。
### 方式一：在 Web UI 中使用
如果初始化最后出现 `How do you want to hatch your bot?`，可以选择 `Open the Web UI`。OpenClaw 会自动打开 Web UI，你可以直接在网页对话框中输入需求。
### 方式二：在终端 TUI 中使用
也可以在终端中输入以下命令进入 OpenClaw TUI。Windows 用户可以在 PowerShell 或 Windows Terminal 中执行同样的命令：
```bash macOS / Linux theme={null}
openclaw tui
```
```powershell Windows theme={null}
openclaw tui
```
在 Web UI 或 TUI 的对话框中直接输入你的需求即可，例如：
```text theme={null}
请使用 senseaudio-tts-1.5-260319 生成一段温柔女声朗读音频：欢迎使用 SenseAudio Token Plan。
```
能正常返回结果即配置成功。
运行效果如下：
***
## 常见问题
### 初始化时选错了怎么办
如果安装完成后的初始化步骤选错了，建议重新执行初始化引导：
```bash macOS / Linux theme={null}
openclaw onboard
```
```powershell Windows theme={null}
openclaw onboard
```
### 安装后无法使用 `senseaudio-s2`
打开配置文件 `openclaw.json`，确认默认模型已配置为 `senseaudio/senseaudio-s2`，然后执行以下命令重启网关：
```bash macOS / Linux theme={null}
openclaw gateway start
```
```powershell Windows theme={null}
openclaw gateway start
```
如果网关已经在运行，也可以执行：
```bash macOS / Linux theme={null}
openclaw gateway restart
```
```powershell Windows theme={null}
openclaw gateway restart
```
### 如何检查 OpenClaw 状态
可使用以下命令检查配置与网关状态：
```bash macOS / Linux theme={null}
openclaw doctor
openclaw status
```
```powershell Windows theme={null}
openclaw doctor
openclaw status
```
## 相关资源
订阅、限额、切换、开票等问题解答。