OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

وكيل API لـ Claude Max

claude-max-api-proxy هي حزمة npm مجتمعية (وليست Plugin لـ OpenClaw) تتيح اشتراك Claude Max/Pro كنقطة نهاية API متوافقة مع OpenAI، بحيث يمكنك توجيه أي أداة متوافقة مع OpenAI إلى اشتراكك بدلًا من مفتاح Anthropic API.

لماذا تستخدم هذا

النهج مسار التكلفة الأنسب لـ
مفتاح Anthropic API الدفع لكل رمز عبر Claude Console تطبيقات الإنتاج والأتمتة المشتركة والأحجام الكبيرة
وكيل اشتراك Claude قواعد الخطة والرصيد في Claude Code / claude -p التجارب الشخصية باستخدام أدوات متوافقة

يتيح هذا الوكيل لاشتراك Claude Max أو Pro العمل مع الأدوات المتوافقة مع OpenAI. وهو ليس مسارًا غير محدود بسعر ثابت، بل يرث حدود استخدام Claude Code. تظل مفاتيح API مسار الفوترة الأوضح للاستخدام في بيئات الإنتاج.

آلية العمل

text
Your App -> claude-max-api-proxy -> Claude Code CLI / claude -p -> Anthropic     (OpenAI format)                (converts format)              (uses your login)

يشغّل الوكيل Claude Code CLI كعملية فرعية لكل طلب، ويحوّل طلبات المحادثة بتنسيق OpenAI إلى مطالبات CLI، ثم يبث الاستجابة (أو يعيدها) بتنسيق OpenAI.

بدء الاستخدام

  • Install the proxy

    يتطلب Node.js 20 أو أحدث وClaude Code CLI تمت مصادقته.

    bash
    npm install -g claude-max-api-proxy # Verify Claude CLI is authenticatedclaude --versionclaude auth login   # if not already authenticated

  • Start the server

    bash
    claude-max-api# Server runs at http://localhost:3456

  • Test the proxy

    bash
    curl http://localhost:3456/healthcurl http://localhost:3456/v1/models curl http://localhost:3456/v1/chat/completions \  -H "Content-Type: application/json" \  -d '{    "model": "claude-opus-4",    "messages": [{"role": "user", "content": "Hello!"}]  }'

  • Configure OpenClaw

    وجّه OpenClaw إلى الوكيل بوصفه نقطة نهاية مخصصة متوافقة مع OpenAI:

    json5
    {  env: {    OPENAI_API_KEY: "not-needed",    OPENAI_BASE_URL: "http://localhost:3456/v1",  },  agents: {    defaults: {      model: { primary: "openai/claude-opus-4" },    },  },}
    • معرّف النموذج الاسم المستعار في CLI التعيين الحالي
    claude-opus-4 opus Claude Opus 4.5
    claude-sonnet-4 sonnet Claude Sonnet 4
    claude-haiku-4 haiku Claude Haiku 4

    الإعداد المتقدم

    Proxy-style OpenAI-compatible notes

    يستخدم هذا المسار العام المخصص /v1 والمتوافق مع OpenAI في OpenClaw، وهو المسار نفسه الذي تستخدمه أي واجهة خلفية أخرى مستضافة ذاتيًا ومتوافقة مع OpenAI:

    • لا ينطبق تشكيل الطلبات الأصلي الخاص بـ OpenAI فقط.
    • لا ينطبق /fast وservice_tier إلا على حركة البيانات المباشرة إلى api.anthropic.com؛ وتترك مسارات الوكيل service_tier دون تغيير (راجع الوضع السريع لموفّر Anthropic).
    • لا يتوفر store الخاص بواجهة Responses، ولا تلميحات ذاكرة التخزين المؤقت للمطالبات، ولا تشكيل حمولات توافق الاستدلال في OpenAI.
    • لا تُرسل ترويسات الإسناد الخاصة بـ OpenAI/Codex في OpenClaw (originator وversion وUser-Agent) إلا مع حركة OAuth الأصلية إلى api.openai.com، ولا تُرسل إلى أهداف OPENAI_BASE_URL المخصصة مثل هذا الوكيل.
    Auto-start on macOS with LaunchAgent
    bash
    cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>  <key>Label</key>  <string>com.claude-max-api</string>  <key>RunAtLoad</key>  <true/>  <key>KeepAlive</key>  <true/>  <key>ProgramArguments</key>  <array>    <string>/usr/local/bin/node</string>    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>  </array>  <key>EnvironmentVariables</key>  <dict>    <key>PATH</key>    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>  </dict></dict></plist>EOF launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

    ملاحظات

    • يرث سلوك الفوترة ورصيد الاستخدام وحدود المعدل الخاص بـ claude -p في Claude Code.
    • يرتبط بـ 127.0.0.1 فقط، ولا يرسل البيانات إلى أي خادم تابع لجهة خارجية بخلاف اتصال CLI نفسه بـ Anthropic.
    • يدعم بث الاستجابات.
    • لا يجري التحقق من إخفاقات المصادقة عند بدء التشغيل، ولا تظهر إلا عند تنفيذ طلب محادثة فعليًا؛ إذا لم تتم مصادقة CLI، فتوقّع إخفاق الطلب الأول بدلًا من رفض الخادم بدء التشغيل.

    ذو صلة

    Anthropic provider

    تكامل OpenClaw الأصلي مع Claude CLI أو مفاتيح API.
    OpenAI provider

    لاشتراكات OpenAI/Codex.
    Model selection

    نظرة عامة على جميع الموفّرين ومراجع النماذج وسلوك تجاوز الفشل.
    Configuration

    مرجع الإعداد الكامل.
    Was this useful?
    On this page

    On this page