Поверхня облікових даних SecretRef
Ця сторінка визначає канонічну поверхню облікових даних SecretRef. Наміри щодо сфери охоплення:- У сфері охоплення: виключно облікові дані, надані користувачем, які OpenClaw не створює і не ротує.
- Поза сферою охоплення: облікові дані, що створюються або ротуються під час виконання, матеріали OAuth refresh і артефакти, подібні до сесій.
Підтримувані облікові дані
Цілі openclaw.json (secrets configure + secrets apply + secrets audit)
models.providers.*.apiKeymodels.providers.*.headers.*models.providers.*.request.auth.tokenmodels.providers.*.request.auth.valuemodels.providers.*.request.headers.*models.providers.*.request.proxy.tls.camodels.providers.*.request.proxy.tls.certmodels.providers.*.request.proxy.tls.keymodels.providers.*.request.proxy.tls.passphrasemodels.providers.*.request.tls.camodels.providers.*.request.tls.certmodels.providers.*.request.tls.keymodels.providers.*.request.tls.passphraseskills.entries.*.apiKeyagents.defaults.memorySearch.remote.apiKeyagents.list[].memorySearch.remote.apiKeytalk.providers.*.apiKeymessages.tts.providers.*.apiKeytools.web.fetch.firecrawl.apiKeyplugins.entries.brave.config.webSearch.apiKeyplugins.entries.google.config.webSearch.apiKeyplugins.entries.xai.config.webSearch.apiKeyplugins.entries.moonshot.config.webSearch.apiKeyplugins.entries.perplexity.config.webSearch.apiKeyplugins.entries.firecrawl.config.webSearch.apiKeyplugins.entries.minimax.config.webSearch.apiKeyplugins.entries.tavily.config.webSearch.apiKeytools.web.search.apiKeygateway.auth.passwordgateway.auth.tokengateway.remote.tokengateway.remote.passwordcron.webhookTokenchannels.telegram.botTokenchannels.telegram.webhookSecretchannels.telegram.accounts.*.botTokenchannels.telegram.accounts.*.webhookSecretchannels.slack.botTokenchannels.slack.appTokenchannels.slack.userTokenchannels.slack.signingSecretchannels.slack.accounts.*.botTokenchannels.slack.accounts.*.appTokenchannels.slack.accounts.*.userTokenchannels.slack.accounts.*.signingSecretchannels.discord.tokenchannels.discord.pluralkit.tokenchannels.discord.voice.tts.providers.*.apiKeychannels.discord.accounts.*.tokenchannels.discord.accounts.*.pluralkit.tokenchannels.discord.accounts.*.voice.tts.providers.*.apiKeychannels.irc.passwordchannels.irc.nickserv.passwordchannels.irc.accounts.*.passwordchannels.irc.accounts.*.nickserv.passwordchannels.bluebubbles.passwordchannels.bluebubbles.accounts.*.passwordchannels.feishu.appSecretchannels.feishu.encryptKeychannels.feishu.verificationTokenchannels.feishu.accounts.*.appSecretchannels.feishu.accounts.*.encryptKeychannels.feishu.accounts.*.verificationTokenchannels.msteams.appPasswordchannels.mattermost.botTokenchannels.mattermost.accounts.*.botTokenchannels.matrix.accessTokenchannels.matrix.passwordchannels.matrix.accounts.*.accessTokenchannels.matrix.accounts.*.passwordchannels.nextcloud-talk.botSecretchannels.nextcloud-talk.apiPasswordchannels.nextcloud-talk.accounts.*.botSecretchannels.nextcloud-talk.accounts.*.apiPasswordchannels.zalo.botTokenchannels.zalo.webhookSecretchannels.zalo.accounts.*.botTokenchannels.zalo.accounts.*.webhookSecretchannels.googlechat.serviceAccountчерез сусіднійserviceAccountRef(виняток сумісності)channels.googlechat.accounts.*.serviceAccountчерез сусіднійserviceAccountRef(виняток сумісності)
Цілі auth-profiles.json (secrets configure + secrets apply + secrets audit)
profiles.*.keyRef(type: "api_key"; не підтримується, колиauth.profiles.<id>.mode = "oauth")profiles.*.tokenRef(type: "token"; не підтримується, колиauth.profiles.<id>.mode = "oauth")
- Цілі плану auth-profile вимагають
agentId. - Записи плану націлюються на
profiles.*.key/profiles.*.tokenі записують сусідні посилання (keyRef/tokenRef). - Посилання auth-profile включені в покриття розв’язання під час виконання та аудиту.
- Захист політики OAuth:
auth.profiles.<id>.mode = "oauth"не можна поєднувати з входами SecretRef для цього профілю. Запуск/перезавантаження та розв’язання auth-profile аварійно завершуються одразу, якщо цю політику порушено. - Для постачальників моделей, керованих SecretRef, згенеровані записи
agents/*/agent/models.jsonзберігають не секретні маркери (а не розв’язані секретні значення) для поверхоньapiKey/заголовків. - Збереження маркерів є авторитетним щодо джерела: OpenClaw записує маркери з активного знімка конфігурації джерела (до розв’язання), а не з розв’язаних значень секретів під час виконання.
- Для вебпошуку:
- У режимі явного постачальника (
tools.web.search.providerзадано) активним є лише ключ вибраного постачальника. - В автоматичному режимі (
tools.web.search.providerне задано) активним є лише перший ключ постачальника, який розв’язується за пріоритетом. - В автоматичному режимі посилання не вибраних постачальників вважаються неактивними, доки їх не буде вибрано.
- Застарілі шляхи постачальників
tools.web.search.*усе ще розв’язуються протягом вікна сумісності, але канонічна поверхня SecretRef — цеplugins.entries.<plugin>.config.webSearch.*.
- У режимі явного постачальника (
Непідтримувані облікові дані
Облікові дані поза сферою охоплення включають:commands.ownerDisplaySecrethooks.tokenhooks.gmail.pushTokenhooks.mappings[].sessionKeyauth-profiles.oauth.*channels.discord.threadBindings.webhookTokenchannels.discord.accounts.*.threadBindings.webhookTokenchannels.whatsapp.creds.jsonchannels.whatsapp.accounts.*.creds.json
- Це створювані, ротаційні, сесійні або OAuth-стійкі класи облікових даних, які не відповідають моделі розв’язання зовнішнього SecretRef лише для читання.