أنظمة متعددة الوكلاء

{
  agents: {
    ownership: "explicit",
    entries: {
      main:    { workspace: "~/.openclaw/workspace" },
      support: { workspace: "~/.openclaw/workspace-support" },
    },
  },
  bindings: [
    {
      agentId: "support",
      comment: "Route the support bot account to the support agent",
      match: { channel: "discord", accountId: "support" },
    },
    {
      agentId: "main",
      match: { channel: "discord", accountId: "*" },
    },
  ],
}

{
  agents: {
    defaults: {
      maxConcurrent: 4,          // سقف الـ main lane المشترك
      subagents: {
        maxSpawnDepth: 2,        // الافتراضي 5، المدى 1-5
        maxChildrenPerAgent: 5,  // أقصى أطفال نشطين لكل session
        maxConcurrent: 8,        // أقصى runs متوازية لكل spawning session
        runTimeoutSeconds: 900,  // 0 = بلا مهلة
        announceTimeoutMs: 120000,
        delegationMode: "prefer",
      },
    },
  },
  messages: { queue: { mode: "collect", cap: 20, drop: "summarize" } },
}

# إنشاء + وصف (الوصف مهم لو الـ profile هيشتغل kanban worker)
hermes profile create researcher \
  --description "Reads source code and external docs, writes findings."

# نسخ: config فقط / كل حاجة / من profile محدد
hermes profile create work --clone
hermes profile create backup --clone-all
hermes profile create work --clone-from coder

# الاستخدام
hermes -p work chat
hermes profile use work        # sticky default
hermes profile list
hermes profile describe --all --auto
hermes -p <name> auth add <provider>

# الـ Bot == profile: كل حاجة بتعملها في الواجهة بتفضل من الـ CLI
hermes -p <name> chat      # بيفتح نفس الـ agent بالظبط
hermes profile list        # الـ roster

# الـ routines هي cron jobs حقيقية — نفس أدوات cron
hermes cron list

# 1. Single
delegate_task(goal, context)

# 2. Batch — كل الـ children متوازية في handle واحد
delegate_task(tasks=[
    {"goal": "...", "context": "..."},
    {"goal": "...", "context": "..."},
    {"goal": "...", "context": "..."},
])

# 3. Background — بيرجع handle على طول، النتيجة turn جديد
delegate_task(goal=..., context=..., background=True)

# 4. Orchestrator — طفل يقدر يspawn أولاده
delegate_task(goal=..., role="orchestrator")

# النتيجة JSON متحقّقة — ده اللي يخليك تدمج بدل parsing نص حر
delegate_task(goal=..., output_schema={...})

# إنشاء مهمة بمعاملاتها المهمة
hermes kanban create "Research: agent frameworks 2026" \
  --body "Gather facts ... output a brief with a sources table." \
  --assignee researcher --workspace scratch --priority 10 --max-runtime 30m

# dependencies: ده اللي بيخلّي الـ pipeline يعمل لوحده
hermes kanban link <research_id> <write_id>

# lifecycle
hermes kanban request-review <id>   # مستني مراجعة — مش block
hermes kanban block <id> --note "needs an API key"
hermes kanban promote <id>         # recovery: todo/blocked → ready

# تشخيص
hermes kanban dispatch --dry-run
hermes kanban diagnostics
hermes kanban stats
hermes kanban watch

# Swarm: workers متوازيين → verifier → synthesizer، بتبعيات مولّدة تلقائياً
hermes kanban swarm "قارن بين Postgres و SQLite لتطبيقنا" \
  --worker "researcher:ابحث عن مزايا Postgres" \
  --worker "researcher:ابحث عن مزايا SQLite" \
  --worker "analyst:اقرأ الكود الحالي" \
  --verifier auditor \
  --synthesizer writer

# مهمة open-ended: worker في goal loop، judge بيقيس كل رد ضد الكارت
hermes kanban create "Improve the article's opening" \
  --assignee writer --goal --goal-max-turns 5

# جودة الـ auto-routing مرهونة بجودة الأوصاف — من غيرها بيرمي child tasks عشوائي
hermes profile describe researcher --text "Reads source code and external docs, writes findings."
hermes profile describe auditor   --text "Verifies every claim against sources; rejects unsupported assertions."
hermes profile describe --all --auto

# الفرق المهم: review مش block
hermes kanban request-review <id>    # التنفيذ خلص، مستني مراجعة
hermes kanban block <id>            # محتاج تدخل بشري
hermes kanban request-changes <id>  # حكم الـ reviewer: رجّع للأنفّذ

# الـ recipe التشخيصي — 3 خطوات
hermes config get delegation.max_concurrent_children

grep -E "Truncated.*delegate_task|Too many tasks" ~/.hermes/logs/agent.log | tail

python -c "from tools.delegate_tool import _get_max_concurrent_children; print(_get_max_concurrent_children())"

# 1) تلات profiles بأوصاف — الأوصاف هي اللي بيوجّه الـ decomposer
hermes profile create researcher --description "Reads source code and external docs, writes findings with citations."
hermes profile create writer     --description "Turns a researched brief into a structured article. Does not invent facts."
hermes profile create auditor    --description "Verifies every claim against its cited source. Rejects unsupported assertions."
hermes -p researcher setup && hermes -p writer setup && hermes -p auditor setup

# 2) اكتب هوية كل واحد في SOUL.md — بيتحقن في كل جلسة
cat > ~/.hermes/profiles/auditor/SOUL.md <<'EOF'
# Auditor
## Owns
- Verifying every claim in a draft against its cited source
## Does not own
- Writing or rewriting the draft (→ writer)
## Output contract
| Claim | Verdict | Evidence |
Verdict is exactly one of: SUPPORTED / UNSUPPORTED / MISLEADING
End with PASS or FAIL. FAIL if any UNSUPPORTED claim remains.
EOF

# 3) لوحة + pipeline بالـ links — الـ promotion بيحصل لوحده
hermes kanban boards create content-pipeline --name "Content Pipeline" --switch
hermes kanban create "Research: agent frameworks" --assignee researcher --max-runtime 30m
hermes kanban create "Write: comparison"        --assignee writer     --max-runtime 20m
hermes kanban create "Audit: article"          --assignee auditor    --max-runtime 15m
hermes kanban link <research_id> <write_id> && hermes kanban link <write_id> <audit_id>

# 4) شغّل واعرف النجاح: pipeline end-to-end + auto-promotion + goal loop
hermes kanban dispatch --dry-run
hermes gateway start
hermes kanban list --status running