​

Slack

​

الإعداد السريع

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

openclaw gateway

​

قائمة التحقق من البيان والنطاقات

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "إرسال رسالة إلى OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "إرسال رسالة إلى OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

​

إعدادات بيان إضافية

    "slash_commands": [
      {
        "command": "/new",
        "description": "بدء جلسة جديدة",
        "usage_hint": "[model]"
      },
      {
        "command": "/reset",
        "description": "إعادة تعيين الجلسة الحالية"
      },
      {
        "command": "/compact",
        "description": "ضغط سياق الجلسة",
        "usage_hint": "[instructions]"
      },
      {
        "command": "/stop",
        "description": "إيقاف التشغيل الحالي"
      },
      {
        "command": "/session",
        "description": "إدارة انتهاء ربط سلسلة المحادثة",
        "usage_hint": "idle <duration|off> or max-age <duration|off>"
      },
      {
        "command": "/think",
        "description": "تعيين مستوى التفكير",
        "usage_hint": "<off|minimal|low|medium|high|xhigh>"
      },
      {
        "command": "/verbose",
        "description": "تبديل المخرجات التفصيلية",
        "usage_hint": "on|off|full"
      },
      {
        "command": "/fast",
        "description": "عرض الوضع السريع أو تعيينه",
        "usage_hint": "[status|on|off]"
      },
      {
        "command": "/reasoning",
        "description": "تبديل إظهار الاستدلال",
        "usage_hint": "[on|off|stream]"
      },
      {
        "command": "/elevated",
        "description": "تبديل الوضع المرتفع",
        "usage_hint": "[on|off|ask|full]"
      },
      {
        "command": "/exec",
        "description": "عرض إعدادات exec الافتراضية أو تعيينها",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
      },
      {
        "command": "/model",
        "description": "عرض النموذج أو تعيينه",
        "usage_hint": "[name|#|status]"
      },
      {
        "command": "/models",
        "description": "سرد المزوّدين أو نماذج مزوّد معيّن",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
      },
      {
        "command": "/help",
        "description": "عرض ملخص المساعدة المختصر"
      },
      {
        "command": "/commands",
        "description": "عرض كتالوج الأوامر المُولَّد"
      },
      {
        "command": "/tools",
        "description": "عرض ما يمكن للوكيل الحالي استخدامه الآن",
        "usage_hint": "[compact|verbose]"
      },
      {
        "command": "/agentstatus",
        "description": "عرض حالة وقت التشغيل، بما في ذلك استخدام/حصة المزوّد عند توفرها"
      },
      {
        "command": "/tasks",
        "description": "سرد مهام الخلفية النشطة/الحديثة للجلسة الحالية"
      },
      {
        "command": "/context",
        "description": "شرح كيفية تجميع السياق",
        "usage_hint": "[list|detail|json]"
      },
      {
        "command": "/whoami",
        "description": "عرض هوية المُرسِل الخاصة بك"
      },
      {
        "command": "/skill",
        "description": "تشغيل Skill بالاسم",
        "usage_hint": "<name> [input]"
      },
      {
        "command": "/btw",
        "description": "طرح سؤال جانبي بدون تغيير سياق الجلسة",
        "usage_hint": "<question>"
      },
      {
        "command": "/usage",
        "description": "التحكم في تذييل الاستخدام أو عرض ملخص التكلفة",
        "usage_hint": "off|tokens|full|cost"
      }
    ]

    "slash_commands": [
      {
        "command": "/new",
        "description": "بدء جلسة جديدة",
        "usage_hint": "[model]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reset",
        "description": "إعادة تعيين الجلسة الحالية",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/compact",
        "description": "ضغط سياق الجلسة",
        "usage_hint": "[instructions]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/stop",
        "description": "إيقاف التشغيل الحالي",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/session",
        "description": "إدارة انتهاء ربط سلسلة المحادثة",
        "usage_hint": "idle <duration|off> or max-age <duration|off>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/think",
        "description": "تعيين مستوى التفكير",
        "usage_hint": "<off|minimal|low|medium|high|xhigh>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/verbose",
        "description": "تبديل المخرجات التفصيلية",
        "usage_hint": "on|off|full",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/fast",
        "description": "عرض الوضع السريع أو تعيينه",
        "usage_hint": "[status|on|off]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reasoning",
        "description": "تبديل إظهار الاستدلال",
        "usage_hint": "[on|off|stream]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/elevated",
        "description": "تبديل الوضع المرتفع",
        "usage_hint": "[on|off|ask|full]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/exec",
        "description": "عرض إعدادات exec الافتراضية أو تعيينها",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/model",
        "description": "عرض النموذج أو تعيينه",
        "usage_hint": "[name|#|status]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/models",
        "description": "سرد المزوّدين أو نماذج مزوّد معيّن",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/help",
        "description": "عرض ملخص المساعدة المختصر",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/commands",
        "description": "عرض كتالوج الأوامر المُولَّد",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tools",
        "description": "عرض ما يمكن للوكيل الحالي استخدامه الآن",
        "usage_hint": "[compact|verbose]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/agentstatus",
        "description": "عرض حالة وقت التشغيل، بما في ذلك استخدام/حصة المزوّد عند توفرها",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tasks",
        "description": "سرد مهام الخلفية النشطة/الحديثة للجلسة الحالية",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/context",
        "description": "شرح كيفية تجميع السياق",
        "usage_hint": "[list|detail|json]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/whoami",
        "description": "عرض هوية المُرسِل الخاصة بك",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/skill",
        "description": "تشغيل Skill بالاسم",
        "usage_hint": "<name> [input]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/btw",
        "description": "طرح سؤال جانبي بدون تغيير سياق الجلسة",
        "usage_hint": "<question>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/usage",
        "description": "التحكم في تذييل الاستخدام أو عرض ملخص التكلفة",
        "usage_hint": "off|tokens|full|cost",
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]

​

نموذج الرموز المميزة

• botToken و appToken مطلوبان لـ Socket Mode.
• يتطلب وضع HTTP كلاً من botToken و signingSecret.
• تقبل botToken و appToken و signingSecret و userToken سلاسل نصية عادية أو كائنات SecretRef.
• تتجاوز رموز التكوين المميزة بديل متغيرات البيئة.
• ينطبق بديل متغيرات البيئة SLACK_BOT_TOKEN / SLACK_APP_TOKEN على الحساب الافتراضي فقط.
• userToken (xoxp-...) متاح عبر التكوين فقط (من دون بديل متغيرات البيئة) ويكون افتراضيًا بسلوك للقراءة فقط (userTokenReadOnly: true).

• يتتبع فحص حساب Slack حقول *Source و *Status لكل اعتماد (botToken و appToken و signingSecret و userToken).
• تكون الحالة available أو configured_unavailable أو missing.
• تعني configured_unavailable أن الحساب مكوَّن عبر SecretRef أو مصدر أسرار آخر غير مضمن، ولكن مسار الأمر/وقت التشغيل الحالي لم يتمكن من حل القيمة الفعلية.
• في وضع HTTP، يتم تضمين signingSecretStatus؛ وفي Socket Mode، يكون الزوج المطلوب هو botTokenStatus + appTokenStatus.

​

الإجراءات والبوابات

​

التحكم في الوصول والتوجيه

​

سلاسل المحادثات والجلسات وعلامات الرد

• تُوجَّه الرسائل الخاصة كـ direct؛ والقنوات كـ channel؛ وMPIMs كـ group.
• مع الإعداد الافتراضي session.dmScope=main، تُدمج الرسائل الخاصة في Slack ضمن الجلسة الرئيسية للوكيل.
• جلسات القنوات: agent:<agentId>:slack:channel:<channelId>.
• يمكن أن تُنشئ ردود السلاسل لاحقات جلسة خاصة بالسلسلة (:thread:<threadTs>) عند الاقتضاء.
• القيمة الافتراضية لـ channels.slack.thread.historyScope هي thread؛ والقيمة الافتراضية لـ thread.inheritParent هي false.
• تتحكم channels.slack.thread.initialHistoryLimit في عدد رسائل السلسلة الموجودة التي يتم جلبها عند بدء جلسة سلسلة جديدة (الافتراضي 20؛ اضبطها على 0 للتعطيل).
• channels.slack.thread.requireExplicitMention (الافتراضي false): عند تعيينها إلى true، يتم تعطيل الإشارات الضمنية في السلسلة حتى لا يرد البوت إلا على إشارات @bot الصريحة داخل السلاسل، حتى عندما يكون البوت قد شارك بالفعل في السلسلة. ومن دون هذا، تتجاوز الردود في سلسلة شارك فيها البوت بوابة requireMention.

• channels.slack.replyToMode: off|first|all|batched (الافتراضي off)
• channels.slack.replyToModeByChatType: لكل من direct|group|channel
• البديل القديم للمحادثات المباشرة: channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

تفاعلات الإقرار

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• البديل من emoji لهوية الوكيل (agents.list[].identity.emoji، وإلا ”👀”)

• يتوقع Slack shortcodes (مثل "eyes").
• استخدم "" لتعطيل التفاعل لحساب Slack أو على المستوى العام.

​

بث النص

• off: تعطيل بث المعاينة المباشرة.
• partial (الافتراضي): استبدال نص المعاينة بأحدث مخرجات جزئية.
• block: إلحاق تحديثات المعاينة المقطعة.
• progress: عرض نص حالة التقدم أثناء الإنشاء، ثم إرسال النص النهائي.

• يجب أن تكون سلسلة رد متاحة حتى يظهر البث النصي الأصلي وحالة سلسلة مساعد Slack. ويظل اختيار السلسلة يتبع replyToMode.
• يمكن أن تستمر جذور القنوات ومحادثات المجموعات في استخدام معاينة المسودة العادية عندما لا يكون البث الأصلي متاحًا.
• تظل الرسائل الخاصة ذات المستوى الأعلى في Slack خارج السلسلة افتراضيًا، لذلك لا تعرض المعاينة بنمط السلسلة؛ استخدم ردود السلسلة أو typingReaction إذا كنت تريد تقدمًا مرئيًا هناك.
• تعود الوسائط والحمولات غير النصية إلى التسليم العادي.
• إذا فشل البث في منتصف الرد، يعود OpenClaw إلى التسليم العادي للحمولات المتبقية.

{
  channels: {
    slack: {
      streaming: {
        mode: "partial",
        nativeTransport: false,
      },
    },
  },
}

• تتم ترحيل channels.slack.streamMode (replace | status_final | append) تلقائيًا إلى channels.slack.streaming.mode.
• تتم ترحيل channels.slack.streaming المنطقية تلقائيًا إلى channels.slack.streaming.mode و channels.slack.streaming.nativeTransport.
• تتم ترحيل channels.slack.nativeStreaming القديمة تلقائيًا إلى channels.slack.streaming.nativeTransport.

​

بديل تفاعل الكتابة

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

• يتوقع Slack shortcodes (مثل "hourglass_flowing_sand").
• يكون التفاعل على أساس أفضل جهد، وتُحاول عملية التنظيف تلقائيًا بعد اكتمال الرد أو مسار الفشل.

​

الوسائط والتقطيع والتسليم

​

الأوامر وسلوك أوامر الشرطة المائلة

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

/openclaw /help

• يكون الوضع التلقائي للأوامر الأصلية معطّلًا في Slack، لذلك لا يؤدي commands.native: "auto" إلى تفعيل أوامر Slack الأصلية.

/help

• حتى 5 خيارات: كتل أزرار
• من 6 إلى 100 خيار: قائمة تحديد ثابتة
• أكثر من 100 خيار: تحديد خارجي مع تصفية خيارات غير متزامنة عندما تكون معالجات خيارات التفاعلية متاحة
• عند تجاوز حدود Slack: تعود قيم الخيارات المرمّزة إلى الأزرار

/think

​

الردود التفاعلية

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

• هذه واجهة مستخدم خاصة بـ Slack. لا تترجم القنوات الأخرى توجيهات Slack Block Kit إلى أنظمة الأزرار الخاصة بها.
• قيم الاستدعاء التفاعلي هي رموز مبهمة مولدة من OpenClaw، وليست قيمًا خامًا أنشأها الوكيل.
• إذا كانت الكتل التفاعلية المولدة ستتجاوز حدود Slack Block Kit، يعود OpenClaw إلى الرد النصي الأصلي بدلًا من إرسال حمولة كتل غير صالحة.

​

موافقات Exec في Slack

• تستخدم موافقات Exec المسار channels.slack.execApprovals.* للتوجيه الأصلي في الرسائل الخاصة/القنوات.
• لا تزال موافقات plugin تُحل عبر نفس سطح الأزرار الأصلي في Slack عندما يصل الطلب بالفعل إلى Slack ويكون نوع معرّف الموافقة هو plugin:.
• يظل تفويض الموافقين مطبقًا: يمكن فقط للمستخدمين المحددين بوصفهم موافقين الموافقة على الطلبات أو رفضها عبر Slack.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (اختياري؛ يعود إلى commands.ownerAllowFrom عند الإمكان)
• channels.slack.execApprovals.target (dm | channel | both، الافتراضي: dm)
• agentFilter, sessionFilter

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

​

الأحداث والسلوك التشغيلي

• تُحوَّل تعديلات الرسائل/حذفها/بث السلاسل إلى أحداث نظام.
• تُحوَّل أحداث إضافة/إزالة التفاعلات إلى أحداث نظام.
• تُحوَّل أحداث انضمام/مغادرة الأعضاء، وإنشاء/إعادة تسمية القنوات، وإضافة/إزالة التثبيت إلى أحداث نظام.
• يمكن لـ channel_id_changed ترحيل مفاتيح تكوين القناة عندما تكون configWrites مفعلة.
• يُتعامل مع بيانات موضوع/غرض القناة الوصفية على أنها سياق غير موثوق ويمكن حقنها في سياق التوجيه.
• تُرشَّح رسائل بدء السلسلة وتغذية سياق سجل السلسلة الأولي وفقًا لقوائم سماح المرسلين المكوَّنة عند الاقتضاء.
• تصدر إجراءات الكتل وتفاعلات النوافذ المشروطة أحداث نظام منظَّمة من نوع Slack interaction: ... مع حقول حمولة غنية:
  • إجراءات الكتل: القيم المحددة، والتسميات، وقيم أدوات الاختيار، وبيانات workflow_* الوصفية
  • أحداث النوافذ view_submission و view_closed مع بيانات القناة الموجَّهة ومدخلات النماذج

​

مؤشرات مرجعية للتكوين

• مرجع التكوين - Slack حقول Slack عالية الأهمية:
  • الوضع/المصادقة: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • وصول الرسائل الخاصة: dm.enabled, dmPolicy, allowFrom (قديم: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • مفتاح التوافق: dangerouslyAllowNameMatching (للطوارئ؛ اتركه معطلًا ما لم تكن بحاجة إليه)
  • وصول القنوات: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • السلاسل/السجل: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • التسليم: textChunkLimit, chunkMode, mediaMaxMb, streaming, streaming.nativeTransport
  • العمليات/الميزات: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

استكشاف الأخطاء وإصلاحها

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

ذو صلة

• الاقتران
• المجموعات
• الأمان
• توجيه القنوات
• استكشاف الأخطاء وإصلاحها
• التكوين
• أوامر الشرطة المائلة