Asosiy tarkibga o'tish

​
49. OAuth

  1. OpenClaw OAuth orqali “subscription auth”ni qo‘llab-quvvatlaydi (ayniqsa OpenAI Codex (ChatGPT OAuth)). Anthropic obunalari uchun setup-token oqimidan foydalaning. Ushbu sahifa quyidagilarni tushuntiradi:
  • OAuth token exchange qanday ishlashi (PKCE)
  • tokenlar qayerda saqlanishi (va nega)
  • bir nechta akkauntlar bilan qanday ishlash (profilar + sessiya bo‘yicha override’lar)
OpenClaw, shuningdek, o‘z OAuth yoki API‑kalit oqimiga ega bo‘lgan provider pluginlarini ham qo‘llab-quvvatlaydi. Ularni quyidagicha ishga tushiring: 
openclaw models auth login --provider <id>

​
Token sink (nega u mavjud)

OAuth providerlari odatda login/refresh oqimlari vaqtida yangi refresh token yaratadi. Ba’zi providerlar (yoki OAuth klientlari) bir xil foydalanuvchi/app uchun yangi token berilganda eski refresh tokenlarni bekor qilishi mumkin. Amaliy alomat:
  • siz OpenClaw orqali va Claude Code / Codex CLI orqali login qilasiz → ulardan biri keyinroq tasodifan “logout” bo‘lib qoladi
Buni kamaytirish uchun OpenClaw auth-profiles.json ni token sink sifatida ko‘radi:
  • runtime credential’larni bitta joydan o‘qiydi
  • biz bir nechta profilni saqlab, ularni deterministik tarzda yo‘naltira olamiz

​
Saqlash (tokenlar qayerda yashaydi)

Sirlar har bir agent bo‘yicha saqlanadi:
  • Auth profillari (OAuth + API kalitlar): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • Runtime kesh (avtomatik boshqariladi; tahrirlamang): ~/.openclaw/agents/<agentId>/agent/auth.json
Legacy faqat-import fayli (hali ham qo‘llab-quvvatlanadi, lekin asosiy ombor emas):
  • ~/.openclaw/credentials/oauth.json (birinchi foydalanishda auth-profiles.json ga import qilinadi)
Yuqoridagilarning barchasi $OPENCLAW_STATE_DIR ni ham hurmat qiladi (state dir override). To‘liq ma’lumotnoma: /gateway/configuration

​
Anthropic setup-token (obuna autentifikatsiyasi)

Istalgan mashinada claude setup-token ni ishga tushiring, so‘ng uni OpenClaw’ga joylashtiring: 
openclaw models auth setup-token --provider anthropic
Agar tokenni boshqa joyda yaratgan bo‘lsangiz, uni qo‘lda joylashtiring: 
openclaw models auth paste-token --provider anthropic
Tekshirish: 
openclaw models status

​
OAuth exchange (login qanday ishlaydi)

OpenClaw’ning interaktiv login oqimlari @mariozechner/pi-ai da amalga oshirilgan va wizardlar/buyruqlarga ulangan.

​
Anthropic (Claude Pro/Max) sozlash tokeni

Oqim shakli:
  1. claude setup-token ni ishga tushiring
  2. tokenni OpenClaw’ga joylashtiring
  3. token auth profili sifatida saqlang (refresh yo‘q)
Wizard yo‘li: openclaw onboard → auth tanlovi setup-token (Anthropic).

​
OpenAI Codex (ChatGPT OAuth)

Oqim shakli (PKCE):
  1. PKCE verifier/challenge + tasodifiy state yarating
  2. https://auth.openai.com/oauth/authorize?... ni oching
  3. http://127.0.0.1:1455/auth/callback da callback’ni ushlashga harakat qiling
  4. agar callback bog‘lana olmasa (yoki siz remote/headless bo‘lsangiz), redirect URL/kodni joylashtiring
  5. https://auth.openai.com/oauth/token da exchange qiling
  6. access token’dan accountId ni ajrating va { access, refresh, expires, accountId } ni saqlang
Wizard yo‘li: openclaw onboard → auth tanlovi openai-codex.

​
Refresh + muddati tugashi

Profillar expires vaqt tamg‘asini saqlaydi. Ish vaqtida:
  • expires kelajakda bo‘lsa → saqlangan access token’dan foydalaning
  • agar muddati tugagan bo‘lsa → yangilang (fayl lock ostida) va saqlangan credential’larni ustiga yozing
Refresh jarayoni avtomatik; odatda tokenlarni qo‘lda boshqarishingiz shart emas.

​
Bir nechta akkauntlar (profil) + marshrutlash

Ikki naqsh:

​
1. Afzal: alohida agentlar

Agar “personal” va “work” hech qachon o‘zaro aralashmasin desangiz, izolyatsiyalangan agentlardan foydalaning (alohida sessiyalar + credential’lar + workspace): 
openclaw agents add work
openclaw agents add personal
So‘ng har bir agent uchun auth’ni sozlang (wizard orqali) va chatlarni mos agentga yo‘naltiring.

​
2. Kengaytirilgan: bitta agentda bir nechta profil

auth-profiles.json bir xil provider uchun bir nechta profile ID’larni qo‘llab-quvvatlaydi. Qaysi profil ishlatilishini tanlang:
  • global tarzda config tartibi orqali (auth.order)
  • sessiya bo‘yicha /model ...@<profileId> orqali
Misol (sessiya override):
  • /model Opus@anthropic:work
Qaysi profile ID’lar mavjudligini qanday ko‘rish mumkin:
  • openclaw channels list --json (auth[] ni ko‘rsatadi)
Bog‘liq hujjatlar: