fix: resolve local TTS SecretRefs before conversion by joshavant · Pull Request #72549 · openclaw/openclaw

joshavant · 2026-04-27T03:16:30Z

Summary

Problem: local infer tts convert loaded source config directly, so messages.tts.providers.minimax.apiKey stayed as a SecretRef object instead of the resolved startup/reload snapshot value.
Why it matters: MiniMax TTS could fail locally and fall back to another provider even when the SecretRef audit was clean.
What changed: route local TTS conversion through command SecretRef resolution for messages.tts.providers.*.apiKey before computing TTS overrides and calling the runtime.
What did NOT change (scope boundary): gateway TTS behavior and other SecretRef coverage gaps in SecretRef coverage gaps for several auth/config paths #68690 are unchanged.

Change Type (select all)

Scope (select all touched areas)

Linked Issue/PR

Related SecretRef coverage gaps for several auth/config paths #68690
This PR fixes a bug or regression

Root Cause (if applicable)

Root cause: the local TTS CLI path used loadConfig() directly, while SecretRef-backed command paths need the shared command SecretRef resolver to read the active gateway snapshot or local fallback resolution.
Missing detection / guardrail: src/cli/capability-cli.ts was not listed in command SecretRef resolution callsite coverage.
Contributing context (if known): MiniMax validates apiKey through normalized resolved secret input and fails when it receives an unresolved SecretRef object.

Regression Test Plan (if applicable)

Coverage level that should have caught this:
- Unit test
- Seam / integration test
- End-to-end test
- Existing coverage already sufficient
Target test or file: src/cli/capability-cli.test.ts, src/cli/command-secret-resolution.coverage.test.ts, src/cli/command-secret-targets.test.ts
Scenario the test should lock in: local capability tts convert resolves messages.tts.providers.*.apiKey SecretRefs and passes the resolved config to TTS override/runtime code.
Why this is the smallest reliable guardrail: it exercises the CLI seam that regressed without requiring live MiniMax credentials.
Existing test that already covers this (if any): none before this PR.
If no new test is added, why not: N/A

User-visible / Behavior Changes

Local openclaw infer tts convert now supports SecretRef-backed messages.tts.providers.minimax.apiKey through the shared command SecretRef resolution path.

Diagram (if applicable)

Before:
local infer tts convert -> source config -> unresolved MiniMax apiKey SecretRef -> provider failure/fallback

After:
local infer tts convert -> command SecretRef resolver -> resolved config -> MiniMax TTS request

Security Impact (required)

New permissions/capabilities? (Yes/No) No
Secrets/tokens handling changed? (Yes/No) Yes
New/changed network calls? (Yes/No) No
Command/tool execution surface changed? (Yes/No) No
Data access scope changed? (Yes/No) No
If any Yes, explain risk + mitigation: local TTS now uses the same command SecretRef resolver already used by other supported command paths, scoped only to static TTS provider API-key targets and enforce_resolved mode.

Repro + Verification

Environment

OS: Linux container
Runtime/container: Docker node:22-bookworm
Model/provider: MiniMax TTS, mock local T2A v2 endpoint
Integration/channel (if any): local CLI TTS
Relevant config (redacted): messages.tts.provider: "minimax"; messages.tts.providers.minimax.apiKey as an exec SecretRef resolving to a mock static key

Steps

Configure messages.tts.providers.minimax.apiKey as an exec SecretRef and point MiniMax TTS baseUrl to a local mock endpoint.
Run OPENCLAW_STATE_DIR=/workspace/repro/state pnpm openclaw secrets audit --allow-exec --json.
Run OPENCLAW_STATE_DIR=/workspace/repro/state pnpm openclaw infer tts convert --text "SecretRef reproduction sample" --json.
Run OPENCLAW_STATE_DIR=/workspace/repro/state pnpm openclaw infer tts convert --text "SecretRef explicit MiniMax sample" --model minimax/speech-2.8-hd --json.

Expected

SecretRef audit is clean.
Both TTS commands use MiniMax and send the resolved bearer token to the mock endpoint.

Actual

Before: local TTS failed MiniMax with unresolved SecretRef and fell back, or failed directly for explicit MiniMax.
After: both local TTS commands succeed with provider: "minimax".

Evidence

Failing test/log before + passing after
Trace/log snippets
Screenshot/recording
Perf numbers (if relevant)

Docker mock endpoint received two requests with Authorization: Bearer mock-minimax-static-key after the fix.

Local validation:

pnpm test src/cli/capability-cli.test.ts src/cli/command-secret-targets.test.ts src/cli/command-secret-targets.import.test.ts src/cli/command-secret-resolution.coverage.test.ts
pnpm check:changed

Human Verification (required)

Verified scenarios: clean SecretRef audit, local default MiniMax TTS, local explicit MiniMax model TTS, mock endpoint bearer-token request capture.
Edge cases checked: explicit provider/model selection disables fallback and still succeeds with the resolved SecretRef.
What you did not verify: real MiniMax API credentials/service response.

Review Conversations

I replied to or resolved every bot review conversation I addressed in this PR.
I left unresolved only the conversations that still need reviewer or maintainer judgment.

Compatibility / Migration

Backward compatible? (Yes/No) Yes
Config/env changes? (Yes/No) No
Migration needed? (Yes/No) No
If yes, exact upgrade steps: N/A

Risks and Mitigations

Risk: local TTS now attempts command SecretRef resolution for configured TTS API-key refs.
- Mitigation: resolution is scoped to messages.tts.providers.*.apiKey and uses the existing shared resolver with enforce_resolved behavior.

aisle-research-bot · 2026-04-27T03:16:37Z

🔒 Aisle Security Analysis

We found 1 potential security issue(s) in this PR:

#	Severity	Title
1	🟠 High	Potential arbitrary command execution via SecretRef exec provider during `infer tts convert` secret resolution

1. 🟠 Potential arbitrary command execution via SecretRef exec provider during `infer tts convert` secret resolution

Property	Value
Severity	High
CWE	CWE-78
Location	`src/cli/capability-cli.ts:1116-1121`

Description

infer tts convert now resolves SecretRefs before running by calling resolveCommandSecretRefsViaGateway(...) with mode: "enforce_resolved".

If the gateway is unavailable or its snapshot is incomplete, resolveCommandSecretRefsViaGateway falls back to local secret resolution, which can execute configured secret providers of source: "exec" (spawning a subprocess) based on values from the user/project-controlled config.

Why this is a security risk:

Input/control: loadConfig() loads project/user configuration which may come from a checked-out repository or other untrusted source.
Dangerous behavior: local fallback uses resolveSecretRefValue() → resolveExecRefs() which runs spawn(command, args, ...) for secrets.providers.<name>.command.
Trigger: this behavior can now be triggered simply by invoking infer tts convert (even if the user did not intend to run any local exec-based provider), when SecretRefs are present and the gateway cannot resolve them.

This can lead to executing attacker-controlled binaries/scripts referenced in config (e.g., an exec provider pointing at an absolute path within the repo), resulting in arbitrary code execution under the user's account.

Recommendation

Treat exec-based SecretRef providers as explicitly opt-in for CLI commands, and avoid spawning processes during implicit resolution flows.

Suggested mitigations (pick one or combine):

Disable local fallback for exec providers in this command path (or in general) unless a user explicitly enables it:

await resolveCommandSecretRefsViaGateway({
  config: loadConfig(),
  commandName: "infer tts convert",
  targetIds: getTtsCommandSecretTargetIds(),
  mode: "enforce_resolved",
  // new option: disallowLocalExecProviders: true
});

Allowlist provider sources permitted for automatic resolution (e.g., only env/file), and fail closed when config contains exec SecretRefs:

if (providerConfig.source === "exec") {
  throw new Error("Exec secret providers are disabled for this command unless --allow-exec-secrets is set");
}

If exec providers must remain supported, require:

an interactive prompt or --yes/--allow-exec-secrets flag
and a hardcoded trusted directory policy not controllable by config (do not rely on trustedDirs/allowInsecurePath values provided by the same untrusted config).

Analyzed PR: #72549 at commit e265c32

_{Last updated on: 2026-04-27T03:19:04Z}

greptile-apps · 2026-04-27T03:17:38Z

Greptile Summary

Routes local infer tts convert through the shared command SecretRef resolver (resolveCommandSecretRefsViaGateway) before computing TTS overrides and calling the runtime, fixing a bug where messages.tts.providers.minimax.apiKey was passed as an unresolved SecretRef object to MiniMax. The refactor also extracts STATIC_TTS_TARGET_IDS into its own named constant and export, keeping the spread in STATIC_AGENT_RUNTIME_BASE_TARGET_IDS to avoid any regression on agent-runtime resolution.

Confidence Score: 5/5

This PR is safe to merge — the fix is narrow, well-tested, and follows the existing SecretRef resolution pattern used by other command paths.

Changes are tightly scoped: a single call-site switch from loadConfig() to resolveCommandSecretRefsViaGateway(...), a constant extraction with no semantic change to agent-runtime resolution, and a new exported helper. New test coverage directly locks in the fixed behaviour. No existing contract is altered and the gateway path is untouched.

No files require special attention.

_{Reviews (1): Last reviewed commit: "fix: resolve tts secret refs for local i..." | Re-trigger Greptile}

This reverts commit 4878d3e.

This reverts commit 6506f23.

This reverts commit f89ac65.

This reverts commit 28461ca.

This reverts commit 0884f7b.

This reverts commit d37ad37.

This reverts commit 01282ec.

fix: resolve tts secret refs for local infer

e265c32

openclaw-barnacle Bot added cli CLI command changes size: S maintainer Maintainer-authored PR labels Apr 27, 2026

joshavant merged commit 4878d3e into main Apr 27, 2026
67 of 70 checks passed

joshavant deleted the fix/minimax-tts-secretref branch April 27, 2026 03:31

joshavant added a commit that referenced this pull request Apr 27, 2026

Revert "fix: resolve tts secret refs for local infer (#72549)"

6b6f8ab

This reverts commit 4878d3e.

joshavant mentioned this pull request Apr 27, 2026

fix: use runtime snapshot for TTS SecretRefs #72581

Merged

25 tasks

ogt-redknie pushed a commit to ogt-redknie/OPENX that referenced this pull request May 2, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

6506f23

ogt-redknie pushed a commit to ogt-redknie/OPENX that referenced this pull request May 2, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

4d2be43

This reverts commit 6506f23.

github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request May 9, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

f89ac65

github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request May 9, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

338de51

This reverts commit f89ac65.

globalcaos pushed a commit to globalcaos/tinkerclaw that referenced this pull request May 13, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

28461ca

globalcaos pushed a commit to globalcaos/tinkerclaw that referenced this pull request May 13, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

20638cd

This reverts commit 28461ca.

github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request May 24, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

0884f7b

github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request May 24, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

6baaa1c

This reverts commit 0884f7b.

jameslcowan pushed a commit to jameslcowan/openclaw that referenced this pull request Jun 2, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

d37ad37

jameslcowan pushed a commit to jameslcowan/openclaw that referenced this pull request Jun 2, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

1fe4309

This reverts commit d37ad37.

sablehead pushed a commit to sablehead/openclaw that referenced this pull request Jun 10, 2026

fix: resolve tts secret refs for local infer (openclaw#72549)

01282ec

sablehead pushed a commit to sablehead/openclaw that referenced this pull request Jun 10, 2026

Revert "fix: resolve tts secret refs for local infer (openclaw#72549)"

1e0b841

This reverts commit 01282ec.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

fix: resolve local TTS SecretRefs before conversion#72549

fix: resolve local TTS SecretRefs before conversion#72549
joshavant merged 1 commit into
mainfrom
fix/minimax-tts-secretref

joshavant commented Apr 27, 2026

Uh oh!

aisle-research-bot Bot commented Apr 27, 2026 •

edited

Loading

Description

Recommendation

Uh oh!

greptile-apps Bot commented Apr 27, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Uh oh!

Conversation

joshavant commented Apr 27, 2026

Summary

Change Type (select all)

Scope (select all touched areas)

Linked Issue/PR

Root Cause (if applicable)

Regression Test Plan (if applicable)

User-visible / Behavior Changes

Diagram (if applicable)

Security Impact (required)

Repro + Verification

Environment

Steps

Expected

Actual

Evidence

Human Verification (required)

Review Conversations

Compatibility / Migration

Risks and Mitigations

Uh oh!

aisle-research-bot Bot commented Apr 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔒 Aisle Security Analysis

Description

Recommendation

Uh oh!

greptile-apps Bot commented Apr 27, 2026

Greptile Summary

Confidence Score: 5/5

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

aisle-research-bot Bot commented Apr 27, 2026 •

edited

Loading