مرجع بيئة Codex للاختبار

​

سطح إعدادات الإضافة

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

​

الإشراف

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          sessionCatalog: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

نقل App-server

codex app-server --listen stdio://

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

export default {
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            sandbox: "workspace-write",
            networkProxy: {
              enabled: true,
              domains: {
                "api.openai.com": "allow",
                "blocked.example.com": "deny",
              },
              allowUpstreamProxy: true,
              proxyUrl: "http://127.0.0.1:3128",
            },
          },
        },
      },
    },
  },
};

​

أوضاع الموافقة ووضع الحماية

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

​

التنفيذ الأصلي ضمن وضع الحماية

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            experimental: {
              sandboxExecServer: true,
            },
          },
        },
      },
    },
  },
}

​

عزل المصادقة والبيئة

1. ملف تعريف مصادقة OpenClaw Codex صريح للوكيل.
2. حساب خادم التطبيق الحالي في دليل Codex الرئيسي لذلك الوكيل.
3. لعمليات تشغيل خادم التطبيق المحلية عبر stdio فقط، CODEX_API_KEY، ثم OPENAI_API_KEY، عندما لا يوجد حساب لخادم التطبيق وتظل مصادقة OpenAI مطلوبة.

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

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

​

الأدوات الديناميكية

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan
• tool_call
• tool_describe
• tool_search
• tool_search_code

​

المُهَل الزمنية

• وسيطة timeoutMs موجبة لكل استدعاء.
• بالنسبة إلى image_generate، ‏agents.defaults.imageGenerationModel.timeoutMs.
• بالنسبة إلى image_generate من دون مهلة مضبوطة، القيمة الافتراضية لتوليد الصور وهي 120 ثانية.
• بالنسبة إلى أداة فهم الوسائط image، تُحوَّل tools.media.image.timeoutSeconds إلى ميلي ثانية، أو تُستخدم القيمة الافتراضية للوسائط وهي 60 ثانية. وبالنسبة إلى فهم الصور، ينطبق ذلك على الطلب نفسه ولا يُخفَّض بسبب أعمال التحضير السابقة.
• بالنسبة إلى أداة message، قيمة افتراضية ثابتة قدرها 120 ثانية.
• القيمة الافتراضية للأداة الديناميكية وهي 90 ثانية.

​

اكتشاف النماذج

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

ملفات تمهيد مساحة العمل

• يُمرَّر TOOLS.md باعتباره تعليمات مطوّر موروثة في Codex، بحيث يراه أيضًا الوكلاء الفرعيون الأصليون في Codex الذين يُنشؤون أثناء الدور.
• تُمرَّر SOUL.md وIDENTITY.md وUSER.md باعتبارها تعليمات تعاون محدودة بنطاق الدور. لا يرثها الوكلاء الفرعيون الأصليون في Codex، ما يمنع أدوار الوكلاء الفرعيين من التقاط شخصية الوكيل الأصل وملف المستخدم الشخصي.
• تُمرَّر أيضًا قائمة Skills المحمّلة والموجزة في OpenClaw باعتبارها تعليمات مطوّر للتعاون محدودة بنطاق الدور، ولذلك لا يرثها الوكلاء الفرعيون الأصليون في Codex أيضًا.
• لا يُحقن محتوى HEARTBEAT.md؛ بل تحصل أدوار Heartbeat على مؤشر في وضع التعاون لقراءة الملف عندما يكون موجودًا وغير فارغ.
• لا يُلصق محتوى MEMORY.md من مساحة عمل الوكيل المضبوطة في إدخال الدور الأصلي في Codex عندما تكون أدوات الذاكرة متاحة لمساحة العمل تلك؛ وعندما يكون موجودًا، يضيف إطار التشغيل مؤشرًا صغيرًا لذاكرة مساحة العمل إلى تعليمات مطوّر التعاون محدودة نطاق الدور، وينبغي لـ Codex استخدام memory_search أو memory_get عندما تكون الذاكرة الدائمة ذات صلة. وإذا كانت الأدوات معطلة، أو كان البحث في الذاكرة غير متاح، أو اختلفت مساحة العمل النشطة عن مساحة عمل ذاكرة الوكيل، يستخدم MEMORY.md مسار سياق الدور المحدود المعتاد بدلًا من ذلك.
• يُمرَّر BOOTSTRAP.md، عند وجوده، باعتباره سياقًا مرجعيًا لإدخال دور OpenClaw.

​

تجاوزات البيئة

• 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

​

ذو صلة

• إطار تشغيل Codex
• وقت تشغيل إطار Codex
• الإشراف على Codex
• Plugins الأصلية في Codex
• استخدام الحاسوب عبر Codex
• مزوّد OpenAI
• مرجع الإعداد