# Table of Contents - [OpenClaw - OpenClaw](#openclaw-openclaw) - [دلالات بيانات اعتماد المصادقة - OpenClaw](#-openclaw) - [المهام المجدولة - OpenClaw](#-openclaw) - [الأتمتة والمهام - OpenClaw](#-openclaw) - [الخطافات - OpenClaw](#-openclaw) - [توجيه القنوات - OpenClaw](#-openclaw) - [Google Chat - OpenClaw](#google-chat-openclaw) - [Task Flow - OpenClaw](#task-flow-openclaw) - [المهام في الخلفية - OpenClaw](#-openclaw) - [الأوامر الدائمة - OpenClaw](#-openclaw) - [مجموعات البث - OpenClaw](#-openclaw) - [BlueBubbles - OpenClaw](#bluebubbles-openclaw) - [Feishu - OpenClaw](#feishu-openclaw) --- # OpenClaw - OpenClaw [Skip to main content](https://docs.openclaw.ai/#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/) ![US](https://d3gk2c5xim1je2.cloudfront.net/flags/US.svg) English Search... ⌘K Search... Navigation Overview OpenClaw [Get started](https://docs.openclaw.ai/) [Install](https://docs.openclaw.ai/install) [Channels](https://docs.openclaw.ai/channels) [Agents](https://docs.openclaw.ai/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/tools) [Models](https://docs.openclaw.ai/providers) [Platforms](https://docs.openclaw.ai/platforms) [Gateway & Ops](https://docs.openclaw.ai/gateway) [Reference](https://docs.openclaw.ai/cli) [Help](https://docs.openclaw.ai/help) On this page * [OpenClaw 🦞](https://docs.openclaw.ai/#openclaw-) * [What is OpenClaw?](https://docs.openclaw.ai/#what-is-openclaw) * [How it works](https://docs.openclaw.ai/#how-it-works) * [Key capabilities](https://docs.openclaw.ai/#key-capabilities) * [Quick start](https://docs.openclaw.ai/#quick-start) * [Dashboard](https://docs.openclaw.ai/#dashboard) * [Configuration (optional)](https://docs.openclaw.ai/#configuration-optional) * [Start here](https://docs.openclaw.ai/#start-here) * [Learn more](https://docs.openclaw.ai/#learn-more) [​](https://docs.openclaw.ai/#openclaw-) OpenClaw 🦞 ======================================================= ![OpenClaw](https://mintcdn.com/clawdhub/-t5HSeZ3Y_0_wH4i/assets/openclaw-logo-text-dark.png?w=2500&fit=max&auto=format&n=-t5HSeZ3Y_0_wH4i&q=85&s=e7b1ad00141bc8497bee7df9e46ccebd)![OpenClaw](https://mintcdn.com/clawdhub/FaXdIfo7gPK_jSWb/assets/openclaw-logo-text.png?w=2500&fit=max&auto=format&n=FaXdIfo7gPK_jSWb&q=85&s=23160e4a3cd4676702869ea051fd3f6e) > _“EXFOLIATE! EXFOLIATE!”_ — A space lobster, probably **Any OS gateway for AI agents across Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.** Send a message, get an agent response from your pocket. Run one Gateway across built-in channels, bundled channel plugins, WebChat, and mobile nodes. Get Started ----------- Install OpenClaw and bring up the Gateway in minutes. Run Onboarding -------------- Guided setup with `openclaw onboard` and pairing flows. Open the Control UI ------------------- Launch the browser dashboard for chat, config, and sessions. [​](https://docs.openclaw.ai/#what-is-openclaw) What is OpenClaw? -------------------------------------------------------------------- OpenClaw is a **self-hosted gateway** that connects your favorite chat apps and channel surfaces — built-in channels plus bundled or external channel plugins such as Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more — to AI coding agents like Pi. You run a single Gateway process on your own machine (or a server), and it becomes the bridge between your messaging apps and an always-available AI assistant. **Who is it for?** Developers and power users who want a personal AI assistant they can message from anywhere — without giving up control of their data or relying on a hosted service. **What makes it different?** * **Self-hosted**: runs on your hardware, your rules * **Multi-channel**: one Gateway serves built-in channels plus bundled or external channel plugins simultaneously * **Agent-native**: built for coding agents with tool use, sessions, memory, and multi-agent routing * **Open source**: MIT licensed, community-driven **What do you need?** Node 24 (recommended), or Node 22 LTS (`22.14+`) for compatibility, an API key from your chosen provider, and 5 minutes. For best quality and security, use the strongest latest-generation model available. [​](https://docs.openclaw.ai/#how-it-works) How it works ----------------------------------------------------------- The Gateway is the single source of truth for sessions, routing, and channel connections. [​](https://docs.openclaw.ai/#key-capabilities) Key capabilities ------------------------------------------------------------------- Multi-channel gateway --------------------- Discord, iMessage, Signal, Slack, Telegram, WhatsApp, WebChat, and more with a single Gateway process. Plugin channels --------------- Bundled plugins add Matrix, Nostr, Twitch, Zalo, and more in normal current releases. Multi-agent routing ------------------- Isolated sessions per agent, workspace, or sender. Media support ------------- Send and receive images, audio, and documents. Web Control UI -------------- Browser dashboard for chat, config, sessions, and nodes. Mobile nodes ------------ Pair iOS and Android nodes for Canvas, camera, and voice-enabled workflows. [​](https://docs.openclaw.ai/#quick-start) Quick start --------------------------------------------------------- 1 [](https://docs.openclaw.ai/#) Install OpenClaw npm install -g openclaw@latest 2 [](https://docs.openclaw.ai/#) Onboard and install the service openclaw onboard --install-daemon 3 [](https://docs.openclaw.ai/#) Chat Open the Control UI in your browser and send a message: openclaw dashboard Or connect a channel ([Telegram](https://docs.openclaw.ai/channels/telegram) is fastest) and chat from your phone. Need the full install and dev setup? See [Getting Started](https://docs.openclaw.ai/start/getting-started) . [​](https://docs.openclaw.ai/#dashboard) Dashboard ----------------------------------------------------- Open the browser Control UI after the Gateway starts. * Local default: [http://127.0.0.1:18789/](http://127.0.0.1:18789/) * Remote access: [Web surfaces](https://docs.openclaw.ai/web) and [Tailscale](https://docs.openclaw.ai/gateway/tailscale) ![OpenClaw](https://mintcdn.com/clawdhub/FaXdIfo7gPK_jSWb/whatsapp-openclaw.jpg?w=2500&fit=max&auto=format&n=FaXdIfo7gPK_jSWb&q=85&s=7050f3dda374e9a1adedf3cd08357338) [​](https://docs.openclaw.ai/#configuration-optional) Configuration (optional) --------------------------------------------------------------------------------- Config lives at `~/.openclaw/openclaw.json`. * If you **do nothing**, OpenClaw uses the bundled Pi binary in RPC mode with per-sender sessions. * If you want to lock it down, start with `channels.whatsapp.allowFrom` and (for groups) mention rules. Example: { channels: { whatsapp: { allowFrom: ["+15555550123"], groups: { "*": { requireMention: true } }, }, }, messages: { groupChat: { mentionPatterns: ["@openclaw"] } }, } [​](https://docs.openclaw.ai/#start-here) Start here ------------------------------------------------------- Docs hubs --------- All docs and guides, organized by use case. Configuration ------------- Core Gateway settings, tokens, and provider config. Remote access ------------- SSH and tailnet access patterns. Channels -------- Channel-specific setup for Feishu, Microsoft Teams, WhatsApp, Telegram, Discord, and more. Nodes ----- iOS and Android nodes with pairing, Canvas, camera, and device actions. Help ---- Common fixes and troubleshooting entry point. [​](https://docs.openclaw.ai/#learn-more) Learn more ------------------------------------------------------- Full feature list ----------------- Complete channel, routing, and media capabilities. Multi-agent routing ------------------- Workspace isolation and per-agent sessions. Security -------- Tokens, allowlists, and safety controls. Troubleshooting --------------- Gateway diagnostics and common errors. About and credits ----------------- Project origins, contributors, and license. [Showcase](https://docs.openclaw.ai/start/showcase) ⌘I --- # دلالات بيانات اعتماد المصادقة - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/auth-credential-semantics#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Configuration and operations دلالات بيانات اعتماد المصادقة [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [دلالات بيانات اعتماد المصادقة](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AF%D9%84%D8%A7%D9%84%D8%A7%D8%AA-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) * [رموز أسباب الفحص المستقرة](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%B1%D9%85%D9%88%D8%B2-%D8%A3%D8%B3%D8%A8%D8%A7%D8%A8-%D8%A7%D9%84%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%82%D8%B1%D8%A9) * [بيانات اعتماد الرمز المميز](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF-%D8%A7%D9%84%D8%B1%D9%85%D8%B2-%D8%A7%D9%84%D9%85%D9%85%D9%8A%D8%B2) * [قواعد الأهلية](https://docs.openclaw.ai/ar/auth-credential-semantics#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A3%D9%87%D9%84%D9%8A%D8%A9) * [قواعد الحل](https://docs.openclaw.ai/ar/auth-credential-semantics#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%AD%D9%84) * [التصفية الصريحة لترتيب المصادقة](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A7%D9%84%D8%AA%D8%B5%D9%81%D9%8A%D8%A9-%D8%A7%D9%84%D8%B5%D8%B1%D9%8A%D8%AD%D8%A9-%D9%84%D8%AA%D8%B1%D8%AA%D9%8A%D8%A8-%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) * [حل أهداف الفحص](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AD%D9%84-%D8%A3%D9%87%D8%AF%D8%A7%D9%81-%D8%A7%D9%84%D9%81%D8%AD%D8%B5) * [حاجز سياسة SecretRef لـ OAuth](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AD%D8%A7%D8%AC%D8%B2-%D8%B3%D9%8A%D8%A7%D8%B3%D8%A9-secretref-%D9%84%D9%80-oauth) * [الرسائل المتوافقة مع الإصدارات القديمة](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%AA%D9%88%D8%A7%D9%81%D9%82%D8%A9-%D9%85%D8%B9-%D8%A7%D9%84%D8%A5%D8%B5%D8%AF%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%82%D8%AF%D9%8A%D9%85%D8%A9) [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AF%D9%84%D8%A7%D9%84%D8%A7%D8%AA-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) دلالات بيانات اعتماد المصادقة =========================================================================================================================================================================================================================================================== يعرّف هذا المستند دلالات الأهلية والحل القانونية لبيانات الاعتماد المستخدمة عبر: * `resolveAuthProfileOrder` * `resolveApiKeyForProfile` * `models status --probe` * `doctor-auth` الهدف هو إبقاء سلوك وقت الاختيار ووقت التشغيل متوافقًا. [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%B1%D9%85%D9%88%D8%B2-%D8%A3%D8%B3%D8%A8%D8%A7%D8%A8-%D8%A7%D9%84%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%82%D8%B1%D8%A9) رموز أسباب الفحص المستقرة ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * `ok` * `excluded_by_auth_order` * `missing_credential` * `invalid_expires` * `expired` * `unresolved_ref` * `no_model` [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF-%D8%A7%D9%84%D8%B1%D9%85%D8%B2-%D8%A7%D9%84%D9%85%D9%85%D9%8A%D8%B2) بيانات اعتماد الرمز المميز -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- تدعم بيانات اعتماد الرمز المميز (`type: "token"`) قيمة `token` المضمنة و/أو `tokenRef`. ### [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A3%D9%87%D9%84%D9%8A%D8%A9) قواعد الأهلية 1. يكون ملف تعريف الرمز المميز غير مؤهل عندما يكون كل من `token` و`tokenRef` غير موجودين. 2. `expires` اختياري. 3. إذا كانت `expires` موجودة، فيجب أن تكون رقمًا منتهيًا أكبر من `0`. 4. إذا كانت `expires` غير صالحة (`NaN` أو `0` أو سالبة أو غير منتهية أو من نوع خاطئ)، يكون ملف التعريف غير مؤهل مع `invalid_expires`. 5. إذا كانت `expires` في الماضي، يكون ملف التعريف غير مؤهل مع `expired`. 6. لا يتجاوز `tokenRef` التحقق من `expires`. ### [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%AD%D9%84) قواعد الحل 1. تتطابق دلالات أداة الحل مع دلالات الأهلية بالنسبة إلى `expires`. 2. بالنسبة إلى ملفات التعريف المؤهلة، يمكن حل مادة الرمز المميز من القيمة المضمنة أو `tokenRef`. 3. تؤدي المراجع غير القابلة للحل إلى `unresolved_ref` في مخرجات `models status --probe`. [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A7%D9%84%D8%AA%D8%B5%D9%81%D9%8A%D8%A9-%D8%A7%D9%84%D8%B5%D8%B1%D9%8A%D8%AD%D8%A9-%D9%84%D8%AA%D8%B1%D8%AA%D9%8A%D8%A8-%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) التصفية الصريحة لترتيب المصادقة ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * عندما يتم تعيين `auth.order.` أو تجاوز ترتيب مخزن المصادقة لموفّر ما، فإن `models status --probe` يفحص فقط معرّفات ملفات التعريف التي تبقى في ترتيب المصادقة المحلول لذلك الموفّر. * لا تتم محاولة ملف تعريف مخزن لذلك الموفّر تم حذفه من الترتيب الصريح لاحقًا بشكل صامت. وتبلّغ مخرجات الفحص عنه باستخدام `reasonCode: excluded_by_auth_order` والتفصيل `Excluded by auth.order for this provider.` [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AD%D9%84-%D8%A3%D9%87%D8%AF%D8%A7%D9%81-%D8%A7%D9%84%D9%81%D8%AD%D8%B5) حل أهداف الفحص ------------------------------------------------------------------------------------------------------------------------------------------------------- * يمكن أن تأتي أهداف الفحص من ملفات تعريف المصادقة أو بيانات اعتماد البيئة أو `models.json`. * إذا كان لدى موفّر بيانات اعتماد ولكن OpenClaw لا يمكنه حل مرشح نموذج قابل للفحص له، فإن `models status --probe` يبلّغ عن `status: no_model` مع `reasonCode: no_model`. [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%AD%D8%A7%D8%AC%D8%B2-%D8%B3%D9%8A%D8%A7%D8%B3%D8%A9-secretref-%D9%84%D9%80-oauth) حاجز سياسة SecretRef لـ OAuth -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * إدخال SecretRef مخصص لبيانات الاعتماد الثابتة فقط. * إذا كانت بيانات اعتماد ملف التعريف من النوع `type: "oauth"`، فلا يتم دعم كائنات SecretRef لمادة بيانات اعتماد ملف التعريف تلك. * إذا كان `auth.profiles..mode` يساوي `"oauth"`، فيتم رفض إدخال `keyRef`/`tokenRef` المدعوم بـ SecretRef لذلك الملف التعريفي. * الانتهاكات هي حالات فشل صارمة في مسارات حل المصادقة عند بدء التشغيل/إعادة التحميل. [​](https://docs.openclaw.ai/ar/auth-credential-semantics#%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%AA%D9%88%D8%A7%D9%81%D9%82%D8%A9-%D9%85%D8%B9-%D8%A7%D9%84%D8%A5%D8%B5%D8%AF%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%82%D8%AF%D9%8A%D9%85%D8%A9) الرسائل المتوافقة مع الإصدارات القديمة --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- للتوافق مع البرامج النصية، تحتفظ أخطاء الفحص بهذا السطر الأول دون تغيير: `Auth profile credentials are missing or expired.` يمكن إضافة تفاصيل سهلة الفهم ورموز أسباب مستقرة في الأسطر اللاحقة. [المصادقة](https://docs.openclaw.ai/ar/gateway/authentication) [إدارة الأسرار](https://docs.openclaw.ai/ar/gateway/secrets) ⌘I --- # المهام المجدولة - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation/cron-jobs#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks المهام المجدولة [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [المهام المجدولة (Cron)](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AC%D8%AF%D9%88%D9%84%D8%A9-cron) * [بدء سريع](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A8%D8%AF%D8%A1-%D8%B3%D8%B1%D9%8A%D8%B9) * [كيف يعمل cron](https://docs.openclaw.ai/ar/automation/cron-jobs#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-cron) * [أنواع الجداول](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%AC%D8%AF%D8%A7%D9%88%D9%84) * [أنماط التنفيذ](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%86%D9%85%D8%A7%D8%B7-%D8%A7%D9%84%D8%AA%D9%86%D9%81%D9%8A%D8%B0) * [خيارات الحمولة للمهام المعزولة](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AE%D9%8A%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D8%AD%D9%85%D9%88%D9%84%D8%A9-%D9%84%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84%D8%A9) * [التسليم والمخرجات](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85-%D9%88%D8%A7%D9%84%D9%85%D8%AE%D8%B1%D8%AC%D8%A7%D8%AA) * [أمثلة CLI](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%85%D8%AB%D9%84%D8%A9-cli) * [Webhooks](https://docs.openclaw.ai/ar/automation/cron-jobs#webhooks) * [المصادقة](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) * [POST /hooks/wake](https://docs.openclaw.ai/ar/automation/cron-jobs#post-%2Fhooks%2Fwake) * [POST /hooks/agent](https://docs.openclaw.ai/ar/automation/cron-jobs#post-%2Fhooks%2Fagent) * [Hooks المعينة (POST /hooks/)](https://docs.openclaw.ai/ar/automation/cron-jobs#hooks-%D8%A7%D9%84%D9%85%D8%B9%D9%8A%D9%86%D8%A9-post-%2Fhooks%2F%3Cname%3E) * [الأمان](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%A3%D9%85%D8%A7%D9%86) * [تكامل Gmail PubSub](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D9%83%D8%A7%D9%85%D9%84-gmail-pubsub) * [إعداد المعالج (موصى به)](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC-%D9%85%D9%88%D8%B5%D9%89-%D8%A8%D9%87) * [التشغيل التلقائي لـ Gateway](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D8%AA%D9%84%D9%82%D8%A7%D8%A6%D9%8A-%D9%84%D9%80-gateway) * [إعداد يدوي لمرة واحدة](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D9%8A%D8%AF%D9%88%D9%8A-%D9%84%D9%85%D8%B1%D8%A9-%D9%88%D8%A7%D8%AD%D8%AF%D8%A9) * [تجاوز نموذج Gmail](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D8%AC%D8%A7%D9%88%D8%B2-%D9%86%D9%85%D9%88%D8%B0%D8%AC-gmail) * [إدارة المهام](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [الإعدادات](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF%D8%A7%D8%AA) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [تسلسل الأوامر](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D8%B3%D9%84%D8%B3%D9%84-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1) * [Cron لا يعمل](https://docs.openclaw.ai/ar/automation/cron-jobs#cron-%D9%84%D8%A7-%D9%8A%D8%B9%D9%85%D9%84) * [تم تشغيل Cron لكن لم يحدث تسليم](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D9%85-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-cron-%D9%84%D9%83%D9%86-%D9%84%D9%85-%D9%8A%D8%AD%D8%AF%D8%AB-%D8%AA%D8%B3%D9%84%D9%8A%D9%85) * [ملاحظات مهمة حول المنطقة الزمنية](https://docs.openclaw.ai/ar/automation/cron-jobs#%D9%85%D9%84%D8%A7%D8%AD%D8%B8%D8%A7%D8%AA-%D9%85%D9%87%D9%85%D8%A9-%D8%AD%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%86%D8%B7%D9%82%D8%A9-%D8%A7%D9%84%D8%B2%D9%85%D9%86%D9%8A%D8%A9) * [ذو صلة](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AC%D8%AF%D9%88%D9%84%D8%A9-cron) المهام المجدولة (Cron) ========================================================================================================================================================================== Cron هو المجدول المدمج في Gateway. فهو يحتفظ بالمهام، ويوقظ الوكيل في الوقت المناسب، ويمكنه إعادة تسليم المخرجات إلى قناة دردشة أو نقطة نهاية webhook. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A8%D8%AF%D8%A1-%D8%B3%D8%B1%D9%8A%D8%B9) بدء سريع ------------------------------------------------------------------------------------------------------------- # Add a one-shot reminder openclaw cron add \ --name "Reminder" \ --at "2026-02-01T16:00:00Z" \ --session main \ --system-event "Reminder: check the cron docs draft" \ --wake now \ --delete-after-run # Check your jobs openclaw cron list # See run history openclaw cron runs --id [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-cron) كيف يعمل cron ----------------------------------------------------------------------------------------------------------------------- * يعمل Cron **داخل** عملية Gateway (وليس داخل النموذج). * تُحفَظ المهام في `~/.openclaw/cron/jobs.json` بحيث لا تؤدي عمليات إعادة التشغيل إلى فقدان الجداول. * تنشئ جميع عمليات تنفيذ cron سجلات [المهام الخلفية](https://docs.openclaw.ai/automation/tasks) . * تُحذف المهام ذات التشغيل الواحد (`--at`) تلقائيًا بعد النجاح افتراضيًا. * تحاول عمليات cron المعزولة، بأفضل جهد ممكن، إغلاق علامات تبويب/عمليات المتصفح المتتبعة الخاصة بجلسة `cron:` عند اكتمال التشغيل، حتى لا تترك أتمتة المتصفح المفصولة عمليات يتيمة وراءها. * تحمي عمليات cron المعزولة أيضًا من ردود الإقرار القديمة. إذا كانت النتيجة الأولى مجرد تحديث حالة مؤقت (`on it` و`pulling everything together` وتلميحات مشابهة) ولم يعد أي تشغيل تابع منحدر لا يزال مسؤولًا عن الإجابة النهائية، فإن OpenClaw يعيد المطالبة مرة واحدة للحصول على النتيجة الفعلية قبل التسليم. تسوية المهام لـ cron مملوكة لوقت التشغيل: تبقى مهمة cron النشطة قيد التشغيل ما دام وقت تشغيل cron لا يزال يتتبع تلك المهمة على أنها قيد التشغيل، حتى إذا كان صف جلسة فرعي قديم لا يزال موجودًا. وبمجرد أن يتوقف وقت التشغيل عن امتلاك المهمة وتنتهي مهلة السماح البالغة 5 دقائق، يمكن للصيانة وضع علامة `lost` على المهمة. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%AC%D8%AF%D8%A7%D9%88%D9%84) أنواع الجداول ------------------------------------------------------------------------------------------------------------------------------------------------ | النوع | علم CLI | الوصف | | --- | --- | --- | | `at` | `--at` | طابع زمني لتشغيل واحد (ISO 8601 أو قيمة نسبية مثل `20m`) | | `every` | `--every` | فاصل زمني ثابت | | `cron` | `--cron` | تعبير cron من 5 أو 6 حقول مع `--tz` اختياري | تُعامل الطوابع الزمنية التي لا تحتوي على منطقة زمنية على أنها UTC. أضف `--tz America/New_York` للجدولة حسب التوقيت المحلي الفعلي. تُوزَّع تعبيرات التكرار أعلى كل ساعة تلقائيًا بفارق يصل إلى 5 دقائق لتقليل ارتفاعات الحمل. استخدم `--exact` لفرض توقيت دقيق أو `--stagger 30s` لنافذة صريحة. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%86%D9%85%D8%A7%D8%B7-%D8%A7%D9%84%D8%AA%D9%86%D9%81%D9%8A%D8%B0) أنماط التنفيذ ------------------------------------------------------------------------------------------------------------------------------------------------ | النمط | قيمة `--session` | يعمل في | الأنسب لـ | | --- | --- | --- | --- | | الجلسة الرئيسية | `main` | دورة heartbeat التالية | التذكيرات، وأحداث النظام | | معزول | `isolated` | `cron:` مخصصة | التقارير، والمهام الخلفية | | الجلسة الحالية | `current` | يُربط وقت الإنشاء | الأعمال الدورية المعتمدة على السياق | | جلسة مخصصة | `session:custom-id` | جلسة مسماة دائمة | سير العمل الذي يعتمد على السجل | تضيف مهام **الجلسة الرئيسية** حدث نظام إلى قائمة الانتظار، ويمكنها اختياريًا إيقاظ heartbeat (`--wake now` أو `--wake next-heartbeat`). تعمل المهام **المعزولة** بدورة وكيل مخصصة مع جلسة جديدة. تحتفظ **الجلسات المخصصة** (`session:xxx`) بالسياق عبر مرات التشغيل، مما يتيح سير عمل مثل الاجتماعات اليومية المختصرة التي تعتمد على الملخصات السابقة. بالنسبة للمهام المعزولة، يتضمن التفكيك في وقت التشغيل الآن تنظيف المتصفح، بأفضل جهد، لتلك الجلسة الخاصة بـ cron. ويتم تجاهل إخفاقات التنظيف بحيث تبقى نتيجة cron الفعلية هي المعتمدة. عندما تقوم عمليات cron المعزولة بتنسيق وكلاء فرعيين، يفضّل التسليم أيضًا المخرجات النهائية التابعة بدلًا من النص المؤقت القديم للأصل. وإذا كانت العمليات التابعة لا تزال قيد التشغيل، فإن OpenClaw يحجب هذا التحديث الجزئي من الأصل بدلًا من إعلانه. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AE%D9%8A%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D8%AD%D9%85%D9%88%D9%84%D8%A9-%D9%84%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84%D8%A9) خيارات الحمولة للمهام المعزولة * `--message`: نص المطالبة (مطلوب للمهام المعزولة) * `--model` / `--thinking`: تجاوزات النموذج ومستوى التفكير * `--light-context`: تخطي حقن ملف تهيئة مساحة العمل * `--tools exec,read`: تقييد الأدوات التي يمكن للمهمة استخدامها يستخدم `--model` النموذج المسموح المحدد لتلك المهمة. إذا كان النموذج المطلوب غير مسموح به، يسجل cron تحذيرًا ويعود إلى اختيار نموذج الوكيل/الافتراضي لتلك المهمة بدلًا من ذلك. وتظل سلاسل التراجع المهيأة مطبقة، لكن تجاوز النموذج العادي من دون قائمة تراجع صريحة لكل مهمة لم يعد يضيف النموذج الأساسي للوكيل كهدف إعادة محاولة إضافي مخفي. أولوية اختيار النموذج للمهام المعزولة هي: 1. تجاوز نموذج hook الخاص بـ Gmail (عندما يكون التشغيل قادمًا من Gmail ويكون هذا التجاوز مسموحًا) 2. `model` في حمولة كل مهمة 3. تجاوز النموذج المخزن لجلسة cron 4. اختيار نموذج الوكيل/الافتراضي يتبع الوضع السريع اختيار التشغيل المباشر الذي تم حله أيضًا. إذا كان إعداد النموذج المحدد يحتوي على `params.fastMode`، فإن cron المعزول يستخدم ذلك افتراضيًا. ويظل تجاوز `fastMode` المخزن للجلسة متقدمًا على الإعداد في كلا الاتجاهين. إذا واجه تشغيل معزول تسليمًا مباشرًا لتبديل النموذج، يعيد cron المحاولة باستخدام المزوّد/النموذج المُبدَّل ويحفظ هذا الاختيار المباشر قبل إعادة المحاولة. وعندما يحمل التبديل أيضًا ملف تعريف مصادقة جديدًا، فإن cron يحفظ تجاوز ملف تعريف المصادقة هذا أيضًا. إعادات المحاولة محدودة: بعد المحاولة الأولية بالإضافة إلى محاولتي تبديل، يُجهِض cron بدلًا من الدخول في حلقة لا نهائية. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85-%D9%88%D8%A7%D9%84%D9%85%D8%AE%D8%B1%D8%AC%D8%A7%D8%AA) التسليم والمخرجات ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | الوضع | ما الذي يحدث | | --- | --- | | `announce` | تسليم الملخص إلى القناة المستهدفة (الافتراضي للمهام المعزولة) | | `webhook` | إرسال حمولة حدث الاكتمال إلى URL عبر POST | | `none` | داخلي فقط، بلا تسليم | استخدم `--announce --channel telegram --to "-1001234567890"` للتسليم إلى قناة. بالنسبة لموضوعات منتدى Telegram، استخدم `-1001234567890:topic:123`. يجب أن تستخدم أهداف Slack/Discord/Mattermost بادئات صريحة (`channel:` و`user:`). بالنسبة للمهام المعزولة المملوكة لـ cron، يمتلك المشغّل مسار التسليم النهائي. تتم مطالبة الوكيل بإرجاع ملخص نصي عادي، ثم يُرسل هذا الملخص عبر `announce` أو `webhook` أو يُحتفظ به داخليًا عند `none`. لا يعيد `--no-deliver` التسليم إلى الوكيل؛ بل يُبقي التشغيل داخليًا. إذا كانت المهمة الأصلية تنص صراحةً على إرسال رسالة إلى مستلم خارجي ما، فيجب على الوكيل أن يذكر في مخرجاته إلى من/أين ينبغي أن تذهب تلك الرسالة بدلًا من محاولة إرسالها مباشرةً. تتبع إشعارات الفشل مسار وجهة منفصلًا: * يعيّن `cron.failureDestination` القيمة الافتراضية العامة لإشعارات الفشل. * يتجاوز `job.delivery.failureDestination` ذلك لكل مهمة. * إذا لم يُضبط أي منهما وكانت المهمة تسلّم بالفعل عبر `announce`، فإن إشعارات الفشل تعود الآن إلى هدف announce الأساسي هذا. * لا يكون `delivery.failureDestination` مدعومًا إلا في المهام ذات `sessionTarget="isolated"` ما لم يكن وضع التسليم الأساسي هو `webhook`. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A3%D9%85%D8%AB%D9%84%D8%A9-cli) أمثلة CLI ----------------------------------------------------------------------------------------------------- تذكير بتشغيل واحد (الجلسة الرئيسية): openclaw cron add \ --name "Calendar check" \ --at "20m" \ --session main \ --system-event "Next heartbeat: check calendar." \ --wake now مهمة معزولة متكررة مع تسليم: openclaw cron add \ --name "Morning brief" \ --cron "0 7 * * *" \ --tz "America/Los_Angeles" \ --session isolated \ --message "Summarize overnight updates." \ --announce \ --channel slack \ --to "channel:C1234567890" مهمة معزولة مع تجاوز للنموذج والتفكير: openclaw cron add \ --name "Deep analysis" \ --cron "0 6 * * 1" \ --tz "America/Los_Angeles" \ --session isolated \ --message "Weekly deep analysis of project progress." \ --model "opus" \ --thinking high \ --announce [​](https://docs.openclaw.ai/ar/automation/cron-jobs#webhooks) Webhooks -------------------------------------------------------------------------- يمكن لـ Gateway كشف نقاط نهاية HTTP webhook للمشغلات الخارجية. فعّل ذلك في الإعدادات: { hooks: { enabled: true, token: "shared-secret", path: "/hooks", }, } ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D9%85%D8%B5%D8%A7%D8%AF%D9%82%D8%A9) المصادقة يجب أن يتضمن كل طلب رمز hook عبر ترويسة: * `Authorization: Bearer ` (موصى به) * `x-openclaw-token: ` يتم رفض الرموز في سلسلة الاستعلام. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#post-/hooks/wake) POST /hooks/wake أضف حدث نظام إلى قائمة انتظار الجلسة الرئيسية: curl -X POST http://127.0.0.1:18789/hooks/wake \ -H 'Authorization: Bearer SECRET' \ -H 'Content-Type: application/json' \ -d '{"text":"New email received","mode":"now"}' * `text` (مطلوب): وصف الحدث * `mode` (اختياري): `now` (الافتراضي) أو `next-heartbeat` ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#post-/hooks/agent) POST /hooks/agent شغّل دورة وكيل معزولة: curl -X POST http://127.0.0.1:18789/hooks/agent \ -H 'Authorization: Bearer SECRET' \ -H 'Content-Type: application/json' \ -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4-mini"}' الحقول: `message` (مطلوب)، `name`، `agentId`، `wakeMode`، `deliver`، `channel`، `to`، `model`، `thinking`، `timeoutSeconds`. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#hooks-%D8%A7%D9%84%D9%85%D8%B9%D9%8A%D9%86%D8%A9-post-/hooks/%3Cname%3E) Hooks المعينة (POST /hooks/) تُحل أسماء hooks المخصصة عبر `hooks.mappings` في الإعدادات. ويمكن للتعيينات تحويل الحمولات العشوائية إلى إجراءات `wake` أو `agent` باستخدام قوالب أو تحويلات برمجية. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%A3%D9%85%D8%A7%D9%86) الأمان * أبقِ نقاط نهاية hook خلف local loopback أو tailnet أو reverse proxy موثوق. * استخدم رمز hook مخصصًا؛ لا تعِد استخدام رموز مصادقة gateway. * أبقِ `hooks.path` على مسار فرعي مخصص؛ يتم رفض `/`. * اضبط `hooks.allowedAgentIds` لتقييد التوجيه الصريح لـ `agentId`. * أبقِ `hooks.allowRequestSessionKey=false` ما لم تكن تحتاج إلى جلسات يحددها المتصل. * إذا فعّلت `hooks.allowRequestSessionKey`، فاضبط أيضًا `hooks.allowedSessionKeyPrefixes` لتقييد أشكال مفاتيح الجلسات المسموح بها. * تُغلَّف حمولات hook بحدود أمان افتراضيًا. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D9%83%D8%A7%D9%85%D9%84-gmail-pubsub) تكامل Gmail PubSub ----------------------------------------------------------------------------------------------------------------------- اربط مشغلات صندوق وارد Gmail بـ OpenClaw عبر Google PubSub. **المتطلبات المسبقة**: CLI `gcloud`، و`gog` (`gogcli`)، وhooks مفعلة في OpenClaw، وTailscale لنقطة النهاية العامة عبر HTTPS. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC-%D9%85%D9%88%D8%B5%D9%89-%D8%A8%D9%87) إعداد المعالج (موصى به) openclaw webhooks gmail setup --account openclaw@gmail.com يكتب هذا إعداد `hooks.gmail`، ويفعّل الإعداد المسبق لـ Gmail، ويستخدم Tailscale Funnel لنقطة نهاية الدفع. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D8%AA%D9%84%D9%82%D8%A7%D8%A6%D9%8A-%D9%84%D9%80-gateway) التشغيل التلقائي لـ Gateway عندما يكون `hooks.enabled=true` و`hooks.gmail.account` مضبوطًا، يبدأ Gateway تشغيل `gog gmail watch serve` عند الإقلاع ويجدد المراقبة تلقائيًا. اضبط `OPENCLAW_SKIP_GMAIL_WATCHER=1` لإلغاء الاشتراك. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D9%8A%D8%AF%D9%88%D9%8A-%D9%84%D9%85%D8%B1%D8%A9-%D9%88%D8%A7%D8%AD%D8%AF%D8%A9) إعداد يدوي لمرة واحدة 1. حدّد مشروع GCP الذي يملك عميل OAuth المستخدم بواسطة `gog`: gcloud auth login gcloud config set project gcloud services enable gmail.googleapis.com pubsub.googleapis.com 2. أنشئ topic وامنح Gmail صلاحية دفع النشر: gcloud pubsub topics create gog-gmail-watch gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \ --member=serviceAccount:gmail-api-push@system.gserviceaccount.com \ --role=roles/pubsub.publisher 3. ابدأ المراقبة: gog gmail watch start \ --account openclaw@gmail.com \ --label INBOX \ --topic projects//topics/gog-gmail-watch ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D8%AC%D8%A7%D9%88%D8%B2-%D9%86%D9%85%D9%88%D8%B0%D8%AC-gmail) تجاوز نموذج Gmail { hooks: { gmail: { model: "openrouter/meta-llama/llama-3.3-70b-instruct:free", thinking: "off", }, }, } [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) إدارة المهام ----------------------------------------------------------------------------------------------------------------------------------------- # List all jobs openclaw cron list # Edit a job openclaw cron edit --message "Updated prompt" --model "opus" # Force run a job now openclaw cron run # Run only if due openclaw cron run --due # View run history openclaw cron runs --id --limit 50 # Delete a job openclaw cron remove # Agent selection (multi-agent setups) openclaw cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops openclaw cron edit --clear-agent ملاحظة حول تجاوز النموذج: * يغيّر `openclaw cron add|edit --model ...` النموذج المحدد للمهمة. * إذا كان النموذج مسموحًا، يصل هذا المزوّد/النموذج المحدد نفسه إلى تشغيل الوكيل المعزول. * إذا لم يكن مسموحًا، يحذّر cron ويعود إلى اختيار نموذج الوكيل/الافتراضي للمهمة. * تظل سلاسل التراجع المهيأة مطبقة، لكن تجاوز `--model` العادي من دون قائمة تراجع صريحة لكل مهمة لم يعد ينتقل إلى النموذج الأساسي للوكيل باعتباره هدف إعادة محاولة إضافيًا صامتًا. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF%D8%A7%D8%AA) الإعدادات ------------------------------------------------------------------------------------------------------------------------- { cron: { enabled: true, store: "~/.openclaw/cron/jobs.json", maxConcurrentRuns: 1, retry: { maxAttempts: 3, backoffMs: [60000, 120000, 300000], retryOn: ["rate_limit", "overloaded", "network", "server_error"], }, webhookToken: "replace-with-dedicated-webhook-token", sessionRetention: "24h", runLog: { maxBytes: "2mb", keepLines: 2000 }, }, } تعطيل cron: `cron.enabled: false` أو `OPENCLAW_SKIP_CRON=1`. **إعادة محاولة التشغيل الواحد**: تتم إعادة المحاولة للأخطاء المؤقتة (حد المعدل، والتحميل الزائد، والشبكة، وخطأ الخادم) حتى 3 مرات مع تراجع أُسّي. أما الأخطاء الدائمة فتؤدي إلى التعطيل فورًا. **إعادة محاولة المهام المتكررة**: تراجع أُسّي (من 30 ثانية إلى 60 دقيقة) بين المحاولات. ويُعاد ضبط التراجع بعد التشغيل الناجح التالي. **الصيانة**: يقوم `cron.sessionRetention` (الافتراضي `24h`) بتقليم إدخالات جلسات التشغيل المعزولة. كما يقوم `cron.runLog.maxBytes` / `cron.runLog.keepLines` بتقليم ملفات سجل التشغيل تلقائيًا. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D8%B3%D9%84%D8%B3%D9%84-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1) تسلسل الأوامر openclaw status openclaw gateway status openclaw cron status openclaw cron list openclaw cron runs --id --limit 20 openclaw system heartbeat last openclaw logs --follow openclaw doctor ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#cron-%D9%84%D8%A7-%D9%8A%D8%B9%D9%85%D9%84) Cron لا يعمل * تحقّق من `cron.enabled` ومتغير البيئة `OPENCLAW_SKIP_CRON`. * أكّد أن Gateway يعمل بشكل مستمر. * بالنسبة لجداول `cron`، تحقّق من المنطقة الزمنية (`--tz`) مقارنة بالمنطقة الزمنية للمضيف. * تعني `reason: not-due` في مخرجات التشغيل أنه تم التحقق من التشغيل اليدوي باستخدام `openclaw cron run --due` وأن المهمة لم يحن موعدها بعد. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%AA%D9%85-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-cron-%D9%84%D9%83%D9%86-%D9%84%D9%85-%D9%8A%D8%AD%D8%AF%D8%AB-%D8%AA%D8%B3%D9%84%D9%8A%D9%85) تم تشغيل Cron لكن لم يحدث تسليم * يعني وضع التسليم `none` أنه لا يُتوقع إرسال أي رسالة خارجية. * يعني غياب/عدم صحة هدف التسليم (`channel`/`to`) أنه تم تخطي الإرسال الخارجي. * تعني أخطاء مصادقة القناة (`unauthorized` و`Forbidden`) أن التسليم تم حجبه بواسطة بيانات الاعتماد. * إذا أعاد التشغيل المعزول فقط الرمز الصامت (`NO_REPLY` / `no_reply`)، فإن OpenClaw يحجب التسليم الخارجي المباشر ويحجب أيضًا مسار الملخص الاحتياطي الموضوع في قائمة الانتظار، لذلك لا يُنشر أي شيء إلى الدردشة. * بالنسبة للمهام المعزولة المملوكة لـ cron، لا تتوقع من الوكيل استخدام أداة الرسائل كحل احتياطي. فالمشغّل يملك التسليم النهائي؛ ويبقي `--no-deliver` التشغيل داخليًا بدلًا من السماح بإرسال مباشر. ### [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D9%85%D9%84%D8%A7%D8%AD%D8%B8%D8%A7%D8%AA-%D9%85%D9%87%D9%85%D8%A9-%D8%AD%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%86%D8%B7%D9%82%D8%A9-%D8%A7%D9%84%D8%B2%D9%85%D9%86%D9%8A%D8%A9) ملاحظات مهمة حول المنطقة الزمنية * يستخدم Cron بدون `--tz` المنطقة الزمنية لمضيف gateway. * تُعامل جداول `at` التي لا تحتوي على منطقة زمنية على أنها UTC. * يستخدم `activeHours` في heartbeat تحليل المنطقة الزمنية المهيأ. [​](https://docs.openclaw.ai/ar/automation/cron-jobs#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ----------------------------------------------------------------------------------------------- * [الأتمتة والمهام](https://docs.openclaw.ai/automation) — لمحة سريعة عن جميع آليات الأتمتة * [المهام الخلفية](https://docs.openclaw.ai/automation/tasks) — سجل المهام لتنفيذات cron * [Heartbeat](https://docs.openclaw.ai/gateway/heartbeat) — دورات الجلسة الرئيسية الدورية * [المنطقة الزمنية](https://docs.openclaw.ai/concepts/timezone) — إعداد المنطقة الزمنية [الأتمتة والمهام](https://docs.openclaw.ai/ar/automation) [المهام في الخلفية](https://docs.openclaw.ai/ar/automation/tasks) ⌘I --- # الأتمتة والمهام - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks الأتمتة والمهام [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [الأتمتة والمهام](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D8%A3%D8%AA%D9%85%D8%AA%D8%A9-%D9%88%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [دليل اتخاذ القرار السريع](https://docs.openclaw.ai/ar/automation#%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D8%AA%D8%AE%D8%A7%D8%B0-%D8%A7%D9%84%D9%82%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) * [Scheduled Tasks (Cron) مقابل Heartbeat](https://docs.openclaw.ai/ar/automation#scheduled-tasks-cron-%D9%85%D9%82%D8%A7%D8%A8%D9%84-heartbeat) * [المفاهيم الأساسية](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%81%D8%A7%D9%87%D9%8A%D9%85-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9) * [المهام المجدولة (cron)](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AC%D8%AF%D9%88%D9%84%D8%A9-cron) * [المهام](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [Task Flow](https://docs.openclaw.ai/ar/automation#task-flow) * [الأوامر الدائمة](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) * [Hooks](https://docs.openclaw.ai/ar/automation#hooks) * [Heartbeat](https://docs.openclaw.ai/ar/automation#heartbeat) * [كيف تعمل معًا](https://docs.openclaw.ai/ar/automation#%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D9%85%D8%B9%D9%8B%D8%A7) * [ذو صلة](https://docs.openclaw.ai/ar/automation#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D8%A3%D8%AA%D9%85%D8%AA%D8%A9-%D9%88%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) الأتمتة والمهام ==================================================================================================================================================== يشغّل OpenClaw العمل في الخلفية من خلال المهام، والوظائف المجدولة، وhooks الأحداث، والتعليمات الدائمة. تساعدك هذه الصفحة على اختيار الآلية المناسبة وفهم كيفية ترابطها. [​](https://docs.openclaw.ai/ar/automation#%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D8%AA%D8%AE%D8%A7%D8%B0-%D8%A7%D9%84%D9%82%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) دليل اتخاذ القرار السريع --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | حالة الاستخدام | الخيار الموصى به | السبب | | --- | --- | --- | | إرسال تقرير يومي في تمام الساعة 9 صباحًا | Scheduled Tasks (Cron) | توقيت دقيق، وتنفيذ معزول | | ذكّرني بعد 20 دقيقة | Scheduled Tasks (Cron) | تشغيل لمرة واحدة مع توقيت دقيق (`--at`) | | تشغيل تحليل عميق أسبوعي | Scheduled Tasks (Cron) | مهمة مستقلة، ويمكنها استخدام نموذج مختلف | | فحص البريد الوارد كل 30 دقيقة | Heartbeat | يجمّع مع فحوصات أخرى، ومدرك للسياق | | مراقبة التقويم للأحداث القادمة | Heartbeat | ملائم بطبيعته للوعي الدوري | | فحص حالة وكيل فرعي أو تشغيل ACP | Background Tasks | يسجّل دفتر المهام كل العمل المنفصل | | تدقيق ما الذي تم تشغيله ومتى | Background Tasks | `openclaw tasks list` و`openclaw tasks audit` | | بحث متعدد الخطوات ثم تلخيص | Task Flow | تنسيق دائم مع تتبع المراجعات | | تشغيل برنامج نصي عند إعادة تعيين الجلسة | Hooks | يعتمد على الأحداث، ويعمل عند أحداث دورة الحياة | | تنفيذ تعليمات برمجية عند كل استدعاء أداة | Hooks | يمكن لـ Hooks التصفية حسب نوع الحدث | | التحقق دائمًا من الامتثال قبل الرد | Standing Orders | تُحقن تلقائيًا في كل جلسة | ### [​](https://docs.openclaw.ai/ar/automation#scheduled-tasks-cron-%D9%85%D9%82%D8%A7%D8%A8%D9%84-heartbeat) Scheduled Tasks (Cron) مقابل Heartbeat | البعد | Scheduled Tasks (Cron) | Heartbeat | | --- | --- | --- | | التوقيت | دقيق (تعبيرات cron، تشغيل لمرة واحدة) | تقريبي (افتراضيًا كل 30 دقيقة) | | سياق الجلسة | جديد (معزول) أو مشترك | سياق الجلسة الرئيسية الكامل | | سجلات المهام | يتم إنشاؤها دائمًا | لا يتم إنشاؤها أبدًا | | التسليم | قناة، أو webhook، أو بصمت | مضمّن داخل الجلسة الرئيسية | | الأنسب لـ | التقارير، والتذكيرات، والوظائف الخلفية | فحوصات البريد الوارد، والتقويم، والإشعارات | استخدم Scheduled Tasks (Cron) عندما تحتاج إلى توقيت دقيق أو تنفيذ معزول. واستخدم Heartbeat عندما يستفيد العمل من سياق الجلسة الكامل ويكون التوقيت التقريبي كافيًا. [​](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%81%D8%A7%D9%87%D9%8A%D9%85-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9) المفاهيم الأساسية ------------------------------------------------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%AC%D8%AF%D9%88%D9%84%D8%A9-cron) المهام المجدولة (cron) يمثل Cron المجدول المدمج في Gateway للتوقيت الدقيق. فهو يحتفظ بالوظائف، ويوقظ الوكيل في الوقت المناسب، ويمكنه تسليم المخرجات إلى قناة دردشة أو نقطة نهاية webhook. ويدعم التذكيرات التي تعمل لمرة واحدة، والتعبيرات المتكررة، ومشغلات webhook الواردة. راجع [Scheduled Tasks](https://docs.openclaw.ai/automation/cron-jobs) . ### [​](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) المهام يتتبع دفتر المهام الخلفية جميع الأعمال المنفصلة: عمليات تشغيل ACP، وتشغيل الوكلاء الفرعيين، وتنفيذات cron المعزولة، وعمليات CLI. المهام هي سجلات وليست مجدولات. استخدم `openclaw tasks list` و`openclaw tasks audit` لفحصها. راجع [Background Tasks](https://docs.openclaw.ai/automation/tasks) . ### [​](https://docs.openclaw.ai/ar/automation#task-flow) Task Flow يمثل Task Flow طبقة تنسيق التدفقات فوق المهام الخلفية. وهو يدير التدفقات الدائمة متعددة الخطوات مع أوضاع المزامنة المُدارة والمنعكسة، وتتبع المراجعات، و`openclaw tasks flow list|show|cancel` للفحص. راجع [Task Flow](https://docs.openclaw.ai/automation/taskflow) . ### [​](https://docs.openclaw.ai/ar/automation#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) الأوامر الدائمة تمنح الأوامر الدائمة الوكيل صلاحية تشغيل دائمة للبرامج المحددة. وهي توجد في ملفات مساحة العمل (عادةً `AGENTS.md`) وتُحقن في كل جلسة. ويمكن دمجها مع cron لفرض التنفيذ المعتمد على الوقت. راجع [Standing Orders](https://docs.openclaw.ai/automation/standing-orders) . ### [​](https://docs.openclaw.ai/ar/automation#hooks) Hooks تمثل Hooks برامج نصية تعتمد على الأحداث ويتم تشغيلها بواسطة أحداث دورة حياة الوكيل (`/new` و`/reset` و`/stop`) وضغط الجلسة، وبدء تشغيل البوابة، وتدفق الرسائل، واستدعاءات الأدوات. يتم اكتشاف Hooks تلقائيًا من الأدلة ويمكن إدارتها باستخدام `openclaw hooks`. راجع [Hooks](https://docs.openclaw.ai/automation/hooks) . ### [​](https://docs.openclaw.ai/ar/automation#heartbeat) Heartbeat يمثل Heartbeat دورًا دوريًا للجلسة الرئيسية (افتراضيًا كل 30 دقيقة). وهو يجمّع عدة فحوصات (البريد الوارد، والتقويم، والإشعارات) في دور وكيل واحد مع سياق الجلسة الكامل. ولا تنشئ أدوار Heartbeat سجلات مهام. استخدم `HEARTBEAT.md` لقائمة تحقق صغيرة، أو كتلة `tasks:` عندما تريد فحوصات دورية مستحقة فقط داخل heartbeat نفسه. تتخطى ملفات heartbeat الفارغة كـ `empty-heartbeat-file`، ويتخطى وضع المهام المستحقة فقط كـ `no-tasks-due`. راجع [Heartbeat](https://docs.openclaw.ai/gateway/heartbeat) . [​](https://docs.openclaw.ai/ar/automation#%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84-%D9%85%D8%B9%D9%8B%D8%A7) كيف تعمل معًا --------------------------------------------------------------------------------------------------------------------------------- * **Cron** يتعامل مع الجداول الدقيقة (التقارير اليومية، والمراجعات الأسبوعية) والتذكيرات التي تعمل لمرة واحدة. جميع تنفيذات cron تنشئ سجلات مهام. * **Heartbeat** يتعامل مع المراقبة الروتينية (البريد الوارد، والتقويم، والإشعارات) في دور مجمّع واحد كل 30 دقيقة. * **Hooks** تتفاعل مع أحداث محددة (استدعاءات الأدوات، وإعادة تعيين الجلسة، والضغط) عبر برامج نصية مخصصة. * **الأوامر الدائمة** تمنح الوكيل سياقًا مستمرًا وحدودًا للصلاحيات. * **Task Flow** ينسق التدفقات متعددة الخطوات فوق المهام الفردية. * **المهام** تتتبع تلقائيًا كل الأعمال المنفصلة حتى تتمكن من فحصها وتدقيقها. [​](https://docs.openclaw.ai/ar/automation#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ------------------------------------------------------------------------------------- * [Scheduled Tasks](https://docs.openclaw.ai/automation/cron-jobs) — الجدولة الدقيقة والتذكيرات التي تعمل لمرة واحدة * [Background Tasks](https://docs.openclaw.ai/automation/tasks) — دفتر المهام لجميع الأعمال المنفصلة * [Task Flow](https://docs.openclaw.ai/automation/taskflow) — تنسيق التدفقات الدائمة متعددة الخطوات * [Hooks](https://docs.openclaw.ai/automation/hooks) — برامج نصية لدورة الحياة تعتمد على الأحداث * [Standing Orders](https://docs.openclaw.ai/automation/standing-orders) — تعليمات الوكيل الدائمة * [Heartbeat](https://docs.openclaw.ai/gateway/heartbeat) — أدوار دورية للجلسة الرئيسية * [Configuration Reference](https://docs.openclaw.ai/gateway/configuration-reference) — جميع مفاتيح الإعداد [OpenProse](https://docs.openclaw.ai/ar/prose) [المهام المجدولة](https://docs.openclaw.ai/ar/automation/cron-jobs) ⌘I --- # الخطافات - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation/hooks#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks الخطافات [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [الخطافات](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) * [البدء السريع](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) * [أنواع الأحداث](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB) * [كتابة الخطافات](https://docs.openclaw.ai/ar/automation/hooks#%D9%83%D8%AA%D8%A7%D8%A8%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) * [بنية الخطاف](https://docs.openclaw.ai/ar/automation/hooks#%D8%A8%D9%86%D9%8A%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81) * [تنسيق HOOK.md](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%86%D8%B3%D9%8A%D9%82-hook-md) * [تنفيذ المعالج](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%86%D9%81%D9%8A%D8%B0-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC) * [أبرز عناصر سياق الحدث](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D8%A8%D8%B1%D8%B2-%D8%B9%D9%86%D8%A7%D8%B5%D8%B1-%D8%B3%D9%8A%D8%A7%D9%82-%D8%A7%D9%84%D8%AD%D8%AF%D8%AB) * [اكتشاف الخطافات](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) * [حزم الخطافات](https://docs.openclaw.ai/ar/automation/hooks#%D8%AD%D8%B2%D9%85-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) * [الخطافات المضمّنة](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86%D8%A9) * [تفاصيل session-memory](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%81%D8%A7%D8%B5%D9%8A%D9%84-session-memory) * [إعداد bootstrap-extra-files](https://docs.openclaw.ai/ar/automation/hooks#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-bootstrap-extra-files) * [خطافات plugins](https://docs.openclaw.ai/ar/automation/hooks#%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA-plugins) * [التكوين](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) * [مرجع CLI](https://docs.openclaw.ai/ar/automation/hooks#%D9%85%D8%B1%D8%AC%D8%B9-cli) * [أفضل الممارسات](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [لم يتم اكتشاف الخطاف](https://docs.openclaw.ai/ar/automation/hooks#%D9%84%D9%85-%D9%8A%D8%AA%D9%85-%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81) * [الخطاف غير مؤهل](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81-%D8%BA%D9%8A%D8%B1-%D9%85%D8%A4%D9%87%D9%84) * [الخطاف لا يتم تنفيذه](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81-%D9%84%D8%A7-%D9%8A%D8%AA%D9%85-%D8%AA%D9%86%D9%81%D9%8A%D8%B0%D9%87) * [ذو صلة](https://docs.openclaw.ai/ar/automation/hooks#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) الخطافات ============================================================================================================== الخطافات هي نصوص برمجية صغيرة تعمل عندما يحدث شيء ما داخل Gateway. يتم اكتشافها تلقائيًا من الأدلة ويمكن فحصها باستخدام `openclaw hooks`. هناك نوعان من الخطافات في OpenClaw: * **الخطافات الداخلية** (هذه الصفحة): تعمل داخل Gateway عند حدوث أحداث الوكيل، مثل `/new` أو `/reset` أو `/stop` أو أحداث دورة الحياة. * **Webhooks**: نقاط نهاية HTTP خارجية تتيح للأنظمة الأخرى تشغيل العمل في OpenClaw. راجع [Webhooks](https://docs.openclaw.ai/automation/cron-jobs#webhooks) . يمكن أيضًا تضمين الخطافات داخل plugins. يعرض `openclaw hooks list` كلًا من الخطافات المستقلة والخطافات التي تديرها plugins. [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) البدء السريع ------------------------------------------------------------------------------------------------------------------------------------- # List available hooks openclaw hooks list # Enable a hook openclaw hooks enable session-memory # Check hook status openclaw hooks check # Get detailed information openclaw hooks info session-memory [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB) أنواع الأحداث -------------------------------------------------------------------------------------------------------------------------------------------- | الحدث | وقت تشغيله | | --- | --- | | `command:new` | عند إصدار الأمر `/new` | | `command:reset` | عند إصدار الأمر `/reset` | | `command:stop` | عند إصدار الأمر `/stop` | | `command` | أي حدث أمر (مستمع عام) | | `session:compact:before` | قبل أن يلخص الضغط السجل | | `session:compact:after` | بعد اكتمال الضغط | | `session:patch` | عند تعديل خصائص الجلسة | | `agent:bootstrap` | قبل إدخال ملفات التمهيد الخاصة بمساحة العمل | | `gateway:startup` | بعد بدء القنوات وتحميل الخطافات | | `message:received` | رسالة واردة من أي قناة | | `message:transcribed` | بعد اكتمال نسخ الصوت | | `message:preprocessed` | بعد اكتمال فهم جميع الوسائط والروابط | | `message:sent` | تم تسليم الرسالة الصادرة | [​](https://docs.openclaw.ai/ar/automation/hooks#%D9%83%D8%AA%D8%A7%D8%A8%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) كتابة الخطافات --------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A8%D9%86%D9%8A%D8%A9-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81) بنية الخطاف كل خطاف عبارة عن دليل يحتوي على ملفين: my-hook/ ├── HOOK.md # Metadata + documentation └── handler.ts # Handler implementation ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%86%D8%B3%D9%8A%D9%82-hook-md) تنسيق HOOK.md --- name: my-hook description: "Short description of what this hook does" metadata: { "openclaw": { "emoji": "🔗", "events": ["command:new"], "requires": { "bins": ["node"] } } } --- # My Hook Detailed documentation goes here. **حقول Metadata** (`metadata.openclaw`): | الحقل | الوصف | | --- | --- | | `emoji` | رمز تعبيري للعرض في CLI | | `events` | مصفوفة بالأحداث المطلوب الاستماع إليها | | `export` | التصدير المسمى المطلوب استخدامه (الافتراضي `"default"`) | | `os` | المنصات المطلوبة (مثل `["darwin", "linux"]`) | | `requires` | مسارات `bins` أو `anyBins` أو `env` أو `config` المطلوبة | | `always` | تجاوز فحوصات الأهلية (قيمة منطقية) | | `install` | طرق التثبيت | ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%86%D9%81%D9%8A%D8%B0-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC) تنفيذ المعالج const handler = async (event) => { if (event.type !== "command" || event.action !== "new") { return; } console.log(`[my-hook] New command triggered`); // Your logic here // Optionally send message to user event.messages.push("Hook executed!"); }; export default handler; يتضمن كل حدث: `type` و`action` و`sessionKey` و`timestamp` و`messages` (استخدم push لإرسالها إلى المستخدم) و`context` (بيانات خاصة بالحدث). ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D8%A8%D8%B1%D8%B2-%D8%B9%D9%86%D8%A7%D8%B5%D8%B1-%D8%B3%D9%8A%D8%A7%D9%82-%D8%A7%D9%84%D8%AD%D8%AF%D8%AB) أبرز عناصر سياق الحدث **أحداث الأوامر** (`command:new`, `command:reset`): ‏`context.sessionEntry` و`context.previousSessionEntry` و`context.commandSource` و`context.workspaceDir` و`context.cfg`. **أحداث الرسائل** (`message:received`): ‏`context.from` و`context.content` و`context.channelId` و`context.metadata` (بيانات خاصة بالمزوّد تتضمن `senderId` و`senderName` و`guildId`). **أحداث الرسائل** (`message:sent`): ‏`context.to` و`context.content` و`context.success` و`context.channelId`. **أحداث الرسائل** (`message:transcribed`): ‏`context.transcript` و`context.from` و`context.channelId` و`context.mediaPath`. **أحداث الرسائل** (`message:preprocessed`): ‏`context.bodyForAgent` (النص النهائي المُثْرى) و`context.from` و`context.channelId`. **أحداث التمهيد** (`agent:bootstrap`): ‏`context.bootstrapFiles` (مصفوفة قابلة للتعديل) و`context.agentId`. **أحداث تصحيح الجلسة** (`session:patch`): ‏`context.sessionEntry` و`context.patch` (الحقول المتغيرة فقط) و`context.cfg`. يمكن فقط للعملاء ذوي الامتيازات تشغيل أحداث التصحيح. **أحداث الضغط**: يتضمن `session:compact:before` القيمتين `messageCount` و`tokenCount`. ويضيف `session:compact:after` القيم `compactedCount` و`summaryLength` و`tokensBefore` و`tokensAfter`. [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) اكتشاف الخطافات ---------------------------------------------------------------------------------------------------------------------------------------------------------- يتم اكتشاف الخطافات من هذه الأدلة، بترتيب تصاعدي لأولوية التجاوز: 1. **الخطافات المضمّنة**: تأتي مع OpenClaw 2. **خطافات plugins**: خطافات مضمّنة داخل plugins المثبتة 3. **الخطافات المُدارة**: ‏`~/.openclaw/hooks/` (مثبتة من المستخدم، ومشتركة بين مساحات العمل). تشترك الأدلة الإضافية من `hooks.internal.load.extraDirs` في هذه الأولوية. 4. **خطافات مساحة العمل**: ‏`/hooks/` (لكل وكيل، ومعطّلة افتراضيًا حتى يتم تفعيلها صراحة) يمكن لخطافات مساحة العمل إضافة أسماء خطافات جديدة، لكنها لا يمكنها تجاوز الخطافات المضمّنة أو المُدارة أو المقدمة من plugin بالاسم نفسه. ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%AD%D8%B2%D9%85-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA) حزم الخطافات حزم الخطافات هي حزم npm تصدّر الخطافات عبر `openclaw.hooks` في `package.json`. ثبّتها باستخدام: openclaw plugins install تكون مواصفات npm من السجل فقط (اسم الحزمة مع إصدار دقيق اختياري أو dist-tag). يتم رفض مواصفات Git/URL/file ونطاقات semver. [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86%D8%A9) الخطافات المضمّنة ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | الخطاف | الأحداث | ما الذي يفعله | | --- | --- | --- | | session-memory | `command:new`, `command:reset` | يحفظ سياق الجلسة في `/memory/` | | bootstrap-extra-files | `agent:bootstrap` | يدرج ملفات تمهيد إضافية من أنماط glob | | command-logger | `command` | يسجل جميع الأوامر في `~/.openclaw/logs/commands.log` | | boot-md | `gateway:startup` | يشغّل `BOOT.md` عند بدء gateway | لتفعيل أي خطاف مضمّن: openclaw hooks enable ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%AA%D9%81%D8%A7%D8%B5%D9%8A%D9%84-session-memory) تفاصيل session-memory يستخرج آخر 15 رسالة مستخدم/مساعد، وينشئ slug وصفيًا لاسم الملف عبر LLM، ويحفظه في `/memory/YYYY-MM-DD-slug.md`. يتطلب تكوين `workspace.dir`. ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-bootstrap-extra-files) إعداد bootstrap-extra-files { "hooks": { "internal": { "entries": { "bootstrap-extra-files": { "enabled": true, "paths": ["packages/*/AGENTS.md", "packages/*/TOOLS.md"] } } } } } تُحلّ المسارات نسبةً إلى مساحة العمل. يتم تحميل أسماء ملفات التمهيد الأساسية المعترف بها فقط (`AGENTS.md` و`SOUL.md` و`TOOLS.md` و`IDENTITY.md` و`USER.md` و`HEARTBEAT.md` و`BOOTSTRAP.md` و`MEMORY.md`). [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%AE%D8%B7%D8%A7%D9%81%D8%A7%D8%AA-plugins) خطافات plugins ---------------------------------------------------------------------------------------------------------------- يمكن لـ plugins تسجيل خطافات من خلال Plugin SDK من أجل تكامل أعمق: اعتراض استدعاءات الأدوات، وتعديل المطالبات، والتحكم في تدفق الرسائل، وغير ذلك. يوفّر Plugin SDK عدد 28 خطافًا تغطي تحليل النموذج، ودورة حياة الوكيل، وتدفق الرسائل، وتنفيذ الأدوات، وتنسيق الوكلاء الفرعيين، ودورة حياة gateway. للاطلاع على المرجع الكامل لخطافات plugin بما في ذلك `before_tool_call` و`before_agent_reply` و`before_install` وجميع خطافات plugin الأخرى، راجع [Plugin Architecture](https://docs.openclaw.ai/plugins/architecture#provider-runtime-hooks) . [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) التكوين ------------------------------------------------------------------------------------------------------- { "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"] } } } } لا تزال صيغة التكوين القديمة للمصفوفة `hooks.internal.handlers` مدعومة للتوافق مع الإصدارات السابقة، لكن يجب أن تستخدم الخطافات الجديدة النظام القائم على الاكتشاف. [​](https://docs.openclaw.ai/ar/automation/hooks#%D9%85%D8%B1%D8%AC%D8%B9-cli) مرجع CLI ------------------------------------------------------------------------------------------ # List all hooks (add --eligible, --verbose, or --json) openclaw hooks list # Show detailed info about a hook openclaw hooks info # Show eligibility summary openclaw hooks check # Enable/disable openclaw hooks enable openclaw hooks disable [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) أفضل الممارسات --------------------------------------------------------------------------------------------------------------------------------------------------- * **أبقِ المعالجات سريعة.** تعمل الخطافات أثناء معالجة الأوامر. نفّذ الأعمال الثقيلة بشكل fire-and-forget باستخدام `void processInBackground(event)`. * **تعامل مع الأخطاء بسلاسة.** لف العمليات المحفوفة بالمخاطر داخل try/catch؛ ولا تُطلق الأخطاء حتى تتمكن المعالجات الأخرى من العمل. * **قم بتصفية الأحداث مبكرًا.** أعد فورًا إذا لم يكن نوع الحدث/الإجراء ذا صلة. * **استخدم مفاتيح أحداث محددة.** فضّل `"events": ["command:new"]` على `"events": ["command"]` لتقليل الحمل. [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D9%84%D9%85-%D9%8A%D8%AA%D9%85-%D8%A7%D9%83%D8%AA%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81) لم يتم اكتشاف الخطاف # Verify directory structure ls -la ~/.openclaw/hooks/my-hook/ # Should show: HOOK.md, handler.ts # List all discovered hooks openclaw hooks list ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81-%D8%BA%D9%8A%D8%B1-%D9%85%D8%A4%D9%87%D9%84) الخطاف غير مؤهل openclaw hooks info my-hook تحقق من الثنائيات المفقودة (PATH) أو متغيرات البيئة أو قيم التكوين أو توافق نظام التشغيل. ### [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%A7%D9%84%D8%AE%D8%B7%D8%A7%D9%81-%D9%84%D8%A7-%D9%8A%D8%AA%D9%85-%D8%AA%D9%86%D9%81%D9%8A%D8%B0%D9%87) الخطاف لا يتم تنفيذه 1. تحقق من أن الخطاف مفعّل: `openclaw hooks list` 2. أعد تشغيل عملية gateway حتى تُعاد تحميل الخطافات. 3. تحقق من سجلات gateway: ‏`./scripts/clawlog.sh | grep hook` [​](https://docs.openclaw.ai/ar/automation/hooks#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ------------------------------------------------------------------------------------------- * [مرجع CLI: hooks](https://docs.openclaw.ai/cli/hooks) * [Webhooks](https://docs.openclaw.ai/automation/cron-jobs#webhooks) * [Plugin Architecture](https://docs.openclaw.ai/plugins/architecture#provider-runtime-hooks) — المرجع الكامل لخطافات plugin * [Configuration](https://docs.openclaw.ai/gateway/configuration-reference#hooks) [الأوامر الدائمة](https://docs.openclaw.ai/ar/automation/standing-orders) [نظرة عامة على الوسائط](https://docs.openclaw.ai/ar/tools/media-overview) ⌘I --- # توجيه القنوات - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/channels/channel-routing#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Configuration توجيه القنوات [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [القنوات والتوجيه](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A7%D9%84%D9%82%D9%86%D9%88%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87) * [المصطلحات الأساسية](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A7%D9%84%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9) * [أشكال مفاتيح الجلسات (أمثلة)](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A3%D8%B4%D9%83%D8%A7%D9%84-%D9%85%D9%81%D8%A7%D8%AA%D9%8A%D8%AD-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-%D8%A3%D9%85%D8%AB%D9%84%D8%A9) * [تثبيت مسار الرسائل المباشرة الرئيسية](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%85%D8%B3%D8%A7%D8%B1-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9-%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9) * [قواعد التوجيه (كيف يتم اختيار الوكيل)](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87-%D9%83%D9%8A%D9%81-%D9%8A%D8%AA%D9%85-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84) * [مجموعات البث (تشغيل عدة وكلاء)](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D8%AB-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%B9%D8%AF%D8%A9-%D9%88%D9%83%D9%84%D8%A7%D8%A1) * [نظرة عامة على الإعداد](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9-%D8%B9%D9%84%D9%89-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF) * [تخزين الجلسات](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) * [سلوك WebChat](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%B3%D9%84%D9%88%D9%83-webchat) * [سياق الرد](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%B3%D9%8A%D8%A7%D9%82-%D8%A7%D9%84%D8%B1%D8%AF) [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A7%D9%84%D9%82%D9%86%D9%88%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87) القنوات والتوجيه ========================================================================================================================================================================= يوجّه OpenClaw الردود **مرة أخرى إلى القناة التي جاءت منها الرسالة**. لا يختار النموذج قناة؛ فالتوجيه حتمي وتتحكم فيه إعدادات المضيف. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A7%D9%84%D9%85%D8%B5%D8%B7%D9%84%D8%AD%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A%D8%A9) المصطلحات الأساسية --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * **القناة**: `telegram` و`whatsapp` و`discord` و`irc` و`googlechat` و`slack` و`signal` و`imessage` و`line`، بالإضافة إلى قنوات الإضافات. `webchat` هي قناة واجهة WebChat الداخلية وليست قناة صادرة قابلة للإعداد. * **AccountId**: مثيل حساب لكل قناة (عند الدعم). * الحساب الافتراضي الاختياري للقناة: يحدد `channels..defaultAccount` الحساب المستخدم عندما لا يحدد مسار صادر قيمة `accountId`. * في إعدادات الحسابات المتعددة، عيّن قيمة افتراضية صريحة (`defaultAccount` أو `accounts.default`) عند إعداد حسابين أو أكثر. وبدون ذلك، قد يختار التوجيه الاحتياطي أول معرّف حساب مُطبّع. * **AgentId**: مساحة عمل + مخزن جلسات معزولان (“العقل”). * **SessionKey**: مفتاح الحاوية المستخدم لتخزين السياق والتحكم في التزامن. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%A3%D8%B4%D9%83%D8%A7%D9%84-%D9%85%D9%81%D8%A7%D8%AA%D9%8A%D8%AD-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-%D8%A3%D9%85%D8%AB%D9%84%D8%A9) أشكال مفاتيح الجلسات (أمثلة) --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- تُطوى الرسائل المباشرة إلى جلسة **الرئيسية** الخاصة بالوكيل: * `agent::` (الافتراضي: `agent:main:main`) وتبقى المجموعات والقنوات معزولة لكل قناة: * المجموعات: `agent:::group:` * القنوات/الغرف: `agent:::channel:` سلاسل الرسائل: * تضيف سلاسل Slack/Discord القيمة `:thread:` إلى المفتاح الأساسي. * تدمج موضوعات منتدى Telegram القيمة `:topic:` في مفتاح المجموعة. أمثلة: * `agent:main:telegram:group:-1001234567890:topic:42` * `agent:main:discord:channel:123456:thread:987654` [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-%D9%85%D8%B3%D8%A7%D8%B1-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9-%D8%A7%D9%84%D8%B1%D8%A6%D9%8A%D8%B3%D9%8A%D8%A9) تثبيت مسار الرسائل المباشرة الرئيسية ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ عندما تكون قيمة `session.dmScope` هي `main`، قد تشترك الرسائل المباشرة في جلسة رئيسية واحدة. ولمنع الكتابة فوق `lastRoute` الخاص بالجلسة بواسطة الرسائل المباشرة من غير المالك، يستنتج OpenClaw مالكًا مثبتًا من `allowFrom` عندما تتحقق جميع الشروط التالية: * يحتوي `allowFrom` على إدخال واحد غير شامل تمامًا. * يمكن تطبيع هذا الإدخال إلى معرّف مرسل فعلي لتلك القناة. * لا يتطابق مرسل الرسالة المباشرة الواردة مع ذلك المالك المثبت. في حالة عدم التطابق هذه، يواصل OpenClaw تسجيل بيانات تعريف الجلسة الواردة، لكنه يتخطى تحديث `lastRoute` للجلسة الرئيسية. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%82%D9%88%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87-%D9%83%D9%8A%D9%81-%D9%8A%D8%AA%D9%85-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84) قواعد التوجيه (كيف يتم اختيار الوكيل) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يختار التوجيه **وكيلًا واحدًا** لكل رسالة واردة: 1. **مطابقة نظير تامة** (`bindings` مع `peer.kind` و`peer.id`). 2. **مطابقة النظير الأصل** (وراثة السلسلة). 3. **مطابقة الخادم + الأدوار** (Discord) عبر `guildId` و`roles`. 4. **مطابقة الخادم** (Discord) عبر `guildId`. 5. **مطابقة الفريق** (Slack) عبر `teamId`. 6. **مطابقة الحساب** (`accountId` على القناة). 7. **مطابقة القناة** (أي حساب على تلك القناة، `accountId: "*"`). 8. **الوكيل الافتراضي** (`agents.list[].default`، وإلا أول إدخال في القائمة، مع الرجوع الاحتياطي إلى `main`). عندما يتضمن الربط عدة حقول مطابقة (`peer` أو `guildId` أو `teamId` أو `roles`)، **يجب أن تتطابق جميع الحقول المقدمة** حتى يُطبَّق هذا الربط. يحدد الوكيل المطابق مساحة العمل ومخزن الجلسات المستخدمين. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D8%AB-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%B9%D8%AF%D8%A9-%D9%88%D9%83%D9%84%D8%A7%D8%A1) مجموعات البث (تشغيل عدة وكلاء) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ تتيح لك مجموعات البث تشغيل **عدة وكلاء** للنظير نفسه **عندما يكون OpenClaw سيرد عادةً** (على سبيل المثال: في مجموعات WhatsApp، بعد ذكر الاسم/بوابة التفعيل). الإعداد: { broadcast: { strategy: "parallel", "120363403215116621@g.us": ["alfred", "baerbel"], "+15555550123": ["support", "logger"], }, } راجع: [مجموعات البث](https://docs.openclaw.ai/channels/broadcast-groups) . [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9-%D8%B9%D9%84%D9%89-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF) نظرة عامة على الإعداد -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * `agents.list`: تعريفات الوكلاء المسماة (مساحة العمل، النموذج، وما إلى ذلك). * `bindings`: ربط القنوات/الحسابات/النظراء الواردة بالوكلاء. مثال: { agents: { list: [{ id: "support", name: "Support", workspace: "~/.openclaw/workspace-support" }], }, bindings: [\ { match: { channel: "slack", teamId: "T123" }, agentId: "support" },\ { match: { channel: "telegram", peer: { kind: "group", id: "-100123" } }, agentId: "support" },\ ], } [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) تخزين الجلسات ---------------------------------------------------------------------------------------------------------------------------------------------------- توجد مخازن الجلسات ضمن دليل الحالة (الافتراضي `~/.openclaw`): * `~/.openclaw/agents//sessions/sessions.json` * توجد نصوص JSONL بجانب المخزن يمكنك تجاوز مسار المخزن عبر `session.store` وقوالب `{agentId}`. يفحص اكتشاف جلسات Gateway وACP أيضًا مخازن الوكلاء المعتمدة على القرص ضمن الجذر الافتراضي `agents/` وضمن جذور `session.store` ذات القوالب. ويجب أن تبقى المخازن المكتشفة داخل جذر الوكيل المحلول هذا وأن تستخدم ملف `sessions.json` عاديًا. يتم تجاهل الروابط الرمزية والمسارات الخارجة عن الجذر. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%B3%D9%84%D9%88%D9%83-webchat) سلوك WebChat ---------------------------------------------------------------------------------------------------------- يرتبط WebChat بـ **الوكيل المحدد** ويستخدم افتراضيًا الجلسة الرئيسية للوكيل. ولهذا السبب، يتيح لك WebChat رؤية السياق المشترك بين القنوات لذلك الوكيل في مكان واحد. [​](https://docs.openclaw.ai/ar/channels/channel-routing#%D8%B3%D9%8A%D8%A7%D9%82-%D8%A7%D9%84%D8%B1%D8%AF) سياق الرد ------------------------------------------------------------------------------------------------------------------------ تتضمن الردود الواردة ما يلي: * `ReplyToId` و`ReplyToBody` و`ReplyToSender` عند توفرها. * يُلحَق السياق المقتبس بـ `Body` ككتلة `[Replying to ...]`. وهذا متسق عبر القنوات. [مجموعات البث](https://docs.openclaw.ai/ar/channels/broadcast-groups) [تحليل مواقع القنوات](https://docs.openclaw.ai/ar/channels/location) ⌘I --- # Google Chat - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/channels/googlechat#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Messaging platforms Google Chat [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [Google Chat (Chat API)](https://docs.openclaw.ai/ar/channels/googlechat#google-chat-chat-api) * [إعداد سريع (للمبتدئين)](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B3%D8%B1%D9%8A%D8%B9-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86) * [الإضافة إلى Google Chat](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-%D8%A5%D9%84%D9%89-google-chat) * [عنوان URL عام (Webhook فقط)](https://docs.openclaw.ai/ar/channels/googlechat#%D8%B9%D9%86%D9%88%D8%A7%D9%86-url-%D8%B9%D8%A7%D9%85-webhook-%D9%81%D9%82%D8%B7) * [الخيار A: Tailscale Funnel (موصى به)](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-a-tailscale-funnel-%D9%85%D9%88%D8%B5%D9%89-%D8%A8%D9%87) * [الخيار B: Reverse Proxy (Caddy)](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-b-reverse-proxy-caddy) * [الخيار C: Cloudflare Tunnel](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-c-cloudflare-tunnel) * [كيف يعمل](https://docs.openclaw.ai/ar/channels/googlechat#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84) * [الأهداف](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%A3%D9%87%D8%AF%D8%A7%D9%81) * [أبرز التكوينات](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A3%D8%A8%D8%B1%D8%B2-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86%D8%A7%D8%AA) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [405 Method Not Allowed](https://docs.openclaw.ai/ar/channels/googlechat#405-method-not-allowed) * [مشكلات أخرى](https://docs.openclaw.ai/ar/channels/googlechat#%D9%85%D8%B4%D9%83%D9%84%D8%A7%D8%AA-%D8%A3%D8%AE%D8%B1%D9%89) * [ذو صلة](https://docs.openclaw.ai/ar/channels/googlechat#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/channels/googlechat#google-chat-chat-api) Google Chat (Chat API) =================================================================================================== الحالة: جاهز للرسائل المباشرة + المساحات عبر webhooks الخاصة بـ Google Chat API (HTTP فقط). [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B3%D8%B1%D9%8A%D8%B9-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86) إعداد سريع (للمبتدئين) --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- 1. أنشئ مشروع Google Cloud وفعّل **Google Chat API**. * انتقل إلى: [Google Chat API Credentials](https://console.cloud.google.com/apis/api/chat.googleapis.com/credentials) * فعّل API إذا لم تكن مفعلة بالفعل. 2. أنشئ **Service Account**: * اضغط **Create Credentials** > **Service Account**. * سمّه كما تريد (مثلًا: `openclaw-chat`). * اترك الأذونات فارغة (اضغط **Continue**). * اترك الجهات الرئيسية التي لديها وصول فارغة (اضغط **Done**). 3. أنشئ ونزّل **JSON Key**: * في قائمة حسابات الخدمة، انقر على الحساب الذي أنشأته للتو. * انتقل إلى علامة التبويب **Keys**. * انقر **Add Key** > **Create new key**. * اختر **JSON** واضغط **Create**. 4. خزّن ملف JSON الذي تم تنزيله على مضيف gateway لديك (مثلًا: `~/.openclaw/googlechat-service-account.json`). 5. أنشئ تطبيق Google Chat في [Google Cloud Console Chat Configuration](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) : * املأ **Application info**: * **App name**: (مثلًا `OpenClaw`) * **Avatar URL**: (مثلًا `https://openclaw.ai/logo.png`) * **Description**: (مثلًا `Personal AI Assistant`) * فعّل **Interactive features**. * ضمن **Functionality**، حدّد **Join spaces and group conversations**. * ضمن **Connection settings**، اختر **HTTP endpoint URL**. * ضمن **Triggers**، اختر **Use a common HTTP endpoint URL for all triggers** واضبطه على عنوان URL العام الخاص بـ gateway متبوعًا بـ `/googlechat`. * _نصيحة: شغّل `openclaw status` للعثور على عنوان URL العام الخاص بـ gateway._ * ضمن **Visibility**، حدّد **Make this Chat app available to specific people and groups in **. * أدخل عنوان بريدك الإلكتروني (مثلًا `user@example.com`) في مربع النص. * انقر **Save** في الأسفل. 6. **فعّل حالة التطبيق**: * بعد الحفظ، **حدّث الصفحة**. * ابحث عن قسم **App status** (عادةً قرب الأعلى أو الأسفل بعد الحفظ). * غيّر الحالة إلى **Live - available to users**. * انقر **Save** مرة أخرى. 7. اضبط OpenClaw باستخدام مسار حساب الخدمة + webhook audience: * متغير البيئة: `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE=/path/to/service-account.json` * أو التكوين: `channels.googlechat.serviceAccountFile: "/path/to/service-account.json"`. 8. اضبط نوع وقيمة webhook audience (بحيث يطابق إعداد تطبيق Chat لديك). 9. ابدأ gateway. سيُرسل Google Chat طلبات POST إلى مسار webhook لديك. [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%A5%D8%B6%D8%A7%D9%81%D8%A9-%D8%A5%D9%84%D9%89-google-chat) الإضافة إلى Google Chat --------------------------------------------------------------------------------------------------------------------------------------------------------- بمجرد تشغيل gateway وإضافة بريدك الإلكتروني إلى قائمة الظهور: 1. انتقل إلى [Google Chat](https://chat.google.com/) . 2. انقر على أيقونة **+** (زائد) بجانب **Direct Messages**. 3. في شريط البحث (حيث تضيف الأشخاص عادةً)، اكتب **App name** الذي قمت بتكوينه في Google Cloud Console. * **ملاحظة**: لن يظهر الروبوت في قائمة التصفح “Marketplace” لأنه تطبيق خاص. يجب أن تبحث عنه بالاسم. 4. اختر الروبوت من النتائج. 5. انقر **Add** أو **Chat** لبدء محادثة فردية. 6. أرسل “Hello” لتشغيل المساعد! [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%B9%D9%86%D9%88%D8%A7%D9%86-url-%D8%B9%D8%A7%D9%85-webhook-%D9%81%D9%82%D8%B7) عنوان URL عام (Webhook فقط) -------------------------------------------------------------------------------------------------------------------------------------------------------------------- تتطلب webhooks الخاصة بـ Google Chat نقطة نهاية HTTPS عامة. لأسباب أمنية، **اكشف فقط المسار `/googlechat`** للإنترنت. أبقِ لوحة تحكم OpenClaw ونقاط النهاية الحساسة الأخرى على شبكتك الخاصة. ### [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-a-tailscale-funnel-%D9%85%D9%88%D8%B5%D9%89-%D8%A8%D9%87) الخيار A: Tailscale Funnel (موصى به) استخدم Tailscale Serve للوحة التحكم الخاصة وFunnel لمسار webhook العام. هذا يُبقي `/` خاصًا مع كشف `/googlechat` فقط. 1. **تحقق من العنوان المرتبط به gateway:** ss -tlnp | grep 18789 دوّن عنوان IP (مثلًا `127.0.0.1` أو `0.0.0.0` أو عنوان Tailscale الخاص بك مثل `100.x.x.x`). 2. **اكشف لوحة التحكم إلى tailnet فقط (المنفذ 8443):** # If bound to localhost (127.0.0.1 or 0.0.0.0): tailscale serve --bg --https 8443 http://127.0.0.1:18789 # If bound to Tailscale IP only (e.g., 100.106.161.80): tailscale serve --bg --https 8443 http://100.106.161.80:18789 3. **اكشف مسار webhook فقط بشكل عام:** # If bound to localhost (127.0.0.1 or 0.0.0.0): tailscale funnel --bg --set-path /googlechat http://127.0.0.1:18789/googlechat # If bound to Tailscale IP only (e.g., 100.106.161.80): tailscale funnel --bg --set-path /googlechat http://100.106.161.80:18789/googlechat 4. **فوّض العقدة للوصول عبر Funnel:** إذا طُلب منك ذلك، فزر عنوان URL الخاص بالتفويض الظاهر في المخرجات لتمكين Funnel لهذه العقدة في سياسة tailnet الخاصة بك. 5. **تحقق من التكوين:** tailscale serve status tailscale funnel status سيكون عنوان URL العام لـ webhook لديك: `https://..ts.net/googlechat` وستبقى لوحة التحكم الخاصة بك ضمن tailnet فقط: `https://..ts.net:8443/` استخدم عنوان URL العام (من دون `:8443`) في إعداد تطبيق Google Chat. > ملاحظة: يستمر هذا التكوين بعد إعادة التشغيل. لإزالته لاحقًا، شغّل `tailscale funnel reset` و`tailscale serve reset`. ### [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-b-reverse-proxy-caddy) الخيار B: Reverse Proxy (Caddy) إذا كنت تستخدم reverse proxy مثل Caddy، فقم بتمرير المسار المحدد فقط: your-domain.com { reverse_proxy /googlechat* localhost:18789 } مع هذا التكوين، سيتم تجاهل أي طلب إلى `your-domain.com/` أو إرجاع 404 له، بينما يتم توجيه `your-domain.com/googlechat` بأمان إلى OpenClaw. ### [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%AE%D9%8A%D8%A7%D8%B1-c-cloudflare-tunnel) الخيار C: Cloudflare Tunnel اضبط قواعد ingress الخاصة بـ tunnel لتوجيه مسار webhook فقط: * **المسار**: `/googlechat` -> `http://localhost:18789/googlechat` * **القاعدة الافتراضية**: HTTP 404 (غير موجود) [​](https://docs.openclaw.ai/ar/channels/googlechat#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84) كيف يعمل ------------------------------------------------------------------------------------------------------------ 1. يرسل Google Chat طلبات webhook من نوع POST إلى gateway. يتضمن كل طلب ترويسة `Authorization: Bearer `. * يتحقق OpenClaw من bearer auth قبل قراءة/تحليل أجسام webhook الكاملة عند وجود الترويسة. * يتم دعم طلبات Google Workspace Add-on التي تحمل `authorizationEventObject.systemIdToken` في الجسم من خلال حد أقصى أكثر صرامة لجسم ما قبل المصادقة. 2. يتحقق OpenClaw من الرمز المميز مقابل `audienceType` و`audience` المكوّنين: * `audienceType: "app-url"` → يكون audience هو عنوان URL الخاص بـ webhook عبر HTTPS. * `audienceType: "project-number"` → يكون audience هو رقم مشروع Cloud. 3. يتم توجيه الرسائل حسب المساحة: * تستخدم الرسائل المباشرة مفتاح الجلسة `agent::googlechat:direct:`. * تستخدم المساحات مفتاح الجلسة `agent::googlechat:group:`. 4. يكون وصول الرسائل المباشرة عبر pairing افتراضيًا. يتلقى المرسلون غير المعروفين رمز pairing؛ وافق عليه باستخدام: * `openclaw pairing approve googlechat ` 5. تتطلب المساحات الجماعية إشارة @ افتراضيًا. استخدم `botUser` إذا كان اكتشاف الإشارة يحتاج إلى اسم مستخدم التطبيق. [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D9%84%D8%A3%D9%87%D8%AF%D8%A7%D9%81) الأهداف ---------------------------------------------------------------------------------------------------------- استخدم هذه المعرّفات للتسليم وقوائم السماح: * الرسائل المباشرة: `users/` (موصى به). * البريد الإلكتروني الخام `name@example.com` قابل للتغيير ويُستخدم فقط لمطابقة قائمة السماح المباشرة عندما تكون `channels.googlechat.dangerouslyAllowNameMatching: true`. * متروك: يتم التعامل مع `users/` على أنه معرّف مستخدم، وليس قائمة سماح للبريد الإلكتروني. * المساحات: `spaces/`. [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A3%D8%A8%D8%B1%D8%B2-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86%D8%A7%D8%AA) أبرز التكوينات ------------------------------------------------------------------------------------------------------------------------------------------------------ { channels: { googlechat: { enabled: true, serviceAccountFile: "/path/to/service-account.json", // or serviceAccountRef: { source: "file", provider: "filemain", id: "/channels/googlechat/serviceAccount" } audienceType: "app-url", audience: "https://gateway.example.com/googlechat", webhookPath: "/googlechat", botUser: "users/1234567890", // optional; helps mention detection dm: { policy: "pairing", allowFrom: ["users/1234567890"], }, groupPolicy: "allowlist", groups: { "spaces/AAAA": { allow: true, requireMention: true, users: ["users/1234567890"], systemPrompt: "Short answers only.", }, }, actions: { reactions: true }, typingIndicator: "message", mediaMaxMb: 20, }, }, } ملاحظات: * يمكن أيضًا تمرير بيانات اعتماد حساب الخدمة مباشرة باستخدام `serviceAccount` (سلسلة JSON). * `serviceAccountRef` مدعوم أيضًا (SecretRef للبيئة/الملف)، بما في ذلك المراجع لكل حساب ضمن `channels.googlechat.accounts..serviceAccountRef`. * مسار webhook الافتراضي هو `/googlechat` إذا لم يتم تعيين `webhookPath`. * تعيد `dangerouslyAllowNameMatching` تمكين مطابقة principal للبريد الإلكتروني القابل للتغيير لقوائم السماح (وضع توافقية طارئ). * تتوفر التفاعلات عبر أداة `reactions` و`channels action` عندما تكون `actions.reactions` مفعلة. * تعرض إجراءات الرسائل `send` للنص و`upload-file` لإرسال المرفقات بشكل صريح. تقبل `upload-file` القيم `media` / `filePath` / `path` بالإضافة إلى `message` و`filename` الاختياريين واستهداف السلسلة. * يدعم `typingIndicator` القيم `none` و`message` (الافتراضي) و`reaction` (يتطلب التفاعل OAuth للمستخدم). * يتم تنزيل المرفقات عبر Chat API وتخزينها في مسار الوسائط (مع حد للحجم تحدده `mediaMaxMb`). تفاصيل مرجع الأسرار: [Secrets Management](https://docs.openclaw.ai/gateway/secrets) . [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/googlechat#405-method-not-allowed) 405 Method Not Allowed إذا أظهر Google Cloud Logs Explorer أخطاء مثل: status code: 405, reason phrase: HTTP error response: HTTP/1.1 405 Method Not Allowed فهذا يعني أن معالج webhook غير مسجّل. الأسباب الشائعة: 1. **القناة غير مكوّنة**: قسم `channels.googlechat` مفقود من التكوين. تحقق باستخدام: openclaw config get channels.googlechat إذا أعاد “Config path not found”، فأضف التكوين (راجع [أبرز التكوينات](https://docs.openclaw.ai/ar/channels/googlechat#config-highlights) ). 2. **plugin غير مفعّل**: تحقق من حالة plugin: openclaw plugins list | grep googlechat إذا أظهر “disabled”، فأضف `plugins.entries.googlechat.enabled: true` إلى التكوين. 3. **لم تتم إعادة تشغيل gateway**: بعد إضافة التكوين، أعد تشغيل gateway: openclaw gateway restart تحقق من أن القناة تعمل: openclaw channels status # Should show: Google Chat default: enabled, configured, ... ### [​](https://docs.openclaw.ai/ar/channels/googlechat#%D9%85%D8%B4%D9%83%D9%84%D8%A7%D8%AA-%D8%A3%D8%AE%D8%B1%D9%89) مشكلات أخرى * تحقق من `openclaw channels status --probe` بحثًا عن أخطاء المصادقة أو غياب إعداد audience. * إذا لم تصل أي رسائل، فتأكد من عنوان URL الخاص بـ webhook لتطبيق Chat واشتراكات الأحداث. * إذا كان تقييد الإشارة يمنع الردود، فاضبط `botUser` على اسم مورد مستخدم التطبيق وتحقق من `requireMention`. * استخدم `openclaw logs --follow` أثناء إرسال رسالة اختبار لمعرفة ما إذا كانت الطلبات تصل إلى gateway. الوثائق ذات الصلة: * [تكوين gateway](https://docs.openclaw.ai/gateway/configuration) * [الأمان](https://docs.openclaw.ai/gateway/security) * [التفاعلات](https://docs.openclaw.ai/tools/reactions) [​](https://docs.openclaw.ai/ar/channels/googlechat#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ---------------------------------------------------------------------------------------------- * [نظرة عامة على القنوات](https://docs.openclaw.ai/channels) — جميع القنوات المدعومة * [Pairing](https://docs.openclaw.ai/channels/pairing) — مصادقة الرسائل المباشرة وتدفق pairing * [المجموعات](https://docs.openclaw.ai/channels/groups) — سلوك الدردشة الجماعية وتقييد الإشارات * [توجيه القنوات](https://docs.openclaw.ai/channels/channel-routing) — توجيه الجلسات للرسائل * [الأمان](https://docs.openclaw.ai/gateway/security) — نموذج الوصول والتقوية [Feishu](https://docs.openclaw.ai/ar/channels/feishu) [iMessage](https://docs.openclaw.ai/ar/channels/imessage) ⌘I --- # Task Flow - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation/taskflow#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks Task Flow [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow#task-flow) * [متى تستخدم Task Flow](https://docs.openclaw.ai/ar/automation/taskflow#%D9%85%D8%AA%D9%89-%D8%AA%D8%B3%D8%AA%D8%AE%D8%AF%D9%85-task-flow) * [أوضاع المزامنة](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A3%D9%88%D8%B6%D8%A7%D8%B9-%D8%A7%D9%84%D9%85%D8%B2%D8%A7%D9%85%D9%86%D8%A9) * [الوضع المُدار](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D9%88%D8%B6%D8%B9-%D8%A7%D9%84%D9%85%D9%8F%D8%AF%D8%A7%D8%B1) * [الوضع المعكوس](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D9%88%D8%B6%D8%B9-%D8%A7%D9%84%D9%85%D8%B9%D9%83%D9%88%D8%B3) * [الحالة المستدامة وتتبع المراجعات](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D8%AD%D8%A7%D9%84%D8%A9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AF%D8%A7%D9%85%D8%A9-%D9%88%D8%AA%D8%AA%D8%A8%D8%B9-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A7%D8%AA) * [سلوك الإلغاء](https://docs.openclaw.ai/ar/automation/taskflow#%D8%B3%D9%84%D9%88%D9%83-%D8%A7%D9%84%D8%A5%D9%84%D8%BA%D8%A7%D8%A1) * [أوامر CLI](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A3%D9%88%D8%A7%D9%85%D8%B1-cli) * [كيف ترتبط التدفقات بالمهام](https://docs.openclaw.ai/ar/automation/taskflow#%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%AA%D8%A8%D8%B7-%D8%A7%D9%84%D8%AA%D8%AF%D9%81%D9%82%D8%A7%D8%AA-%D8%A8%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [ذو صلة](https://docs.openclaw.ai/ar/automation/taskflow#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation/taskflow#task-flow) Task Flow =========================================================================== Task Flow هي البنية الأساسية لتنسيق التدفقات التي تقع فوق [المهام الخلفية](https://docs.openclaw.ai/automation/tasks) . وهي تدير تدفقات مستدامة متعددة الخطوات لها حالتها الخاصة، وتتبع المراجعات، ودلالات المزامنة، بينما تظل المهام الفردية هي وحدة العمل المنفصل. [​](https://docs.openclaw.ai/ar/automation/taskflow#%D9%85%D8%AA%D9%89-%D8%AA%D8%B3%D8%AA%D8%AE%D8%AF%D9%85-task-flow) متى تستخدم Task Flow ---------------------------------------------------------------------------------------------------------------------------------------------- استخدم Task Flow عندما يمتد العمل عبر خطوات متسلسلة متعددة أو متفرعة وتحتاج إلى تتبع مستدام للتقدم عبر عمليات إعادة تشغيل البوابة. بالنسبة إلى العمليات الخلفية المفردة، تكون [المهمة](https://docs.openclaw.ai/automation/tasks) العادية كافية. | السيناريو | الاستخدام | | --- | --- | | مهمة خلفية واحدة | مهمة عادية | | مسار متعدد الخطوات (A ثم B ثم C) | Task Flow (مُدارة) | | مراقبة المهام المُنشأة خارجيًا | Task Flow (معكوسة) | | تذكير لمرة واحدة | مهمة Cron | [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A3%D9%88%D8%B6%D8%A7%D8%B9-%D8%A7%D9%84%D9%85%D8%B2%D8%A7%D9%85%D9%86%D8%A9) أوضاع المزامنة ------------------------------------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D9%88%D8%B6%D8%B9-%D8%A7%D9%84%D9%85%D9%8F%D8%AF%D8%A7%D8%B1) الوضع المُدار تتولى Task Flow دورة الحياة من البداية إلى النهاية. فهي تنشئ المهام كخطوات للتدفق، وتدفعها إلى الاكتمال، وتُقدّم حالة التدفق تلقائيًا. مثال: تدفق تقرير أسبوعي يقوم (1) بجمع البيانات، و(2) بإنشاء التقرير، و(3) بتسليمه. تنشئ Task Flow كل خطوة كمهمة خلفية، وتنتظر اكتمالها، ثم تنتقل إلى الخطوة التالية. Flow: weekly-report Step 1: gather-data → task created → succeeded Step 2: generate-report → task created → succeeded Step 3: deliver → task created → running ### [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D9%88%D8%B6%D8%B9-%D8%A7%D9%84%D9%85%D8%B9%D9%83%D9%88%D8%B3) الوضع المعكوس تراقب Task Flow المهام المُنشأة خارجيًا وتحافظ على مزامنة حالة التدفق من دون تولي مسؤولية إنشاء المهام. يكون هذا مفيدًا عندما تنشأ المهام من مهام Cron أو أوامر CLI أو مصادر أخرى وتريد عرضًا موحدًا لتقدمها كتدفق. مثال: ثلاث مهام Cron مستقلة تشكّل معًا روتين “عمليات الصباح”. يتتبع التدفق المعكوس تقدمها الجماعي من دون التحكم في وقت تشغيلها أو كيفية تشغيلها. [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A7%D9%84%D8%AD%D8%A7%D9%84%D8%A9-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AF%D8%A7%D9%85%D8%A9-%D9%88%D8%AA%D8%AA%D8%A8%D8%B9-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A7%D8%AA) الحالة المستدامة وتتبع المراجعات -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يحفظ كل تدفق حالته الخاصة ويتتبع المراجعات بحيث يستمر التقدم عبر عمليات إعادة تشغيل البوابة. ويتيح تتبع المراجعات اكتشاف التعارضات عندما تحاول مصادر متعددة تقديم التدفق نفسه بالتزامن. [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%B3%D9%84%D9%88%D9%83-%D8%A7%D9%84%D8%A5%D9%84%D8%BA%D8%A7%D8%A1) سلوك الإلغاء ---------------------------------------------------------------------------------------------------------------------------------------- يضبط `openclaw tasks flow cancel` نية إلغاء ثابتة على التدفق. تُلغى المهام النشطة داخل التدفق، ولا تبدأ أي خطوات جديدة. تستمر نية الإلغاء عبر عمليات إعادة التشغيل، لذا يظل التدفق المُلغى مُلغًى حتى إذا أُعيد تشغيل البوابة قبل انتهاء جميع المهام الفرعية. [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%A3%D9%88%D8%A7%D9%85%D8%B1-cli) أوامر CLI ---------------------------------------------------------------------------------------------------- # List active and recent flows openclaw tasks flow list # Show details for a specific flow openclaw tasks flow show # Cancel a running flow and its active tasks openclaw tasks flow cancel | الأمر | الوصف | | --- | --- | | `openclaw tasks flow list` | يعرض التدفقات المتتبعة مع الحالة ووضع المزامنة | | `openclaw tasks flow show ` | يفحص تدفقًا واحدًا حسب معرّف التدفق أو مفتاح البحث | | `openclaw tasks flow cancel ` | يُلغي تدفقًا قيد التشغيل ومهامه النشطة | [​](https://docs.openclaw.ai/ar/automation/taskflow#%D9%83%D9%8A%D9%81-%D8%AA%D8%B1%D8%AA%D8%A8%D8%B7-%D8%A7%D9%84%D8%AA%D8%AF%D9%81%D9%82%D8%A7%D8%AA-%D8%A8%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) كيف ترتبط التدفقات بالمهام -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- تنسّق التدفقات المهام، ولا تستبدلها. قد يقود تدفق واحد عدة مهام خلفية خلال مدة عمله. استخدم `openclaw tasks` لفحص سجلات المهام الفردية، واستخدم `openclaw tasks flow` لفحص التدفق المنسِّق. [​](https://docs.openclaw.ai/ar/automation/taskflow#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ---------------------------------------------------------------------------------------------- * [المهام الخلفية](https://docs.openclaw.ai/automation/tasks) — سجل العمل المنفصل الذي تنسقه التدفقات * [CLI: tasks](https://docs.openclaw.ai/cli/index#tasks) — مرجع أوامر CLI لـ `openclaw tasks flow` * [نظرة عامة على الأتمتة](https://docs.openclaw.ai/automation) — جميع آليات الأتمتة في لمحة * [مهام Cron](https://docs.openclaw.ai/automation/cron-jobs) — الوظائف المجدولة التي قد تتدفق إلى التدفقات [المهام في الخلفية](https://docs.openclaw.ai/ar/automation/tasks) [الأوامر الدائمة](https://docs.openclaw.ai/ar/automation/standing-orders) ⌘I --- # المهام في الخلفية - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation/tasks#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks المهام في الخلفية [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [المهام في الخلفية](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D8%AE%D9%84%D9%81%D9%8A%D8%A9) * [باختصار](https://docs.openclaw.ai/ar/automation/tasks#%D8%A8%D8%A7%D8%AE%D8%AA%D8%B5%D8%A7%D8%B1) * [البدء السريع](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) * [ما الذي يُنشئ مهمة](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D8%A7-%D8%A7%D9%84%D8%B0%D9%8A-%D9%8A%D9%8F%D9%86%D8%B4%D8%A6-%D9%85%D9%87%D9%85%D8%A9) * [دورة حياة المهمة](https://docs.openclaw.ai/ar/automation/tasks#%D8%AF%D9%88%D8%B1%D8%A9-%D8%AD%D9%8A%D8%A7%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D9%85%D8%A9) * [التسليم والإشعارات](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85-%D9%88%D8%A7%D9%84%D8%A5%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA) * [سياسات الإشعارات](https://docs.openclaw.ai/ar/automation/tasks#%D8%B3%D9%8A%D8%A7%D8%B3%D8%A7%D8%AA-%D8%A7%D9%84%D8%A5%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA) * [مرجع CLI](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D8%B1%D8%AC%D8%B9-cli) * [tasks list](https://docs.openclaw.ai/ar/automation/tasks#tasks-list) * [tasks show](https://docs.openclaw.ai/ar/automation/tasks#tasks-show) * [tasks cancel](https://docs.openclaw.ai/ar/automation/tasks#tasks-cancel) * [tasks notify](https://docs.openclaw.ai/ar/automation/tasks#tasks-notify) * [tasks audit](https://docs.openclaw.ai/ar/automation/tasks#tasks-audit) * [tasks maintenance](https://docs.openclaw.ai/ar/automation/tasks#tasks-maintenance) * [tasks flow list|show|cancel](https://docs.openclaw.ai/ar/automation/tasks#tasks-flow-list%7Cshow%7Ccancel) * [لوحة مهام الدردشة (/tasks)](https://docs.openclaw.ai/ar/automation/tasks#%D9%84%D9%88%D8%AD%D8%A9-%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D8%AF%D8%B1%D8%AF%D8%B4%D8%A9-%2Ftasks) * [التكامل مع الحالة (ضغط المهام)](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D9%83%D8%A7%D9%85%D9%84-%D9%85%D8%B9-%D8%A7%D9%84%D8%AD%D8%A7%D9%84%D8%A9-%D8%B6%D8%BA%D8%B7-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [التخزين والصيانة](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-%D9%88%D8%A7%D9%84%D8%B5%D9%8A%D8%A7%D9%86%D8%A9) * [مكان وجود المهام](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D9%83%D8%A7%D9%86-%D9%88%D8%AC%D9%88%D8%AF-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [الصيانة التلقائية](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%B5%D9%8A%D8%A7%D9%86%D8%A9-%D8%A7%D9%84%D8%AA%D9%84%D9%82%D8%A7%D8%A6%D9%8A%D8%A9) * [كيفية ارتباط المهام بالأنظمة الأخرى](https://docs.openclaw.ai/ar/automation/tasks#%D9%83%D9%8A%D9%81%D9%8A%D8%A9-%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A8%D8%A7%D9%84%D8%A3%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D8%A3%D8%AE%D8%B1%D9%89) * [المهام وTask Flow](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88task-flow) * [المهام وcron](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88cron) * [المهام وheartbeat](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88heartbeat) * [المهام والجلسات](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) * [المهام وعمليات تشغيل الوكيل](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88%D8%B9%D9%85%D9%84%D9%8A%D8%A7%D8%AA-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84) * [ذو صلة](https://docs.openclaw.ai/ar/automation/tasks#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D8%AE%D9%84%D9%81%D9%8A%D8%A9) المهام في الخلفية =================================================================================================================================================================== > **هل تبحث عن الجدولة؟** راجع [الأتمتة والمهام](https://docs.openclaw.ai/ar/automation) > لاختيار الآلية المناسبة. تغطي هذه الصفحة **تتبّع** العمل في الخلفية، وليس جدولته. تتتبّع المهام في الخلفية العمل الذي يُشغَّل **خارج جلسة المحادثة الرئيسية**: عمليات ACP، وتشغيل الوكلاء الفرعيين، وتنفيذ وظائف cron المعزولة، والعمليات التي يبدأها CLI. لا تحل المهام محل الجلسات أو وظائف cron أو heartbeat — بل هي **سجل النشاط** الذي يسجّل ما الذي حدث من عمل منفصل، ومتى حدث، وما إذا كان قد نجح. ليست كل عمليات تشغيل الوكيل تُنشئ مهمة. عمليات heartbeat والمحادثة التفاعلية العادية لا تفعل ذلك. جميع عمليات تنفيذ cron، وعمليات تشغيل ACP، وعمليات تشغيل الوكلاء الفرعيين، وأوامر الوكيل عبر CLI تنشئ مهام. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A8%D8%A7%D8%AE%D8%AA%D8%B5%D8%A7%D8%B1) باختصار ------------------------------------------------------------------------------------------------------- * المهام هي **سجلات** وليست مجدولات — cron وheartbeat يحددان _متى_ يُشغَّل العمل، بينما تتتبّع المهام _ما الذي حدث_. * تنشئ ACP، والوكلاء الفرعيون، وجميع وظائف cron، وعمليات CLI مهام. أما عمليات heartbeat فلا تنشئها. * تنتقل كل مهمة عبر `queued → running → terminal` (succeeded أو failed أو timed\_out أو cancelled أو lost). * تظل مهام cron نشطة ما دام وقت تشغيل cron لا يزال يملك الوظيفة؛ وتظل مهام CLI المدعومة بالدردشة نشطة فقط ما دام سياق التشغيل المالك لها لا يزال فعالًا. * الاكتمال يعتمد على الدفع: يمكن للعمل المنفصل أن يُخطر مباشرة أو يوقظ جلسة الطالب/heartbeat عند انتهائه، لذلك تكون حلقات استطلاع الحالة عادةً الشكل غير المناسب. * تُجري عمليات cron المعزولة وعمليات اكتمال الوكلاء الفرعيين تنظيفًا بأفضل جهد ممكن لعلامات تبويب/عمليات المتصفح المتتبَّعة الخاصة بالجلسة الفرعية قبل تسجيلات التنظيف النهائية. * يمنع تسليم cron المعزول الردود المرحلية القديمة من الأصل بينما لا يزال عمل الوكيل الفرعي التابع قيد التصريف، ويفضّل مخرجات التابع النهائية عندما تصل قبل التسليم. * تُسلَّم إشعارات الاكتمال مباشرة إلى قناة أو تُوضَع في قائمة انتظار heartbeat التالي. * يعرض `openclaw tasks list` جميع المهام؛ ويُظهر `openclaw tasks audit` المشكلات. * تُحتفَظ بالسجلات النهائية لمدة 7 أيام، ثم تُزال تلقائيًا. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) البدء السريع ------------------------------------------------------------------------------------------------------------------------------------- # سرد جميع المهام (الأحدث أولًا) openclaw tasks list # التصفية حسب بيئة التشغيل أو الحالة openclaw tasks list --runtime acp openclaw tasks list --status running # عرض تفاصيل مهمة محددة (بالمعرّف أو معرّف التشغيل أو مفتاح الجلسة) openclaw tasks show # إلغاء مهمة قيد التشغيل (يُنهي الجلسة الفرعية) openclaw tasks cancel # تغيير سياسة الإشعارات لمهمة openclaw tasks notify state_changes # تشغيل تدقيق سلامة openclaw tasks audit # معاينة الصيانة أو تطبيقها openclaw tasks maintenance openclaw tasks maintenance --apply # فحص حالة TaskFlow openclaw tasks flow list openclaw tasks flow show openclaw tasks flow cancel [​](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D8%A7-%D8%A7%D9%84%D8%B0%D9%8A-%D9%8A%D9%8F%D9%86%D8%B4%D8%A6-%D9%85%D9%87%D9%85%D8%A9) ما الذي يُنشئ مهمة --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | المصدر | نوع بيئة التشغيل | وقت إنشاء سجل المهمة | سياسة الإشعارات الافتراضية | | --- | --- | --- | --- | | عمليات ACP في الخلفية | `acp` | تشغيل جلسة ACP فرعية | `done_only` | | تنظيم الوكلاء الفرعيين | `subagent` | تشغيل وكيل فرعي عبر `sessions_spawn` | `done_only` | | وظائف cron (كل الأنواع) | `cron` | كل تنفيذ لـ cron (الجلسة الرئيسية والمعزولة) | `silent` | | عمليات CLI | `cli` | أوامر `openclaw agent` التي تعمل عبر البوابة | `silent` | | وظائف وسائط الوكيل | `cli` | عمليات `video_generate` المدعومة بالجلسة | `silent` | تستخدم مهام cron الخاصة بالجلسة الرئيسية سياسة الإشعارات `silent` افتراضيًا — فهي تُنشئ سجلات للتتبّع ولكنها لا تولّد إشعارات. كما تستخدم مهام cron المعزولة أيضًا `silent` افتراضيًا، لكنها أكثر وضوحًا لأنها تعمل في جلستها الخاصة. تستخدم عمليات `video_generate` المدعومة بالجلسة أيضًا سياسة الإشعارات `silent`. ومع ذلك، فإنها تُنشئ سجلات مهام، لكن الاكتمال يُعاد إلى جلسة الوكيل الأصلية كتنبيه داخلي حتى يتمكّن الوكيل من كتابة رسالة المتابعة وإرفاق الفيديو المكتمل بنفسه. إذا فعّلت `tools.media.asyncCompletion.directSend`، فستحاول عمليات الاكتمال غير المتزامنة لـ `music_generate` و`video_generate` أولًا التسليم المباشر إلى القناة قبل الرجوع إلى مسار إيقاظ جلسة الطالب. وأثناء استمرار مهمة `video_generate` المدعومة بالجلسة، تعمل الأداة أيضًا كحاجز حماية: إذ إن استدعاءات `video_generate` المتكررة في الجلسة نفسها تُرجع حالة المهمة النشطة بدلًا من بدء توليد ثانٍ متزامن. استخدم `action: "status"` عندما تريد بحثًا صريحًا عن التقدّم/الحالة من جهة الوكيل. **ما الذي لا يُنشئ مهام:** * عمليات heartbeat — الجلسة الرئيسية؛ راجع [Heartbeat](https://docs.openclaw.ai/ar/gateway/heartbeat) * أدوار المحادثة التفاعلية العادية * الاستجابات المباشرة لـ `/command` [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%AF%D9%88%D8%B1%D8%A9-%D8%AD%D9%8A%D8%A7%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D9%85%D8%A9) دورة حياة المهمة ------------------------------------------------------------------------------------------------------------------------------------------------------------ | الحالة | ما الذي تعنيه | | --- | --- | | `queued` | أُنشئت وتنتظر بدء الوكيل | | `running` | دور الوكيل قيد التنفيذ الفعلي | | `succeeded` | اكتملت بنجاح | | `failed` | اكتملت مع حدوث خطأ | | `timed_out` | تجاوزت المهلة المكوَّنة | | `cancelled` | أوقفها المشغّل عبر `openclaw tasks cancel` | | `lost` | فقدت بيئة التشغيل حالة الارتكاز المعتمدة بعد فترة سماح مدتها 5 دقائق | تحدث الانتقالات تلقائيًا — عندما ينتهي تشغيل الوكيل المرتبط، تتحدّث حالة المهمة لتطابقه. تكون `lost` واعية ببيئة التشغيل: * مهام ACP: اختفت بيانات جلسة ACP الفرعية الداعمة. * مهام الوكيل الفرعي: اختفت الجلسة الفرعية الداعمة من مخزن الوكيل المستهدف. * مهام cron: لم يعد وقت تشغيل cron يتتبّع الوظيفة على أنها نشطة. * مهام CLI: تستخدم مهام الجلسات الفرعية المعزولة الجلسة الفرعية؛ أما مهام CLI المدعومة بالدردشة فتستخدم سياق التشغيل الحي المالك بدلًا من ذلك، لذلك فإن صفوف الجلسات العالقة للقناة/المجموعة/الرسائل المباشرة لا تُبقيها نشطة. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85-%D9%88%D8%A7%D9%84%D8%A5%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA) التسليم والإشعارات ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- عندما تصل المهمة إلى حالة نهائية، يقوم OpenClaw بإخطارك. هناك مساران للتسليم: **التسليم المباشر** — إذا كان للمهمة هدف قناة (أي `requesterOrigin`)، تُرسل رسالة الاكتمال مباشرة إلى تلك القناة (Telegram أو Discord أو Slack أو غيرها). وبالنسبة إلى عمليات اكتمال الوكلاء الفرعيين، يحافظ OpenClaw أيضًا على توجيه الخيط/الموضوع المرتبط عند توفره، ويمكنه ملء `to` / الحساب المفقود من المسار المخزَّن في جلسة الطالب (`lastChannel` / `lastTo` / `lastAccountId`) قبل التخلي عن التسليم المباشر. **التسليم المُدرَج في قائمة انتظار الجلسة** — إذا فشل التسليم المباشر أو لم يكن هناك أصل مضبوط، يُوضَع التحديث في قائمة الانتظار كحدث نظام في جلسة الطالب ويظهر في heartbeat التالي. يؤدي اكتمال المهمة إلى تشغيل إيقاظ heartbeat فوري حتى ترى النتيجة بسرعة — لا تحتاج إلى انتظار نبضة heartbeat المجدولة التالية. وهذا يعني أن سير العمل المعتاد يعتمد على الدفع: ابدأ العمل المنفصل مرة واحدة، ثم دع وقت التشغيل يوقظك أو يخطرك عند الاكتمال. لا تستطلع حالة المهمة إلا عندما تحتاج إلى التصحيح أو التدخل أو تدقيق صريح. ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%B3%D9%8A%D8%A7%D8%B3%D8%A7%D8%AA-%D8%A7%D9%84%D8%A5%D8%B4%D8%B9%D8%A7%D8%B1%D8%A7%D8%AA) سياسات الإشعارات تحكّم في مقدار ما تريد سماعه عن كل مهمة: | السياسة | ما الذي يتم تسليمه | | --- | --- | | `done_only` (افتراضي) | الحالة النهائية فقط (succeeded أو failed أو غير ذلك) — **وهذا هو الافتراضي** | | `state_changes` | كل انتقال حالة وتحديث تقدّم | | `silent` | لا شيء على الإطلاق | غيّر السياسة أثناء تشغيل المهمة: openclaw tasks notify state_changes [​](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D8%B1%D8%AC%D8%B9-cli) مرجع CLI ------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-list) `tasks list` openclaw tasks list [--runtime ] [--status ] [--json] أعمدة المخرجات: معرّف المهمة، النوع، الحالة، التسليم، معرّف التشغيل، الجلسة الفرعية، الملخّص. ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-show) `tasks show` openclaw tasks show يقبل رمز البحث معرّف المهمة أو معرّف التشغيل أو مفتاح الجلسة. ويعرض السجل الكامل بما في ذلك التوقيت، وحالة التسليم، والخطأ، والملخّص النهائي. ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-cancel) `tasks cancel` openclaw tasks cancel بالنسبة إلى مهام ACP ومهام الوكيل الفرعي، يؤدي هذا إلى إنهاء الجلسة الفرعية. أما بالنسبة إلى المهام المتتبَّعة عبر CLI، فيُسجَّل الإلغاء في سجل المهام (ولا يوجد مقبض منفصل لوقت تشغيل فرعي). وتنتقل الحالة إلى `cancelled` ويُرسل إشعار تسليم عند الاقتضاء. ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-notify) `tasks notify` openclaw tasks notify ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-audit) `tasks audit` openclaw tasks audit [--json] يُظهر المشكلات التشغيلية. كما تظهر النتائج أيضًا في `openclaw status` عند اكتشاف مشكلات. | النتيجة | الخطورة | المُشغِّل | | --- | --- | --- | | `stale_queued` | warn | بقيت في حالة انتظار لأكثر من 10 دقائق | | `stale_running` | error | بقيت في حالة تشغيل لأكثر من 30 دقيقة | | `lost` | error | اختفت ملكية المهمة المدعومة ببيئة التشغيل | | `delivery_failed` | warn | فشل التسليم وسياسة الإشعارات ليست `silent` | | `missing_cleanup` | warn | مهمة نهائية بلا طابع زمني للتنظيف | | `inconsistent_timestamps` | warn | انتهاك في التسلسل الزمني (مثلًا انتهت قبل أن تبدأ) | ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-maintenance) `tasks maintenance` openclaw tasks maintenance [--json] openclaw tasks maintenance --apply [--json] استخدم هذا لمعاينة أو تطبيق التسوية، ووضع طابع زمني للتنظيف، والتقليم للمهام وحالة Task Flow. التسوية واعية ببيئة التشغيل: * تتحقق مهام ACP/الوكيل الفرعي من الجلسة الفرعية الداعمة. * تتحقق مهام cron مما إذا كان وقت تشغيل cron لا يزال يملك الوظيفة. * تتحقق مهام CLI المدعومة بالدردشة من سياق التشغيل الحي المالك، وليس فقط من صف جلسة الدردشة. تنظيف الاكتمال واعٍ أيضًا ببيئة التشغيل: * يجري اكتمال الوكيل الفرعي إغلاقًا بأفضل جهد ممكن لعلامات تبويب/عمليات المتصفح المتتبَّعة الخاصة بالجلسة الفرعية قبل متابعة تنظيف الإعلان. * يجري اكتمال cron المعزول إغلاقًا بأفضل جهد ممكن لعلامات تبويب/عمليات المتصفح المتتبَّعة الخاصة بجلسة cron قبل إنهاء التشغيل بالكامل. * ينتظر تسليم cron المعزول متابعة الوكيل الفرعي التابع عند الحاجة ويمنع نص الإقرار القديم من الأصل بدلًا من إعلانه. * يفضّل تسليم اكتمال الوكيل الفرعي أحدث نص مرئي من المساعد؛ وإذا كان فارغًا، فإنه يرجع إلى أحدث نص من الأداة/نتيجة الأداة بعد تنقيته، ويمكن لعمليات استدعاء الأدوات التي تنتهي بالمهلة فقط أن تُختصر إلى ملخّص قصير للتقدّم الجزئي. * لا تُخفي إخفاقات التنظيف النتيجة الحقيقية للمهمة. ### [​](https://docs.openclaw.ai/ar/automation/tasks#tasks-flow-list|show|cancel) `tasks flow list|show|cancel` openclaw tasks flow list [--status ] [--json] openclaw tasks flow show [--json] openclaw tasks flow cancel استخدم هذه الأوامر عندما يكون Task Flow المنظِّم هو ما يهمك بدلًا من سجل مهمة خلفية فردي. [​](https://docs.openclaw.ai/ar/automation/tasks#%D9%84%D9%88%D8%AD%D8%A9-%D9%85%D9%87%D8%A7%D9%85-%D8%A7%D9%84%D8%AF%D8%B1%D8%AF%D8%B4%D8%A9-/tasks) لوحة مهام الدردشة (`/tasks`) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- استخدم `/tasks` في أي جلسة دردشة لرؤية المهام في الخلفية المرتبطة بتلك الجلسة. تعرض اللوحة المهام النشطة والتي اكتملت مؤخرًا مع بيئة التشغيل، والحالة، والتوقيت، وتفاصيل التقدّم أو الخطأ. عندما لا تحتوي الجلسة الحالية على مهام مرتبطة مرئية، يعود `/tasks` إلى عدد المهام المحلية الخاصة بالوكيل بحيث تظل تحصل على نظرة عامة من دون كشف تفاصيل الجلسات الأخرى. للحصول على سجل المشغّل الكامل، استخدم CLI: `openclaw tasks list`. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D9%83%D8%A7%D9%85%D9%84-%D9%85%D8%B9-%D8%A7%D9%84%D8%AD%D8%A7%D9%84%D8%A9-%D8%B6%D8%BA%D8%B7-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) التكامل مع الحالة (ضغط المهام) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يتضمن `openclaw status` ملخّصًا سريعًا للمهام: Tasks: 3 queued · 2 running · 1 issues يبلّغ الملخّص عن: * **active** — عدد `queued` + `running` * **failures** — عدد `failed` + `timed_out` + `lost` * **byRuntime** — تقسيم حسب `acp` و`subagent` و`cron` و`cli` يستخدم كل من `/status` وأداة `session_status` لقطة مهام واعية بالتنظيف: تُفضَّل المهام النشطة، وتُخفى الصفوف المكتملة القديمة، ولا تظهر الإخفاقات الأخيرة إلا عندما لا يبقى أي عمل نشط. وهذا يُبقي بطاقة الحالة مركّزة على ما يهم الآن. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%AA%D8%AE%D8%B2%D9%8A%D9%86-%D9%88%D8%A7%D9%84%D8%B5%D9%8A%D8%A7%D9%86%D8%A9) التخزين والصيانة ----------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D9%85%D9%83%D8%A7%D9%86-%D9%88%D8%AC%D9%88%D8%AF-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) مكان وجود المهام تُحفَظ سجلات المهام في SQLite في: $OPENCLAW_STATE_DIR/tasks/runs.sqlite يُحمَّل السجل إلى الذاكرة عند بدء تشغيل البوابة ويزامن عمليات الكتابة إلى SQLite لضمان الاستمرارية عبر إعادة التشغيل. ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D8%B5%D9%8A%D8%A7%D9%86%D8%A9-%D8%A7%D9%84%D8%AA%D9%84%D9%82%D8%A7%D8%A6%D9%8A%D8%A9) الصيانة التلقائية يعمل مُنظِّف كل **60 ثانية** ويتعامل مع ثلاثة أمور: 1. **التسوية** — يتحقق مما إذا كانت المهام النشطة لا تزال تملك ارتكازًا معتمدًا من بيئة التشغيل. تستخدم مهام ACP/الوكيل الفرعي حالة الجلسة الفرعية، وتستخدم مهام cron ملكية الوظيفة النشطة، وتستخدم مهام CLI المدعومة بالدردشة سياق التشغيل المالك. إذا اختفت حالة الارتكاز هذه لأكثر من 5 دقائق، تُعلَّم المهمة على أنها `lost`. 2. **وضع طابع زمني للتنظيف** — يضبط طابعًا زمنيًا `cleanupAfter` على المهام النهائية (`endedAt + 7 days`). 3. **التقليم** — يحذف السجلات التي تجاوزت تاريخ `cleanupAfter` الخاص بها. **الاحتفاظ**: تُحفَظ سجلات المهام النهائية لمدة **7 أيام**، ثم تُقلَّم تلقائيًا. لا حاجة إلى أي إعداد. [​](https://docs.openclaw.ai/ar/automation/tasks#%D9%83%D9%8A%D9%81%D9%8A%D8%A9-%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D8%A8%D8%A7%D9%84%D8%A3%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D8%A3%D8%AE%D8%B1%D9%89) كيفية ارتباط المهام بالأنظمة الأخرى --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88task-flow) المهام وTask Flow يشكّل [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow) طبقة تنظيم التدفق فوق المهام في الخلفية. قد ينسّق تدفق واحد عدة مهام على مدى عمره باستخدام أوضاع مزامنة مُدارة أو معكوسة. استخدم `openclaw tasks` لفحص سجلات المهام الفردية، واستخدم `openclaw tasks flow` لفحص التدفق المنظِّم. راجع [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow) للحصول على التفاصيل. ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88cron) المهام وcron يوجد **تعريف** وظيفة cron في `~/.openclaw/cron/jobs.json`. يُنشئ **كل** تنفيذ لـ cron سجل مهمة — سواء في الجلسة الرئيسية أو المعزولة. تستخدم مهام cron الخاصة بالجلسة الرئيسية سياسة الإشعارات `silent` افتراضيًا حتى تتتبّع من دون توليد إشعارات. راجع [وظائف Cron](https://docs.openclaw.ai/ar/automation/cron-jobs) . ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88heartbeat) المهام وheartbeat عمليات تشغيل heartbeat هي أدوار في الجلسة الرئيسية — ولا تُنشئ سجلات مهام. وعندما تكتمل مهمة، يمكنها تشغيل إيقاظ heartbeat حتى ترى النتيجة بسرعة. راجع [Heartbeat](https://docs.openclaw.ai/ar/gateway/heartbeat) . ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) المهام والجلسات قد تشير المهمة إلى `childSessionKey` (حيث يُشغَّل العمل) و`requesterSessionKey` (من الذي بدأها). الجلسات هي سياق المحادثة؛ أما المهام فهي طبقة تتبّع النشاط فوق ذلك. ### [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85-%D9%88%D8%B9%D9%85%D9%84%D9%8A%D8%A7%D8%AA-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84) المهام وعمليات تشغيل الوكيل يرتبط `runId` الخاص بالمهمة بعملية تشغيل الوكيل التي تنفّذ العمل. وتعمل أحداث دورة حياة الوكيل (البدء، والانتهاء، والخطأ) على تحديث حالة المهمة تلقائيًا — ولا تحتاج إلى إدارة دورة الحياة يدويًا. [​](https://docs.openclaw.ai/ar/automation/tasks#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ------------------------------------------------------------------------------------------- * [الأتمتة والمهام](https://docs.openclaw.ai/ar/automation) — جميع آليات الأتمتة بنظرة سريعة * [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow) — تنظيم التدفق فوق المهام * [المهام المجدولة](https://docs.openclaw.ai/ar/automation/cron-jobs) — جدولة العمل في الخلفية * [Heartbeat](https://docs.openclaw.ai/ar/gateway/heartbeat) — أدوار دورية في الجلسة الرئيسية * [CLI: المهام](https://docs.openclaw.ai/cli/index#tasks) — مرجع أوامر CLI [المهام المجدولة](https://docs.openclaw.ai/ar/automation/cron-jobs) [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow) ⌘I --- # الأوامر الدائمة - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/automation/standing-orders#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Automation & Tasks الأوامر الدائمة [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [الأوامر الدائمة](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) * [لماذا الأوامر الدائمة؟](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9%D8%9F) * [كيف تعمل](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84) * [مكونات الأمر الدائم](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%85%D9%83%D9%88%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85) * [الأوامر الدائمة + مهام Cron](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9-%2B-%D9%85%D9%87%D8%A7%D9%85-cron) * [أمثلة](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A3%D9%85%D8%AB%D9%84%D8%A9) * [المثال 1: المحتوى ووسائل التواصل الاجتماعي (دورة أسبوعية)](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-1-%D8%A7%D9%84%D9%85%D8%AD%D8%AA%D9%88%D9%89-%D9%88%D9%88%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D8%B5%D9%84-%D8%A7%D9%84%D8%A7%D8%AC%D8%AA%D9%85%D8%A7%D8%B9%D9%8A-%D8%AF%D9%88%D8%B1%D8%A9-%D8%A3%D8%B3%D8%A8%D9%88%D8%B9%D9%8A%D8%A9) * [المثال 2: العمليات المالية (تعمل بالمحفزات الحدثية)](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-2-%D8%A7%D9%84%D8%B9%D9%85%D9%84%D9%8A%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%A7%D9%84%D9%8A%D8%A9-%D8%AA%D8%B9%D9%85%D9%84-%D8%A8%D8%A7%D9%84%D9%85%D8%AD%D9%81%D8%B2%D8%A7%D8%AA-%D8%A7%D9%84%D8%AD%D8%AF%D8%AB%D9%8A%D8%A9) * [المثال 3: المراقبة والتنبيهات (مستمرة)](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-3-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87%D8%A7%D8%AA-%D9%85%D8%B3%D8%AA%D9%85%D8%B1%D8%A9) * [نمط التنفيذ-التحقق-الإبلاغ](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%86%D9%85%D8%B7-%D8%A7%D9%84%D8%AA%D9%86%D9%81%D9%8A%D8%B0-%D8%A7%D9%84%D8%AA%D8%AD%D9%82%D9%82-%D8%A7%D9%84%D8%A5%D8%A8%D9%84%D8%A7%D8%BA) * [بنية متعددة البرامج](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A8%D9%86%D9%8A%D8%A9-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF%D8%A9-%D8%A7%D9%84%D8%A8%D8%B1%D8%A7%D9%85%D8%AC) * [أفضل الممارسات](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) * [افعل](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%81%D8%B9%D9%84) * [تجنب](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%AA%D8%AC%D9%86%D8%A8) * [ذو صلة](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) الأوامر الدائمة ==================================================================================================================================================================== تمنح الأوامر الدائمة وكيلك **سلطة تشغيل دائمة** للبرامج المحددة. وبدلًا من إعطاء تعليمات لكل مهمة على حدة في كل مرة، فإنك تعرّف برامج ذات نطاق واضح ومشغلات وقواعد تصعيد — وينفذ الوكيل العمل ذاتيًا ضمن تلك الحدود. وهذا هو الفرق بين أن تقول لمساعدك “أرسل التقرير الأسبوعي” كل يوم جمعة، وبين منحه سلطة دائمة: “أنت مسؤول عن التقرير الأسبوعي. اجمعه كل يوم جمعة، وأرسله، ولا تصعّد إلا إذا بدا أن هناك شيئًا غير صحيح.” [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9%D8%9F) لماذا الأوامر الدائمة؟ ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- **من دون أوامر دائمة:** * يجب عليك مطالبة الوكيل بكل مهمة * يظل الوكيل في وضع خمول بين الطلبات * يُنسى العمل الروتيني أو يتأخر * تصبح أنت عنق الزجاجة **مع الأوامر الدائمة:** * ينفذ الوكيل العمل ذاتيًا ضمن حدود محددة * يتم إنجاز العمل الروتيني في موعده من دون مطالبة * لا تتدخل إلا في الاستثناءات وحالات الموافقة * يستثمر الوكيل وقت الخمول بشكل منتج [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D9%85%D9%84) كيف تعمل ------------------------------------------------------------------------------------------------------------------- تُعرَّف الأوامر الدائمة في ملفات [مساحة عمل الوكيل](https://docs.openclaw.ai/concepts/agent-workspace) الخاصة بك. والنهج الموصى به هو تضمينها مباشرةً في `AGENTS.md` (الذي يُحقن تلقائيًا في كل جلسة) حتى تكون دائمًا ضمن سياق الوكيل. وبالنسبة إلى الإعدادات الأكبر، يمكنك أيضًا وضعها في ملف مخصص مثل `standing-orders.md` والإشارة إليه من `AGENTS.md`. يحدد كل برنامج ما يلي: 1. **النطاق** — ما الذي يملك الوكيل صلاحية القيام به 2. **المشغلات** — متى يتم التنفيذ (جدول زمني أو حدث أو شرط) 3. **بوابات الموافقة** — ما الذي يتطلب اعتمادًا بشريًا قبل التنفيذ 4. **قواعد التصعيد** — متى يجب التوقف وطلب المساعدة يحمّل الوكيل هذه التعليمات في كل جلسة عبر ملفات تمهيد مساحة العمل (راجع [مساحة عمل الوكيل](https://docs.openclaw.ai/concepts/agent-workspace) للحصول على القائمة الكاملة للملفات المحقونة تلقائيًا) وينفذ وفقًا لها، مع دمجها مع [مهام cron](https://docs.openclaw.ai/automation/cron-jobs) لفرض التنفيذ المعتمد على الوقت. ضع الأوامر الدائمة في `AGENTS.md` لضمان تحميلها في كل جلسة. يقوم تمهيد مساحة العمل تلقائيًا بحقن `AGENTS.md` و`SOUL.md` و`TOOLS.md` و`IDENTITY.md` و`USER.md` و`HEARTBEAT.md` و`BOOTSTRAP.md` و`MEMORY.md` — لكنه لا يحقن الملفات العشوائية داخل الأدلة الفرعية. [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%85%D9%83%D9%88%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85) مكونات الأمر الدائم ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ## Program: Weekly Status Report **Authority:** Compile data, generate report, deliver to stakeholders **Trigger:** Every Friday at 4 PM (enforced via cron job) **Approval gate:** None for standard reports. Flag anomalies for human review. **Escalation:** If data source is unavailable or metrics look unusual (>2σ from norm) ### Execution Steps 1. Pull metrics from configured sources 2. Compare to prior week and targets 3. Generate report in Reports/weekly/YYYY-MM-DD.md 4. Deliver summary via configured channel 5. Log completion to Agent/Logs/ ### What NOT to Do - Do not send reports to external parties - Do not modify source data - Do not skip delivery if metrics look bad — report accurately [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9-+-%D9%85%D9%87%D8%A7%D9%85-cron) الأوامر الدائمة + مهام Cron ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- تحدد الأوامر الدائمة **ما الذي** يملك الوكيل صلاحية فعله. وتحدد [مهام Cron](https://docs.openclaw.ai/automation/cron-jobs) **متى** يحدث ذلك. وهما يعملان معًا: Standing Order: "You own the daily inbox triage" ↓ Cron Job (8 AM daily): "Execute inbox triage per standing orders" ↓ Agent: Reads standing orders → executes steps → reports results يجب أن تشير رسالة مهمة cron إلى الأمر الدائم بدلًا من تكراره: openclaw cron add \ --name daily-inbox-triage \ --cron "0 8 * * 1-5" \ --tz America/New_York \ --timeout-seconds 300 \ --announce \ --channel bluebubbles \ --to "+1XXXXXXXXXX" \ --message "Execute daily inbox triage per standing orders. Check mail for new alerts. Parse, categorize, and persist each item. Report summary to owner. Escalate unknowns." [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A3%D9%85%D8%AB%D9%84%D8%A9) أمثلة --------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-1-%D8%A7%D9%84%D9%85%D8%AD%D8%AA%D9%88%D9%89-%D9%88%D9%88%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D8%B5%D9%84-%D8%A7%D9%84%D8%A7%D8%AC%D8%AA%D9%85%D8%A7%D8%B9%D9%8A-%D8%AF%D9%88%D8%B1%D8%A9-%D8%A3%D8%B3%D8%A8%D9%88%D8%B9%D9%8A%D8%A9) المثال 1: المحتوى ووسائل التواصل الاجتماعي (دورة أسبوعية) ## Program: Content & Social Media **Authority:** Draft content, schedule posts, compile engagement reports **Approval gate:** All posts require owner review for first 30 days, then standing approval **Trigger:** Weekly cycle (Monday review → mid-week drafts → Friday brief) ### Weekly Cycle - **Monday:** Review platform metrics and audience engagement - **Tuesday–Thursday:** Draft social posts, create blog content - **Friday:** Compile weekly marketing brief → deliver to owner ### Content Rules - Voice must match the brand (see SOUL.md or brand voice guide) - Never identify as AI in public-facing content - Include metrics when available - Focus on value to audience, not self-promotion ### [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-2-%D8%A7%D9%84%D8%B9%D9%85%D9%84%D9%8A%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%A7%D9%84%D9%8A%D8%A9-%D8%AA%D8%B9%D9%85%D9%84-%D8%A8%D8%A7%D9%84%D9%85%D8%AD%D9%81%D8%B2%D8%A7%D8%AA-%D8%A7%D9%84%D8%AD%D8%AF%D8%AB%D9%8A%D8%A9) المثال 2: العمليات المالية (تعمل بالمحفزات الحدثية) ## Program: Financial Processing **Authority:** Process transaction data, generate reports, send summaries **Approval gate:** None for analysis. Recommendations require owner approval. **Trigger:** New data file detected OR scheduled monthly cycle ### When New Data Arrives 1. Detect new file in designated input directory 2. Parse and categorize all transactions 3. Compare against budget targets 4. Flag: unusual items, threshold breaches, new recurring charges 5. Generate report in designated output directory 6. Deliver summary to owner via configured channel ### Escalation Rules - Single item > $500: immediate alert - Category > budget by 20%: flag in report - Unrecognizable transaction: ask owner for categorization - Failed processing after 2 retries: report failure, do not guess ### [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-3-%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D9%82%D8%A8%D8%A9-%D9%88%D8%A7%D9%84%D8%AA%D9%86%D8%A8%D9%8A%D9%87%D8%A7%D8%AA-%D9%85%D8%B3%D8%AA%D9%85%D8%B1%D8%A9) المثال 3: المراقبة والتنبيهات (مستمرة) ## Program: System Monitoring **Authority:** Check system health, restart services, send alerts **Approval gate:** Restart services automatically. Escalate if restart fails twice. **Trigger:** Every heartbeat cycle ### Checks - Service health endpoints responding - Disk space above threshold - Pending tasks not stale (>24 hours) - Delivery channels operational ### Response Matrix | Condition | Action | Escalate? | | ---------------- | ------------------------ | ------------------------ | | Service down | Restart automatically | Only if restart fails 2x | | Disk space < 10% | Alert owner | Yes | | Stale task > 24h | Remind owner | No | | Channel offline | Log and retry next cycle | If offline > 2 hours | [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D9%86%D9%85%D8%B7-%D8%A7%D9%84%D8%AA%D9%86%D9%81%D9%8A%D8%B0-%D8%A7%D9%84%D8%AA%D8%AD%D9%82%D9%82-%D8%A7%D9%84%D8%A5%D8%A8%D9%84%D8%A7%D8%BA) نمط التنفيذ-التحقق-الإبلاغ --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- تعمل الأوامر الدائمة بأفضل شكل عند دمجها مع انضباط صارم في التنفيذ. يجب أن تتبع كل مهمة في أمر دائم هذه الحلقة: 1. **التنفيذ** — نفّذ العمل الفعلي (لا تكتفِ بالإقرار بالتعليمات) 2. **التحقق** — أكّد أن النتيجة صحيحة (الملف موجود، الرسالة تم تسليمها، البيانات جرى تحليلها) 3. **الإبلاغ** — أخبر المالك بما تم إنجازه وما الذي تم التحقق منه ### Execution Rules - Every task follows Execute-Verify-Report. No exceptions. - "I'll do that" is not execution. Do it, then report. - "Done" without verification is not acceptable. Prove it. - If execution fails: retry once with adjusted approach. - If still fails: report failure with diagnosis. Never silently fail. - Never retry indefinitely — 3 attempts max, then escalate. يمنع هذا النمط أكثر أوضاع فشل الوكلاء شيوعًا: الإقرار بالمهمة من دون إكمالها. [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A8%D9%86%D9%8A%D8%A9-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF%D8%A9-%D8%A7%D9%84%D8%A8%D8%B1%D8%A7%D9%85%D8%AC) بنية متعددة البرامج ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- بالنسبة إلى الوكلاء الذين يديرون عدة مجالات، نظّم الأوامر الدائمة كبرامج منفصلة ذات حدود واضحة: # Standing Orders ## Program 1: [Domain A] (Weekly) ... ## Program 2: [Domain B] (Monthly + On-Demand) ... ## Program 3: [Domain C] (As-Needed) ... ## Escalation Rules (All Programs) - [Common escalation criteria] - [Approval gates that apply across programs] يجب أن يكون لكل برنامج: * **وتيرة تشغيل** خاصة به (أسبوعية، شهرية، مدفوعة بالأحداث، مستمرة) * **بوابات موافقة** خاصة به (بعض البرامج تحتاج إلى إشراف أكبر من غيرها) * **حدود** واضحة (يجب أن يعرف الوكيل أين ينتهي برنامج ويبدأ آخر) [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) أفضل الممارسات ------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%A7%D9%81%D8%B9%D9%84) افعل * ابدأ بسلطة محدودة ووسّعها مع بناء الثقة * حدّد بوابات موافقة صريحة للإجراءات عالية المخاطر * أدرج أقسام “ما الذي لا يجب فعله” — فالحدود مهمة بقدر أهمية الأذونات * ادمجها مع مهام cron لتنفيذ موثوق معتمد على الوقت * راجع سجلات الوكيل أسبوعيًا للتحقق من الالتزام بالأوامر الدائمة * حدّث الأوامر الدائمة مع تطور احتياجاتك — فهي وثائق حية ### [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%AA%D8%AC%D9%86%D8%A8) تجنب * منح سلطة واسعة من اليوم الأول (“افعل ما تراه أفضل”) * تجاوز قواعد التصعيد — كل برنامج يحتاج إلى بند “متى تتوقف وتسأل” * افتراض أن الوكيل سيتذكر التعليمات الشفهية — ضع كل شيء في الملف * خلط المجالات في برنامج واحد — برامج منفصلة لمجالات منفصلة * نسيان فرض التنفيذ باستخدام مهام cron — فالأوامر الدائمة من دون مشغلات تصبح مجرد اقتراحات [​](https://docs.openclaw.ai/ar/automation/standing-orders#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ----------------------------------------------------------------------------------------------------- * [الأتمتة والمهام](https://docs.openclaw.ai/automation) — نظرة شاملة على جميع آليات الأتمتة * [مهام Cron](https://docs.openclaw.ai/automation/cron-jobs) — فرض الجدولة للأوامر الدائمة * [Hooks](https://docs.openclaw.ai/automation/hooks) — نصوص برمجية مدفوعة بالأحداث لأحداث دورة حياة الوكيل * [Webhooks](https://docs.openclaw.ai/automation/cron-jobs#webhooks) — مشغلات أحداث HTTP واردة * [مساحة عمل الوكيل](https://docs.openclaw.ai/concepts/agent-workspace) — المكان الذي تعيش فيه الأوامر الدائمة، بما في ذلك القائمة الكاملة لملفات التمهيد المحقونة تلقائيًا (`AGENTS.md` و`SOUL.md` وغيرها) [Task Flow](https://docs.openclaw.ai/ar/automation/taskflow) [الخطافات](https://docs.openclaw.ai/ar/automation/hooks) ⌘I --- # مجموعات البث - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/channels/broadcast-groups#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Configuration مجموعات البث [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [مجموعات البث](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D8%AB) * [نظرة عامة](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) * [حالات الاستخدام](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AD%D8%A7%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85) * [1\. فرق الوكلاء المتخصصة](https://docs.openclaw.ai/ar/channels/broadcast-groups#1-%D9%81%D8%B1%D9%82-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D8%A7%D9%84%D9%85%D8%AA%D8%AE%D8%B5%D8%B5%D8%A9) * [2\. دعم متعدد اللغات](https://docs.openclaw.ai/ar/channels/broadcast-groups#2-%D8%AF%D8%B9%D9%85-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%84%D8%BA%D8%A7%D8%AA) * [3\. سير عمل ضمان الجودة](https://docs.openclaw.ai/ar/channels/broadcast-groups#3-%D8%B3%D9%8A%D8%B1-%D8%B9%D9%85%D9%84-%D8%B6%D9%85%D8%A7%D9%86-%D8%A7%D9%84%D8%AC%D9%88%D8%AF%D8%A9) * [4\. أتمتة المهام](https://docs.openclaw.ai/ar/channels/broadcast-groups#4-%D8%A3%D8%AA%D9%85%D8%AA%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) * [التكوين](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) * [الإعداد الأساسي](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A) * [استراتيجية المعالجة](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D8%B3%D8%AA%D8%B1%D8%A7%D8%AA%D9%8A%D8%AC%D9%8A%D8%A9-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC%D8%A9) * [بالتوازي (الافتراضي)](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A8%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D8%B2%D9%8A-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A) * [بالتسلسل](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A8%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D8%B3%D9%84) * [مثال كامل](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AB%D8%A7%D9%84-%D9%83%D8%A7%D9%85%D9%84) * [كيف يعمل](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84) * [تدفق الرسائل](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AA%D8%AF%D9%81%D9%82-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) * [عزل الجلسات](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%B9%D8%B2%D9%84-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) * [مثال: جلسات معزولة](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AB%D8%A7%D9%84-%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-%D9%85%D8%B9%D8%B2%D9%88%D9%84%D8%A9) * [أفضل الممارسات](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) * [1\. أبقِ الوكلاء مركّزين](https://docs.openclaw.ai/ar/channels/broadcast-groups#1-%D8%A3%D8%A8%D9%82%D9%90-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D9%85%D8%B1%D9%83%D9%91%D8%B2%D9%8A%D9%86) * [2\. استخدم أسماء وصفية](https://docs.openclaw.ai/ar/channels/broadcast-groups#2-%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D9%85-%D8%A3%D8%B3%D9%85%D8%A7%D8%A1-%D9%88%D8%B5%D9%81%D9%8A%D8%A9) * [3\. كوّن وصولًا مختلفًا إلى الأدوات](https://docs.openclaw.ai/ar/channels/broadcast-groups#3-%D9%83%D9%88%D9%91%D9%86-%D9%88%D8%B5%D9%88%D9%84%D9%8B%D8%A7-%D9%85%D8%AE%D8%AA%D9%84%D9%81%D9%8B%D8%A7-%D8%A5%D9%84%D9%89-%D8%A7%D9%84%D8%A3%D8%AF%D9%88%D8%A7%D8%AA) * [4\. راقب الأداء](https://docs.openclaw.ai/ar/channels/broadcast-groups#4-%D8%B1%D8%A7%D9%82%D8%A8-%D8%A7%D9%84%D8%A3%D8%AF%D8%A7%D8%A1) * [5\. تعامل مع الإخفاقات بسلاسة](https://docs.openclaw.ai/ar/channels/broadcast-groups#5-%D8%AA%D8%B9%D8%A7%D9%85%D9%84-%D9%85%D8%B9-%D8%A7%D9%84%D8%A5%D8%AE%D9%81%D8%A7%D9%82%D8%A7%D8%AA-%D8%A8%D8%B3%D9%84%D8%A7%D8%B3%D8%A9) * [التوافق](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D9%81%D9%82) * [المزوّدون](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%B2%D9%88%D9%91%D8%AF%D9%88%D9%86) * [التوجيه](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [الوكلاء لا يردون](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D9%84%D8%A7-%D9%8A%D8%B1%D8%AF%D9%88%D9%86) * [وكيل واحد فقط يرد](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%88%D9%83%D9%8A%D9%84-%D9%88%D8%A7%D8%AD%D8%AF-%D9%81%D9%82%D8%B7-%D9%8A%D8%B1%D8%AF) * [مشكلات الأداء](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%B4%D9%83%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D8%AF%D8%A7%D8%A1) * [أمثلة](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A3%D9%85%D8%AB%D9%84%D8%A9) * [المثال 1: فريق مراجعة الشيفرة](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-1-%D9%81%D8%B1%D9%8A%D9%82-%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D8%B4%D9%8A%D9%81%D8%B1%D8%A9) * [المثال 2: دعم متعدد اللغات](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-2-%D8%AF%D8%B9%D9%85-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%84%D8%BA%D8%A7%D8%AA) * [مرجع API](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%B1%D8%AC%D8%B9-api) * [مخطط التكوين](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AE%D8%B7%D8%B7-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) * [الحقول](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AD%D9%82%D9%88%D9%84) * [القيود](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%82%D9%8A%D9%88%D8%AF) * [تحسينات مستقبلية](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AA%D8%AD%D8%B3%D9%8A%D9%86%D8%A7%D8%AA-%D9%85%D8%B3%D8%AA%D9%82%D8%A8%D9%84%D9%8A%D8%A9) * [راجع أيضًا](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%B1%D8%A7%D8%AC%D8%B9-%D8%A3%D9%8A%D8%B6%D9%8B%D8%A7) [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D8%AB) مجموعات البث ============================================================================================================================================== **الحالة:** تجريبية **الإصدار:** أضيفت في 2026.1.9 [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) نظرة عامة ------------------------------------------------------------------------------------------------------------------------- تتيح مجموعات البث لعدة وكلاء معالجة الرسالة نفسها والرد عليها في الوقت نفسه. يتيح لك ذلك إنشاء فرق وكلاء متخصصة تعمل معًا داخل مجموعة WhatsApp واحدة أو رسالة خاصة — وكل ذلك باستخدام رقم هاتف واحد. النطاق الحالي: **WhatsApp فقط** (قناة الويب). تُقيَّم مجموعات البث بعد قوائم السماح الخاصة بالقنوات وقواعد تفعيل المجموعات. في مجموعات WhatsApp، يعني هذا أن عمليات البث تحدث عندما يكون OpenClaw سيرد عادةً (على سبيل المثال: عند الإشارة، حسب إعدادات مجموعتك). [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AD%D8%A7%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85) حالات الاستخدام ------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#1-%D9%81%D8%B1%D9%82-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D8%A7%D9%84%D9%85%D8%AA%D8%AE%D8%B5%D8%B5%D8%A9) 1\. فرق الوكلاء المتخصصة انشر عدة وكلاء بمسؤوليات محددة ومركزة: Group: "Development Team" Agents: - CodeReviewer (reviews code snippets) - DocumentationBot (generates docs) - SecurityAuditor (checks for vulnerabilities) - TestGenerator (suggests test cases) يعالج كل وكيل الرسالة نفسها ويقدم منظوره المتخصص. ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#2-%D8%AF%D8%B9%D9%85-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%84%D8%BA%D8%A7%D8%AA) 2\. دعم متعدد اللغات Group: "International Support" Agents: - Agent_EN (responds in English) - Agent_DE (responds in German) - Agent_ES (responds in Spanish) ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#3-%D8%B3%D9%8A%D8%B1-%D8%B9%D9%85%D9%84-%D8%B6%D9%85%D8%A7%D9%86-%D8%A7%D9%84%D8%AC%D9%88%D8%AF%D8%A9) 3\. سير عمل ضمان الجودة Group: "Customer Support" Agents: - SupportAgent (provides answer) - QAAgent (reviews quality, only responds if issues found) ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#4-%D8%A3%D8%AA%D9%85%D8%AA%D8%A9-%D8%A7%D9%84%D9%85%D9%87%D8%A7%D9%85) 4\. أتمتة المهام Group: "Project Management" Agents: - TaskTracker (updates task database) - TimeLogger (logs time spent) - ReportGenerator (creates summaries) [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) التكوين ---------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D8%B3%D8%A7%D8%B3%D9%8A) الإعداد الأساسي أضف قسم `broadcast` على المستوى الأعلى (بجانب `bindings`). المفاتيح هي معرّفات نظير WhatsApp: * محادثات المجموعات: group JID (مثل `120363403215116621@g.us`) * الرسائل الخاصة: رقم هاتف بتنسيق E.164 (مثل `+15551234567`) { "broadcast": { "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"] } } **النتيجة:** عندما يكون OpenClaw سيرد في هذه الدردشة، سيشغّل الوكلاء الثلاثة جميعهم. ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D8%B3%D8%AA%D8%B1%D8%A7%D8%AA%D9%8A%D8%AC%D9%8A%D8%A9-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC%D8%A9) استراتيجية المعالجة تحكم في كيفية معالجة الوكلاء للرسائل: #### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A8%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D8%B2%D9%8A-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A) بالتوازي (الافتراضي) يعالج جميع الوكلاء الرسائل في الوقت نفسه: { "broadcast": { "strategy": "parallel", "120363403215116621@g.us": ["alfred", "baerbel"] } } #### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A8%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D8%B3%D9%84) بالتسلسل يعالج الوكلاء الرسائل بالترتيب (ينتظر أحدهم انتهاء السابق): { "broadcast": { "strategy": "sequential", "120363403215116621@g.us": ["alfred", "baerbel"] } } ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AB%D8%A7%D9%84-%D9%83%D8%A7%D9%85%D9%84) مثال كامل { "agents": { "list": [\ {\ "id": "code-reviewer",\ "name": "Code Reviewer",\ "workspace": "/path/to/code-reviewer",\ "sandbox": { "mode": "all" }\ },\ {\ "id": "security-auditor",\ "name": "Security Auditor",\ "workspace": "/path/to/security-auditor",\ "sandbox": { "mode": "all" }\ },\ {\ "id": "docs-generator",\ "name": "Documentation Generator",\ "workspace": "/path/to/docs-generator",\ "sandbox": { "mode": "all" }\ }\ ] }, "broadcast": { "strategy": "parallel", "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"], "120363424282127706@g.us": ["support-en", "support-de"], "+15555550123": ["assistant", "logger"] } } [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84) كيف يعمل ------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AA%D8%AF%D9%81%D9%82-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) تدفق الرسائل 1. **تصل رسالة واردة** في مجموعة WhatsApp 2. **فحص البث**: يتحقق النظام مما إذا كان معرّف النظير موجودًا في `broadcast` 3. **إذا كان في قائمة البث**: * يعالج جميع الوكلاء المدرجين الرسالة * لكل وكيل مفتاح جلسة خاص به وسياق معزول * يعالج الوكلاء الرسائل بالتوازي (افتراضيًا) أو بالتسلسل 4. **إذا لم يكن في قائمة البث**: * يُطبَّق التوجيه العادي (أول binding مطابق) ملاحظة: لا تتجاوز مجموعات البث قوائم السماح الخاصة بالقنوات أو قواعد تفعيل المجموعات (الإشارات/الأوامر/إلخ). فهي تغيّر فقط _أي الوكلاء يعملون_ عندما تكون الرسالة مؤهلة للمعالجة. ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%B9%D8%B2%D9%84-%D8%A7%D9%84%D8%AC%D9%84%D8%B3%D8%A7%D8%AA) عزل الجلسات يحافظ كل وكيل في مجموعة بث على فصل كامل لما يلي: * **مفاتيح الجلسات** (`agent:alfred:whatsapp:group:120363...` مقابل `agent:baerbel:whatsapp:group:120363...`) * **سجل المحادثة** (الوكيل لا يرى رسائل الوكلاء الآخرين) * **مساحة العمل** (بيئات معزولة منفصلة إذا تم تكوينها) * **الوصول إلى الأدوات** (قوائم سماح/منع مختلفة) * **الذاكرة/السياق** (`IDENTITY.md` و`SOUL.md` وما إلى ذلك بشكل منفصل) * **مخزن سياق المجموعة** (رسائل المجموعة الحديثة المستخدمة للسياق) يكون مشتركًا لكل نظير، لذا يرى جميع وكلاء البث السياق نفسه عند التشغيل وهذا يتيح لكل وكيل أن يمتلك: * شخصيات مختلفة * وصولًا مختلفًا إلى الأدوات (مثل للقراءة فقط مقابل القراءة والكتابة) * نماذج مختلفة (مثل opus مقابل sonnet) * Skills مختلفة مثبّتة ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AB%D8%A7%D9%84-%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-%D9%85%D8%B9%D8%B2%D9%88%D9%84%D8%A9) مثال: جلسات معزولة في المجموعة `120363403215116621@g.us` مع الوكلاء `["alfred", "baerbel"]`: **سياق Alfred:** Session: agent:alfred:whatsapp:group:120363403215116621@g.us History: [user message, alfred's previous responses] Workspace: /Users/user/openclaw-alfred/ Tools: read, write, exec **سياق Bärbel:** Session: agent:baerbel:whatsapp:group:120363403215116621@g.us History: [user message, baerbel's previous responses] Workspace: /Users/user/openclaw-baerbel/ Tools: read only [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A3%D9%81%D8%B6%D9%84-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA) أفضل الممارسات ------------------------------------------------------------------------------------------------------------------------------------------------------------ ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#1-%D8%A3%D8%A8%D9%82%D9%90-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D9%85%D8%B1%D9%83%D9%91%D8%B2%D9%8A%D9%86) 1\. أبقِ الوكلاء مركّزين صمّم كل وكيل بحيث تكون له مسؤولية واحدة وواضحة: { "broadcast": { "DEV_GROUP": ["formatter", "linter", "tester"] } } ✅ **جيد:** لكل وكيل مهمة واحدة ❌ **سيئ:** وكيل عام واحد باسم “dev-helper” ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#2-%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D9%85-%D8%A3%D8%B3%D9%85%D8%A7%D8%A1-%D9%88%D8%B5%D9%81%D9%8A%D8%A9) 2\. استخدم أسماء وصفية اجعل وظيفة كل وكيل واضحة: { "agents": { "security-scanner": { "name": "Security Scanner" }, "code-formatter": { "name": "Code Formatter" }, "test-generator": { "name": "Test Generator" } } } ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#3-%D9%83%D9%88%D9%91%D9%86-%D9%88%D8%B5%D9%88%D9%84%D9%8B%D8%A7-%D9%85%D8%AE%D8%AA%D9%84%D9%81%D9%8B%D8%A7-%D8%A5%D9%84%D9%89-%D8%A7%D9%84%D8%A3%D8%AF%D9%88%D8%A7%D8%AA) 3\. كوّن وصولًا مختلفًا إلى الأدوات امنح الوكلاء الأدوات التي يحتاجونها فقط: { "agents": { "reviewer": { "tools": { "allow": ["read", "exec"] } // Read-only }, "fixer": { "tools": { "allow": ["read", "write", "edit", "exec"] } // Read-write } } } ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#4-%D8%B1%D8%A7%D9%82%D8%A8-%D8%A7%D9%84%D8%A3%D8%AF%D8%A7%D8%A1) 4\. راقب الأداء مع وجود عدد كبير من الوكلاء، ضع في اعتبارك ما يلي: * استخدام `"strategy": "parallel"` (الافتراضي) للسرعة * حصر مجموعات البث في 5-10 وكلاء * استخدام نماذج أسرع للوكلاء الأبسط ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#5-%D8%AA%D8%B9%D8%A7%D9%85%D9%84-%D9%85%D8%B9-%D8%A7%D9%84%D8%A5%D8%AE%D9%81%D8%A7%D9%82%D8%A7%D8%AA-%D8%A8%D8%B3%D9%84%D8%A7%D8%B3%D8%A9) 5\. تعامل مع الإخفاقات بسلاسة يفشل الوكلاء بشكل مستقل. لا يمنع خطأ أحد الوكلاء الآخرين: Message → [Agent A ✓, Agent B ✗ error, Agent C ✓] Result: Agent A and C respond, Agent B logs error [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%88%D8%A7%D9%81%D9%82) التوافق ---------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%B2%D9%88%D9%91%D8%AF%D9%88%D9%86) المزوّدون تعمل مجموعات البث حاليًا مع: * ✅ WhatsApp (منفذ) * 🚧 Telegram (مخطط له) * 🚧 Discord (مخطط له) * 🚧 Slack (مخطط له) ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AA%D9%88%D8%AC%D9%8A%D9%87) التوجيه تعمل مجموعات البث إلى جانب التوجيه الحالي: { "bindings": [\ {\ "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },\ "agentId": "alfred"\ }\ ], "broadcast": { "GROUP_B": ["agent1", "agent2"] } } * `GROUP_A`: يرد alfred فقط (توجيه عادي) * `GROUP_B`: يرد agent1 وagent2 معًا (بث) **الأسبقية:** يأخذ `broadcast` الأولوية على `bindings`. [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D9%84%D8%A7-%D9%8A%D8%B1%D8%AF%D9%88%D9%86) الوكلاء لا يردون **تحقق من:** 1. وجود معرّفات الوكلاء في `agents.list` 2. صحة تنسيق معرّف النظير (مثل `120363403215116621@g.us`) 3. عدم وجود الوكلاء في قوائم المنع **التصحيح:** tail -f ~/.openclaw/logs/gateway.log | grep broadcast ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%88%D9%83%D9%8A%D9%84-%D9%88%D8%A7%D8%AD%D8%AF-%D9%81%D9%82%D8%B7-%D9%8A%D8%B1%D8%AF) وكيل واحد فقط يرد **السبب:** قد يكون معرّف النظير موجودًا في `bindings` ولكن ليس في `broadcast`. **الحل:** أضفه إلى تكوين البث أو أزله من bindings. ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%B4%D9%83%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A3%D8%AF%D8%A7%D8%A1) مشكلات الأداء **إذا كان الأداء بطيئًا مع عدد كبير من الوكلاء:** * قلّل عدد الوكلاء لكل مجموعة * استخدم نماذج أخف (sonnet بدلًا من opus) * تحقق من وقت بدء تشغيل sandbox [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A3%D9%85%D8%AB%D9%84%D8%A9) أمثلة -------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-1-%D9%81%D8%B1%D9%8A%D9%82-%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D8%B4%D9%8A%D9%81%D8%B1%D8%A9) المثال 1: فريق مراجعة الشيفرة { "broadcast": { "strategy": "parallel", "120363403215116621@g.us": [\ "code-formatter",\ "security-scanner",\ "test-coverage",\ "docs-checker"\ ] }, "agents": { "list": [\ {\ "id": "code-formatter",\ "workspace": "~/agents/formatter",\ "tools": { "allow": ["read", "write"] }\ },\ {\ "id": "security-scanner",\ "workspace": "~/agents/security",\ "tools": { "allow": ["read", "exec"] }\ },\ {\ "id": "test-coverage",\ "workspace": "~/agents/testing",\ "tools": { "allow": ["read", "exec"] }\ },\ { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }\ ] } } **يرسل المستخدم:** مقتطف شيفرة **الردود:** * code-formatter: “Fixed indentation and added type hints” * security-scanner: “⚠️ SQL injection vulnerability in line 12” * test-coverage: “Coverage is 45%, missing tests for error cases” * docs-checker: “Missing docstring for function `process_data`” ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%85%D8%AB%D8%A7%D9%84-2-%D8%AF%D8%B9%D9%85-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%84%D8%BA%D8%A7%D8%AA) المثال 2: دعم متعدد اللغات { "broadcast": { "strategy": "sequential", "+15555550123": ["detect-language", "translator-en", "translator-de"] }, "agents": { "list": [\ { "id": "detect-language", "workspace": "~/agents/lang-detect" },\ { "id": "translator-en", "workspace": "~/agents/translate-en" },\ { "id": "translator-de", "workspace": "~/agents/translate-de" }\ ] } } [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%B1%D8%AC%D8%B9-api) مرجع API --------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D9%85%D8%AE%D8%B7%D8%B7-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) مخطط التكوين interface OpenClawConfig { broadcast?: { strategy?: "parallel" | "sequential"; [peerId: string]: string[]; }; } ### [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D8%AD%D9%82%D9%88%D9%84) الحقول * `strategy` (اختياري): كيفية معالجة الوكلاء * `"parallel"` (افتراضي): يعالج جميع الوكلاء في الوقت نفسه * `"sequential"`: يعالج الوكلاء وفق ترتيبهم في المصفوفة * `[peerId]`: group JID لـ WhatsApp، أو رقم E.164، أو معرّف نظير آخر * القيمة: مصفوفة من معرّفات الوكلاء الذين يجب أن يعالجوا الرسائل [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%A7%D9%84%D9%82%D9%8A%D9%88%D8%AF) القيود --------------------------------------------------------------------------------------------------------- 1. **الحد الأقصى للوكلاء:** لا يوجد حد صارم، لكن 10+ وكلاء قد يكونون بطيئين 2. **السياق المشترك:** لا يرى الوكلاء ردود بعضهم البعض (عن قصد) 3. **ترتيب الرسائل:** قد تصل الردود المتوازية بأي ترتيب 4. **حدود المعدل:** تُحتسب جميع الوكلاء ضمن حدود معدل WhatsApp [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%AA%D8%AD%D8%B3%D9%8A%D9%86%D8%A7%D8%AA-%D9%85%D8%B3%D8%AA%D9%82%D8%A8%D9%84%D9%8A%D8%A9) تحسينات مستقبلية -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- الميزات المخطط لها: * [ ] وضع السياق المشترك (يرى الوكلاء ردود بعضهم البعض) * [ ] تنسيق الوكلاء (يمكن للوكلاء إرسال إشارات إلى بعضهم البعض) * [ ] اختيار ديناميكي للوكلاء (اختيار الوكلاء بناءً على محتوى الرسالة) * [ ] أولويات الوكلاء (يرد بعض الوكلاء قبل الآخرين) [​](https://docs.openclaw.ai/ar/channels/broadcast-groups#%D8%B1%D8%A7%D8%AC%D8%B9-%D8%A3%D9%8A%D8%B6%D9%8B%D8%A7) راجع أيضًا -------------------------------------------------------------------------------------------------------------------------------- * [تكوين متعدد الوكلاء](https://docs.openclaw.ai/tools/multi-agent-sandbox-tools) * [تكوين التوجيه](https://docs.openclaw.ai/channels/channel-routing) * [إدارة الجلسات](https://docs.openclaw.ai/concepts/session) [المجموعات](https://docs.openclaw.ai/ar/channels/groups) [توجيه القنوات](https://docs.openclaw.ai/ar/channels/channel-routing) ⌘I --- # BlueBubbles - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/channels/bluebubbles#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Messaging platforms BlueBubbles [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [BlueBubbles (REST على macOS)](https://docs.openclaw.ai/ar/channels/bluebubbles#bluebubbles-rest-%D8%B9%D9%84%D9%89-macos) * [plugin المضمّن](https://docs.openclaw.ai/ar/channels/bluebubbles#plugin-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86) * [نظرة عامة](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) * [البدء السريع](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) * [إبقاء Messages.app نشطًا (إعدادات VM / بدون واجهة)](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A5%D8%A8%D9%82%D8%A7%D8%A1-messages-app-%D9%86%D8%B4%D8%B7%D9%8B%D8%A7-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF%D8%A7%D8%AA-vm-%2F-%D8%A8%D8%AF%D9%88%D9%86-%D9%88%D8%A7%D8%AC%D9%87%D8%A9) * [1) احفظ AppleScript](https://docs.openclaw.ai/ar/channels/bluebubbles#1-%D8%A7%D8%AD%D9%81%D8%B8-applescript) * [2) ثبّت LaunchAgent](https://docs.openclaw.ai/ar/channels/bluebubbles#2-%D8%AB%D8%A8%D9%91%D8%AA-launchagent) * [الإعداد التفاعلي](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%AA%D9%81%D8%A7%D8%B9%D9%84%D9%8A) * [التحكم في الوصول (الرسائل الخاصة + المجموعات)](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%AA%D8%AD%D9%83%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D8%AE%D8%A7%D8%B5%D8%A9-%2B-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) * [إثراء أسماء جهات الاتصال (macOS، اختياري)](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A5%D8%AB%D8%B1%D8%A7%D8%A1-%D8%A3%D8%B3%D9%85%D8%A7%D8%A1-%D8%AC%D9%87%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AA%D8%B5%D8%A7%D9%84-macos%D8%8C-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1%D9%8A) * [ضبط الإشارات (المجموعات)](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B6%D8%A8%D8%B7-%D8%A7%D9%84%D8%A5%D8%B4%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) * [ضبط الأوامر](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B6%D8%A8%D8%B7-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1) * [ارتباطات محادثات ACP](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7%D8%A7%D8%AA-%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A7%D8%AA-acp) * [الكتابة + إيصالات القراءة](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D9%83%D8%AA%D8%A7%D8%A8%D8%A9-%2B-%D8%A5%D9%8A%D8%B5%D8%A7%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D9%82%D8%B1%D8%A7%D8%A1%D8%A9) * [الإجراءات المتقدمة](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D9%82%D8%AF%D9%85%D8%A9) * [معرفات الرسائل (القصيرة مقابل الكاملة)](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%85%D8%B9%D8%B1%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%82%D8%B5%D9%8A%D8%B1%D8%A9-%D9%85%D9%82%D8%A7%D8%A8%D9%84-%D8%A7%D9%84%D9%83%D8%A7%D9%85%D9%84%D8%A9) * [تدفق الكتل](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%AA%D8%AF%D9%81%D9%82-%D8%A7%D9%84%D9%83%D8%AA%D9%84) * [الوسائط + الحدود](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D9%88%D8%B3%D8%A7%D8%A6%D8%B7-%2B-%D8%A7%D9%84%D8%AD%D8%AF%D9%88%D8%AF) * [مرجع التكوين](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%85%D8%B1%D8%AC%D8%B9-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) * [الاستهداف / أهداف التسليم](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%87%D8%AF%D8%A7%D9%81-%2F-%D8%A3%D9%87%D8%AF%D8%A7%D9%81-%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85) * [الأمان](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A3%D9%85%D8%A7%D9%86) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [ذو صلة](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/channels/bluebubbles#bluebubbles-rest-%D8%B9%D9%84%D9%89-macos) BlueBubbles (REST على macOS) =============================================================================================================================== الحالة: plugin مضمّن يتصل بخادم BlueBubbles على macOS عبر HTTP. **موصى به لتكامل iMessage** بسبب واجهة API الأغنى وسهولة الإعداد مقارنة بقناة imsg القديمة. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#plugin-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86) plugin المضمّن ------------------------------------------------------------------------------------------------------------------------- تتضمن إصدارات OpenClaw الحالية BlueBubbles، لذلك لا تحتاج الإصدارات المعبأة المعتادة إلى خطوة `openclaw plugins install` منفصلة. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) نظرة عامة -------------------------------------------------------------------------------------------------------------------- * يعمل على macOS عبر تطبيق BlueBubbles المساعد ([bluebubbles.app](https://bluebubbles.app/) ). * الموصى به/المختبر: macOS Sequoia ‏(15). يعمل macOS Tahoe ‏(26)، لكن التحرير معطل حاليًا على Tahoe، وقد تُبلغ تحديثات أيقونات المجموعات عن النجاح لكنها لا تتزامن. * يتصل OpenClaw به عبر واجهة REST API الخاصة به (`GET /api/v1/ping` و`POST /message/text` و`POST /chat/:id/*`). * تصل الرسائل الواردة عبر webhooks؛ أما الردود الصادرة ومؤشرات الكتابة وإيصالات القراءة وtapbacks فهي استدعاءات REST. * يتم استيعاب المرفقات والملصقات كوسائط واردة (وتُعرَض للوكيل عندما يكون ذلك ممكنًا). * يعمل الاقتران/قائمة السماح بالطريقة نفسها كما في القنوات الأخرى (`/channels/pairing` وما إلى ذلك) باستخدام `channels.bluebubbles.allowFrom` + رموز الاقتران. * تُعرَض التفاعلات كأحداث نظام تمامًا مثل Slack/Telegram بحيث يمكن للوكلاء “الإشارة” إليها قبل الرد. * الميزات المتقدمة: التحرير، وإلغاء الإرسال، وسلاسل الردود، وتأثيرات الرسائل، وإدارة المجموعات. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) البدء السريع ----------------------------------------------------------------------------------------------------------------------------------------- 1. ثبّت خادم BlueBubbles على جهاز Mac لديك (اتبع التعليمات على [bluebubbles.app/install](https://bluebubbles.app/install) ). 2. في إعدادات BlueBubbles، فعّل web API وحدد كلمة مرور. 3. شغّل `openclaw onboard` وحدد BlueBubbles، أو قم بالتكوين يدويًا: { channels: { bluebubbles: { enabled: true, serverUrl: "http://192.168.1.100:1234", password: "example-password", webhookPath: "/bluebubbles-webhook", }, }, } 4. وجّه webhooks الخاصة بـ BlueBubbles إلى gateway لديك (مثال: `https://your-gateway-host:3000/bluebubbles-webhook?password=`). 5. ابدأ تشغيل gateway؛ سيقوم بتسجيل معالج webhook وبدء الاقتران. ملاحظة أمنية: * احرص دائمًا على تعيين كلمة مرور لـ webhook. * تكون مصادقة webhook مطلوبة دائمًا. يرفض OpenClaw طلبات BlueBubbles webhook ما لم تتضمن كلمة مرور/guid يطابق `channels.bluebubbles.password` (مثل `?password=` أو `x-password`) بغض النظر عن بنية loopback/proxy. * يتم التحقق من مصادقة كلمة المرور قبل قراءة/تحليل أجسام webhook الكاملة. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A5%D8%A8%D9%82%D8%A7%D8%A1-messages-app-%D9%86%D8%B4%D8%B7%D9%8B%D8%A7-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF%D8%A7%D8%AA-vm-/-%D8%A8%D8%AF%D9%88%D9%86-%D9%88%D8%A7%D8%AC%D9%87%D8%A9) إبقاء Messages.app نشطًا (إعدادات VM / بدون واجهة) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- قد تنتهي بعض إعدادات macOS VM / التشغيل الدائم إلى أن يصبح Messages.app “خاملًا” (تتوقف الأحداث الواردة حتى يتم فتح التطبيق/إحضاره إلى المقدمة). أحد الحلول البسيطة هو **تحفيز Messages كل 5 دقائق** باستخدام AppleScript + LaunchAgent. ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#1-%D8%A7%D8%AD%D9%81%D8%B8-applescript) 1) احفظ AppleScript احفظ هذا باسم: * `~/Scripts/poke-messages.scpt` مثال على script ‏(غير تفاعلي؛ لا يسرق التركيز): try tell application "Messages" if not running then launch end if -- Touch the scripting interface to keep the process responsive. set _chatCount to (count of chats) end tell on error -- Ignore transient failures (first-run prompts, locked session, etc). end try ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#2-%D8%AB%D8%A8%D9%91%D8%AA-launchagent) 2) ثبّت LaunchAgent احفظ هذا باسم: * `~/Library/LaunchAgents/com.user.poke-messages.plist` Label com.user.poke-messages ProgramArguments /bin/bash -lc /usr/bin/osascript "$HOME/Scripts/poke-messages.scpt" RunAtLoad StartInterval 300 StandardOutPath /tmp/poke-messages.log StandardErrorPath /tmp/poke-messages.err ملاحظات: * يعمل هذا **كل 300 ثانية** و**عند تسجيل الدخول**. * قد يؤدي التشغيل الأول إلى ظهور مطالبات macOS **Automation** ‏(`osascript` → Messages). وافق عليها في جلسة المستخدم نفسها التي تشغّل LaunchAgent. قم بتحميله: launchctl unload ~/Library/LaunchAgents/com.user.poke-messages.plist 2>/dev/null || true launchctl load ~/Library/LaunchAgents/com.user.poke-messages.plist [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%AA%D9%81%D8%A7%D8%B9%D9%84%D9%8A) الإعداد التفاعلي --------------------------------------------------------------------------------------------------------------------------------------------------------------------- يتوفر BlueBubbles في الإعداد التفاعلي: openclaw onboard يطلب المعالج ما يلي: * **Server URL** ‏(مطلوب): عنوان خادم BlueBubbles ‏(مثلًا، `http://192.168.1.100:1234`) * **Password** ‏(مطلوب): كلمة مرور API من إعدادات BlueBubbles Server * **Webhook path** ‏(اختياري): القيمة الافتراضية هي `/bluebubbles-webhook` * **DM policy**: ‏pairing أو allowlist أو open أو disabled * **Allow list**: أرقام الهواتف أو عناوين البريد الإلكتروني أو أهداف الدردشة يمكنك أيضًا إضافة BlueBubbles عبر CLI: openclaw channels add bluebubbles --http-url http://192.168.1.100:1234 --password [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%AA%D8%AD%D9%83%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D8%AE%D8%A7%D8%B5%D8%A9-+-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) التحكم في الوصول (الرسائل الخاصة + المجموعات) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- الرسائل الخاصة: * الافتراضي: `channels.bluebubbles.dmPolicy = "pairing"`. * يتلقى المرسلون غير المعروفين رمز اقتران؛ ويتم تجاهل الرسائل حتى الموافقة عليها (تنتهي صلاحية الرموز بعد ساعة واحدة). * وافق عبر: * `openclaw pairing list bluebubbles` * `openclaw pairing approve bluebubbles ` * الاقتران هو تبادل الرموز الافتراضي. التفاصيل: [الاقتران](https://docs.openclaw.ai/channels/pairing) المجموعات: * `channels.bluebubbles.groupPolicy = open | allowlist | disabled` ‏(الافتراضي: `allowlist`). * يتحكم `channels.bluebubbles.groupAllowFrom` في من يمكنه التفعيل في المجموعات عندما يتم تعيين `allowlist`. ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A5%D8%AB%D8%B1%D8%A7%D8%A1-%D8%A3%D8%B3%D9%85%D8%A7%D8%A1-%D8%AC%D9%87%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AA%D8%B5%D8%A7%D9%84-macos%D8%8C-%D8%A7%D8%AE%D8%AA%D9%8A%D8%A7%D8%B1%D9%8A) إثراء أسماء جهات الاتصال (macOS، اختياري) غالبًا ما تتضمن webhooks الخاصة بمجموعات BlueBubbles عناوين المشاركين الخام فقط. إذا كنت تريد أن يُظهر سياق `GroupMembers` أسماء جهات الاتصال المحلية بدلًا من ذلك، فيمكنك الاشتراك في إثراء Contacts المحلي على macOS: * يؤدي `channels.bluebubbles.enrichGroupParticipantsFromContacts = true` إلى تمكين البحث. الافتراضي: `false`. * لا تعمل عمليات البحث إلا بعد أن يسمح وصول المجموعة وتفويض الأوامر وضبط الإشارات بمرور الرسالة. * يتم إثراء المشاركين الهاتفيين غير المسمّين فقط. * تبقى أرقام الهواتف الخام هي البديل عند عدم العثور على تطابق محلي. { channels: { bluebubbles: { enrichGroupParticipantsFromContacts: true, }, }, } ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B6%D8%A8%D8%B7-%D8%A7%D9%84%D8%A5%D8%B4%D8%A7%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) ضبط الإشارات (المجموعات) يدعم BlueBubbles ضبط الإشارات للمحادثات الجماعية، بما يتطابق مع سلوك iMessage/WhatsApp: * يستخدم `agents.list[].groupChat.mentionPatterns` (أو `messages.groupChat.mentionPatterns`) لاكتشاف الإشارات. * عند تمكين `requireMention` لمجموعة، لا يرد الوكيل إلا عند الإشارة إليه. * تتجاوز أوامر التحكم من المرسلين المصرح لهم ضبط الإشارات. تكوين لكل مجموعة: { channels: { bluebubbles: { groupPolicy: "allowlist", groupAllowFrom: ["+15555550123"], groups: { "*": { requireMention: true }, // الافتراضي لجميع المجموعات "iMessage;-;chat123": { requireMention: false }, // تجاوز لمجموعة محددة }, }, }, } ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B6%D8%A8%D8%B7-%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1) ضبط الأوامر * تتطلب أوامر التحكم (مثل `/config` و`/model`) تفويضًا. * يستخدم `allowFrom` و`groupAllowFrom` لتحديد تفويض الأوامر. * يمكن للمرسلين المصرح لهم تشغيل أوامر التحكم حتى بدون إشارة في المجموعات. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7%D8%A7%D8%AA-%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A7%D8%AA-acp) ارتباطات محادثات ACP ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يمكن تحويل محادثات BlueBubbles إلى مساحات عمل ACP دائمة من دون تغيير طبقة النقل. تدفق المشغل السريع: * شغّل `/acp spawn codex --bind here` داخل الرسالة الخاصة أو الدردشة الجماعية المسموح بها. * تُوجَّه الرسائل المستقبلية في محادثة BlueBubbles نفسها إلى جلسة ACP المنشأة. * يعيد `/new` و`/reset` تعيين جلسة ACP المرتبطة نفسها في مكانها. * يغلق `/acp close` جلسة ACP ويزيل الارتباط. يتم أيضًا دعم الارتباطات الدائمة المكوّنة من خلال إدخالات `bindings[]` على المستوى الأعلى مع `type: "acp"` و`match.channel: "bluebubbles"`. يمكن أن يستخدم `match.peer.id` أي صيغة هدف BlueBubbles مدعومة: * مقبض DM مُطبَّع مثل `+15555550123` أو `user@example.com` * `chat_id:` * `chat_guid:` * `chat_identifier:` للحصول على ارتباطات مجموعات مستقرة، استخدم `chat_id:*` أو `chat_identifier:*` ويفضل ذلك. مثال: { agents: { list: [\ {\ id: "codex",\ runtime: {\ type: "acp",\ acp: { agent: "codex", backend: "acpx", mode: "persistent" },\ },\ },\ ], }, bindings: [\ {\ type: "acp",\ agentId: "codex",\ match: {\ channel: "bluebubbles",\ accountId: "default",\ peer: { kind: "dm", id: "+15555550123" },\ },\ acp: { label: "codex-imessage" },\ },\ ], } راجع [وكلاء ACP](https://docs.openclaw.ai/tools/acp-agents) للاطلاع على سلوك ارتباط ACP المشترك. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D9%83%D8%AA%D8%A7%D8%A8%D8%A9-+-%D8%A5%D9%8A%D8%B5%D8%A7%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D9%82%D8%B1%D8%A7%D8%A1%D8%A9) الكتابة + إيصالات القراءة --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- * **مؤشرات الكتابة**: يتم إرسالها تلقائيًا قبل وأثناء توليد الرد. * **إيصالات القراءة**: يتحكم فيها `channels.bluebubbles.sendReadReceipts` ‏(الافتراضي: `true`). * **مؤشرات الكتابة**: يرسل OpenClaw أحداث بدء الكتابة؛ ويقوم BlueBubbles بمسح حالة الكتابة تلقائيًا عند الإرسال أو انتهاء المهلة (الإيقاف اليدوي عبر DELETE غير موثوق). { channels: { bluebubbles: { sendReadReceipts: false, // تعطيل إيصالات القراءة }, }, } [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AA%D9%82%D8%AF%D9%85%D8%A9) الإجراءات المتقدمة ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يدعم BlueBubbles إجراءات الرسائل المتقدمة عند تمكينها في التكوين: { channels: { bluebubbles: { actions: { reactions: true, // tapbacks (الافتراضي: true) edit: true, // تحرير الرسائل المرسلة (macOS 13+، معطل على macOS 26 Tahoe) unsend: true, // إلغاء إرسال الرسائل (macOS 13+) reply: true, // سلاسل الردود حسب GUID الرسالة sendWithEffect: true, // تأثيرات الرسائل (slam وloud وما إلى ذلك) renameGroup: true, // إعادة تسمية الدردشات الجماعية setGroupIcon: true, // تعيين أيقونة/صورة الدردشة الجماعية (غير مستقر على macOS 26 Tahoe) addParticipant: true, // إضافة مشاركين إلى المجموعات removeParticipant: true, // إزالة مشاركين من المجموعات leaveGroup: true, // مغادرة الدردشات الجماعية sendAttachment: true, // إرسال المرفقات/الوسائط }, }, }, } الإجراءات المتاحة: * **react**: إضافة/إزالة تفاعلات tapback ‏(`messageId` و`emoji` و`remove`) * **edit**: تحرير رسالة مرسلة (`messageId` و`text`) * **unsend**: إلغاء إرسال رسالة (`messageId`) * **reply**: الرد على رسالة محددة (`messageId` و`text` و`to`) * **sendWithEffect**: الإرسال مع تأثير iMessage ‏(`text` و`to` و`effectId`) * **renameGroup**: إعادة تسمية دردشة جماعية (`chatGuid` و`displayName`) * **setGroupIcon**: تعيين أيقونة/صورة دردشة جماعية (`chatGuid` و`media`) — غير مستقر على macOS 26 Tahoe ‏(قد تُرجع API نجاحًا لكن الأيقونة لا تتزامن). * **addParticipant**: إضافة شخص إلى مجموعة (`chatGuid` و`address`) * **removeParticipant**: إزالة شخص من مجموعة (`chatGuid` و`address`) * **leaveGroup**: مغادرة دردشة جماعية (`chatGuid`) * **upload-file**: إرسال وسائط/ملفات (`to` و`buffer` و`filename` و`asVoice`) * المذكرات الصوتية: اضبط `asVoice: true` مع صوت **MP3** أو **CAF** للإرسال كرسالة صوتية في iMessage. يقوم BlueBubbles بتحويل MP3 → CAF عند إرسال المذكرات الصوتية. * الاسم المستعار القديم: ما زال `sendAttachment` يعمل، لكن `upload-file` هو اسم الإجراء المعتمد. ### [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%85%D8%B9%D8%B1%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%82%D8%B5%D9%8A%D8%B1%D8%A9-%D9%85%D9%82%D8%A7%D8%A8%D9%84-%D8%A7%D9%84%D9%83%D8%A7%D9%85%D9%84%D8%A9) معرفات الرسائل (القصيرة مقابل الكاملة) قد يعرض OpenClaw معرفات رسائل _قصيرة_ (مثل `1` و`2`) لتوفير الرموز. * يمكن أن تكون `MessageSid` / `ReplyToId` معرفات قصيرة. * تحتوي `MessageSidFull` / `ReplyToIdFull` على المعرفات الكاملة للمزوّد. * المعرفات القصيرة موجودة في الذاكرة؛ وقد تنتهي صلاحيتها عند إعادة التشغيل أو إخلاء ذاكرة التخزين المؤقت. * تقبل الإجراءات `messageId` القصير أو الكامل، لكن المعرفات القصيرة ستؤدي إلى خطأ إذا لم تعد متاحة. استخدم المعرفات الكاملة للأتمتة والتخزين الدائمين: * القوالب: `{{MessageSidFull}}` و`{{ReplyToIdFull}}` * السياق: `MessageSidFull` / `ReplyToIdFull` في الحمولات الواردة راجع [التكوين](https://docs.openclaw.ai/gateway/configuration) للاطلاع على متغيرات القوالب. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%AA%D8%AF%D9%81%D9%82-%D8%A7%D9%84%D9%83%D8%AA%D9%84) تدفق الكتل --------------------------------------------------------------------------------------------------------------------------- تحكم فيما إذا كانت الردود تُرسل كرسالة واحدة أو تُبث على شكل كتل: { channels: { bluebubbles: { blockStreaming: true, // تمكين تدفق الكتل (معطل افتراضيًا) }, }, } [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D9%88%D8%B3%D8%A7%D8%A6%D8%B7-+-%D8%A7%D9%84%D8%AD%D8%AF%D9%88%D8%AF) الوسائط + الحدود ----------------------------------------------------------------------------------------------------------------------------------------------------------- * يتم تنزيل المرفقات الواردة وتخزينها في ذاكرة التخزين المؤقت للوسائط. * حد الوسائط عبر `channels.bluebubbles.mediaMaxMb` للوسائط الواردة والصادرة (الافتراضي: 8 ميجابايت). * يتم تجزئة النص الصادر وفق `channels.bluebubbles.textChunkLimit` ‏(الافتراضي: 4000 حرف). [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D9%85%D8%B1%D8%AC%D8%B9-%D8%A7%D9%84%D8%AA%D9%83%D9%88%D9%8A%D9%86) مرجع التكوين ----------------------------------------------------------------------------------------------------------------------------------------- التكوين الكامل: [التكوين](https://docs.openclaw.ai/gateway/configuration) خيارات المزوّد: * `channels.bluebubbles.enabled`: تمكين/تعطيل القناة. * `channels.bluebubbles.serverUrl`: عنوان URL الأساسي لـ BlueBubbles REST API. * `channels.bluebubbles.password`: كلمة مرور API. * `channels.bluebubbles.webhookPath`: مسار نقطة نهاية webhook ‏(الافتراضي: `/bluebubbles-webhook`). * `channels.bluebubbles.dmPolicy`: ‏`pairing | allowlist | open | disabled` ‏(الافتراضي: `pairing`). * `channels.bluebubbles.allowFrom`: قائمة السماح للرسائل الخاصة (المقابض، والبريد الإلكتروني، وأرقام E.164، و`chat_id:*`، و`chat_guid:*`). * `channels.bluebubbles.groupPolicy`: ‏`open | allowlist | disabled` ‏(الافتراضي: `allowlist`). * `channels.bluebubbles.groupAllowFrom`: قائمة السماح لمرسلي المجموعات. * `channels.bluebubbles.enrichGroupParticipantsFromContacts`: على macOS، إثراء المشاركين غير المسمّين في المجموعة اختياريًا من Contacts المحلية بعد اجتياز الضبط. الافتراضي: `false`. * `channels.bluebubbles.groups`: تكوين لكل مجموعة (`requireMention` وما إلى ذلك). * `channels.bluebubbles.sendReadReceipts`: إرسال إيصالات القراءة (الافتراضي: `true`). * `channels.bluebubbles.blockStreaming`: تمكين تدفق الكتل (الافتراضي: `false`؛ مطلوب للردود المتدفقة). * `channels.bluebubbles.textChunkLimit`: حجم التجزئة الصادرة بالأحرف (الافتراضي: 4000). * `channels.bluebubbles.chunkMode`: يؤدي `length` ‏(الافتراضي) إلى التقسيم فقط عند تجاوز `textChunkLimit`؛ بينما يقسم `newline` عند الأسطر الفارغة (حدود الفقرات) قبل التجزئة حسب الطول. * `channels.bluebubbles.mediaMaxMb`: حد الوسائط الواردة/الصادرة بالميجابايت (الافتراضي: 8). * `channels.bluebubbles.mediaLocalRoots`: قائمة سماح صريحة بالأدلة المحلية المطلقة المسموح بها لمسارات الوسائط المحلية الصادرة. يتم رفض الإرسال عبر المسارات المحلية افتراضيًا ما لم يتم تكوين هذا الخيار. تجاوز لكل حساب: `channels.bluebubbles.accounts..mediaLocalRoots`. * `channels.bluebubbles.historyLimit`: الحد الأقصى لرسائل المجموعة للسياق (يعطل عند 0). * `channels.bluebubbles.dmHistoryLimit`: حد سجل الرسائل الخاصة. * `channels.bluebubbles.actions`: تمكين/تعطيل إجراءات محددة. * `channels.bluebubbles.accounts`: تكوين متعدد الحسابات. الخيارات العامة ذات الصلة: * `agents.list[].groupChat.mentionPatterns` (أو `messages.groupChat.mentionPatterns`). * `messages.responsePrefix`. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%87%D8%AF%D8%A7%D9%81-/-%D8%A3%D9%87%D8%AF%D8%A7%D9%81-%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D9%8A%D9%85) الاستهداف / أهداف التسليم --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يفضل استخدام `chat_guid` للتوجيه المستقر: * `chat_guid:iMessage;-;+15555550123` ‏(مفضل للمجموعات) * `chat_id:123` * `chat_identifier:...` * المقابض المباشرة: `+15555550123` و`user@example.com` * إذا لم يكن للمقبض المباشر دردشة DM موجودة، فسيقوم OpenClaw بإنشاء واحدة عبر `POST /api/v1/chat/new`. وهذا يتطلب تمكين BlueBubbles Private API. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D9%84%D8%A3%D9%85%D8%A7%D9%86) الأمان ---------------------------------------------------------------------------------------------------- * تتم مصادقة طلبات webhook عبر مقارنة معاملات الاستعلام `guid`/`password` أو الرؤوس مع `channels.bluebubbles.password`. * حافظ على سرية كلمة مرور API ونقطة نهاية webhook (تعامل معها على أنها بيانات اعتماد). * لا يوجد تجاوز localhost لمصادقة BlueBubbles webhook. إذا كنت تمرر حركة webhook عبر proxy، فاحتفظ بكلمة مرور BlueBubbles داخل الطلب من الطرف إلى الطرف. لا يستبدل `gateway.trustedProxies` قيمة `channels.bluebubbles.password` هنا. راجع [أمان Gateway](https://docs.openclaw.ai/gateway/security#reverse-proxy-configuration) . * فعّل HTTPS + قواعد الجدار الناري على خادم BlueBubbles إذا كنت ستعرضه خارج شبكتك المحلية. [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ * إذا توقفت أحداث الكتابة/القراءة عن العمل، فتحقق من سجلات BlueBubbles webhook وتأكد من أن مسار gateway يطابق `channels.bluebubbles.webhookPath`. * تنتهي صلاحية رموز الاقتران بعد ساعة واحدة؛ استخدم `openclaw pairing list bluebubbles` و`openclaw pairing approve bluebubbles `. * تتطلب التفاعلات BlueBubbles private API ‏(`POST /api/v1/message/react`)؛ تأكد من أن إصدار الخادم يوفّرها. * يتطلب التحرير/إلغاء الإرسال macOS 13+ وإصدار BlueBubbles Server متوافقًا. في macOS 26 ‏(Tahoe)، يكون التحرير معطلًا حاليًا بسبب تغييرات في private API. * قد تكون تحديثات أيقونات المجموعات غير مستقرة على macOS 26 ‏(Tahoe): قد تُرجع API نجاحًا لكن الأيقونة الجديدة لا تتزامن. * يُخفي OpenClaw تلقائيًا الإجراءات المعروفة بأنها معطلة بناءً على إصدار macOS الخاص بخادم BlueBubbles. إذا استمر ظهور التحرير على macOS 26 ‏(Tahoe)، فعطّله يدويًا باستخدام `channels.bluebubbles.actions.edit=false`. * لمعلومات الحالة/السلامة: `openclaw status --all` أو `openclaw status --deep`. للاطلاع على مرجع عام لتدفق القنوات، راجع [القنوات](https://docs.openclaw.ai/channels) ودليل [Plugins](https://docs.openclaw.ai/tools/plugin) . [​](https://docs.openclaw.ai/ar/channels/bluebubbles#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ----------------------------------------------------------------------------------------------- * [نظرة عامة على القنوات](https://docs.openclaw.ai/channels) — جميع القنوات المدعومة * [الاقتران](https://docs.openclaw.ai/channels/pairing) — مصادقة الرسائل الخاصة وتدفق الاقتران * [المجموعات](https://docs.openclaw.ai/channels/groups) — سلوك الدردشة الجماعية وضبط الإشارات * [توجيه القنوات](https://docs.openclaw.ai/channels/channel-routing) — توجيه الجلسات للرسائل * [الأمان](https://docs.openclaw.ai/gateway/security) — نموذج الوصول والتقوية [قنوات الدردشة](https://docs.openclaw.ai/ar/channels) [Discord](https://docs.openclaw.ai/ar/channels/discord) ⌘I --- # Feishu - OpenClaw [الانتقال إلى المحتوى الرئيسي](https://docs.openclaw.ai/ar/channels/feishu#content-area) [OpenClaw home page![light logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)![dark logo](https://mintcdn.com/clawdhub/dpADRo8IUoiDztzJ/assets/pixel-lobster.svg?fit=max&auto=format&n=dpADRo8IUoiDztzJ&q=85&s=8fdf719fb6d3eaad7c65231385bf28e5)](https://docs.openclaw.ai/ar) ![SA](https://d3gk2c5xim1je2.cloudfront.net/flags/SA.svg) العربية ...ابحث ⌘K ...ابحث Navigation Messaging platforms Feishu [Get started](https://docs.openclaw.ai/ar) [Install](https://docs.openclaw.ai/ar/install) [Channels](https://docs.openclaw.ai/ar/channels) [Agents](https://docs.openclaw.ai/ar/concepts/architecture) [Tools & Plugins](https://docs.openclaw.ai/ar/tools) [Models](https://docs.openclaw.ai/ar/providers) [Platforms](https://docs.openclaw.ai/ar/platforms) [Gateway & Ops](https://docs.openclaw.ai/ar/gateway) [Reference](https://docs.openclaw.ai/ar/cli) [Help](https://docs.openclaw.ai/ar/help) في هذه الصفحة * [بوت Feishu](https://docs.openclaw.ai/ar/channels/feishu#%D8%A8%D9%88%D8%AA-feishu) * [الـ plugin المضمّن](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D9%80-plugin-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86) * [البدء السريع](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) * [الطريقة 1: الإعداد الأولي (مستحسن)](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B7%D8%B1%D9%8A%D9%82%D8%A9-1-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D9%88%D9%84%D9%8A-%D9%85%D8%B3%D8%AA%D8%AD%D8%B3%D9%86) * [الطريقة 2: الإعداد عبر CLI](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B7%D8%B1%D9%8A%D9%82%D8%A9-2-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-cli) * [الخطوة 1: إنشاء تطبيق Feishu](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-1-%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82-feishu) * [1\. افتح Feishu Open Platform](https://docs.openclaw.ai/ar/channels/feishu#1-%D8%A7%D9%81%D8%AA%D8%AD-feishu-open-platform) * [2\. أنشئ تطبيقًا](https://docs.openclaw.ai/ar/channels/feishu#2-%D8%A3%D9%86%D8%B4%D8%A6-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%8B%D8%A7) * [3\. انسخ بيانات الاعتماد](https://docs.openclaw.ai/ar/channels/feishu#3-%D8%A7%D9%86%D8%B3%D8%AE-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF) * [4\. إعداد الأذونات](https://docs.openclaw.ai/ar/channels/feishu#4-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D8%B0%D9%88%D9%86%D8%A7%D8%AA) * [5\. فعّل إمكانية البوت](https://docs.openclaw.ai/ar/channels/feishu#5-%D9%81%D8%B9%D9%91%D9%84-%D8%A5%D9%85%D9%83%D8%A7%D9%86%D9%8A%D8%A9-%D8%A7%D9%84%D8%A8%D9%88%D8%AA) * [6\. إعداد اشتراك الأحداث](https://docs.openclaw.ai/ar/channels/feishu#6-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D8%B4%D8%AA%D8%B1%D8%A7%D9%83-%D8%A7%D9%84%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB) * [7\. انشر التطبيق](https://docs.openclaw.ai/ar/channels/feishu#7-%D8%A7%D9%86%D8%B4%D8%B1-%D8%A7%D9%84%D8%AA%D8%B7%D8%A8%D9%8A%D9%82) * [الخطوة 2: إعداد OpenClaw](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-2-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-openclaw) * [الإعداد باستخدام المعالج (مستحسن)](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A8%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC-%D9%85%D8%B3%D8%AA%D8%AD%D8%B3%D9%86) * [الإعداد عبر ملف التهيئة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-%D9%85%D9%84%D9%81-%D8%A7%D9%84%D8%AA%D9%87%D9%8A%D8%A6%D8%A9) * [Verification Token وEncrypt Key ‏(وضع webhook)](https://docs.openclaw.ai/ar/channels/feishu#verification-token-%D9%88encrypt-key-%E2%80%8F-%D9%88%D8%B6%D8%B9-webhook) * [الإعداد عبر متغيرات البيئة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-%D9%85%D8%AA%D8%BA%D9%8A%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D9%8A%D8%A6%D8%A9) * [نطاق Lark (العالمي)](https://docs.openclaw.ai/ar/channels/feishu#%D9%86%D8%B7%D8%A7%D9%82-lark-%D8%A7%D9%84%D8%B9%D8%A7%D9%84%D9%85%D9%8A) * [علامات تحسين الحصة](https://docs.openclaw.ai/ar/channels/feishu#%D8%B9%D9%84%D8%A7%D9%85%D8%A7%D8%AA-%D8%AA%D8%AD%D8%B3%D9%8A%D9%86-%D8%A7%D9%84%D8%AD%D8%B5%D8%A9) * [الخطوة 3: البدء + الاختبار](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-3-%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%2B-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1) * [1\. شغّل البوابة](https://docs.openclaw.ai/ar/channels/feishu#1-%D8%B4%D8%BA%D9%91%D9%84-%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A9) * [2\. أرسل رسالة اختبار](https://docs.openclaw.ai/ar/channels/feishu#2-%D8%A3%D8%B1%D8%B3%D9%84-%D8%B1%D8%B3%D8%A7%D9%84%D8%A9-%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1) * [3\. وافق على الاقتران](https://docs.openclaw.ai/ar/channels/feishu#3-%D9%88%D8%A7%D9%81%D9%82-%D8%B9%D9%84%D9%89-%D8%A7%D9%84%D8%A7%D9%82%D8%AA%D8%B1%D8%A7%D9%86) * [نظرة عامة](https://docs.openclaw.ai/ar/channels/feishu#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) * [التحكم في الوصول](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AA%D8%AD%D9%83%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84) * [الرسائل المباشرة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9) * [دردشات المجموعات](https://docs.openclaw.ai/ar/channels/feishu#%D8%AF%D8%B1%D8%AF%D8%B4%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) * [أمثلة على إعداد المجموعات](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%85%D8%AB%D9%84%D8%A9-%D8%B9%D9%84%D9%89-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) * [السماح لجميع المجموعات، من دون الحاجة إلى @mention ‏(الافتراضي للمجموعات المفتوحة)](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D8%AC%D9%85%D9%8A%D8%B9-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA%D8%8C-%D9%85%D9%86-%D8%AF%D9%88%D9%86-%D8%A7%D9%84%D8%AD%D8%A7%D8%AC%D8%A9-%D8%A5%D9%84%D9%89-%40mention-%E2%80%8F-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A-%D9%84%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9) * [السماح لجميع المجموعات، مع الاستمرار في طلب @mention](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D8%AC%D9%85%D9%8A%D8%B9-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA%D8%8C-%D9%85%D8%B9-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%85%D8%B1%D8%A7%D8%B1-%D9%81%D9%8A-%D8%B7%D9%84%D8%A8-%40mention) * [السماح بمجموعات محددة فقط](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D8%A8%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D9%85%D8%AD%D8%AF%D8%AF%D8%A9-%D9%81%D9%82%D8%B7) * [تقييد المرسلين المسموح لهم بالمراسلة داخل مجموعة (قائمة سماح للمرسلين)](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D9%82%D9%8A%D9%8A%D8%AF-%D8%A7%D9%84%D9%85%D8%B1%D8%B3%D9%84%D9%8A%D9%86-%D8%A7%D9%84%D9%85%D8%B3%D9%85%D9%88%D8%AD-%D9%84%D9%87%D9%85-%D8%A8%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D8%B3%D9%84%D8%A9-%D8%AF%D8%A7%D8%AE%D9%84-%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A9-%D9%82%D8%A7%D8%A6%D9%85%D8%A9-%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D9%84%D9%85%D8%B1%D8%B3%D9%84%D9%8A%D9%86) * [الحصول على معرّفات المجموعة/المستخدم](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AD%D8%B5%D9%88%D9%84-%D8%B9%D9%84%D9%89-%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A9%2F%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AE%D8%AF%D9%85) * [معرّفات المجموعات (chat\_id)](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-chat_id) * [معرّفات المستخدمين (open\_id)](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AE%D8%AF%D9%85%D9%8A%D9%86-open_id) * [الأوامر الشائعة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%B4%D8%A7%D8%A6%D8%B9%D8%A9) * [أوامر إدارة البوابة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A9) * [استكشاف الأخطاء وإصلاحها](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) * [البوت لا يستجيب في دردشات المجموعات](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D9%88%D8%AA-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D8%AC%D9%8A%D8%A8-%D9%81%D9%8A-%D8%AF%D8%B1%D8%AF%D8%B4%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) * [البوت لا يستقبل الرسائل](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D9%88%D8%AA-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D9%82%D8%A8%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) * [تسرّب App Secret](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D8%B3%D8%B1%D9%91%D8%A8-app-secret) * [فشل إرسال الرسائل](https://docs.openclaw.ai/ar/channels/feishu#%D9%81%D8%B4%D9%84-%D8%A5%D8%B1%D8%B3%D8%A7%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) * [الإعداد المتقدم](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%AA%D9%82%D8%AF%D9%85) * [حسابات متعددة](https://docs.openclaw.ai/ar/channels/feishu#%D8%AD%D8%B3%D8%A7%D8%A8%D8%A7%D8%AA-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF%D8%A9) * [حدود الرسائل](https://docs.openclaw.ai/ar/channels/feishu#%D8%AD%D8%AF%D9%88%D8%AF-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) * [البث](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D8%AB) * [جلسات ACP](https://docs.openclaw.ai/ar/channels/feishu#%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-acp) * [ارتباطات ACP الدائمة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7%D8%A7%D8%AA-acp-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) * [إنشاء ACP مرتبط بسلسلة محادثة من الدردشة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-acp-%D9%85%D8%B1%D8%AA%D8%A8%D8%B7-%D8%A8%D8%B3%D9%84%D8%B3%D9%84%D8%A9-%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%B1%D8%AF%D8%B4%D8%A9) * [توجيه متعدد الوكلاء](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D9%88%D8%AC%D9%8A%D9%87-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1) * [مرجع الإعداد](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B1%D8%AC%D8%B9-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF) * [مرجع dmPolicy](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B1%D8%AC%D8%B9-dmpolicy) * [أنواع الرسائل المدعومة](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%AF%D8%B9%D9%88%D9%85%D8%A9) * [الاستقبال](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%82%D8%A8%D8%A7%D9%84) * [الإرسال](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B1%D8%B3%D8%A7%D9%84) * [سلاسل المحادثات والردود](https://docs.openclaw.ai/ar/channels/feishu#%D8%B3%D9%84%D8%A7%D8%B3%D9%84-%D8%A7%D9%84%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B1%D8%AF%D9%88%D8%AF) * [تعليقات Drive](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D8%B9%D9%84%D9%8A%D9%82%D8%A7%D8%AA-drive) * [سطح إجراءات وقت التشغيل](https://docs.openclaw.ai/ar/channels/feishu#%D8%B3%D8%B7%D8%AD-%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1%D8%A7%D8%AA-%D9%88%D9%82%D8%AA-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84) * [ذو صلة](https://docs.openclaw.ai/ar/channels/feishu#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A8%D9%88%D8%AA-feishu) بوت Feishu ======================================================================================== Feishu ‏(Lark) هو نظام دردشة جماعي تستخدمه الشركات للمراسلة والتعاون. يربط هذا الـ plugin بين OpenClaw وبوت Feishu/Lark باستخدام اشتراك أحداث WebSocket الخاص بالمنصة، بحيث يمكن استقبال الرسائل من دون تعريض عنوان URL عام لـ webhook. * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D9%80-plugin-%D8%A7%D9%84%D9%85%D8%B6%D9%85%D9%91%D9%86) الـ plugin المضمّن ------------------------------------------------------------------------------------------------------------------------------------------- يأتي Feishu مضمّنًا مع إصدارات OpenClaw الحالية، لذلك لا يلزم تثبيت plugin منفصل. إذا كنت تستخدم إصدارًا أقدم أو تثبيتًا مخصصًا لا يتضمن Feishu المضمّن، فقم بتثبيته يدويًا: openclaw plugins install @openclaw/feishu * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-%D8%A7%D9%84%D8%B3%D8%B1%D9%8A%D8%B9) البدء السريع ------------------------------------------------------------------------------------------------------------------------------------ هناك طريقتان لإضافة قناة Feishu: ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B7%D8%B1%D9%8A%D9%82%D8%A9-1-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D9%88%D9%84%D9%8A-%D9%85%D8%B3%D8%AA%D8%AD%D8%B3%D9%86) الطريقة 1: الإعداد الأولي (مستحسن) إذا كنت قد ثبّت OpenClaw للتو، فشغّل الإعداد الأولي: openclaw onboard سيرشدك المعالج خلال ما يلي: 1. إنشاء تطبيق Feishu وجمع بيانات الاعتماد 2. إعداد بيانات اعتماد التطبيق في OpenClaw 3. بدء تشغيل البوابة ✅ **بعد الإعداد**، تحقّق من حالة البوابة: * `openclaw gateway status` * `openclaw logs --follow` ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B7%D8%B1%D9%8A%D9%82%D8%A9-2-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-cli) الطريقة 2: الإعداد عبر CLI إذا كنت قد أكملت التثبيت الأولي بالفعل، فأضف القناة عبر CLI: openclaw channels add اختر **Feishu**، ثم أدخل App ID وApp Secret. ✅ **بعد الإعداد**، أدر البوابة: * `openclaw gateway status` * `openclaw gateway restart` * `openclaw logs --follow` * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-1-%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82-feishu) الخطوة 1: إنشاء تطبيق Feishu -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#1-%D8%A7%D9%81%D8%AA%D8%AD-feishu-open-platform) 1\. افتح Feishu Open Platform زر [Feishu Open Platform](https://open.feishu.cn/app) وسجّل الدخول. يجب على مستأجري Lark (العالمي) استخدام [https://open.larksuite.com/app](https://open.larksuite.com/app) وضبط `domain: "lark"` في إعدادات Feishu. ### [​](https://docs.openclaw.ai/ar/channels/feishu#2-%D8%A3%D9%86%D8%B4%D8%A6-%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%8B%D8%A7) 2\. أنشئ تطبيقًا 1. انقر **Create enterprise app** 2. املأ اسم التطبيق والوصف 3. اختر أيقونة للتطبيق ![Create enterprise app](https://mintcdn.com/clawdhub/6NERQ7Dymau_gJ4k/images/feishu-step2-create-app.png?w=2500&fit=max&auto=format&n=6NERQ7Dymau_gJ4k&q=85&s=557c61a223bc55c58ca1bdc30165ef38) ### [​](https://docs.openclaw.ai/ar/channels/feishu#3-%D8%A7%D9%86%D8%B3%D8%AE-%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%B9%D8%AA%D9%85%D8%A7%D8%AF) 3\. انسخ بيانات الاعتماد من **Credentials & Basic Info**، انسخ: * **App ID** (بالتنسيق: `cli_xxx`) * **App Secret** ❗ **مهم:** احتفظ بـ App Secret بشكل خاص. ![Get credentials](https://mintcdn.com/clawdhub/6NERQ7Dymau_gJ4k/images/feishu-step3-credentials.png?w=2500&fit=max&auto=format&n=6NERQ7Dymau_gJ4k&q=85&s=0a70aa721db7c57bfe8f2ea01cb93e78) ### [​](https://docs.openclaw.ai/ar/channels/feishu#4-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D8%A3%D8%B0%D9%88%D9%86%D8%A7%D8%AA) 4\. إعداد الأذونات في **Permissions**، انقر **Batch import** والصق: { "scopes": { "tenant": [\ "aily:file:read",\ "aily:file:write",\ "application:application.app_message_stats.overview:readonly",\ "application:application:self_manage",\ "application:bot.menu:write",\ "cardkit:card:read",\ "cardkit:card:write",\ "contact:user.employee_id:readonly",\ "corehr:file:download",\ "event:ip_list",\ "im:chat.access_event.bot_p2p_chat:read",\ "im:chat.members:bot_access",\ "im:message",\ "im:message.group_at_msg:readonly",\ "im:message.p2p_msg:readonly",\ "im:message:readonly",\ "im:message:send_as_bot",\ "im:resource"\ ], "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] } } ![Configure permissions](https://mintcdn.com/clawdhub/6NERQ7Dymau_gJ4k/images/feishu-step4-permissions.png?w=2500&fit=max&auto=format&n=6NERQ7Dymau_gJ4k&q=85&s=3a255ce38f028ee2eb0086d5897b82e1) ### [​](https://docs.openclaw.ai/ar/channels/feishu#5-%D9%81%D8%B9%D9%91%D9%84-%D8%A5%D9%85%D9%83%D8%A7%D9%86%D9%8A%D8%A9-%D8%A7%D9%84%D8%A8%D9%88%D8%AA) 5\. فعّل إمكانية البوت في **App Capability** > **Bot**: 1. فعّل إمكانية البوت 2. عيّن اسم البوت ![Enable bot capability](https://mintcdn.com/clawdhub/6NERQ7Dymau_gJ4k/images/feishu-step5-bot-capability.png?w=2500&fit=max&auto=format&n=6NERQ7Dymau_gJ4k&q=85&s=97dcaf96c2bc7e0f6b803b4135a35a2a) ### [​](https://docs.openclaw.ai/ar/channels/feishu#6-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D8%B4%D8%AA%D8%B1%D8%A7%D9%83-%D8%A7%D9%84%D8%A3%D8%AD%D8%AF%D8%A7%D8%AB) 6\. إعداد اشتراك الأحداث ⚠️ **مهم:** قبل إعداد اشتراك الأحداث، تأكد من: 1. أنك شغّلت بالفعل `openclaw channels add` لـ Feishu 2. أن البوابة قيد التشغيل (`openclaw gateway status`) في **Event Subscription**: 1. اختر **Use long connection to receive events** ‏(WebSocket) 2. أضف الحدث: `im.message.receive_v1` 3. (اختياري) لمهام تعليقات Drive، أضف أيضًا: `drive.notice.comment_add_v1` ⚠️ إذا لم تكن البوابة قيد التشغيل، فقد يفشل حفظ إعداد الاتصال الطويل. ![Configure event subscription](https://mintcdn.com/clawdhub/6NERQ7Dymau_gJ4k/images/feishu-step6-event-subscription.png?w=2500&fit=max&auto=format&n=6NERQ7Dymau_gJ4k&q=85&s=bd43f9b379e63e537950aaad8baed907) ### [​](https://docs.openclaw.ai/ar/channels/feishu#7-%D8%A7%D9%86%D8%B4%D8%B1-%D8%A7%D9%84%D8%AA%D8%B7%D8%A8%D9%8A%D9%82) 7\. انشر التطبيق 1. أنشئ إصدارًا في **Version Management & Release** 2. أرسله للمراجعة وانشره 3. انتظر موافقة المسؤول (تطبيقات المؤسسات تُوافق عادةً تلقائيًا) * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-2-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-openclaw) الخطوة 2: إعداد OpenClaw ----------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A8%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-%D8%A7%D9%84%D9%85%D8%B9%D8%A7%D9%84%D8%AC-%D9%85%D8%B3%D8%AA%D8%AD%D8%B3%D9%86) الإعداد باستخدام المعالج (مستحسن) openclaw channels add اختر **Feishu** والصق App ID وApp Secret. ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-%D9%85%D9%84%D9%81-%D8%A7%D9%84%D8%AA%D9%87%D9%8A%D8%A6%D8%A9) الإعداد عبر ملف التهيئة حرّر `~/.openclaw/openclaw.json`: { channels: { feishu: { enabled: true, dmPolicy: "pairing", accounts: { main: { appId: "cli_xxx", appSecret: "xxx", name: "My AI assistant", }, }, }, }, } إذا كنت تستخدم `connectionMode: "webhook"`، فاضبط كلًا من `verificationToken` و`encryptKey`. يرتبط خادم webhook الخاص بـ Feishu على `127.0.0.1` افتراضيًا؛ لا تضبط `webhookHost` إلا إذا كنت تحتاج عمدًا إلى عنوان ربط مختلف. #### [​](https://docs.openclaw.ai/ar/channels/feishu#verification-token-%D9%88encrypt-key-%E2%80%8F-%D9%88%D8%B6%D8%B9-webhook) Verification Token وEncrypt Key ‏(وضع webhook) عند استخدام وضع webhook، اضبط كلًا من `channels.feishu.verificationToken` و`channels.feishu.encryptKey` في إعداداتك. للحصول على القيم: 1. في Feishu Open Platform، افتح تطبيقك 2. انتقل إلى **Development** → **Events & Callbacks** ‏(开发配置 → 事件与回调) 3. افتح تبويب **Encryption** ‏(加密策略) 4. انسخ **Verification Token** و**Encrypt Key** توضح الصورة التالية مكان العثور على **Verification Token**. أما **Encrypt Key** فهو مدرج في القسم نفسه **Encryption**. ![Verification Token location](https://mintcdn.com/clawdhub/coDyKPKdey9mC-El/images/feishu-verification-token.png?w=2500&fit=max&auto=format&n=coDyKPKdey9mC-El&q=85&s=9c1ceb9ac253544a9602129d756be45f) ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%B9%D8%A8%D8%B1-%D9%85%D8%AA%D8%BA%D9%8A%D8%B1%D8%A7%D8%AA-%D8%A7%D9%84%D8%A8%D9%8A%D8%A6%D8%A9) الإعداد عبر متغيرات البيئة export FEISHU_APP_ID="cli_xxx" export FEISHU_APP_SECRET="xxx" ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%86%D8%B7%D8%A7%D9%82-lark-%D8%A7%D9%84%D8%B9%D8%A7%D9%84%D9%85%D9%8A) نطاق Lark (العالمي) إذا كان المستأجر الخاص بك على Lark (الدولي)، فاضبط النطاق إلى `lark` (أو سلسلة نطاق كاملة). يمكنك ضبطه في `channels.feishu.domain` أو لكل حساب على حدة (`channels.feishu.accounts..domain`). { channels: { feishu: { domain: "lark", accounts: { main: { appId: "cli_xxx", appSecret: "xxx", }, }, }, }, } ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%B9%D9%84%D8%A7%D9%85%D8%A7%D8%AA-%D8%AA%D8%AD%D8%B3%D9%8A%D9%86-%D8%A7%D9%84%D8%AD%D8%B5%D8%A9) علامات تحسين الحصة يمكنك تقليل استخدام Feishu API باستخدام علامتين اختياريتين: * `typingIndicator` (الافتراضي `true`): عند ضبطه على `false`، يتم تخطي استدعاءات تفاعل الكتابة. * `resolveSenderNames` (الافتراضي `true`): عند ضبطه على `false`، يتم تخطي استدعاءات البحث عن ملف المُرسِل الشخصي. اضبطهما على المستوى الأعلى أو لكل حساب: { channels: { feishu: { typingIndicator: false, resolveSenderNames: false, accounts: { main: { appId: "cli_xxx", appSecret: "xxx", typingIndicator: true, resolveSenderNames: false, }, }, }, }, } * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AE%D8%B7%D9%88%D8%A9-3-%D8%A7%D9%84%D8%A8%D8%AF%D8%A1-+-%D8%A7%D9%84%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1) الخطوة 3: البدء + الاختبار ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#1-%D8%B4%D8%BA%D9%91%D9%84-%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A9) 1\. شغّل البوابة openclaw gateway ### [​](https://docs.openclaw.ai/ar/channels/feishu#2-%D8%A3%D8%B1%D8%B3%D9%84-%D8%B1%D8%B3%D8%A7%D9%84%D8%A9-%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1) 2\. أرسل رسالة اختبار في Feishu، ابحث عن البوت وأرسل رسالة. ### [​](https://docs.openclaw.ai/ar/channels/feishu#3-%D9%88%D8%A7%D9%81%D9%82-%D8%B9%D9%84%D9%89-%D8%A7%D9%84%D8%A7%D9%82%D8%AA%D8%B1%D8%A7%D9%86) 3\. وافق على الاقتران بشكل افتراضي، يرد البوت برمز اقتران. وافق عليه: openclaw pairing approve feishu بعد الموافقة، يمكنك الدردشة بشكل طبيعي. * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%86%D8%B8%D8%B1%D8%A9-%D8%B9%D8%A7%D9%85%D8%A9) نظرة عامة --------------------------------------------------------------------------------------------------------------- * **قناة بوت Feishu**: بوت Feishu تديره البوابة * **توجيه حتمي**: تعود الردود دائمًا إلى Feishu * **عزل الجلسات**: تشترك الرسائل الخاصة في جلسة رئيسية؛ أما المجموعات فمعزولة * **اتصال WebSocket**: اتصال طويل عبر Feishu SDK، ولا حاجة إلى عنوان URL عام * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AA%D8%AD%D9%83%D9%85-%D9%81%D9%8A-%D8%A7%D9%84%D9%88%D8%B5%D9%88%D9%84) التحكم في الوصول ----------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%A8%D8%A7%D8%B4%D8%B1%D8%A9) الرسائل المباشرة * **الافتراضي**: `dmPolicy: "pairing"` ‏(يحصل المستخدمون غير المعروفين على رمز اقتران) * **الموافقة على الاقتران**: openclaw pairing list feishu openclaw pairing approve feishu * **وضع قائمة السماح**: اضبط `channels.feishu.allowFrom` باستخدام Open IDs المسموح بها ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AF%D8%B1%D8%AF%D8%B4%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) دردشات المجموعات **1\. سياسة المجموعات** (`channels.feishu.groupPolicy`): * `"open"` = السماح للجميع في المجموعات * `"allowlist"` = السماح فقط لما هو موجود في `groupAllowFrom` * `"disabled"` = تعطيل رسائل المجموعات الافتراضي: `allowlist` **2\. شرط الإشارة** (`channels.feishu.requireMention`، ويمكن تجاوزه عبر `channels.feishu.groups..requireMention`): * `true` صراحةً = يتطلب @mention * `false` صراحةً = يرد من دون إشارات * عند عدم ضبطه ووجود `groupPolicy: "open"` = الافتراضي `false` * عند عدم ضبطه وكون `groupPolicy` ليس `"open"` = الافتراضي `true` * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%85%D8%AB%D9%84%D8%A9-%D8%B9%D9%84%D9%89-%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) أمثلة على إعداد المجموعات --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D8%AC%D9%85%D9%8A%D8%B9-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA%D8%8C-%D9%85%D9%86-%D8%AF%D9%88%D9%86-%D8%A7%D9%84%D8%AD%D8%A7%D8%AC%D8%A9-%D8%A5%D9%84%D9%89-@mention-%E2%80%8F-%D8%A7%D9%84%D8%A7%D9%81%D8%AA%D8%B1%D8%A7%D8%B6%D9%8A-%D9%84%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9) السماح لجميع المجموعات، من دون الحاجة إلى @mention ‏(الافتراضي للمجموعات المفتوحة) { channels: { feishu: { groupPolicy: "open", }, }, } ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D8%AC%D9%85%D9%8A%D8%B9-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA%D8%8C-%D9%85%D8%B9-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%85%D8%B1%D8%A7%D8%B1-%D9%81%D9%8A-%D8%B7%D9%84%D8%A8-@mention) السماح لجميع المجموعات، مع الاستمرار في طلب @mention { channels: { feishu: { groupPolicy: "open", requireMention: true, }, }, } ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%B3%D9%85%D8%A7%D8%AD-%D8%A8%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-%D9%85%D8%AD%D8%AF%D8%AF%D8%A9-%D9%81%D9%82%D8%B7) السماح بمجموعات محددة فقط { channels: { feishu: { groupPolicy: "allowlist", // Feishu group IDs (chat_id) look like: oc_xxx groupAllowFrom: ["oc_xxx", "oc_yyy"], }, }, } ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D9%82%D9%8A%D9%8A%D8%AF-%D8%A7%D9%84%D9%85%D8%B1%D8%B3%D9%84%D9%8A%D9%86-%D8%A7%D9%84%D9%85%D8%B3%D9%85%D9%88%D8%AD-%D9%84%D9%87%D9%85-%D8%A8%D8%A7%D9%84%D9%85%D8%B1%D8%A7%D8%B3%D9%84%D8%A9-%D8%AF%D8%A7%D8%AE%D9%84-%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A9-%D9%82%D8%A7%D8%A6%D9%85%D8%A9-%D8%B3%D9%85%D8%A7%D8%AD-%D9%84%D9%84%D9%85%D8%B1%D8%B3%D9%84%D9%8A%D9%86) تقييد المرسلين المسموح لهم بالمراسلة داخل مجموعة (قائمة سماح للمرسلين) بالإضافة إلى السماح للمجموعة نفسها، فإن **كل الرسائل** داخل تلك المجموعة يتم ضبطها حسب `open_id` الخاص بالمرسل: فقط المستخدمون المدرجون في `groups..allowFrom` تتم معالجة رسائلهم؛ أما الرسائل من الأعضاء الآخرين فيتم تجاهلها (هذا ضبط كامل على مستوى المرسل، وليس فقط لأوامر التحكم مثل `/reset` أو `/new`). { channels: { feishu: { groupPolicy: "allowlist", groupAllowFrom: ["oc_xxx"], groups: { oc_xxx: { // Feishu user IDs (open_id) look like: ou_xxx allowFrom: ["ou_user1", "ou_user2"], }, }, }, }, } * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%AD%D8%B5%D9%88%D9%84-%D8%B9%D9%84%D9%89-%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A9/%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AE%D8%AF%D9%85) الحصول على معرّفات المجموعة/المستخدم --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA-chat_id) معرّفات المجموعات (chat\_id) تبدو معرّفات المجموعات بهذا الشكل `oc_xxx`. **الطريقة 1 (مستحسنة)** 1. شغّل البوابة واذكر البوت باستخدام @mention داخل المجموعة 2. شغّل `openclaw logs --follow` وابحث عن `chat_id` **الطريقة 2** استخدم مصحح Feishu API لسرد دردشات المجموعات. ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B9%D8%B1%D9%91%D9%81%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D8%AE%D8%AF%D9%85%D9%8A%D9%86-open_id) معرّفات المستخدمين (open\_id) تبدو معرّفات المستخدمين بهذا الشكل `ou_xxx`. **الطريقة 1 (مستحسنة)** 1. شغّل البوابة وأرسل رسالة مباشرة إلى البوت 2. شغّل `openclaw logs --follow` وابحث عن `open_id` **الطريقة 2** تحقق من طلبات الاقتران للحصول على Open IDs الخاصة بالمستخدمين: openclaw pairing list feishu * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A7%D9%84%D8%B4%D8%A7%D8%A6%D8%B9%D8%A9) الأوامر الشائعة --------------------------------------------------------------------------------------------------------------------------------------------------------- | الأمر | الوصف | | --- | --- | | `/status` | عرض حالة البوت | | `/reset` | إعادة تعيين الجلسة | | `/model` | عرض/تبديل النموذج | > ملاحظة: لا يدعم Feishu قوائم الأوامر الأصلية حتى الآن، لذلك يجب إرسال الأوامر كنص. [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%88%D8%A7%D9%85%D8%B1-%D8%A5%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D8%A8%D9%88%D8%A7%D8%A8%D8%A9) أوامر إدارة البوابة -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | الأمر | الوصف | | --- | --- | | `openclaw gateway status` | عرض حالة البوابة | | `openclaw gateway install` | تثبيت/بدء خدمة البوابة | | `openclaw gateway stop` | إيقاف خدمة البوابة | | `openclaw gateway restart` | إعادة تشغيل خدمة البوابة | | `openclaw logs --follow` | تتبع سجلات البوابة | * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7) استكشاف الأخطاء وإصلاحها ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D9%88%D8%AA-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D8%AC%D9%8A%D8%A8-%D9%81%D9%8A-%D8%AF%D8%B1%D8%AF%D8%B4%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%AC%D9%85%D9%88%D8%B9%D8%A7%D8%AA) البوت لا يستجيب في دردشات المجموعات 1. تأكد من إضافة البوت إلى المجموعة 2. تأكد من أنك تشير إلى البوت باستخدام @mention ‏(السلوك الافتراضي) 3. تحقق من أن `groupPolicy` ليس مضبوطًا على `"disabled"` 4. تحقق من السجلات: `openclaw logs --follow` ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D9%88%D8%AA-%D9%84%D8%A7-%D9%8A%D8%B3%D8%AA%D9%82%D8%A8%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) البوت لا يستقبل الرسائل 1. تأكد من أن التطبيق منشور ومعتمد 2. تأكد من أن اشتراك الأحداث يتضمن `im.message.receive_v1` 3. تأكد من تفعيل **long connection** 4. تأكد من اكتمال أذونات التطبيق 5. تأكد من أن البوابة قيد التشغيل: `openclaw gateway status` 6. تحقق من السجلات: `openclaw logs --follow` ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D8%B3%D8%B1%D9%91%D8%A8-app-secret) تسرّب App Secret 1. أعد تعيين App Secret في Feishu Open Platform 2. حدّث App Secret في إعداداتك 3. أعد تشغيل البوابة ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%81%D8%B4%D9%84-%D8%A5%D8%B1%D8%B3%D8%A7%D9%84-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) فشل إرسال الرسائل 1. تأكد من أن التطبيق يملك إذن `im:message:send_as_bot` 2. تأكد من أن التطبيق منشور 3. تحقق من السجلات للحصول على أخطاء مفصلة * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF-%D8%A7%D9%84%D9%85%D8%AA%D9%82%D8%AF%D9%85) الإعداد المتقدم --------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AD%D8%B3%D8%A7%D8%A8%D8%A7%D8%AA-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF%D8%A9) حسابات متعددة { channels: { feishu: { defaultAccount: "main", accounts: { main: { appId: "cli_xxx", appSecret: "xxx", name: "Primary bot", }, backup: { appId: "cli_yyy", appSecret: "yyy", name: "Backup bot", enabled: false, }, }, }, }, } يتحكم `defaultAccount` في حساب Feishu المستخدم عندما لا تحدد واجهات API الصادرة `accountId` بشكل صريح. ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AD%D8%AF%D9%88%D8%AF-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84) حدود الرسائل * `textChunkLimit`: حجم مقطع النص الصادر (الافتراضي: 2000 حرف) * `mediaMaxMb`: حد رفع/تنزيل الوسائط (الافتراضي: 30MB) ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A8%D8%AB) البث يدعم Feishu الردود المتدفقة عبر البطاقات التفاعلية. عند التفعيل، يحدّث البوت بطاقة أثناء توليد النص. { channels: { feishu: { streaming: true, // enable streaming card output (default true) blockStreaming: true, // enable block-level streaming (default true) }, }, } اضبط `streaming: false` للانتظار حتى يكتمل الرد بالكامل قبل الإرسال. ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AC%D9%84%D8%B3%D8%A7%D8%AA-acp) جلسات ACP يدعم Feishu ‏ACP في: * الرسائل المباشرة * محادثات موضوعات المجموعات يعتمد ACP في Feishu على أوامر نصية. لا توجد قوائم أوامر slash أصلية، لذا استخدم رسائل `/acp ...` مباشرة في المحادثة. #### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7%D8%A7%D8%AA-acp-%D8%A7%D9%84%D8%AF%D8%A7%D8%A6%D9%85%D8%A9) ارتباطات ACP الدائمة استخدم ارتباطات ACP المكتوبة على المستوى الأعلى لتثبيت رسالة مباشرة أو محادثة موضوع في Feishu إلى جلسة ACP دائمة. { agents: { list: [\ {\ id: "codex",\ runtime: {\ type: "acp",\ acp: {\ agent: "codex",\ backend: "acpx",\ mode: "persistent",\ cwd: "/workspace/openclaw",\ },\ },\ },\ ], }, bindings: [\ {\ type: "acp",\ agentId: "codex",\ match: {\ channel: "feishu",\ accountId: "default",\ peer: { kind: "direct", id: "ou_1234567890" },\ },\ },\ {\ type: "acp",\ agentId: "codex",\ match: {\ channel: "feishu",\ accountId: "default",\ peer: { kind: "group", id: "oc_group_chat:topic:om_topic_root" },\ },\ acp: { label: "codex-feishu-topic" },\ },\ ], } #### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A5%D9%86%D8%B4%D8%A7%D8%A1-acp-%D9%85%D8%B1%D8%AA%D8%A8%D8%B7-%D8%A8%D8%B3%D9%84%D8%B3%D9%84%D8%A9-%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%B1%D8%AF%D8%B4%D8%A9) إنشاء ACP مرتبط بسلسلة محادثة من الدردشة في رسالة مباشرة أو محادثة موضوع في Feishu، يمكنك إنشاء جلسة ACP وربطها في مكانها: /acp spawn codex --thread here ملاحظات: * يعمل `--thread here` مع الرسائل المباشرة وموضوعات Feishu. * يتم توجيه الرسائل اللاحقة في الرسالة المباشرة/الموضوع المرتبط مباشرة إلى جلسة ACP تلك. * لا يستهدف الإصدار v1 دردشات المجموعات العامة غير المرتبطة بموضوع. ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D9%88%D8%AC%D9%8A%D9%87-%D9%85%D8%AA%D8%B9%D8%AF%D8%AF-%D8%A7%D9%84%D9%88%D9%83%D9%84%D8%A7%D8%A1) توجيه متعدد الوكلاء استخدم `bindings` لتوجيه الرسائل المباشرة أو المجموعات في Feishu إلى وكلاء مختلفين. { agents: { list: [\ { id: "main" },\ {\ id: "clawd-fan",\ workspace: "/home/user/clawd-fan",\ agentDir: "/home/user/.openclaw/agents/clawd-fan/agent",\ },\ {\ id: "clawd-xi",\ workspace: "/home/user/clawd-xi",\ agentDir: "/home/user/.openclaw/agents/clawd-xi/agent",\ },\ ], }, bindings: [\ {\ agentId: "main",\ match: {\ channel: "feishu",\ peer: { kind: "direct", id: "ou_xxx" },\ },\ },\ {\ agentId: "clawd-fan",\ match: {\ channel: "feishu",\ peer: { kind: "direct", id: "ou_yyy" },\ },\ },\ {\ agentId: "clawd-xi",\ match: {\ channel: "feishu",\ peer: { kind: "group", id: "oc_zzz" },\ },\ },\ ], } حقول التوجيه: * `match.channel`: ‏`"feishu"` * `match.peer.kind`: ‏`"direct"` أو `"group"` * `match.peer.id`: معرّف Open للمستخدم (`ou_xxx`) أو معرّف المجموعة (`oc_xxx`) راجع [الحصول على معرّفات المجموعة/المستخدم](https://docs.openclaw.ai/ar/channels/feishu#get-groupuser-ids) للحصول على نصائح البحث. * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B1%D8%AC%D8%B9-%D8%A7%D9%84%D8%A5%D8%B9%D8%AF%D8%A7%D8%AF) مرجع الإعداد ------------------------------------------------------------------------------------------------------------------------------------ الإعداد الكامل: [إعدادات البوابة](https://docs.openclaw.ai/gateway/configuration) الخيارات الأساسية: | الإعداد | الوصف | الافتراضي | | --- | --- | --- | | `channels.feishu.enabled` | تفعيل/تعطيل القناة | `true` | | `channels.feishu.domain` | نطاق API ‏(`feishu` أو `lark`) | `feishu` | | `channels.feishu.connectionMode` | وضع نقل الأحداث | `websocket` | | `channels.feishu.defaultAccount` | معرّف الحساب الافتراضي للتوجيه الصادر | `default` | | `channels.feishu.verificationToken` | مطلوب لوضع webhook | \- | | `channels.feishu.encryptKey` | مطلوب لوضع webhook | \- | | `channels.feishu.webhookPath` | مسار route لـ webhook | `/feishu/events` | | `channels.feishu.webhookHost` | مضيف الربط لـ webhook | `127.0.0.1` | | `channels.feishu.webhookPort` | منفذ الربط لـ webhook | `3000` | | `channels.feishu.accounts..appId` | App ID | \- | | `channels.feishu.accounts..appSecret` | App Secret | \- | | `channels.feishu.accounts..domain` | تجاوز نطاق API لكل حساب | `feishu` | | `channels.feishu.dmPolicy` | سياسة الرسائل المباشرة | `pairing` | | `channels.feishu.allowFrom` | قائمة السماح للرسائل المباشرة (قائمة `open_id`) | \- | | `channels.feishu.groupPolicy` | سياسة المجموعات | `allowlist` | | `channels.feishu.groupAllowFrom` | قائمة السماح للمجموعات | \- | | `channels.feishu.requireMention` | طلب @mention افتراضيًا | مشروط | | `channels.feishu.groups..requireMention` | تجاوز طلب @mention لكل مجموعة | موروث | | `channels.feishu.groups..enabled` | تفعيل المجموعة | `true` | | `channels.feishu.textChunkLimit` | حجم مقطع الرسالة | `2000` | | `channels.feishu.mediaMaxMb` | حد حجم الوسائط | `30` | | `channels.feishu.streaming` | تفعيل خرج البطاقات المتدفقة | `true` | | `channels.feishu.blockStreaming` | تفعيل البث على مستوى الكتل | `true` | * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D9%85%D8%B1%D8%AC%D8%B9-dmpolicy) مرجع dmPolicy --------------------------------------------------------------------------------------------------- | القيمة | السلوك | | --- | --- | | `"pairing"` | **الافتراضي.** يحصل المستخدمون غير المعروفين على رمز اقتران؛ ويجب اعتمادهم | | `"allowlist"` | فقط المستخدمون الموجودون في `allowFrom` يمكنهم الدردشة | | `"open"` | السماح لجميع المستخدمين (يتطلب `"*"` في `allowFrom`) | | `"disabled"` | تعطيل الرسائل المباشرة | * * * [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D9%85%D8%AF%D8%B9%D9%88%D9%85%D8%A9) أنواع الرسائل المدعومة ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D9%82%D8%A8%D8%A7%D9%84) الاستقبال * ✅ نص * ✅ نص منسق (post) * ✅ صور * ✅ ملفات * ✅ صوت * ✅ فيديو/وسائط * ✅ ملصقات ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%A7%D9%84%D8%A5%D8%B1%D8%B3%D8%A7%D9%84) الإرسال * ✅ نص * ✅ صور * ✅ ملفات * ✅ صوت * ✅ فيديو/وسائط * ✅ بطاقات تفاعلية * ⚠️ نص منسق (تنسيق بنمط post وبطاقات، وليس ميزات التأليف العشوائية في Feishu) ### [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%B3%D9%84%D8%A7%D8%B3%D9%84-%D8%A7%D9%84%D9%85%D8%AD%D8%A7%D8%AF%D8%AB%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B1%D8%AF%D9%88%D8%AF) سلاسل المحادثات والردود * ✅ ردود مضمّنة * ✅ ردود سلسلة الموضوع عندما يوفّر Feishu ‏`reply_in_thread` * ✅ تظل ردود الوسائط مدركة للسلسلة عند الرد على رسالة سلسلة/موضوع [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%AA%D8%B9%D9%84%D9%8A%D9%82%D8%A7%D8%AA-drive) تعليقات Drive ------------------------------------------------------------------------------------------------------------------ يمكن لـ Feishu تشغيل الوكيل عندما يضيف شخص ما تعليقًا على مستند Feishu Drive ‏(Docs وSheets وغيرها). يتلقى الوكيل نص التعليق وسياق المستند وسلسلة التعليق حتى يتمكن من الرد داخل السلسلة أو إجراء تعديلات على المستند. المتطلبات: * الاشتراك في `drive.notice.comment_add_v1` ضمن إعدادات اشتراك أحداث تطبيق Feishu (إلى جانب `im.message.receive_v1` الموجود) * أداة Drive مفعلة افتراضيًا؛ عطّلها باستخدام `channels.feishu.tools.drive: false` تكشف أداة `feishu_drive` عن إجراءات التعليقات التالية: | الإجراء | الوصف | | --- | --- | | `list_comments` | سرد التعليقات على مستند | | `list_comment_replies` | سرد الردود في سلسلة تعليق | | `add_comment` | إضافة تعليق جديد على المستوى الأعلى | | `reply_comment` | الرد على سلسلة تعليق موجودة | عندما يتعامل الوكيل مع حدث تعليق Drive، فإنه يتلقى: * نص التعليق والمرسل * بيانات المستند الوصفية (العنوان والنوع وURL) * سياق سلسلة التعليق للردود داخل السلسلة بعد إجراء تعديلات على المستند، يتم توجيه الوكيل لاستخدام `feishu_drive.reply_comment` لإخطار المعلّق ثم إخراج الرمز الصامت المطابق تمامًا `NO_REPLY` / `no_reply` لتجنب الإرسال المكرر. [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%B3%D8%B7%D8%AD-%D8%A5%D8%AC%D8%B1%D8%A7%D8%A1%D8%A7%D8%AA-%D9%88%D9%82%D8%AA-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84) سطح إجراءات وقت التشغيل ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- يكشف Feishu حاليًا عن إجراءات وقت التشغيل التالية: * `send` * `read` * `edit` * `thread-reply` * `pin` * `list-pins` * `unpin` * `member-info` * `channel-info` * `channel-list` * `react` و`reactions` عندما تكون التفاعلات مفعّلة في الإعدادات * إجراءات تعليقات `feishu_drive`: ‏`list_comments` و`list_comment_replies` و`add_comment` و`reply_comment` [​](https://docs.openclaw.ai/ar/channels/feishu#%D8%B0%D9%88-%D8%B5%D9%84%D8%A9) ذو صلة ------------------------------------------------------------------------------------------ * [نظرة عامة على القنوات](https://docs.openclaw.ai/channels) — جميع القنوات المدعومة * [الاقتران](https://docs.openclaw.ai/channels/pairing) — مصادقة الرسائل المباشرة وتدفق الاقتران * [المجموعات](https://docs.openclaw.ai/channels/groups) — سلوك دردشات المجموعات وضبط الإشارات * [توجيه القنوات](https://docs.openclaw.ai/channels/channel-routing) — توجيه الجلسات للرسائل * [الأمان](https://docs.openclaw.ai/gateway/security) — نموذج الوصول والتحصين [Discord](https://docs.openclaw.ai/ar/channels/discord) [Google Chat](https://docs.openclaw.ai/ar/channels/googlechat) ⌘I ---