# اعرض الخطافات المتاحة
openclaw hooks list

# فعّل خطافًا
openclaw hooks enable session-memory

# تحقّق من حالة الخطاف
openclaw hooks check

# احصل على معلومات مفصلة
openclaw hooks info session-memory

my-hook/
├── HOOK.md          # البيانات الوصفية + التوثيق
└── handler.ts       # تنفيذ المعالج

---
name: my-hook
description: "وصف قصير لما يفعله هذا الخطاف"
metadata:
  { "openclaw": { "emoji": "🔗", "events": ["command:new"], "requires": { "bins": ["node"] } } }
---

# خطافي

يوضع التوثيق المفصل هنا.

const handler = async (event) => {
  if (event.type !== "command" || event.action !== "new") {
    return;
  }

  console.log(`[my-hook] New command triggered`);
  // منطقك هنا

  // اختياريًا أرسل رسالة إلى المستخدم
  event.messages.push("تم تنفيذ الخطاف!");
};

export default handler;

openclaw plugins install <path-or-spec>

openclaw hooks enable <hook-name>

{
  "hooks": {
    "internal": {
      "entries": {
        "bootstrap-extra-files": {
          "enabled": true,
          "paths": ["packages/*/AGENTS.md", "packages/*/TOOLS.md"]
        }
      }
    }
  }
}

{
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-memory": { "enabled": true },
        "command-logger": { "enabled": false }
      }
    }
  }
}

{
  "hooks": {
    "internal": {
      "entries": {
        "my-hook": {
          "enabled": true,
          "env": { "MY_CUSTOM_VAR": "value" }
        }
      }
    }
  }
}

{
  "hooks": {
    "internal": {
      "load": {
        "extraDirs": ["/path/to/more/hooks"]
      }
    }
  }
}

# اعرض كل الخطافات (أضف --eligible أو --verbose أو --json)
openclaw hooks list

# اعرض معلومات مفصلة عن خطاف
openclaw hooks info <hook-name>

# اعرض ملخص الأهلية
openclaw hooks check

# تفعيل/تعطيل
openclaw hooks enable <hook-name>
openclaw hooks disable <hook-name>

# تحقّق من بنية الدليل
ls -la ~/.openclaw/hooks/my-hook/
# يجب أن يعرض: HOOK.md, handler.ts

# اعرض كل الخطافات المكتشفة
openclaw hooks list

openclaw hooks info my-hook