إطار تشغيل Codex

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

المتطلبات

• OpenClaw مع Plugin codex المضمّنة متاحة.
• إذا كان إعدادك يستخدم plugins.allow، فأدرج codex.
• Codex app-server 0.125.0 أو أحدث. تدير Plugin المضمّنة ثنائي Codex app-server متوافقاً افتراضياً، لذلك لا تؤثر أوامر codex المحلية على PATH في بدء تشغيل المشغّل العادي.
• مصادقة Codex متاحة عبر openclaw models auth login --provider openai-codex، أو حساب app-server في منزل Codex الخاص بالوكيل، أو ملف تعريف مصادقة Codex API-key صريح.

​

البدء السريع

openclaw models auth login --provider openai-codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

الإعداد

{
  auth: {
    order: {
      openai: ["openai-codex:user@example.com", "openai:api-key-backup"],
    },
  },
}

​

التحقق من وقت تشغيل Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

التوجيه واختيار النموذج

• استخدم openai/gpt-* لدورات وكيل OpenAI عبر Codex.
• لا تستخدم openai-codex/gpt-* في الإعداد. شغّل openclaw doctor --fix لإصلاح المراجع القديمة وتثبيتات مسار الجلسة الراكدة.
• agentRuntime.id: "codex" اختياري لوضع OpenAI التلقائي العادي، لكنه مفيد عندما يجب أن يفشل النشر فشلاً مغلقاً إذا لم يكن Codex متاحاً.
• agentRuntime.id: "pi" يختار لمزوّد أو نموذج سلوك PI المباشر عندما يكون ذلك مقصوداً.
• يتحكم /codex ... في محادثات Codex app-server الأصلية من المحادثة.
• ACP/acpx هو مسار مشغّل خارجي منفصل. استخدمه فقط عندما يطلب المستخدم ACP/acpx أو محوّل مشغّل خارجي.

​

أنماط النشر

​

نشر Codex الأساسي

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

​

نشر بمزوّدين مختلطين

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-6",
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
      },
    ],
  },
}

​

نشر Codex بفشل مغلق

{
  models: {
    providers: {
      openai: {
        agentRuntime: {
          id: "codex",
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

سياسة app-server

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

​

الأوامر والتشخيصات

• يتحقق /codex status من اتصال خادم التطبيق، والنماذج، والحساب، وحدود المعدل، وخوادم MCP، وSkills.
• يعرض /codex models نماذج خادم تطبيق Codex المباشرة.
• يعرض /codex threads [filter] سلاسل خادم تطبيق Codex الأخيرة.
• يربط /codex resume <thread-id> جلسة OpenClaw الحالية بسلسلة Codex موجودة.
• يطلب /codex compact من خادم تطبيق Codex تنفيذ Compaction للسلسلة المرتبطة.
• يبدأ /codex review مراجعة Codex الأصلية للسلسلة المرتبطة.
• يطلب /codex diagnostics [note] الإذن قبل إرسال ملاحظات Codex للسلسلة المرتبطة.
• يعرض /codex account حالة الحساب وحدود المعدل.
• يعرض /codex mcp حالة خادم MCP في خادم تطبيق Codex.
• يعرض /codex skills Skills الخاصة بخادم تطبيق Codex.

​

فحص سلاسل Codex محليًا

codex resume <thread-id>

1. ملفات تعريف مصادقة OpenAI المرتّبة للوكيل، ويفضّل أن تكون تحت auth.order.openai. تظل معرفات ملفات التعريف الحالية openai-codex:* صالحة.
2. الحساب الموجود لخادم التطبيق في موطن Codex لذلك الوكيل.
3. لتشغيل خادم التطبيق المحلي عبر stdio فقط، CODEX_API_KEY ثم OPENAI_API_KEY، عندما لا يكون هناك حساب خادم تطبيق موجود وتظل مصادقة OpenAI مطلوبة.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],
          },
        },
      },
    },
  },
}

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

​

Plugins الأصلية في Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}

​

استخدام الكمبيوتر

​

حدود وقت التشغيل

• أدوات OpenClaw الديناميكية مدعومة. يطلب Codex من OpenClaw تنفيذ تلك الأدوات، لذلك يبقى OpenClaw ضمن مسار التنفيذ.
• أدوات الصدفة، والرقع، وMCP، والتطبيقات الأصلية الخاصة بـ Codex مملوكة من Codex. يمكن لـ OpenClaw مراقبة أحداث أصلية محددة أو حظرها عبر الترحيل المدعوم، لكنه لا يعيد كتابة وسيطات الأدوات الأصلية.
• يملك Codex Compaction الأصلي. يحتفظ OpenClaw بنسخة مرآة من النص لأجل سجل القناة، والبحث، و/new، و/reset، والتبديل المستقبلي للنموذج أو الحاضن.
• يستمر توليد الوسائط، وفهم الوسائط، وتحويل النص إلى كلام، والموافقات، ومخرجات أداة المراسلة عبر إعدادات مزود/نموذج OpenClaw المطابقة.
• ينطبق tool_result_persist على نتائج أدوات النص المملوكة من OpenClaw، وليس على سجلات نتائج أدوات Codex الأصلية.

​

استكشاف الأخطاء وإصلاحها

​

ذات صلة

• مرجع حاضن Codex
• وقت تشغيل حاضن Codex
• Plugins الأصلية في Codex
• استخدام الكمبيوتر في Codex
• أوقات تشغيل الوكيل
• مزودو النماذج
• مزود OpenAI
• Plugins حواضن الوكلاء
• خطافات Plugin
• تصدير التشخيصات
• الحالة
• الاختبار