عمليات الملفات الآمنة

Documentation Index

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

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

​

الافتراضي: لا يوجد مساعد Python

• يجب ألا يشغّل Gateway عملية Python جانبية مستمرة إلا إذا اختار المشغّل ذلك صراحة؛
• كثير من عمليات التثبيت لا تحتاج إلى التقوية الإضافية لتعديلات الدليل الأب؛
• إبقاء Python معطّلًا يجعل سلوك الحزمة/وقت التشغيل أكثر قابلية للتنبؤ عبر بيئات سطح المكتب، وDocker، وCI، والتطبيقات المضمّنة.

# Default OpenClaw behavior: Node-only fs-safe fallbacks.
OPENCLAW_FS_SAFE_PYTHON_MODE=off

# Opt into the helper when available, falling back if unavailable.
OPENCLAW_FS_SAFE_PYTHON_MODE=auto

# Fail closed if the helper cannot start.
OPENCLAW_FS_SAFE_PYTHON_MODE=require

# Optional explicit interpreter.
OPENCLAW_FS_SAFE_PYTHON=/usr/bin/python3

​

ما يبقى محميًا بدون Python

• رفض الإفلاتات عبر المسارات النسبية مثل ..، والمسارات المطلقة، وفواصل المسارات حيث لا يُسمح إلا بالأسماء؛
• حل العمليات عبر مقبض جذر موثوق بدلًا من فحوصات مخصصة مثل path.resolve(...).startsWith(...);
• رفض أنماط الروابط الرمزية والروابط الصلبة في واجهات API التي تتطلب هذه السياسة؛
• فتح الملفات مع فحوصات هوية عندما تُرجع واجهة API محتويات ملف أو تستهلكها؛
• كتابات ذرية عبر ملفات مؤقتة شقيقة لملفات الحالة/الإعدادات؛
• حدود البايت للقراءات واستخراج الأرشيفات؛
• أوضاع خاصة للأسرار وملفات الحالة حيث تتطلبها واجهة API.

​

ما يضيفه Python

OPENCLAW_FS_SAFE_PYTHON_MODE=require

​

إرشادات Plugin والجوهر

• يجب أن يمر وصول الملفات الموجّه إلى Plugin عبر مساعدات openclaw/plugin-sdk/*، وليس fs الخام، عندما يأتي المسار من رسالة، أو مخرجات نموذج، أو إعدادات، أو إدخال Plugin.
• يجب أن يستخدم كود الجوهر أغلفة fs-safe المحلية ضمن src/infra/* حتى تُطبّق سياسة عملية OpenClaw باتساق.
• يجب أن يستخدم استخراج الأرشيفات مساعدات أرشيف fs-safe مع حدود صريحة للحجم، وعدد الإدخالات، والروابط، والوجهة.
• يجب أن تستخدم الأسرار مساعدات أسرار OpenClaw أو مساعدات الأسرار/الحالة الخاصة في fs-safe؛ لا تنشئ فحوصات أوضاع يدوية حول fs.writeFile.
• إذا كنت تحتاج إلى عزل عن مستخدم محلي عدائي، فلا تعتمد على fs-safe وحده. شغّل Gateways منفصلة تحت مستخدمي/مضيفي نظام تشغيل منفصلين أو استخدم العزل الرملي.