SecretRef kimlik bilgisi yüzeyi
Bu sayfa, kanonik SecretRef kimlik bilgisi yüzeyini tanımlar. Kapsam amacı:- Kapsam dahilinde: OpenClaw’ın oluşturmadığı veya döndürmediği, kesinlikle kullanıcı tarafından sağlanan kimlik bilgileri.
- Kapsam dışında: çalışma zamanında oluşturulan veya döndürülen kimlik bilgileri, OAuth yenileme materyalleri 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.firecrawl.config.webFetch.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.serviceAccountvia siblingserviceAccountRef(uyumluluk istisnası)channels.googlechat.accounts.*.serviceAccountvia siblingserviceAccountRef(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 kardeş ref’leri (keyRef/tokenRef) yazar. - Auth-profile ref’leri çalışma zamanı çözümlemesine ve denetim kapsamına dahildir.
- OAuth ilke koruması:
auth.profiles.<id>.mode = "oauth"bu profil için SecretRef girdileriyle birleştirilemez. Bu ilke ihlal edildiğinde başlangıç/yeniden yükleme ve auth-profile çözümlemesi hızlıca başarısız olur. - SecretRef tarafından yönetilen model sağlayıcıları için oluşturulan
agents/*/agent/models.jsongirdileri,apiKey/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 araması için:
- Açık sağlayıcı modunda (
tools.web.search.providerayarlı), yalnızca seçili sağlayıcı anahtarı etkindir. - Otomatik modda (
tools.web.search.providerayarsız), yalnızca öncelik sırasına göre çözümlenen ilk sağlayıcı anahtarı etkindir. - Otomatik modda, seçilmeyen sağlayıcı ref’leri seçilene kadar etkin olmayan olarak değerlendirilir.
- Eski
tools.web.search.*sağlayıcı yolları uyumluluk penceresi boyunca hâlâ çözülür, ancak kanonik SecretRef yüzeyiplugins.entries.<plugin>.config.webSearch.*şeklindedir.
- Açık sağlayıcı 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 oluşturulan, döndürülen, oturum taşıyan veya salt okunur harici SecretRef çözümlemesine uymayan OAuth kalıcı sınıflarıdır.