---
read_when:
    - تريد فهم OAuth في OpenClaw من البداية إلى النهاية
    - تواجه مشكلات إبطال الرمز المميز / تسجيل الخروج
    - تريد تدفقات مصادقة Claude CLI أو OAuth
    - تريد حسابات متعددة أو توجيه الملفات الشخصية
summary: 'OAuth في OpenClaw: تبادل الرموز المميزة وتخزينها وأنماط تعدد الحسابات'
title: OAuth
x-i18n:
    generated_at: "2026-04-30T07:53:40Z"
    model: gpt-5.5
    provider: openai
    source_hash: b4b228c83a79afa4018e9572f790ddfef016a73d2383d2847facdc5bb61ed004
    source_path: concepts/oauth.md
    workflow: 16
---

يدعم OpenClaw «مصادقة الاشتراك» عبر OAuth للمزوّدين الذين يوفّرونها
(خصوصًا **OpenAI Codex (ChatGPT OAuth)**). بالنسبة إلى Anthropic، أصبح التقسيم العملي
الآن هو:

- **مفتاح Anthropic API**: فوترة Anthropic API العادية
- **Anthropic Claude CLI / مصادقة الاشتراك داخل OpenClaw**: أخبرنا موظفو Anthropic
  أن هذا الاستخدام مسموح به مجددًا

يُدعم OpenAI Codex OAuth صراحةً للاستخدام في أدوات خارجية مثل
OpenClaw. تشرح هذه الصفحة:

بالنسبة إلى Anthropic في الإنتاج، تُعدّ مصادقة مفتاح API المسار الموصى به الأكثر أمانًا.

- كيف يعمل **تبادل الرمز المميز** في OAuth (PKCE)
- أين تُخزَّن **الرموز المميزة** (ولماذا)
- كيفية التعامل مع **حسابات متعددة** (ملفات تعريف + تجاوزات لكل جلسة)

يدعم OpenClaw أيضًا **Provider Plugins** التي تأتي بتدفقات OAuth أو مفاتيح API
الخاصة بها. شغّلها عبر:

```bash
openclaw models auth login --provider <id>
```

## مصرف الرموز المميزة (سبب وجوده)

غالبًا ما ينشئ مزوّدو OAuth **رمز تحديث مميزًا جديدًا** أثناء تدفقات تسجيل الدخول/التحديث. يمكن لبعض المزوّدين (أو عملاء OAuth) إبطال رموز التحديث المميزة الأقدم عند إصدار رمز جديد للمستخدم/التطبيق نفسه.

العَرَض العملي:

- تسجّل الدخول عبر OpenClaw _وكذلك_ عبر Claude Code / Codex CLI ← يُسجَّل خروج أحدهما لاحقًا بشكل عشوائي

للحد من ذلك، يتعامل OpenClaw مع `auth-profiles.json` بوصفه **مصرفًا للرموز المميزة**:

- يقرأ وقت التشغيل بيانات الاعتماد من **مكان واحد**
- يمكننا الاحتفاظ بملفات تعريف متعددة وتوجيهها بطريقة حتمية
- إعادة استخدام CLI خارجي خاصة بالمزوّد: يمكن لـ Codex CLI تمهيد ملف تعريف
  `openai-codex:default` فارغ، لكن بمجرد أن يمتلك OpenClaw ملف تعريف OAuth محليًا،
  يصبح رمز التحديث المحلي هو المرجع المعتمد؛ ويمكن أن تبقى التكاملات الأخرى
  مُدارة خارجيًا وتعيد قراءة مخزن مصادقة CLI الخاص بها
- مسارات الحالة وبدء التشغيل التي تعرف بالفعل مجموعة المزوّدين المهيأة تحصر
  اكتشاف CLI الخارجي في تلك المجموعة، بحيث لا يُفحَص مخزن تسجيل دخول CLI غير مرتبط
  لإعداد ذي مزوّد واحد

## التخزين (أين توجد الرموز المميزة)

تُخزَّن الأسرار في مخازن مصادقة الوكيل:

- ملفات تعريف المصادقة (OAuth + مفاتيح API + مراجع اختيارية على مستوى القيمة): `~/.openclaw/agents/<agentId>/agent/auth-profiles.json`
- ملف التوافق القديم: `~/.openclaw/agents/<agentId>/agent/auth.json`
  (تُزال إدخالات `api_key` الثابتة عند اكتشافها)

ملف قديم للاستيراد فقط (ما زال مدعومًا، لكنه ليس المخزن الرئيسي):

- `~/.openclaw/credentials/oauth.json` (يُستورد إلى `auth-profiles.json` عند أول استخدام)

كل ما سبق يحترم أيضًا `$OPENCLAW_STATE_DIR` (تجاوز دليل الحالة). المرجع الكامل: [/gateway/configuration](/ar/gateway/configuration-reference#auth-storage)

للاطلاع على مراجع الأسرار الثابتة وسلوك تفعيل لقطة وقت التشغيل، راجع [إدارة الأسرار](/ar/gateway/secrets).

عندما لا يمتلك وكيل ثانوي ملف تعريف مصادقة محليًا، يستخدم OpenClaw توريث القراءة
من مخزن الوكيل الافتراضي/الرئيسي. ولا ينسخ `auth-profiles.json` الخاص بالوكيل
الرئيسي عند القراءة. رموز تحديث OAuth حساسة على نحو خاص: تتخطاها تدفقات النسخ
العادية افتراضيًا لأن بعض المزوّدين يدوّرون رموز التحديث أو يبطلونها بعد الاستخدام.
هيّئ تسجيل دخول OAuth منفصلًا لوكيل عندما يحتاج إلى حساب مستقل.

## توافق رموز Anthropic القديمة

<Warning>
تقول وثائق Claude Code العامة من Anthropic إن الاستخدام المباشر لـ Claude Code يبقى ضمن
حدود اشتراك Claude، وأخبرنا موظفو Anthropic أن استخدام Claude
CLI بأسلوب OpenClaw مسموح به مجددًا. لذلك يتعامل OpenClaw مع إعادة استخدام Claude CLI
واستخدام `claude -p` بوصفهما معتمدين لهذا التكامل ما لم تنشر Anthropic
سياسة جديدة.

للاطلاع على وثائق خطط Claude Code المباشرة الحالية من Anthropic، راجع [استخدام Claude Code
مع خطة Pro أو Max
الخاصة بك](https://support.claude.com/en/articles/11145838-using-claude-code-with-your-pro-or-max-plan)
و[استخدام Claude Code مع خطة Team أو Enterprise
الخاصة بك](https://support.anthropic.com/en/articles/11845131-using-claude-code-with-your-team-or-enterprise-plan/).

إذا كنت تريد خيارات أخرى بأسلوب الاشتراك في OpenClaw، فراجع [OpenAI
Codex](/ar/providers/openai)، و[Qwen Cloud Coding
Plan](/ar/providers/qwen)، و[MiniMax Coding Plan](/ar/providers/minimax)،
و[Z.AI / GLM Coding Plan](/ar/providers/glm).
</Warning>

يعرّض OpenClaw أيضًا رمز إعداد Anthropic كمسار مدعوم للمصادقة بالرموز المميزة، لكنه يفضّل الآن إعادة استخدام Claude CLI و`claude -p` عند توفرهما.

## ترحيل Anthropic Claude CLI

يدعم OpenClaw إعادة استخدام Anthropic Claude CLI مجددًا. إذا كان لديك بالفعل تسجيل دخول
محلي إلى Claude على المضيف، فيمكن لمسار الإعداد/التهيئة إعادة استخدامه مباشرة.

## تبادل OAuth (كيفية عمل تسجيل الدخول)

تُنفَّذ تدفقات تسجيل الدخول التفاعلية في OpenClaw ضمن `@mariozechner/pi-ai` وتُوصَل بالمعالجات/الأوامر.

### رمز إعداد Anthropic

شكل التدفق:

1. ابدأ رمز إعداد Anthropic أو الصق الرمز من OpenClaw
2. يخزّن OpenClaw بيانات اعتماد Anthropic الناتجة في ملف تعريف مصادقة
3. يبقى اختيار النموذج على `anthropic/...`
4. تظل ملفات تعريف مصادقة Anthropic الموجودة متاحة للتحكم في الرجوع/الترتيب

### OpenAI Codex (ChatGPT OAuth)

يُدعم OpenAI Codex OAuth صراحةً للاستخدام خارج Codex CLI، بما في ذلك تدفقات عمل OpenClaw.

شكل التدفق (PKCE):

1. إنشاء متحقق/تحدي PKCE + قيمة `state` عشوائية
2. فتح `https://auth.openai.com/oauth/authorize?...`
3. محاولة التقاط رد النداء على `http://127.0.0.1:1455/auth/callback`
4. إذا تعذر ربط رد النداء (أو كنت تعمل عن بُعد/بلا واجهة)، فالصق عنوان URL/رمز إعادة التوجيه
5. التبادل عند `https://auth.openai.com/oauth/token`
6. استخراج `accountId` من رمز الوصول وتخزين `{ access, refresh, expires, accountId }`

مسار المعالج هو `openclaw onboard` ← خيار المصادقة `openai-codex`.

## التحديث + انتهاء الصلاحية

تخزّن ملفات التعريف طابعًا زمنيًا `expires`.

في وقت التشغيل:

- إذا كان `expires` في المستقبل ← استخدم رمز الوصول المخزّن
- إذا انتهت الصلاحية ← حدّث (تحت قفل ملف) واكتب فوق بيانات الاعتماد المخزّنة
- إذا قرأ وكيل ثانوي ملف تعريف OAuth موروثًا من الوكيل الرئيسي، فإن التحديث
  يكتب عائدًا إلى مخزن الوكيل الرئيسي بدلًا من نسخ رمز التحديث إلى
  مخزن الوكيل الثانوي
- استثناء: تبقى بعض بيانات اعتماد CLI الخارجية مُدارة خارجيًا؛ يعيد OpenClaw
  قراءة مخازن مصادقة CLI تلك بدلًا من إنفاق رموز تحديث منسوخة.
  تمهيد Codex CLI أضيق عمدًا: فهو يزرع ملف تعريف
  `openai-codex:default` فارغًا، ثم تُبقي التحديثات المملوكة لـ OpenClaw ملف التعريف
  المحلي هو المرجع المعتمد.

تدفق التحديث تلقائي؛ عادةً لا تحتاج إلى إدارة الرموز المميزة يدويًا.

## حسابات متعددة (ملفات تعريف) + التوجيه

نمطان:

### 1) المفضّل: وكلاء منفصلون

إذا أردت ألا يتفاعل «الشخصي» و«العمل» مطلقًا، فاستخدم وكلاء معزولين (جلسات + بيانات اعتماد + مساحة عمل منفصلة):

```bash
openclaw agents add work
openclaw agents add personal
```

ثم هيّئ المصادقة لكل وكيل (المعالج) ووجّه المحادثات إلى الوكيل المناسب.

### 2) متقدم: ملفات تعريف متعددة في وكيل واحد

يدعم `auth-profiles.json` معرّفات ملفات تعريف متعددة للمزوّد نفسه.

اختر ملف التعريف المستخدم:

- عموميًا عبر ترتيب التهيئة (`auth.order`)
- لكل جلسة عبر `/model ...@<profileId>`

مثال (تجاوز جلسة):

- `/model Opus@anthropic:work`

كيفية معرفة معرّفات ملفات التعريف الموجودة:

- `openclaw channels list --json` (يعرض `auth[]`)

وثائق ذات صلة:

- [تجاوز فشل النموذج](/ar/concepts/model-failover) (قواعد التناوب + التهدئة)
- [أوامر Slash](/ar/tools/slash-commands) (سطح الأوامر)

## ذو صلة

- [المصادقة](/ar/gateway/authentication) — نظرة عامة على مصادقة مزوّد النموذج
- [الأسرار](/ar/gateway/secrets) — تخزين بيانات الاعتماد وSecretRef
- [مرجع التهيئة](/ar/gateway/configuration-reference#auth-storage) — مفاتيح تهيئة المصادقة
