跳转到主要内容

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 是一款开源的本地 AI 网关(Gateway)工具,支持多模型供应商切换、OAuth 登录、会话记忆、命令日志等能力。本页介绍如何在 OpenClaw 中接入 SenseAudio Token Plan,并使用 S2 模型。 更多安装与配置说明请参考 OpenClaw 官方文档

前提条件

已订阅 SenseAudio Token Plan
一台可访问终端的电脑(macOS、Linux 或 Windows WSL2)

步骤一:安装 OpenClaw

在终端中运行以下命令安装(老用户同样可用此命令更新):
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后,终端会自动进入初始化引导。请按界面出现的顺序依次选择下面的选项。
如果中途选错了,不用担心。先继续完成当前流程,结束后重新运行 openclaw onboard 即可再次进入初始化引导。openclaw config 用于修改指定配置项;如果你不熟悉这些选项,建议优先使用 openclaw onboard
  1. 出现欢迎界面后,选择 Yes 继续。
  1. Setup mode 选择 QuickStart
  1. Model/auth provider 选择 Skip for now。这里先跳过内置模型供应商配置,后面会在 openclaw.json 中手动添加 SenseAudio 配置。
  1. Filter models by provider 选择 All providers(默认选项),直接按回车确认即可。
  1. Default model 选择 Keep current(默认选项),直接按回车确认即可。后面配置 SenseAudio 后,会把默认模型改成 senseaudio/senseaudio-s2
  1. Select channel (QuickStart) 选择 Skip for now,暂时不添加 Telegram、Discord、飞书等外部聊天渠道。如果你确实需要接入某个渠道,可以按界面选择对应渠道,并根据 OpenClaw 官方文档 补充该渠道需要的配置。
  1. Search provider 选择 Skip for now,暂时不配置联网搜索服务。联网搜索通常需要额外的搜索服务 API Key;如果你需要开启,可以后续参考 OpenClaw 官方文档 按需配置。
  1. Configure skills now? (recommended) 可以按需选择。如果你想使用某个 Skill,可以在这里选择对应能力;如果暂时不确定,可以先跳过,后续再通过 openclaw config 指定配置。
  2. Install missing skill dependencies 建议新手先选择 Skip for now。如果你需要使用某个 Skill,后续可以运行 openclaw config,进入 Skills (Install/enable workspace skills),再按需选择并安装对应 Skill。
  1. 后续几个第三方 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
  1. Enable hooks? 选择 Skip for now。Hooks 是自动化能力,新手可以先不启用。
  2. 如果提示 Gateway service already installed,选择 Restart,让网关使用最新配置重新启动。
  3. 如果出现 How do you want to hatch your bot?,新手建议选择 Open the Web UI,OpenClaw 会自动打开网页界面;如果你更习惯终端,也可以稍后运行 openclaw tui 使用终端界面。
如果初始化过程中出现依赖安装失败、网络下载失败、API Key 不知道怎么填等情况,可以先选择 Skip for nowNo 完成初始化。只要后续完成 SenseAudio API 配置,就可以正常使用 S2 模型。

步骤二:配置 SenseAudio API

完成步骤一安装 OpenClaw 后,打开 OpenClaw 的配置文件 openclaw.json,在里面修改对应配置,把 SenseAudio API KEY 添加进去。根据你的系统,在终端中运行对应命令打开配置文件:
open ~/.openclaw/openclaw.json
需要在现有配置 openclaw.json 中修改或补充以下字段。请先在 SenseAudio Token Plan 获取 API Key,并把示例中的 <SENSEAUDIO_API_KEY> 替换成你的真实 Key。
agents.defaults 的默认模型修改为 senseaudio/senseaudio-s2;如果没有 agentsdefaults 字段,则新增对应配置:
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "senseaudio/senseaudio-s2"
      }
    }
  }
}
如果你的 openclaw.json 里已经有 models 字段,不要删除原有内容,只需要在 providers 里新增 senseaudio 这一段配置;如果不确定怎么合并,也可以参考下面的完整示例:
{
  "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": 1050000,
            "maxTokens": 128000,
            "compat": {
              "supportsStore": false,
              "supportsReasoningEffort": true
            }
          }
        ]
      }
    }
  }
}
配置完成后,执行以下命令重启 OpenClaw 网关,使配置生效:
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 中执行同样的命令:
openclaw tui
在 Web UI 或 TUI 的对话框中直接输入你的需求即可,例如:
 请使用 senseaudio-tts-1.5-260319 生成一段温柔女声朗读音频:欢迎使用 SenseAudio Token Plan。
能正常返回结果即配置成功。 运行效果如下:

常见问题

初始化时选错了怎么办

如果安装完成后的初始化步骤选错了,建议重新执行初始化引导:
openclaw onboard

安装后无法使用 senseaudio-s2

打开配置文件 openclaw.json,确认默认模型已配置为 senseaudio/senseaudio-s2,然后执行以下命令重启网关:
openclaw gateway start
如果网关已经在运行,也可以执行:
openclaw gateway restart

如何检查 OpenClaw 状态

可使用以下命令检查配置与网关状态:
openclaw doctor
openclaw status

相关资源

SenseAudio CLI

Hermes Agent

FAQ