مسودات التقدّم

تجعل مسودات التقدم دورات الوكيل طويلة التشغيل تبدو حية في المحادثة من دون تحويل المحادثة إلى مجموعة من ردود الحالة المؤقتة.

عند تفعيل مسودات التقدم، ينشئ OpenClaw رسالة واحدة مرئية للعمل قيد التنفيذ فقط بعد أن تثبت الدورة أنها تنجز عملا فعليا، ويحدثها بينما يقرأ الوكيل أو يخطط أو يستدعي الأدوات أو ينتظر الموافقة، ثم يحول تلك المسودة إلى الإجابة النهائية عندما تستطيع القناة فعل ذلك بأمان.

Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests

استخدم مسودات التقدم عندما تريد رسالة حالة واحدة مرتبة أثناء العمل الكثيف بالأدوات والإجابة النهائية عند انتهاء الدورة.

​

البدء السريع

فعل مسودات التقدم لكل قناة باستخدام streaming.mode: "progress":

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}

هذا يكفي عادة. سيختار OpenClaw تسمية تلقائية من كلمة واحدة، وينتظر حتى يستمر العمل خمس ثوان على الأقل أو يصدر حدث عمل ثانيا، ويضيف أسطر تقدم موجزة أثناء حدوث عمل مفيد، ويمنع رسائل التقدم المستقلة المكررة لتلك الدورة.

​

ما يراه المستخدمون

تتكون مسودة التقدم من جزأين:

الجزء	الغرض
التسمية	سطر بدء/حالة قصير مثل Thinking... أو Shelling....
أسطر التقدم	تحديثات تشغيل موجزة تستخدم أيقونات الأدوات ومنسق التفاصيل نفسيهما كما في الإخراج المطول.

تظهر التسمية بعد أن يبدأ الوكيل عملا ذا معنى، وإما أن يبقى مشغولا لمدة خمس ثوان أو يصدر حدث عمل ثانيا. وهي جزء من قائمة أسطر التقدم المتداولة، لذلك تختفي حالة البدء من العرض بعد ظهور ما يكفي من العمل الملموس. لا تعرض الردود النصية فقط مسودة تقدم. تضاف أسطر التقدم فقط عندما يصدر الوكيل تحديثات عمل مفيدة، مثل 🛠️ Bash: run tests، أو 🔎 Web Search: for "discord edit message"، أو ✍️ Write: to /tmp/file. تستخدم افتراضيا وضع الشرح الموجز نفسه مثل /verbose؛ اضبط agents.defaults.toolProgressDetail: "raw" عند التصحيح وعندما تريد أيضا إلحاق الأوامر/التفاصيل الخام. تحل الإجابة النهائية محل المسودة عندما يكون ذلك ممكنا؛ وإلا يرسل OpenClaw الإجابة النهائية بشكل عادي وينظف المسودة أو يتوقف عن تحديثها وفقا لآلية نقل القناة.

​

اختيار وضع

يتحكم channels.<channel>.streaming.mode في سلوك التقدم المرئي أثناء التنفيذ:

الوضع	الأنسب لـ	ما يظهر في المحادثة
off	القنوات الهادئة	الإجابة النهائية فقط.
partial	مشاهدة نص الإجابة وهو يظهر	مسودة واحدة تعدل بأحدث نص للإجابة.
block	مقاطع أكبر لمعاينة الإجابة	معاينة واحدة تحدث أو تلحق بمقاطع أكبر.
progress	الدورات الكثيفة بالأدوات أو طويلة التشغيل	مسودة حالة واحدة، ثم الإجابة النهائية.

اختر progress عندما يهتم المستخدمون بما يحدث أكثر من مشاهدة نص الإجابة يتدفق رمزا برمز.

اختر partial عندما تكون الإجابة نفسها هي إشارة التقدم.

اختر block عندما تريد تحديثات معاينة المسودة في مقاطع نصية أكبر. في Discord وTelegram، يظل streaming.mode: "block" بث معاينة، وليس تسليم كتل عاديا. استخدم streaming.block.enabled أو blockStreaming القديم عندما تريد ردود كتل عادية.

​

تكوين التسميات

توجد تسميات التقدم ضمن channels.<channel>.streaming.progress.

التسمية الافتراضية هي auto، وهي تختار من مجموعة التسميات المضمنة في OpenClaw المكونة من كلمة واحدة مع علامة حذف:

Thinking...
Shelling...
Scuttling...
Clawing...
Pinching...
Molting...
Bubbling...
Tiding...
Reefing...
Cracking...
Sifting...
Brining...
Nautiling...
Krilling...
Barnacling...
Lobstering...
Tidepooling...
Pearling...
Snapping...
Surfacing...

استخدم تسمية ثابتة:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}

استخدم مجموعة تسميات تلقائية خاصة بك:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}

أخف التسمية واعرض أسطر التقدم فقط:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

​

التحكم في أسطر التقدم

تكون أسطر التقدم مفعلة افتراضيا في وضع التقدم. وهي تأتي من أحداث تشغيل حقيقية: بدء الأدوات، وتحديثات العناصر، وخطط المهام، والموافقات، وإخراج الأوامر، وملخصات الرقع، ونشاطات الوكيل المشابهة.

يستخدم OpenClaw المنسق نفسه لمسودات التقدم و/verbose:

{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}

"explain" هو الإعداد الافتراضي ويبقي المسودات مستقرة بتسميات موجزة مثل 🛠️ check JS syntax for /tmp/app.js. يضيف "raw" الأمر/التفصيل الأساسي عند توفره، وهذا مفيد أثناء التصحيح لكنه أكثر ضجيجا في المحادثة.

على سبيل المثال، يظهر الأمر نفسه بشكل مختلف حسب وضع التفاصيل:

الوضع	سطر التقدم
explain	🛠️ check JS syntax for /tmp/app.js
raw	🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js

حدد عدد الأسطر التي تبقى مرئية:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}

تضغط أسطر التقدم تلقائيا لتقليل إعادة تدفق فقاعات المحادثة أثناء تحرير المسودة.

يقتطع OpenClaw أسطر التقدم الطويلة افتراضيا حتى لا تؤدي تعديلات المسودة المتكررة إلى التفاف مختلف في كل تحديث. تبقى البادئة قابلة للقراءة، وتختصر التفاصيل الطويلة مثل المسارات أو الأوامر الخام بعلامة حذف.

يمكن أن يعرض Slack أسطر التقدم كحقول Block Kit منظمة بدلا من نص واحد:

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}

يحافظ العرض الغني على الرجوع النصي العادي نفسه حتى تظل القنوات والعملاء التي لا تدعم البنية الأغنى قادرة على عرض نص التقدم الموجز.

احتفظ بمسودة التقدم الواحدة لكن أخف أسطر الأدوات والمهام:

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}

مع toolProgress: false، يظل OpenClaw يمنع رسائل تقدم الأدوات المستقلة الأقدم لتلك الدورة. تبقى القناة هادئة بصريا حتى الإجابة النهائية، باستثناء التسمية إذا كانت مكونة.

​

سلوك القنوات

تستخدم كل قناة أنظف آلية نقل تدعمها:

القناة	آلية نقل التقدم	ملاحظات
Discord	إرسال رسالة واحدة، ثم تعديلها.	يعدل النص النهائي في مكانه عندما يناسب رسالة معاينة آمنة واحدة.
Matrix	إرسال حدث واحد، ثم تعديله.	يتحكم تكوين البث على مستوى الحساب في المسودات على مستوى الحساب.
Microsoft Teams	بث Teams أصلي في المحادثات الشخصية.	يرتبط streaming.mode: "block" بتسليم كتل Teams.
Slack	بث أصلي أو منشور مسودة قابل للتعديل.	يؤثر توفر الخيط في إمكانية استخدام البث الأصلي.
Telegram	إرسال رسالة واحدة، ثم تعديلها.	قد تستبدل المسودات المرئية الأقدم حتى تبقى الطوابع الزمنية النهائية مفيدة.
Mattermost	منشور مسودة قابل للتعديل.	يدمج نشاط الأدوات في المنشور نفسه بأسلوب المسودة.

القنوات التي لا تدعم التعديل الآمن تعود عادة إلى مؤشرات الكتابة أو تسليم الإجابة النهائية فقط.

​

الإنهاء

عندما تكون الإجابة النهائية جاهزة، يحاول OpenClaw إبقاء المحادثة نظيفة:

• إذا كان بإمكان المسودة أن تصبح الإجابة النهائية بأمان، يعدلها OpenClaw في مكانها.
• إذا كانت القناة تستخدم بث تقدم أصليا، ينهي OpenClaw ذلك البث عندما تقبل آلية النقل الأصلية النص النهائي.
• إذا كانت الإجابة النهائية تحتوي على وسائط، أو مطالبة موافقة، أو هدف رد صريح، أو عددا كبيرا جدا من المقاطع، أو فشل تعديل/إرسال، يرسل OpenClaw الإجابة النهائية عبر مسار التسليم العادي للقناة.

مسار الرجوع مقصود. فمن الأفضل إرسال إجابة نهائية جديدة بدلا من فقدان النص، أو وضع رد في خيط خاطئ، أو استبدال مسودة بحمولة لا تستطيع القناة تمثيلها بأمان.

​

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

لا أرى إلا الإجابة النهائية.

تحقق من ضبط channels.<channel>.streaming.mode على progress للحساب أو القناة التي عالجت الرسالة. قد تعطل بعض مسارات المجموعات أو ردود الاقتباس معاينات المسودات لدورة عندما لا تستطيع القناة تعديل الرسالة الصحيحة بأمان.

أرى التسمية لكن لا أرى أسطر أدوات.

تحقق من streaming.progress.toolProgress. إذا كانت false، يبقي OpenClaw سلوك المسودة الواحدة لكنه يخفي أسطر تقدم الأدوات والمهام.

أرى رسالة نهائية جديدة بدلا من مسودة معدلة.

هذا رجوع للسلامة. يمكن أن يحدث لردود الوسائط، أو الإجابات الطويلة، أو أهداف الرد الصريحة، أو مسودات Telegram القديمة، أو أهداف خيط Slack المفقودة، أو رسائل المعاينة المحذوفة، أو فشل إنهاء البث الأصلي.

ما زلت أرى رسائل تقدم مستقلة.

يمنع وضع التقدم رسائل تقدم الأدوات المستقلة الافتراضية عندما تكون المسودة نشطة. إذا ظلت الرسائل المستقلة تظهر، فتحقق من أن الدورة تستخدم فعلا وضع التقدم وليس streaming.mode: "off" أو مسار قناة لا يستطيع إنشاء مسودة لتلك الرسالة.

يتصرف Teams بشكل مختلف عن Discord أو Telegram.

يستخدم Microsoft Teams بثا أصليا في المحادثات الشخصية بدلا من آلية نقل المعاينة العامة القائمة على الإرسال والتعديل. ويتعامل Teams أيضا مع streaming.mode: "block" باعتباره تسليم كتل Teams لأنه لا يملك وضع كتل معاينة المسودات نفسه المستخدم في Discord وTelegram.

​

ذات صلة

• البث والتقسيم إلى مقاطع
• الرسائل
• تكوين القنوات
• Discord
• Matrix
• Microsoft Teams
• Slack
• Telegram