OpenClaw 接入火山引擎Volcengine / Doubao全指南模型 Provider、编码端点与 Seed Speech TTS 配置【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文是 OpenClaw 官方openclaw/volcengine-provider插件的完整技术指南覆盖火山引擎 Doubao 模型接入、通用与 Coding 双端点路由、内置模型目录以及 BytePlus Seed Speech 语音合成TTS的完整配置流程。读完本文你将掌握从安装插件、配置 API Key、设定默认模型到启用语音输出与排查后台服务环境变量问题的全链路实战方案。插件概览与能力边界Volcengine Provider 是 OpenClaw 的官方插件为 OpenClaw 接入火山引擎Volcano Engine托管的 Doubao 系列模型以及托管在火山引擎上的第三方模型如 GLM、DeepSeek 等并提供独立的通用负载与 Coding 负载端点。同一个插件还会把火山引擎语音Volcengine Speech注册为 OpenClaw 的 TTS 语音合成 Provider。DetailValueProvidersvolcengine通用 TTS、volcengine-planCodingModel authVOLCANO_ENGINE_API_KEYTTS authVOLCENGINE_TTS_API_KEY或BYTEPLUS_SEED_SPEECH_API_KEYAPIOpenAI-compatible models、BytePlus Seed Speech TTS从源码角度看插件入口 extensions/volcengine/index.ts 通过defineSingleProviderPluginEntry注册provider部分用buildOpenAICompatibleProviderFamilyCatalog构建双 Provider 目录register(api)阶段通过api.registerSpeechProvider(buildVolcengineSpeechProvider())注册语音 Provider。插件清单 extensions/volcengine/openclaw.plugin.json 同时声明了speechProviders合约下的volcengine、bytedance、doubao三个别名。安装与快速上手安装插件并重启 Gatewayopenclaw plugins install openclaw/volcengine-provider openclaw gateway restart插件包名为openclaw/volcengine-provider也可通过 ClawHub 安装clawhub:openclaw/volcengine-provider参见插件参考页 docs/plugins/reference/volcengine.md。插件在清单中默认启用enabledByDefault: true启动时不强制加载onStartup: false由按需激活机制加载。配置 API Key交互式运行交互式引导一个 API Key 会同时注册通用volcengine与 Codingvolcengine-plan两个 Provideropenclaw onboard --auth-choice volcengine-api-key该交互项在插件清单中定义为volcengine-api-keymethod: api-keyCLI 参数为--volcengine-api-key key引导完成后会把volcengine-plan/ark-code-latest设为默认模型同时注册通用volcengine模型目录。配置 API Key非交互式 / CI在脚本或 CI 环境中直接通过命令行传入 Keyopenclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice volcengine-api-key \ --volcengine-api-key $VOLCANO_ENGINE_API_KEY设置默认模型在openclaw.json中为 Agent 默认模型指定编码端点下的ark-code-latest{ agents: { defaults: { model: { primary: volcengine-plan/ark-code-latest }, }, }, }验证模型可用openclaw models list --provider volcengine openclaw models list --provider volcengine-planProvider 与端点路由ProviderEndpointUse casevolcengineark.cn-beijing.volces.com/api/v3General modelsvolcengine-planark.cn-beijing.volces.com/api/coding/v3Coding models两个 Provider 共用同一个 API Key。volcengine-plan是volcengine的认证别名providerAuthAliases声明在 openclaw.plugin.json 中因此在模型选择器里 Coding Provider 会复用通用 Provider 的认证信息无需重复配置密钥。端点与模型数据在清单中集中定义volcengine指向https://ark.cn-beijing.volces.com/api/v3volcengine-plan指向https://ark.cn-beijing.volces.com/api/coding/v3两者 API 协议均为openai-completions即与 OpenAI 兼容的补全接口。模型目录的构建逻辑位于 extensions/volcengine/models.ts通过buildManifestProviderCatalogFamily把清单中两个 Provider 的模型列表包装成 OpenClaw 的目录结构并对外导出DOUBAO_BASE_URL、DOUBAO_CODING_BASE_URL等常量。内置模型目录两个目录均为静态目录不做/models动态发现请求清单中discovery为refreshable并支持 OpenAI 兼容的流式用量核算supportsStreamingUsage: true。通用目录volcengineModel refNameInputContextvolcengine/doubao-seed-evolvingDoubao Seed Evolvingtext, image, video1,024,000volcengine/doubao-seed-2-1-pro-260628Doubao Seed 2.1 Protext, image, video256,000volcengine/doubao-seed-2-1-turbo-260628Doubao Seed 2.1 Turbotext, image, video256,000volcengine/glm-5-2-260617GLM 5.2text1,024,000volcengine/deepseek-v4-pro-260425DeepSeek V4 Protext1,024,000volcengine/deepseek-v4-flash-260425DeepSeek V4 Flashtext1,024,000Coding 目录volcengine-planModel refNameInputContextvolcengine-plan/ark-code-latestArk Coding Plantext256,000volcengine-plan/doubao-seed-2.1-turboDoubao Seed 2.1 Turbotext, image, video256,000volcengine-plan/glm-5.2GLM 5.2text1,024,000volcengine-plan/deepseek-v4-proDeepSeek V4 Protext1,024,000volcengine-plan/deepseek-v4-flashDeepSeek V4 Flashtext1,024,000补充说明来自清单源码 openclaw.plugin.json每个模型条目除id、name、input类型与contextWindow外还预置了maxTokens与cost元数据input/output/cacheRead/cacheWrite四档单价OpenClaw 据此进行用量核算volcengine-plan目录下的glm-5.2、deepseek-v4-pro、deepseek-v4-flash额外声明了compat.codeMode: capable标记其适用于代码模式。通用目录中仍保留了一批标记为deprecated的旧模型如kimi-k2-5-260127、glm-4-7-251222、deepseek-v3-2-251201并在replacedBy字段中指明替代模型便于存量配置平滑迁移。测试 extensions/volcengine/index.test.ts 验证了通用与 Coding 两个目录的配对顺序、augmentModelCatalog的注入结果以及volcengine-plan/ark-code-latest作为引导默认模型starterModel的行为。工具 Schema 兼容处理火山引擎的工具调用 API 会拒绝 JSON Schema 中的minLength、maxLength、minItems、maxItems、minContains、maxContains关键字因此插件在模型解析阶段自动剥离这些字段。实现位于 extensions/volcengine/api.tsVOLCENGINE_UNSUPPORTED_TOOL_SCHEMA_KEYWORDS常量列出六个关键字applyVolcengineToolSchemaCompat通过applyModelCompatPatch把它们合并进模型的compat.unsupportedToolSchemaKeywords入口插件在normalizeResolvedModel中调用该函数index.ts测试中也对关键字清单做了断言。文本转语音Text-to-SpeechVolcengine TTS 走的是 BytePlus Seed Speech HTTP APIvoice.ap-southeast-1.bytepluses.com与 OpenAI 兼容的 Doubao 模型 API Key 相互独立需要单独配置。获取并配置 Seed Speech 凭据在 BytePlus 控制台进入 Seed Speech Settings API Keys复制 API Key 后设置export VOLCENGINE_TTS_API_KEYbyteplus_seed_speech_api_key export VOLCENGINE_TTS_RESOURCE_IDseed-tts-1.0然后在openclaw.json中启用{ tts: { auto: always, provider: volcengine, providers: { volcengine: { apiKey: byteplus_seed_speech_api_key, voice: en_female_anna_mars_bigtts, speedRatio: 1.0, }, }, }, }可配置字段tts.providers.volcengine支持以下字段字段说明默认值apiKeyBytePlus Seed Speech API Key也可由环境变量提供无voice发音人 ID见下方内置发音人列表en_female_anna_mars_bigttsspeedRatio语速倍率取值范围 0.2–3.01.0emotion情感参数可选无cluster语音集群legacy 认证使用volcano_ttsresourceIdSeed Speech 资源 IDseed-tts-1.0appKeySeed Speech 应用 KeyaGjiRDfUWibaseUrl服务地址覆盖用于代理或自建网关场景官方 BytePlus 端点speedRatio的范围0.2–3.0在源码中由normalizeSpeedRatio通过asFiniteNumberInRange(value, { min: 0.2, max: 3 })强制校验speech-provider.ts越界值会被丢弃。!emotionvalue也可作为内联语音指令使用在允许语音设置覆盖的场景下生效。语音输出编码与别名对语音消息voice-note目标OpenClaw 会请求 Provider 原生支持的ogg_opus编码普通音频附件则请求mp3。该逻辑位于 speech-provider.ts 的synthesize实现中按req.target voice-note决定编码并同步返回对应的outputFormat与文件扩展名。Provider 别名bytedance与doubao同样解析到该语音 Provideraliases定义于 speech-provider.ts。内置发音人VOLCENGINE_VOICES包括en_female_anna_mars_bigtts、en_male_adam_mars_bigtts、en_female_sarah_mars_bigtts、en_male_smith_mars_bigtts、zh_female_cancan_mars_bigtts、zh_female_qingxinnvsheng_mars_bigtts、zh_female_linjia_mars_bigtts、zh_male_wennuanahu_moon_bigtts、zh_male_shaonianzixin_moon_bigtts、zh_female_shuangkuaisisi_moon_bigtts。Resource ID 说明默认资源 ID 为seed-tts-1.0这是 BytePlus 为新建 Seed Speech API Key 默认授予的 entitlement。如果你的项目已开通 TTS 2.0可将VOLCENGINE_TTS_RESOURCE_ID设为seed-tts-2.0。⚠️ 注意VOLCANO_ENGINE_API_KEY仅用于 ModelArk / Doubao 模型端点不是Seed Speech API Key。TTS 需要 BytePlus Speech 控制台的 Seed Speech API Key或旧版 Speech 控制台的 AppID/token 凭据对。旧版 AppID / Token 认证旧版 Speech Console 应用仍支持 AppID/token 认证方式export VOLCENGINE_TTS_APPIDspeech_app_id export VOLCENGINE_TTS_TOKENspeech_access_token export VOLCENGINE_TTS_CLUSTERvolcano_tts其他可选 TTS 环境变量VOLCENGINE_TTS_VOICE、VOLCENGINE_TTS_APP_KEY、VOLCENGINE_TTS_BASE_URL设置后会覆盖tts.providers.volcengine中对应的配置字段。TTS 底层实现要点两种认证路径的 HTTP 实现均位于 extensions/volcengine/tts.tsSeed Speech 路径seedSpeechTTSPOST 到https://voice.ap-southeast-1.bytepluses.com/api/v3/tts/unidirectional请求头携带X-Api-Key、X-Api-Resource-Id、X-Api-App-Key请求体为userreq_params含speaker、audio_params.format、sample_rate: 24000、可选的speed_ratio与emotion。响应为流式 JSON 帧插件逐帧解析只拼接code 0且携带 base64 音频数据的帧code 20000000的帧被跳过其他错误码直接抛出带错误信息的异常。旧版路径legacyVolcengineTTSPOST 到https://openspeech.bytedance.com/api/v1/tts使用Bearer;${token}认证app段携带appid/token/clusteraudio段支持voice_type、encoding、speed_ratio、volume_ratio、pitch_ratio、emotionrequest段以 UUID 作为reqid且operation: query成功时要求业务码code 3000。两条路径都经由 OpenClaw 的fetchWithSsrFGuard发起带 hostname 白名单防止 SSRF、通过readResponseWithLimit限制响应上限16 MiB并对返回的 base64 音频做规范化处理isConfigured校验逻辑speech-provider.ts接受 Seed Speech API Key 或AppID 且 Token任一组合。高级配置引导后的默认模型openclaw onboard --auth-choice volcengine-api-key会把volcengine-plan/ark-code-latest设为默认模型同时注册通用volcengine目录。入口插件通过readManifestProviderDefaultModelRef从清单读取该默认 refindex.ts并在manifestAuth.applyConfig中通过ensureModelAllowlistEntry确保默认模型在模型白名单中。模型选择器回退行为在 onboarding / 配置模型选择阶段Volcengine 认证项会同时优先展示volcengine/*与volcengine-plan/*两行。如果这些模型尚未加载OpenClaw 会回退到未过滤的完整目录而不是显示一个空的、限定 Provider 的选择器。守护进程daemon环境变量如果 Gateway 以守护进程方式运行launchd / systemd交互式 shell 中设置的环境变量不会被自动继承。务必确保模型与 TTS 相关变量对该进程可见例如写入~/.openclaw/.env或在配置中通过env.shellEnv注入模型VOLCANO_ENGINE_API_KEYTTSVOLCENGINE_TTS_API_KEY、BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID、VOLCENGINE_TTS_TOKEN⚠️ 当 OpenClaw 作为后台服务运行时交互式 shell 里export的变量不会自动进入服务进程请按上面的 daemon 说明显式配置。相关文档模型选择与 Provider 概念Provider、模型 ref 与故障切换行为的整体说明Gateway 配置参考agents、models、providers 的完整配置项故障排查常见问题与调试步骤FAQOpenClaw 安装配置高频问答插件参考页openclaw/volcengine-provider的分布、Surface 与相关文档索引【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
OpenClaw 接入火山引擎（Volcengine / Doubao）全指南：模型 Provider、编码端点与 Seed Speech TTS 配置
OpenClaw 接入火山引擎Volcengine / Doubao全指南模型 Provider、编码端点与 Seed Speech TTS 配置【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw本文是 OpenClaw 官方openclaw/volcengine-provider插件的完整技术指南覆盖火山引擎 Doubao 模型接入、通用与 Coding 双端点路由、内置模型目录以及 BytePlus Seed Speech 语音合成TTS的完整配置流程。读完本文你将掌握从安装插件、配置 API Key、设定默认模型到启用语音输出与排查后台服务环境变量问题的全链路实战方案。插件概览与能力边界Volcengine Provider 是 OpenClaw 的官方插件为 OpenClaw 接入火山引擎Volcano Engine托管的 Doubao 系列模型以及托管在火山引擎上的第三方模型如 GLM、DeepSeek 等并提供独立的通用负载与 Coding 负载端点。同一个插件还会把火山引擎语音Volcengine Speech注册为 OpenClaw 的 TTS 语音合成 Provider。DetailValueProvidersvolcengine通用 TTS、volcengine-planCodingModel authVOLCANO_ENGINE_API_KEYTTS authVOLCENGINE_TTS_API_KEY或BYTEPLUS_SEED_SPEECH_API_KEYAPIOpenAI-compatible models、BytePlus Seed Speech TTS从源码角度看插件入口 extensions/volcengine/index.ts 通过defineSingleProviderPluginEntry注册provider部分用buildOpenAICompatibleProviderFamilyCatalog构建双 Provider 目录register(api)阶段通过api.registerSpeechProvider(buildVolcengineSpeechProvider())注册语音 Provider。插件清单 extensions/volcengine/openclaw.plugin.json 同时声明了speechProviders合约下的volcengine、bytedance、doubao三个别名。安装与快速上手安装插件并重启 Gatewayopenclaw plugins install openclaw/volcengine-provider openclaw gateway restart插件包名为openclaw/volcengine-provider也可通过 ClawHub 安装clawhub:openclaw/volcengine-provider参见插件参考页 docs/plugins/reference/volcengine.md。插件在清单中默认启用enabledByDefault: true启动时不强制加载onStartup: false由按需激活机制加载。配置 API Key交互式运行交互式引导一个 API Key 会同时注册通用volcengine与 Codingvolcengine-plan两个 Provideropenclaw onboard --auth-choice volcengine-api-key该交互项在插件清单中定义为volcengine-api-keymethod: api-keyCLI 参数为--volcengine-api-key key引导完成后会把volcengine-plan/ark-code-latest设为默认模型同时注册通用volcengine模型目录。配置 API Key非交互式 / CI在脚本或 CI 环境中直接通过命令行传入 Keyopenclaw onboard --non-interactive --accept-risk --skip-health \ --mode local \ --auth-choice volcengine-api-key \ --volcengine-api-key $VOLCANO_ENGINE_API_KEY设置默认模型在openclaw.json中为 Agent 默认模型指定编码端点下的ark-code-latest{ agents: { defaults: { model: { primary: volcengine-plan/ark-code-latest }, }, }, }验证模型可用openclaw models list --provider volcengine openclaw models list --provider volcengine-planProvider 与端点路由ProviderEndpointUse casevolcengineark.cn-beijing.volces.com/api/v3General modelsvolcengine-planark.cn-beijing.volces.com/api/coding/v3Coding models两个 Provider 共用同一个 API Key。volcengine-plan是volcengine的认证别名providerAuthAliases声明在 openclaw.plugin.json 中因此在模型选择器里 Coding Provider 会复用通用 Provider 的认证信息无需重复配置密钥。端点与模型数据在清单中集中定义volcengine指向https://ark.cn-beijing.volces.com/api/v3volcengine-plan指向https://ark.cn-beijing.volces.com/api/coding/v3两者 API 协议均为openai-completions即与 OpenAI 兼容的补全接口。模型目录的构建逻辑位于 extensions/volcengine/models.ts通过buildManifestProviderCatalogFamily把清单中两个 Provider 的模型列表包装成 OpenClaw 的目录结构并对外导出DOUBAO_BASE_URL、DOUBAO_CODING_BASE_URL等常量。内置模型目录两个目录均为静态目录不做/models动态发现请求清单中discovery为refreshable并支持 OpenAI 兼容的流式用量核算supportsStreamingUsage: true。通用目录volcengineModel refNameInputContextvolcengine/doubao-seed-evolvingDoubao Seed Evolvingtext, image, video1,024,000volcengine/doubao-seed-2-1-pro-260628Doubao Seed 2.1 Protext, image, video256,000volcengine/doubao-seed-2-1-turbo-260628Doubao Seed 2.1 Turbotext, image, video256,000volcengine/glm-5-2-260617GLM 5.2text1,024,000volcengine/deepseek-v4-pro-260425DeepSeek V4 Protext1,024,000volcengine/deepseek-v4-flash-260425DeepSeek V4 Flashtext1,024,000Coding 目录volcengine-planModel refNameInputContextvolcengine-plan/ark-code-latestArk Coding Plantext256,000volcengine-plan/doubao-seed-2.1-turboDoubao Seed 2.1 Turbotext, image, video256,000volcengine-plan/glm-5.2GLM 5.2text1,024,000volcengine-plan/deepseek-v4-proDeepSeek V4 Protext1,024,000volcengine-plan/deepseek-v4-flashDeepSeek V4 Flashtext1,024,000补充说明来自清单源码 openclaw.plugin.json每个模型条目除id、name、input类型与contextWindow外还预置了maxTokens与cost元数据input/output/cacheRead/cacheWrite四档单价OpenClaw 据此进行用量核算volcengine-plan目录下的glm-5.2、deepseek-v4-pro、deepseek-v4-flash额外声明了compat.codeMode: capable标记其适用于代码模式。通用目录中仍保留了一批标记为deprecated的旧模型如kimi-k2-5-260127、glm-4-7-251222、deepseek-v3-2-251201并在replacedBy字段中指明替代模型便于存量配置平滑迁移。测试 extensions/volcengine/index.test.ts 验证了通用与 Coding 两个目录的配对顺序、augmentModelCatalog的注入结果以及volcengine-plan/ark-code-latest作为引导默认模型starterModel的行为。工具 Schema 兼容处理火山引擎的工具调用 API 会拒绝 JSON Schema 中的minLength、maxLength、minItems、maxItems、minContains、maxContains关键字因此插件在模型解析阶段自动剥离这些字段。实现位于 extensions/volcengine/api.tsVOLCENGINE_UNSUPPORTED_TOOL_SCHEMA_KEYWORDS常量列出六个关键字applyVolcengineToolSchemaCompat通过applyModelCompatPatch把它们合并进模型的compat.unsupportedToolSchemaKeywords入口插件在normalizeResolvedModel中调用该函数index.ts测试中也对关键字清单做了断言。文本转语音Text-to-SpeechVolcengine TTS 走的是 BytePlus Seed Speech HTTP APIvoice.ap-southeast-1.bytepluses.com与 OpenAI 兼容的 Doubao 模型 API Key 相互独立需要单独配置。获取并配置 Seed Speech 凭据在 BytePlus 控制台进入 Seed Speech Settings API Keys复制 API Key 后设置export VOLCENGINE_TTS_API_KEYbyteplus_seed_speech_api_key export VOLCENGINE_TTS_RESOURCE_IDseed-tts-1.0然后在openclaw.json中启用{ tts: { auto: always, provider: volcengine, providers: { volcengine: { apiKey: byteplus_seed_speech_api_key, voice: en_female_anna_mars_bigtts, speedRatio: 1.0, }, }, }, }可配置字段tts.providers.volcengine支持以下字段字段说明默认值apiKeyBytePlus Seed Speech API Key也可由环境变量提供无voice发音人 ID见下方内置发音人列表en_female_anna_mars_bigttsspeedRatio语速倍率取值范围 0.2–3.01.0emotion情感参数可选无cluster语音集群legacy 认证使用volcano_ttsresourceIdSeed Speech 资源 IDseed-tts-1.0appKeySeed Speech 应用 KeyaGjiRDfUWibaseUrl服务地址覆盖用于代理或自建网关场景官方 BytePlus 端点speedRatio的范围0.2–3.0在源码中由normalizeSpeedRatio通过asFiniteNumberInRange(value, { min: 0.2, max: 3 })强制校验speech-provider.ts越界值会被丢弃。!emotionvalue也可作为内联语音指令使用在允许语音设置覆盖的场景下生效。语音输出编码与别名对语音消息voice-note目标OpenClaw 会请求 Provider 原生支持的ogg_opus编码普通音频附件则请求mp3。该逻辑位于 speech-provider.ts 的synthesize实现中按req.target voice-note决定编码并同步返回对应的outputFormat与文件扩展名。Provider 别名bytedance与doubao同样解析到该语音 Provideraliases定义于 speech-provider.ts。内置发音人VOLCENGINE_VOICES包括en_female_anna_mars_bigtts、en_male_adam_mars_bigtts、en_female_sarah_mars_bigtts、en_male_smith_mars_bigtts、zh_female_cancan_mars_bigtts、zh_female_qingxinnvsheng_mars_bigtts、zh_female_linjia_mars_bigtts、zh_male_wennuanahu_moon_bigtts、zh_male_shaonianzixin_moon_bigtts、zh_female_shuangkuaisisi_moon_bigtts。Resource ID 说明默认资源 ID 为seed-tts-1.0这是 BytePlus 为新建 Seed Speech API Key 默认授予的 entitlement。如果你的项目已开通 TTS 2.0可将VOLCENGINE_TTS_RESOURCE_ID设为seed-tts-2.0。⚠️ 注意VOLCANO_ENGINE_API_KEY仅用于 ModelArk / Doubao 模型端点不是Seed Speech API Key。TTS 需要 BytePlus Speech 控制台的 Seed Speech API Key或旧版 Speech 控制台的 AppID/token 凭据对。旧版 AppID / Token 认证旧版 Speech Console 应用仍支持 AppID/token 认证方式export VOLCENGINE_TTS_APPIDspeech_app_id export VOLCENGINE_TTS_TOKENspeech_access_token export VOLCENGINE_TTS_CLUSTERvolcano_tts其他可选 TTS 环境变量VOLCENGINE_TTS_VOICE、VOLCENGINE_TTS_APP_KEY、VOLCENGINE_TTS_BASE_URL设置后会覆盖tts.providers.volcengine中对应的配置字段。TTS 底层实现要点两种认证路径的 HTTP 实现均位于 extensions/volcengine/tts.tsSeed Speech 路径seedSpeechTTSPOST 到https://voice.ap-southeast-1.bytepluses.com/api/v3/tts/unidirectional请求头携带X-Api-Key、X-Api-Resource-Id、X-Api-App-Key请求体为userreq_params含speaker、audio_params.format、sample_rate: 24000、可选的speed_ratio与emotion。响应为流式 JSON 帧插件逐帧解析只拼接code 0且携带 base64 音频数据的帧code 20000000的帧被跳过其他错误码直接抛出带错误信息的异常。旧版路径legacyVolcengineTTSPOST 到https://openspeech.bytedance.com/api/v1/tts使用Bearer;${token}认证app段携带appid/token/clusteraudio段支持voice_type、encoding、speed_ratio、volume_ratio、pitch_ratio、emotionrequest段以 UUID 作为reqid且operation: query成功时要求业务码code 3000。两条路径都经由 OpenClaw 的fetchWithSsrFGuard发起带 hostname 白名单防止 SSRF、通过readResponseWithLimit限制响应上限16 MiB并对返回的 base64 音频做规范化处理isConfigured校验逻辑speech-provider.ts接受 Seed Speech API Key 或AppID 且 Token任一组合。高级配置引导后的默认模型openclaw onboard --auth-choice volcengine-api-key会把volcengine-plan/ark-code-latest设为默认模型同时注册通用volcengine目录。入口插件通过readManifestProviderDefaultModelRef从清单读取该默认 refindex.ts并在manifestAuth.applyConfig中通过ensureModelAllowlistEntry确保默认模型在模型白名单中。模型选择器回退行为在 onboarding / 配置模型选择阶段Volcengine 认证项会同时优先展示volcengine/*与volcengine-plan/*两行。如果这些模型尚未加载OpenClaw 会回退到未过滤的完整目录而不是显示一个空的、限定 Provider 的选择器。守护进程daemon环境变量如果 Gateway 以守护进程方式运行launchd / systemd交互式 shell 中设置的环境变量不会被自动继承。务必确保模型与 TTS 相关变量对该进程可见例如写入~/.openclaw/.env或在配置中通过env.shellEnv注入模型VOLCANO_ENGINE_API_KEYTTSVOLCENGINE_TTS_API_KEY、BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID、VOLCENGINE_TTS_TOKEN⚠️ 当 OpenClaw 作为后台服务运行时交互式 shell 里export的变量不会自动进入服务进程请按上面的 daemon 说明显式配置。相关文档模型选择与 Provider 概念Provider、模型 ref 与故障切换行为的整体说明Gateway 配置参考agents、models、providers 的完整配置项故障排查常见问题与调试步骤FAQOpenClaw 安装配置高频问答插件参考页openclaw/volcengine-provider的分布、Surface 与相关文档索引【免费下载链接】openclawThe AI that really does things. Any OS. Any Platform. The lobster way. 项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
：机体基础代谢核心调控标志物，云克隆ELISA试剂盒助力科研样本定量检测)
)
