​

openclaw agents

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

​

أمثلة

openclaw agents list
openclaw agents list --bindings
openclaw agents add work --workspace ~/.openclaw/workspace-work
openclaw agents add ops --workspace ~/.openclaw/workspace-ops --bind telegram:ops --non-interactive
openclaw agents bindings
openclaw agents bind --agent work --bind telegram:ops
openclaw agents unbind --agent work --bind telegram:ops
openclaw agents set-identity --workspace ~/.openclaw/workspace --from-identity
openclaw agents set-identity --agent main --avatar avatars/openclaw.png
openclaw agents delete work

​

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

openclaw agents bindings
openclaw agents bindings --agent work
openclaw agents bindings --json

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

​

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

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

# initial channel-only binding
openclaw agents bind --agent work --bind telegram

# later upgrade to account-scoped binding
openclaw agents bind --agent work --bind telegram:ops

openclaw agents unbind --agent work --bind telegram:ops
openclaw agents unbind --agent work --all

​

سطح الأوامر

​

agents

​

agents list

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

​

agents add [name]

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

• تمرير أي أعلام إضافة صريحة يحوّل الأمر إلى المسار غير التفاعلي.
• يتطلب الوضع غير التفاعلي اسم وكيل و--workspace معًا.
• main محجوز ولا يمكن استخدامه كمعرّف للوكيل الجديد.

​

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، يلزم تأكيد تفاعلي.
• يتم نقل مجلدات مساحة العمل وحالة الوكيل وسجل الجلسة إلى سلة المهملات، ولا تُحذف نهائيًا.

​

ملفات الهوية

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

​

تعيين الهوية

• name
• theme
• emoji
• avatar (مسار نسبةً إلى مساحة العمل، أو URL من نوع http(s)، أو data 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.

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

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

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