Skip to content

Commit 806803b

Browse files
joshavantsteipete
joshavant
and
steipete
authored
feat(secrets): expand SecretRef coverage across user-supplied credentials (#29580)
* feat(secrets): expand secret target coverage and gateway tooling * docs(secrets): align gateway and CLI secret docs * chore(protocol): regenerate swift gateway models for secrets methods * fix(config): restore talk apiKey fallback and stabilize runner test * ci(windows): reduce test worker count for shard stability * ci(windows): raise node heap for test shard stability * test(feishu): make proxy env precedence assertion windows-safe * fix(gateway): resolve auth password SecretInput refs for clients * fix(gateway): resolve remote SecretInput credentials for clients * fix(secrets): skip inactive refs in command snapshot assignments * fix(secrets): scope gateway.remote refs to effective auth surfaces * fix(secrets): ignore memory defaults when enabled agents disable search * fix(secrets): honor Google Chat serviceAccountRef inheritance * fix(secrets): address tsgo errors in command and gateway collectors * fix(secrets): avoid auth-store load in providers-only configure * fix(gateway): defer local password ref resolution by precedence * fix(secrets): gate telegram webhook secret refs by webhook mode * fix(secrets): gate slack signing secret refs to http mode * fix(secrets): skip telegram botToken refs when tokenFile is set * fix(secrets): gate discord pluralkit refs by enabled flag * fix(secrets): gate discord voice tts refs by voice enabled * test(secrets): make runtime fixture modes explicit * fix(cli): resolve local qr password secret refs * fix(cli): fail when gateway leaves command refs unresolved * fix(gateway): fail when local password SecretRef is unresolved * fix(gateway): fail when required remote SecretRefs are unresolved * fix(gateway): resolve local password refs only when password can win * fix(cli): skip local password SecretRef resolution on qr token override * test(gateway): cast SecretRef fixtures to OpenClawConfig * test(secrets): activate mode-gated targets in runtime coverage fixture * fix(cron): support SecretInput webhook tokens safely * fix(bluebubbles): support SecretInput passwords across config paths * fix(msteams): make appPassword SecretInput-safe in onboarding/token paths * fix(bluebubbles): align SecretInput schema helper typing * fix(cli): clarify secrets.resolve version-skew errors * refactor(secrets): return structured inactive paths from secrets.resolve * refactor(gateway): type onboarding secret writes as SecretInput * chore(protocol): regenerate swift models for secrets.resolve * feat(secrets): expand extension credential secretref support * fix(secrets): gate web-search refs by active provider * fix(onboarding): detect SecretRef credentials in extension status * fix(onboarding): allow keeping existing ref in secret prompt * fix(onboarding): resolve gateway password SecretRefs for probe and tui * fix(onboarding): honor secret-input-mode for local gateway auth * fix(acp): resolve gateway SecretInput credentials * fix(secrets): gate gateway.remote refs to remote surfaces * test(secrets): cover pattern matching and inactive array refs * docs(secrets): clarify secrets.resolve and remote active surfaces * fix(bluebubbles): keep existing SecretRef during onboarding * fix(tests): resolve CI type errors in new SecretRef coverage * fix(extensions): replace raw fetch with SSRF-guarded fetch * test(secrets): mark gateway remote targets active in runtime coverage * test(infra): normalize home-prefix expectation across platforms * fix(cli): only resolve local qr password refs in password mode * test(cli): cover local qr token mode with unresolved password ref * docs(cli): clarify local qr password ref resolution behavior * refactor(extensions): reuse sdk SecretInput helpers * fix(wizard): resolve onboarding env-template secrets before plaintext * fix(cli): surface secrets.resolve diagnostics in memory and qr * test(secrets): repair post-rebase runtime and fixtures * fix(gateway): skip remote password ref resolution when token wins * fix(secrets): treat tailscale remote gateway refs as active * fix(gateway): allow remote password fallback when token ref is unresolved * fix(gateway): ignore stale local password refs for none and trusted-proxy * fix(gateway): skip remote secret ref resolution on local call paths * test(cli): cover qr remote tailscale secret ref resolution * fix(secrets): align gateway password active-surface with auth inference * fix(cli): resolve inferred local gateway password refs in qr * fix(gateway): prefer resolvable remote password over token ref pre-resolution * test(gateway): cover none and trusted-proxy stale password refs * docs(secrets): sync qr and gateway active-surface behavior * fix: restore stability blockers from pre-release audit * Secrets: fix collector/runtime precedence contradictions * docs: align secrets and web credential docs * fix(rebase): resolve integration regressions after main rebase * fix(node-host): resolve gateway secret refs for auth * fix(secrets): harden secretinput runtime readers * gateway: skip inactive auth secretref resolution * cli: avoid gateway preflight for inactive secret refs * extensions: allow unresolved refs in onboarding status * tests: fix qr-cli module mock hoist ordering * Security: align audit checks with SecretInput resolution * Gateway: resolve local-mode remote fallback secret refs * Node host: avoid resolving inactive password secret refs * Secrets runtime: mark Slack appToken inactive for HTTP mode * secrets: keep inactive gateway remote refs non-blocking * cli: include agent memory secret targets in runtime resolution * docs(secrets): sync docs with active-surface and web search behavior * fix(secrets): keep telegram top-level token refs active for blank account tokens * fix(daemon): resolve gateway password secret refs for probe auth * fix(secrets): skip IRC NickServ ref resolution when NickServ is disabled * fix(secrets): align token inheritance and exec timeout defaults * docs(secrets): clarify active-surface notes in cli docs * cli: require secrets.resolve gateway capability * gateway: log auth secret surface diagnostics * secrets: remove dead provider resolver module * fix(secrets): restore gateway auth precedence and fallback resolution * fix(tests): align plugin runtime mock typings --------- Co-authored-by: Peter Steinberger <[email protected]>
1 parent f212351 commit 806803b

236 files changed

Lines changed: 16749 additions & 2800 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/ci.yml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -333,10 +333,10 @@ jobs:
333333
runs-on: blacksmith-16vcpu-windows-2025
334334
timeout-minutes: 45
335335
env:
336-
NODE_OPTIONS: --max-old-space-size=4096
337-
# Keep total concurrency predictable on the 16 vCPU runner:
338-
# `scripts/test-parallel.mjs` runs some vitest suites in parallel processes.
339-
OPENCLAW_TEST_WORKERS: 4
336+
NODE_OPTIONS: --max-old-space-size=6144
337+
# Keep total concurrency predictable on the 16 vCPU runner.
338+
# Windows shard 2 has shown intermittent instability at 2 workers.
339+
OPENCLAW_TEST_WORKERS: 1
340340
defaults:
341341
run:
342342
shell: bash

‎apps/macos/Sources/OpenClawProtocol/GatewayModels.swift‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1030,6 +1030,74 @@ public struct PushTestResult: Codable, Sendable {
10301030
}
10311031
}
10321032

1033+
public struct SecretsReloadParams: Codable, Sendable {}
1034+
1035+
public struct SecretsResolveParams: Codable, Sendable {
1036+
public let commandname: String
1037+
public let targetids: [String]
1038+
1039+
public init(
1040+
commandname: String,
1041+
targetids: [String])
1042+
{
1043+
self.commandname = commandname
1044+
self.targetids = targetids
1045+
}
1046+
1047+
private enum CodingKeys: String, CodingKey {
1048+
case commandname = "commandName"
1049+
case targetids = "targetIds"
1050+
}
1051+
}
1052+
1053+
public struct SecretsResolveAssignment: Codable, Sendable {
1054+
public let path: String?
1055+
public let pathsegments: [String]
1056+
public let value: AnyCodable
1057+
1058+
public init(
1059+
path: String?,
1060+
pathsegments: [String],
1061+
value: AnyCodable)
1062+
{
1063+
self.path = path
1064+
self.pathsegments = pathsegments
1065+
self.value = value
1066+
}
1067+
1068+
private enum CodingKeys: String, CodingKey {
1069+
case path
1070+
case pathsegments = "pathSegments"
1071+
case value
1072+
}
1073+
}
1074+
1075+
public struct SecretsResolveResult: Codable, Sendable {
1076+
public let ok: Bool?
1077+
public let assignments: [SecretsResolveAssignment]?
1078+
public let diagnostics: [String]?
1079+
public let inactiverefpaths: [String]?
1080+
1081+
public init(
1082+
ok: Bool?,
1083+
assignments: [SecretsResolveAssignment]?,
1084+
diagnostics: [String]?,
1085+
inactiverefpaths: [String]?)
1086+
{
1087+
self.ok = ok
1088+
self.assignments = assignments
1089+
self.diagnostics = diagnostics
1090+
self.inactiverefpaths = inactiverefpaths
1091+
}
1092+
1093+
private enum CodingKeys: String, CodingKey {
1094+
case ok
1095+
case assignments
1096+
case diagnostics
1097+
case inactiverefpaths = "inactiveRefPaths"
1098+
}
1099+
}
1100+
10331101
public struct SessionsListParams: Codable, Sendable {
10341102
public let limit: Int?
10351103
public let activeminutes: Int?

‎apps/shared/OpenClawKit/Sources/OpenClawProtocol/GatewayModels.swift‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1030,6 +1030,74 @@ public struct PushTestResult: Codable, Sendable {
10301030
}
10311031
}
10321032

1033+
public struct SecretsReloadParams: Codable, Sendable {}
1034+
1035+
public struct SecretsResolveParams: Codable, Sendable {
1036+
public let commandname: String
1037+
public let targetids: [String]
1038+
1039+
public init(
1040+
commandname: String,
1041+
targetids: [String])
1042+
{
1043+
self.commandname = commandname
1044+
self.targetids = targetids
1045+
}
1046+
1047+
private enum CodingKeys: String, CodingKey {
1048+
case commandname = "commandName"
1049+
case targetids = "targetIds"
1050+
}
1051+
}
1052+
1053+
public struct SecretsResolveAssignment: Codable, Sendable {
1054+
public let path: String?
1055+
public let pathsegments: [String]
1056+
public let value: AnyCodable
1057+
1058+
public init(
1059+
path: String?,
1060+
pathsegments: [String],
1061+
value: AnyCodable)
1062+
{
1063+
self.path = path
1064+
self.pathsegments = pathsegments
1065+
self.value = value
1066+
}
1067+
1068+
private enum CodingKeys: String, CodingKey {
1069+
case path
1070+
case pathsegments = "pathSegments"
1071+
case value
1072+
}
1073+
}
1074+
1075+
public struct SecretsResolveResult: Codable, Sendable {
1076+
public let ok: Bool?
1077+
public let assignments: [SecretsResolveAssignment]?
1078+
public let diagnostics: [String]?
1079+
public let inactiverefpaths: [String]?
1080+
1081+
public init(
1082+
ok: Bool?,
1083+
assignments: [SecretsResolveAssignment]?,
1084+
diagnostics: [String]?,
1085+
inactiverefpaths: [String]?)
1086+
{
1087+
self.ok = ok
1088+
self.assignments = assignments
1089+
self.diagnostics = diagnostics
1090+
self.inactiverefpaths = inactiverefpaths
1091+
}
1092+
1093+
private enum CodingKeys: String, CodingKey {
1094+
case ok
1095+
case assignments
1096+
case diagnostics
1097+
case inactiverefpaths = "inactiveRefPaths"
1098+
}
1099+
}
1100+
10331101
public struct SessionsListParams: Codable, Sendable {
10341102
public let limit: Int?
10351103
public let activeminutes: Int?

‎docs/cli/memory.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,3 +50,5 @@ Notes:
5050
- `memory status --deep --index` runs a reindex if the store is dirty.
5151
- `memory index --verbose` prints per-phase details (provider, model, sources, batch activity).
5252
- `memory status` includes any extra paths configured via `memorySearch.extraPaths`.
53+
- If effectively active memory remote API key fields are configured as SecretRefs, the command resolves those values from the active gateway snapshot. If gateway is unavailable, the command fails fast.
54+
- Gateway version skew note: this command path requires a gateway that supports `secrets.resolve`; older gateways return an unknown-method error.

‎docs/cli/qr.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,9 @@ openclaw qr --url wss://gateway.example/ws --token '<token>'
3434
## Notes
3535

3636
- `--token` and `--password` are mutually exclusive.
37+
- With `--remote`, if effectively active remote credentials are configured as SecretRefs and you do not pass `--token` or `--password`, the command resolves them from the active gateway snapshot. If gateway is unavailable, the command fails fast.
38+
- Without `--remote`, local `gateway.auth.password` SecretRefs are resolved when password auth can win (explicit `gateway.auth.mode="password"` or inferred password mode with no winning token from auth/env), and no CLI auth override is passed.
39+
- Gateway version skew note: this command path requires a gateway that supports `secrets.resolve`; older gateways return an unknown-method error.
3740
- After scanning, approve device pairing with:
3841
- `openclaw devices list`
3942
- `openclaw devices approve <requestId>`

‎docs/cli/secrets.md‎

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,14 @@ title: "secrets"
99

1010
# `openclaw secrets`
1111

12-
Use `openclaw secrets` to migrate credentials from plaintext to SecretRefs and keep the active secrets runtime healthy.
12+
Use `openclaw secrets` to manage SecretRefs and keep the active runtime snapshot healthy.
1313

1414
Command roles:
1515

1616
- `reload`: gateway RPC (`secrets.reload`) that re-resolves refs and swaps runtime snapshot only on full success (no config writes).
17-
- `audit`: read-only scan of config + auth stores + legacy residues (`.env`, `auth.json`) for plaintext, unresolved refs, and precedence drift.
18-
- `configure`: interactive planner for provider setup + target mapping + preflight (TTY required).
19-
- `apply`: execute a saved plan (`--dry-run` for validation only), then scrub migrated plaintext residues.
17+
- `audit`: read-only scan of configuration/auth stores and legacy residues for plaintext, unresolved refs, and precedence drift.
18+
- `configure`: interactive planner for provider setup, target mapping, and preflight (TTY required).
19+
- `apply`: execute a saved plan (`--dry-run` for validation only), then scrub targeted plaintext residues.
2020

2121
Recommended operator loop:
2222

@@ -31,11 +31,13 @@ openclaw secrets reload
3131

3232
Exit code note for CI/gates:
3333

34-
- `audit --check` returns `1` on findings, `2` when refs are unresolved.
34+
- `audit --check` returns `1` on findings.
35+
- unresolved refs return `2`.
3536

3637
Related:
3738

3839
- Secrets guide: [Secrets Management](/gateway/secrets)
40+
- Credential surface: [SecretRef Credential Surface](/reference/secretref-credential-surface)
3941
- Security guide: [Security](/gateway/security)
4042

4143
## Reload runtime snapshot
@@ -59,8 +61,8 @@ Scan OpenClaw state for:
5961

6062
- plaintext secret storage
6163
- unresolved refs
62-
- precedence drift (`auth-profiles` shadowing config refs)
63-
- legacy residues (`auth.json`, OAuth out-of-scope notes)
64+
- precedence drift (`auth-profiles.json` credentials shadowing `openclaw.json` refs)
65+
- legacy residues (legacy auth store entries, OAuth reminders)
6466

6567
```bash
6668
openclaw secrets audit
@@ -71,7 +73,7 @@ openclaw secrets audit --json
7173
Exit behavior:
7274

7375
- `--check` exits non-zero on findings.
74-
- unresolved refs exit with a higher-priority non-zero code.
76+
- unresolved refs exit with higher-priority non-zero code.
7577

7678
Report shape highlights:
7779

@@ -85,14 +87,15 @@ Report shape highlights:
8587

8688
## Configure (interactive helper)
8789

88-
Build provider + SecretRef changes interactively, run preflight, and optionally apply:
90+
Build provider and SecretRef changes interactively, run preflight, and optionally apply:
8991

9092
```bash
9193
openclaw secrets configure
9294
openclaw secrets configure --plan-out /tmp/openclaw-secrets-plan.json
9395
openclaw secrets configure --apply --yes
9496
openclaw secrets configure --providers-only
9597
openclaw secrets configure --skip-provider-setup
98+
openclaw secrets configure --agent ops
9699
openclaw secrets configure --json
97100
```
98101

@@ -106,23 +109,26 @@ Flags:
106109

107110
- `--providers-only`: configure `secrets.providers` only, skip credential mapping.
108111
- `--skip-provider-setup`: skip provider setup and map credentials to existing providers.
112+
- `--agent <id>`: scope `auth-profiles.json` target discovery and writes to one agent store.
109113

110114
Notes:
111115

112116
- Requires an interactive TTY.
113117
- You cannot combine `--providers-only` with `--skip-provider-setup`.
114-
- `configure` targets secret-bearing fields in `openclaw.json`.
115-
- Include all secret-bearing fields you intend to migrate (for example both `models.providers.*.apiKey` and `skills.entries.*.apiKey`) so audit can reach a clean state.
118+
- `configure` targets secret-bearing fields in `openclaw.json` plus `auth-profiles.json` for the selected agent scope.
119+
- `configure` supports creating new `auth-profiles.json` mappings directly in the picker flow.
120+
- Canonical supported surface: [SecretRef Credential Surface](/reference/secretref-credential-surface).
116121
- It performs preflight resolution before apply.
117122
- Generated plans default to scrub options (`scrubEnv`, `scrubAuthProfilesForProviderTargets`, `scrubLegacyAuthJson` all enabled).
118-
- Apply path is one-way for migrated plaintext values.
123+
- Apply path is one-way for scrubbed plaintext values.
119124
- Without `--apply`, CLI still prompts `Apply this plan now?` after preflight.
120-
- With `--apply` (and no `--yes`), CLI prompts an extra irreversible-migration confirmation.
125+
- With `--apply` (and no `--yes`), CLI prompts an extra irreversible confirmation.
121126

122127
Exec provider safety note:
123128

124129
- Homebrew installs often expose symlinked binaries under `/opt/homebrew/bin/*`.
125130
- Set `allowSymlinkCommand: true` only when needed for trusted package-manager paths, and pair it with `trustedDirs` (for example `["/opt/homebrew"]`).
131+
- On Windows, if ACL verification is unavailable for a provider path, OpenClaw fails closed. For trusted paths only, set `allowInsecurePath: true` on that provider to bypass path security checks.
126132

127133
## Apply a saved plan
128134

@@ -154,10 +160,9 @@ Safety comes from strict preflight + atomic-ish apply with best-effort in-memory
154160
## Example
155161

156162
```bash
157-
# Audit first, then configure, then confirm clean:
158163
openclaw secrets audit --check
159164
openclaw secrets configure
160165
openclaw secrets audit --check
161166
```
162167

163-
If `audit --check` still reports plaintext findings after a partial migration, verify you also migrated skill keys (`skills.entries.*.apiKey`) and any other reported target paths.
168+
If `audit --check` still reports plaintext findings, update the remaining reported target paths and rerun audit.

‎docs/docs.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1321,6 +1321,7 @@
13211321
"pages": [
13221322
"reference/wizard",
13231323
"reference/token-use",
1324+
"reference/secretref-credential-surface",
13241325
"reference/prompt-caching",
13251326
"reference/api-usage-costs",
13261327
"reference/transcript-hygiene",

‎docs/gateway/configuration-reference.md‎

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1170,8 +1170,8 @@ Optional **Docker sandboxing** for the embedded agent. See [Sandboxing](/gateway
11701170

11711171
**`docker.binds`** mounts additional host directories; global and per-agent binds are merged.
11721172

1173-
**Sandboxed browser** (`sandbox.browser.enabled`): Chromium + CDP in a container. noVNC URL injected into system prompt. Does not require `browser.enabled` in main config.
1174-
noVNC observer access uses VNC auth by default and OpenClaw emits a short-lived token URL that serves a local bootstrap page; noVNC password is passed via URL fragment (instead of URL query).
1173+
**Sandboxed browser** (`sandbox.browser.enabled`): Chromium + CDP in a container. noVNC URL injected into system prompt. Does not require `browser.enabled` in `openclaw.json`.
1174+
noVNC observer access uses VNC auth by default and OpenClaw emits a short-lived token URL (instead of exposing the password in the shared URL).
11751175

11761176
- `allowHostControl: false` (default) blocks sandboxed sessions from targeting the host browser.
11771177
- `network` defaults to `openclaw-sandbox-browser` (dedicated bridge network). Set to `bridge` only when you explicitly want global bridge connectivity.
@@ -1605,7 +1605,8 @@ Defaults for Talk mode (macOS/iOS/Android).
16051605
```
16061606

16071607
- Voice IDs fall back to `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID`.
1608-
- `apiKey` falls back to `ELEVENLABS_API_KEY`.
1608+
- `apiKey` and `providers.*.apiKey` accept plaintext strings or SecretRef objects.
1609+
- `ELEVENLABS_API_KEY` fallback applies only when no Talk API key is configured.
16091610
- `voiceAliases` lets Talk directives use friendly names.
16101611

16111612
---
@@ -1804,7 +1805,7 @@ Configures inbound media understanding (image/audio/video):
18041805

18051806
- `provider`: API provider id (`openai`, `anthropic`, `google`/`gemini`, `groq`, etc.)
18061807
- `model`: model id override
1807-
- `profile` / `preferredProfile`: auth profile selection
1808+
- `profile` / `preferredProfile`: `auth-profiles.json` profile selection
18081809

18091810
**CLI entry** (`type: "cli"`):
18101811

@@ -1817,7 +1818,7 @@ Configures inbound media understanding (image/audio/video):
18171818
- `prompt`, `maxChars`, `maxBytes`, `timeoutSeconds`, `language`: per-entry overrides.
18181819
- Failures fall back to the next entry.
18191820

1820-
Provider auth follows standard order: auth profiles → env vars → `models.providers.*.apiKey`.
1821+
Provider auth follows standard order: `auth-profiles.json` → env vars → `models.providers.*.apiKey`.
18211822

18221823
</Accordion>
18231824

@@ -2638,14 +2639,11 @@ Validation:
26382639
- `source: "file"` id: absolute JSON pointer (for example `"/providers/openai/apiKey"`)
26392640
- `source: "exec"` id pattern: `^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$`
26402641

2641-
### Supported fields in config
2642+
### Supported credential surface
26422643

2643-
- `models.providers.<provider>.apiKey`
2644-
- `skills.entries.<skillKey>.apiKey`
2645-
- `channels.googlechat.serviceAccount`
2646-
- `channels.googlechat.serviceAccountRef`
2647-
- `channels.googlechat.accounts.<accountId>.serviceAccount`
2648-
- `channels.googlechat.accounts.<accountId>.serviceAccountRef`
2644+
- Canonical matrix: [SecretRef Credential Surface](/reference/secretref-credential-surface)
2645+
- `secrets apply` targets supported `openclaw.json` credential paths.
2646+
- `auth-profiles.json` refs are included in runtime resolution and audit coverage.
26492647

26502648
### Secret providers config
26512649

@@ -2683,6 +2681,7 @@ Notes:
26832681
- If `trustedDirs` is configured, the trusted-dir check applies to the resolved target path.
26842682
- `exec` child environment is minimal by default; pass required variables explicitly with `passEnv`.
26852683
- Secret refs are resolved at activation time into an in-memory snapshot, then request paths read the snapshot only.
2684+
- Active-surface filtering applies during activation: unresolved refs on enabled surfaces fail startup/reload, while inactive surfaces are skipped with diagnostics.
26862685

26872686
---
26882687

@@ -2702,8 +2701,8 @@ Notes:
27022701
}
27032702
```
27042703

2705-
- Per-agent auth profiles stored at `<agentDir>/auth-profiles.json`.
2706-
- Auth profiles support value-level refs (`keyRef` for `api_key`, `tokenRef` for `token`).
2704+
- Per-agent profiles are stored at `<agentDir>/auth-profiles.json`.
2705+
- `auth-profiles.json` supports value-level refs (`keyRef` for `api_key`, `tokenRef` for `token`).
27072706
- Static runtime credentials come from in-memory resolved snapshots; legacy static `auth.json` entries are scrubbed when discovered.
27082707
- Legacy OAuth imports from `~/.openclaw/credentials/oauth.json`.
27092708
- See [OAuth](/concepts/oauth).
@@ -2900,7 +2899,7 @@ Split config into multiple files:
29002899
- Array of files: deep-merged in order (later overrides earlier).
29012900
- Sibling keys: merged after includes (override included values).
29022901
- Nested includes: up to 10 levels deep.
2903-
- Paths: resolved relative to the including file, but must stay inside the top-level config directory (`dirname` of the main config file). Absolute/`../` forms are allowed only when they still resolve inside that boundary.
2902+
- Paths: resolved relative to the including file, but must stay inside the top-level config directory (`dirname` of `openclaw.json`). Absolute/`../` forms are allowed only when they still resolve inside that boundary.
29042903
- Errors: clear messages for missing files, parse errors, and circular includes.
29052904

29062905
---

‎docs/gateway/configuration.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -532,6 +532,7 @@ Rules:
532532
```
533533

534534
SecretRef details (including `secrets.providers` for `env`/`file`/`exec`) are in [Secrets Management](/gateway/secrets).
535+
Supported credential paths are listed in [SecretRef Credential Surface](/reference/secretref-credential-surface).
535536
</Accordion>
536537

537538
See [Environment](/help/environment) for full precedence and sources.

0 commit comments

Comments
 (0)