OmeniaClaw agents

إدارة الوكلاء المعزولين (مساحات العمل + المصادقة + التوجيه).

ذات صلة:

• التوجيه متعدد الوكلاء
• مساحة عمل الوكيل
• تكوين Skills: تكوين إتاحة المهارات.

أمثلة

OmeniaClaw agents listOmeniaClaw agents list --bindingsOmeniaClaw agents add work --workspace ~/.OmeniaClaw/workspace-workOmeniaClaw agents add ops --workspace ~/.OmeniaClaw/workspace-ops --bind telegram:ops --non-interactiveOmeniaClaw agents bindingsOmeniaClaw agents bind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identityOmeniaClaw agents set-identity --agent main --avatar avatars/OmeniaClaw.pngOmeniaClaw agents delete work

ارتباطات التوجيه

استخدم ارتباطات التوجيه لتثبيت حركة مرور القنوات الواردة على وكيل محدد.

إذا كنت تريد أيضا Skills مرئية مختلفة لكل وكيل، فكوّن agents.defaults.skills وagents.list[].skills في OmeniaClaw.json. راجع تكوين Skills ومرجع التكوين.

عرض الارتباطات:

OmeniaClaw agents bindingsOmeniaClaw agents bindings --agent workOmeniaClaw agents bindings --json

إضافة ارتباطات:

OmeniaClaw agents bind --agent work --bind telegram:ops --bind discord:guild-a

إذا حذفت accountId (--bind <channel>)، فسيحله OmeniaClaw من إعدادات القناة الافتراضية وخطافات إعداد Plugin عند توفرها.

إذا حذفت --agent مع bind أو unbind، فسيستهدف OmeniaClaw الوكيل الافتراضي الحالي.

سلوك نطاق الارتباط

• الارتباط من دون accountId يطابق حساب القناة الافتراضي فقط.
• accountId: "*" هو خيار الرجوع على مستوى القناة (كل الحسابات)، وهو أقل تحديدا من ارتباط حساب صريح.
• إذا كان لدى الوكيل نفسه مسبقا ارتباط قناة مطابق من دون accountId، ثم ربطت لاحقا باستخدام accountId صريح أو محلول، فسيحدّث OmeniaClaw ذلك الارتباط الموجود في مكانه بدلا من إضافة نسخة مكررة.

مثال:

# initial channel-only bindingOmeniaClaw agents bind --agent work --bind telegram # later upgrade to account-scoped bindingOmeniaClaw agents bind --agent work --bind telegram:ops

بعد الترقية، يصبح توجيه ذلك الارتباط محصورا في telegram:ops. إذا كنت تريد أيضا توجيه حساب افتراضي، فأضفه صراحة (مثلا --bind telegram:default).

إزالة الارتباطات:

OmeniaClaw agents unbind --agent work --bind telegram:opsOmeniaClaw agents unbind --agent work --all

يقبل unbind إما --all أو قيمة واحدة أو أكثر من قيم --bind، وليس كليهما.

واجهة الأوامر

agents

تشغيل OmeniaClaw agents بلا أمر فرعي يعادل OmeniaClaw agents list.

agents list

الخيارات:

• --json
• --bindings: تضمين قواعد التوجيه الكاملة، وليس فقط الأعداد/الملخصات لكل وكيل

agents add [name]

الخيارات:

• --workspace <dir>
• --model <id>
• --agent-dir <dir>
• --bind <channel[:accountId]> (قابل للتكرار)
• --non-interactive
• --json

ملاحظات:

• تمرير أي أعلام إضافة صريحة ينقل الأمر إلى المسار غير التفاعلي.
• يتطلب الوضع غير التفاعلي كلا من اسم وكيل و--workspace.
• main محجوز ولا يمكن استخدامه كمعرف الوكيل الجديد.
• في الوضع التفاعلي، تنسخ تعبئة المصادقة ملفات التعريف الثابتة القابلة للنقل فقط (api_key وtoken الثابت افتراضيا). تظل ملفات تعريف رموز تحديث OAuth متاحة فقط عبر الوراثة بالقراءة من مخزن وكيل main الحقيقي. إذا لم يكن الوكيل الافتراضي المكوّن هو main، فسجّل الدخول بشكل منفصل إلى ملفات تعريف OAuth على الوكيل الجديد.

agents bindings

الخيارات:

• --agent <id>
• --json

agents bind

الخيارات:

• --agent <id> (يعود افتراضيا إلى الوكيل الافتراضي الحالي)
• --bind <channel[:accountId]> (قابل للتكرار)
• --json

agents unbind

الخيارات:

• --agent <id> (يعود افتراضيا إلى الوكيل الافتراضي الحالي)
• --bind <channel[:accountId]> (قابل للتكرار)
• --all
• --json

agents delete <id>

الخيارات:

• --force
• --json

ملاحظات:

• لا يمكن حذف main.
• من دون --force، يلزم تأكيد تفاعلي.
• تُنقل أدلة مساحة العمل وحالة الوكيل ونصوص الجلسات إلى المهملات، ولا تُحذف حذفا نهائيا.
• عندما يكون Gateway قابلا للوصول، يُرسل الحذف عبر Gateway بحيث يشترك تنظيف التكوين ومخزن الجلسات في الكاتب نفسه مثل حركة المرور وقت التشغيل. إذا تعذر الوصول إلى Gateway، يعود CLI إلى المسار المحلي غير المتصل.
• إذا كانت مساحة عمل وكيل آخر هي المسار نفسه، أو داخل مساحة العمل هذه، أو تحتوي على مساحة العمل هذه، فيتم الاحتفاظ بمساحة العمل ويبلّغ --json عن workspaceRetained، وworkspaceRetainedReason، وworkspaceSharedWith.

ملفات الهوية

يمكن أن تتضمن كل مساحة عمل وكيل ملف IDENTITY.md في جذر مساحة العمل:

• مسار مثال: ~/.OmeniaClaw/workspace/IDENTITY.md
• يقرأ set-identity --from-identity من جذر مساحة العمل (أو من --identity-file صريح)

تُحل مسارات الصور الرمزية نسبيا إلى جذر مساحة العمل.

تعيين الهوية

يكتب set-identity الحقول في agents.list[].identity:

• name
• theme
• emoji
• avatar (مسار نسبي إلى مساحة العمل، أو عنوان URL بنمط http(s)، أو URI بيانات)

الخيارات:

• --agent <id>
• --workspace <dir>
• --identity-file <path>
• --from-identity
• --name <name>
• --theme <theme>
• --emoji <emoji>
• --avatar <value>
• --json

ملاحظات:

• يمكن استخدام --agent أو --workspace لاختيار الوكيل الهدف.
• إذا اعتمدت على --workspace وكان عدة وكلاء يتشاركون مساحة العمل تلك، فسيفشل الأمر ويطلب منك تمرير --agent.
• عندما لا تُقدَّم حقول هوية صريحة، يقرأ الأمر بيانات الهوية من IDENTITY.md.

التحميل من IDENTITY.md:

OmeniaClaw agents set-identity --workspace ~/.OmeniaClaw/workspace --from-identity

تجاوز الحقول صراحة:

OmeniaClaw agents set-identity --agent main --name "OmeniaClaw" --emoji "🦞" --avatar avatars/OmeniaClaw.png

عينة تكوين:

{  agents: {    list: [      {        id: "main",        identity: {          name: "OmeniaClaw",          theme: "space lobster",          emoji: "🦞",          avatar: "avatars/OmeniaClaw.png",        },      },    ],  },}

ذات صلة

• مرجع CLI
• التوجيه متعدد الوكلاء
• مساحة عمل الوكيل