الانتقال إلى المحتوى الرئيسي

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.

تجعل مسودات التقدم أدوار الوكيل طويلة التشغيل تبدو حية في الدردشة دون تحويل المحادثة إلى رزمة من ردود الحالة المؤقتة. عند تمكين مسودات التقدم، ينشئ OpenClaw رسالة عمل قيد التنفيذ مرئية واحدة، ويحدّثها أثناء قراءة الوكيل أو تخطيطه أو استدعائه للأدوات أو انتظاره للموافقة، ثم يحوّل تلك المسودة إلى الإجابة النهائية عندما تستطيع القناة فعل ذلك بأمان. 
Shelling
- reading recent channel context
- checking matching issues
- preparing reply
استخدم مسودات التقدم عندما تريد رسالة حالة مرتبة واحدة أثناء العمل كثيف الأدوات والإجابة النهائية عند اكتمال الدور.

​
البدء السريع

فعّل مسودات التقدم لكل قناة باستخدام streaming.mode: "progress": 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}
يكون ذلك كافيًا عادة. سيختار OpenClaw تسمية تلقائية من كلمة واحدة، ويضيف سطور تقدم موجزة أثناء حدوث عمل مفيد، ويمنع ثرثرة التقدم المستقلة المكررة لذلك الدور.

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

تتكون مسودة التقدم من جزأين:
الجزءالغرض
التسميةعنوان قصير مثل Thinking أو Shelling.
سطور التقدمتحديثات تشغيل موجزة مثل استدعاءات الأدوات أو خطوات المهام أو الموافقات.
تظهر التسمية فورًا عندما يبدأ الوكيل بالرد. لا تُضاف سطور التقدم إلا عندما يرسل الوكيل تحديثات عمل مفيدة. تستبدل الإجابة النهائية المسودة عندما يكون ذلك ممكنًا؛ وإلا يرسل 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,
        },
      },
    },
  },
}

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

تكون سطور التقدم مفعلة افتراضيًا في وضع التقدم. وهي تأتي من أحداث تشغيل حقيقية: بدء الأدوات، وتحديثات العناصر، وخطط المهام، والموافقات، ومخرجات الأوامر، وملخصات التصحيحات، ونشاط الوكيل المشابه. حدّد عدد السطور التي تبقى مرئية: 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}
احتفظ بمسودة التقدم الواحدة لكن أخفِ سطور الأدوات والمهام: 
{
  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.

​
ذات صلة