SecretRef kimlik bilgisi yüzeyi
Bu sayfa, kanonik SecretRef kimlik bilgisi yüzeyini tanımlar. Kapsam amacı:- Kapsam dahilinde: OpenClaw’ın üretmediği veya döndürmediği, kesin olarak kullanıcı tarafından sağlanan kimlik bilgileri.
- Kapsam dışında: çalışma zamanında üretilen veya dönen kimlik bilgileri, OAuth yenileme materyali ve oturum benzeri yapıtlar.
Desteklenen kimlik bilgileri
openclaw.json hedefleri (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.serviceAccountsiblingserviceAccountRefüzerinden (uyumluluk istisnası)channels.googlechat.accounts.*.serviceAccountsiblingserviceAccountRefüzerinden (uyumluluk istisnası)
auth-profiles.json hedefleri (secrets configure + secrets apply + secrets audit)
profiles.*.keyRef(type: "api_key";auth.profiles.<id>.mode = "oauth"olduğunda desteklenmez)profiles.*.tokenRef(type: "token";auth.profiles.<id>.mode = "oauth"olduğunda desteklenmez)
- Auth-profile plan hedefleri
agentIdgerektirir. - Plan girdileri
profiles.*.key/profiles.*.tokenalanlarını hedefler ve sibling ref’leri (keyRef/tokenRef) yazar. - Auth-profile ref’leri çalışma zamanı çözümlemesine ve denetim kapsamına dahildir.
- OAuth politika koruması:
auth.profiles.<id>.mode = "oauth", o profil için SecretRef girdileriyle birlikte kullanılamaz. Bu politika ihlal edildiğinde başlangıç/yeniden yükleme ve auth-profile çözümlemesi hızlı başarısız olur. - SecretRef tarafından yönetilen model provider’lar için, oluşturulan
agents/*/agent/models.jsongirdileriapiKey/header yüzeyleri için gizli olmayan işaretleyicileri saklar (çözümlenmiş gizli değerleri değil). - İşaretleyici kalıcılığı kaynak açısından yetkilidir: OpenClaw işaretleyicileri çözümlenmiş çalışma zamanı gizli değerlerinden değil, etkin kaynak yapılandırma anlık görüntüsünden (çözümleme öncesi) yazar.
- Web search için:
- Açık provider modunda (
tools.web.search.providerayarlı), yalnızca seçilen provider anahtarı etkindir. - Otomatik modda (
tools.web.search.providerayarsız), yalnızca öncelik sırasına göre çözümlenen ilk provider anahtarı etkindir. - Otomatik modda, seçilmeyen provider ref’leri seçilene kadar etkisiz kabul edilir.
- Eski
tools.web.search.*provider yolları uyumluluk penceresi boyunca çözümlenmeye devam eder, ancak kanonik SecretRef yüzeyiplugins.entries.<plugin>.config.webSearch.*yoludur.
- Açık provider modunda (
Desteklenmeyen kimlik bilgileri
Kapsam dışı kimlik bilgileri şunları içerir:commands.ownerDisplaySecrethooks.tokenhooks.gmail.pushTokenhooks.mappings[].sessionKeyauth-profiles.oauth.*channels.discord.threadBindings.webhookTokenchannels.discord.accounts.*.threadBindings.webhookTokenchannels.whatsapp.creds.jsonchannels.whatsapp.accounts.*.creds.json
- Bu kimlik bilgileri üretilen, dönen, oturum taşıyan veya salt okunur harici SecretRef çözümlemesine uymayan OAuth-kalıcı sınıflardır.