Slack

​

اختيار وسيلة النقل

​

وضع الترحيل

{
  channels: {
    slack: {
      mode: "relay",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      relay: {
        url: "wss://router.example.com/gateway/ws",
        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },
        gatewayId: "team-gateway",
      },
    },
  },
}

​

عمليات التثبيت على مستوى مؤسسة Enterprise Grid

​

Socket Mode

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      enterpriseOrgInstall: true,
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

عناوين URL لطلبات HTTP

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "channels:history",
        "channels:read",
        "chat:write",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "mpim:history",
        "mpim:read",
        "reactions:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "org_deploy_enabled": true,
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim"
      ]
    }
  }
}

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      enterpriseOrgInstall: true,
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: {
        source: "env",
        provider: "default",
        id: "SLACK_SIGNING_SECRET",
      },
      webhookPath: "/slack/events",
      dmPolicy: "open",
      allowFrom: ["*"],
      groupPolicy: "allowlist",
      channels: {
        C0123456789: { requireMention: true },
      },
    },
  },
}

​

التثبيت

openclaw plugins install @openclaw/slack

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.",
      "suggested_prompts": [
        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },
        {
          "title": "تلخيص هذه القناة",
          "message": "لخّص النشاط الأخير في هذه القناة."
        },
        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }
      ]
    },
    "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",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.",
      "suggested_prompts": [
        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },
        {
          "title": "تلخيص هذه القناة",
          "message": "لخّص النشاط الأخير في هذه القناة."
        },
        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }
      ]
    },
    "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",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
cat > slack.socket.patch.json5 <<'JSON5'
{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
    },
  },
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "يربط OpenClaw سلاسل محادثات مساعد Slack بوكلاء OpenClaw.",
      "suggested_prompts": [
        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },
        {
          "title": "تلخيص هذه القناة",
          "message": "لخّص النشاط الأخير في هذه القناة."
        },
        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }
      ]
    },
    "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",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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"
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "يربط OpenClaw سلاسل مساعد Slack بوكلاء OpenClaw.",
      "suggested_prompts": [
        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },
        {
          "title": "لخّص هذه القناة",
          "message": "لخّص النشاط الأخير في هذه القناة."
        },
        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }
      ]
    },
    "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",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

export SLACK_BOT_TOKEN=slack-bot-token-example
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
      webhookPath: "/slack/events",
    },
  },
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

​

ضبط نقل وضع Socket

{
  channels: {
    slack: {
      mode: "socket",
      socketMode: {
        clientPingTimeout: 20000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
    },
  },
}

• يتم تجاهل socketMode في وضع HTTP Request URL.
• تنطبق إعدادات channels.slack.socketMode الأساسية على جميع حسابات Slack ما لم يتم تجاوزها. تستخدم التجاوزات الخاصة بكل حساب channels.slack.accounts.<accountId>.socketMode؛ ونظرًا إلى أن هذا تجاوز كائن، فأدرج كل حقل من حقول ضبط Socket الذي تريده لذلك الحساب.
• لا يملك قيمة OpenClaw افتراضية (15000) سوى clientPingTimeout. لا يتم تمرير serverPingTimeout وpingPongLoggingEnabled إلى Slack SDK إلا عند تهيئتهما.
• يبدأ التراجع بين محاولات إعادة تشغيل وضع Socket من نحو 2 ثانية ويبلغ حده الأقصى عند نحو 30 ثانية. تُعاد محاولة إخفاقات البدء وانتظار البدء وانقطاع الاتصال القابلة للاسترداد حتى تتوقف القناة. أما أخطاء الحساب وبيانات الاعتماد الدائمة، مثل المصادقة غير الصالحة أو الرموز المميزة الملغاة أو النطاقات المفقودة، فتفشل سريعًا بدلًا من إعادة المحاولة إلى الأبد.

​

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

{
  "display_information": {
    "name": "OpenClaw",
    "description": "موصل Slack لـ OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "assistant_view": {
      "assistant_description": "يربط OpenClaw سلاسل مساعد Slack بوكلاء OpenClaw.",
      "suggested_prompts": [
        { "title": "ما الذي يمكنك فعله؟", "message": "بماذا يمكنك مساعدتي؟" },
        {
          "title": "لخّص هذه القناة",
          "message": "لخّص النشاط الأخير في هذه القناة."
        },
        { "title": "صياغة رد", "message": "ساعدني في صياغة رد." }
      ]
    },
    "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",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "إرسال رسالة إلى OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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": "خمول <duration|off> أو أقصى عمر <duration|off>"
    },
    {
      "command": "/think",
      "description": "تعيين مستوى التفكير",
      "usage_hint": "<level>"
    },
    {
      "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": "عرض الإعدادات الافتراضية للتنفيذ أو تعيينها",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "الموافقة على طلبات الموافقة المعلّقة أو رفضها",
      "usage_hint": "<id> <decision>"
    },
    {
      "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": "تشغيل مهارة بالاسم",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "طرح سؤال جانبي دون تغيير سياق الجلسة",
      "usage_hint": "<question>"
    },
    {
      "command": "/side",
      "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": "/help",
      "description": "عرض ملخص المساعدة القصير",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

نموذج الرموز

• botToken + appToken مطلوبان لـ Socket Mode.
• يتطلب وضع HTTP ‏botToken + signingSecret.
• يتطلب وضع الترحيل botToken بالإضافة إلى relay.url وrelay.authToken وrelay.gatewayId؛ ولا يستخدم رمز تطبيق أو سر توقيع.
• تقبل botToken وappToken وsigningSecret وrelay.authToken وuserToken سلاسل نصية عادية أو كائنات SecretRef.
• تتجاوز رموز الإعدادات القيم الاحتياطية لمتغيرات البيئة.
• تنطبق القيم الاحتياطية لمتغيرات البيئة SLACK_BOT_TOKEN وSLACK_APP_TOKEN وSLACK_USER_TOKEN كلٌّ منها على الحساب الافتراضي فقط.
• تكون القيمة الافتراضية لـ userToken سلوك القراءة فقط (userTokenReadOnly: true).

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

​

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

​

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

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { enabled: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { enabled: true, requireMention: true },
      },
    },
  },
}

​

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

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

• channels.slack.channels.<id>.replyToMode: تجاوز لكل قناة لرسائل قنوات Slack والقنوات الخاصة
• channels.slack.replyToMode: off|first|all|batched (الافتراضي off)
• channels.slack.replyToModeByChatType: لكل direct|group|channel
• البديل الاحتياطي القديم للمحادثات المباشرة: channels.slack.dm.replyToMode

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

​

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

​

الرمز التعبيري (ackReaction)

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• البديل الاحتياطي للرمز التعبيري لهوية الوكيل (agents.list[].identity.emoji، وإلا "eyes" / 👀)

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

​

النطاق (messages.ackReactionScope)

• "all": التفاعل في الرسائل المباشرة والمجموعات، بما في ذلك أحداث الغرف المحيطة.
• "direct": التفاعل في الرسائل المباشرة فقط.
• "group-all": التفاعل مع كل رسالة جماعية باستثناء أحداث الغرف المحيطة (من دون رسائل مباشرة).
• "group-mentions" (الافتراضي): التفاعل في المجموعات، ولكن فقط عند الإشارة إلى البوت (أو في العناصر القابلة للإشارة الجماعية التي اشتركت). تُستبعد الرسائل المباشرة.
• "off" / "none": عدم التفاعل مطلقًا.

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // التفاعل في الرسائل المباشرة والمجموعات
  },
}

​

بث النص

• off: تعطيل بث المعاينة المباشرة.
• partial (الافتراضي): استبدال نص المعاينة بأحدث مخرجات جزئية.
• block: إلحاق تحديثات المعاينة المجزأة.
• progress: عرض نص حالة التقدم أثناء الإنشاء، ثم إرسال النص النهائي.
• streaming.preview.toolProgress: عندما تكون معاينة المسودة نشطة، توجيه تحديثات الأداة/التقدم إلى رسالة المعاينة المعدّلة نفسها (الافتراضي: true). اضبط false للاحتفاظ برسائل منفصلة للأداة/التقدم.
• streaming.preview.commandText / streaming.progress.commandText: اضبطها على status للاحتفاظ بأسطر تقدم الأداة الموجزة مع إخفاء نص الأمر/التنفيذ الأولي (الافتراضي: raw).

{
  "channels": {
    "slack": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

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

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

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          nativeTaskCards: true,
          render: "rich",
        },
      },
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) اسم مستعار قديم لـ channels.slack.streaming.mode.
• القيمة المنطقية channels.slack.streaming اسم مستعار قديم لـ channels.slack.streaming.mode وchannels.slack.streaming.nativeTransport.
• القيمتان channels.slack.chunkMode وchannels.slack.nativeStreaming على المستوى الأعلى اسمان مستعاران قديمان لـ channels.slack.streaming.chunkMode وchannels.slack.streaming.nativeTransport.
• لا تُقرأ الأسماء المستعارة القديمة في وقت التشغيل؛ شغّل openclaw doctor --fix لإعادة كتابة إعدادات بث Slack المحفوظة باستخدام المفاتيح القياسية.

​

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

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

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

​

الإدخال الصوتي

• يعمل الإملاء الصوتي في Slackbot داخل محادثة Slackbot الخاصة بالمستخدم. يحوّل Slack التسجيل إلى مطالبة في Slackbot، لكنه لا يرسل ملفًا صوتيًا أو حدث إملاء أو مطالبة أو علامة لمصدر الإدخال إلى تطبيقات Slack التابعة لجهات خارجية عبر Events API. لا يمكن لـ Plugin Slack في OpenClaw تمكينه أو استقباله.
• مقاطع Slack الصوتية هي ملفات مخزنة في Slack يمكن نشرها في رسالة خاصة أو قناة أو سلسلة محادثات في OpenClaw. ينزّل OpenClaw المقطع القابل للوصول باستخدام رمز البوت، ويوحّد بيانات MIME الوصفية للمقطع في Slack، ثم يرسله عبر مسار تحويل الصوت إلى نص المشترك. يتضمن بيان التطبيق الموصى به نطاق files:read المطلوب.

​

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

​

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

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

/openclaw /help

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

/help

• من 3 إلى 5 خيارات قصيرة بما يكفي: قائمة تجاوز (”…”)
• أكثر من 100 خيار، مع توفر تصفية غير متزامنة للخيارات: تحديد خارجي
• خيار واحد أو خياران، أو أي خيار تكون قيمته المشفرة أطول مما يسمح به عنصر التحديد: كتل أزرار
• خلاف ذلك (من 6 إلى 100 خيار، أو أكثر من 100 دون تصفية غير متزامنة): قائمة تحديد ثابتة، مقسمة إلى 100 خيار لكل قائمة

/think

​

المخططات الأصلية

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "الإيرادات الفصلية",
      "categories": ["الربع الأول", "الربع الثاني"],
      "series": [{ "name": "الإيرادات", "values": [120, 145] }],
      "xLabel": "الربع"
    }
  ]
}

• العنوان وتسميات المحاور الاختيارية: 50 حرفًا
• المخطط الدائري: من 1 إلى 12 قطاعًا موجبًا
• المخطط الخطي أو الشريطي أو المساحي: من 1 إلى 12 سلسلة ذات أسماء فريدة ومن 1 إلى 20 فئة مشتركة
• تسميات القطاعات والفئات والسلاسل: 20 حرفًا
• يجب أن تحتوي كل سلسلة على قيمة محدودة واحدة لكل فئة؛ ويمكن أن تكون قيم المخططات غير الدائرية سالبة

​

الجداول الأصلية

{
  "blocks": [
    {
      "type": "table",
      "caption": "مسار المبيعات المفتوح",
      "headers": ["الحساب", "المرحلة", "الإيراد السنوي المتكرر"],
      "rows": [
        ["Acme", "تم الفوز", 125000],
        ["Globex", "قيد المراجعة", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• من 1 إلى 20 عمودًا
• من 1 إلى 100 صف بيانات، بالإضافة إلى صف العنوان
• العدد نفسه من الخلايا في كل صف
• بحد أقصى 10,000 حرف إجمالًا عبر جميع خلايا الجدول في رسالة واحدة

​

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

{
  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]]

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

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

​

عمليات إرسال النماذج المشروطة المملوكة للـ Plugin

• اضبط callback_id على openclaw:<namespace>:<payload>.
• أو احتفظ بـ callback_id موجود وضع pluginInteractiveData: "<namespace>:<payload>" في private_metadata الخاص بالنموذج المشروط.

​

الموافقات الأصلية في Slack

• يمكن عرض موافقات التنفيذ والـ Plugin كمطالبات Slack Block Kit أصلية.
• يظل channels.slack.execApprovals.* إعداد تمكين عميل موافقات التنفيذ الأصلي وتوجيه الرسائل المباشرة/القنوات.
• تستخدم الرسائل المباشرة لموافقة التنفيذ channels.slack.execApprovals.approvers أو commands.ownerAllowFrom.
• تستخدم موافقات الـ Plugin أزرار Slack الأصلية عندما يكون Slack مفعّلًا كعميل موافقات أصلي للجلسة المنشئة، أو عندما يوجّه approvals.plugin إلى جلسة Slack المنشئة أو إلى هدف Slack.
• تستخدم الرسائل المباشرة لموافقة الـ Plugin معتمدي Slack Plugin من channels.slack.allowFrom، أو allowFrom للحساب المسمّى، أو مسار الحساب الافتراضي.
• يظل تفويض المعتمد مفروضًا: لا يمكن للمعتمدين المخوّلين للتنفيذ فقط الموافقة على طلبات الـ Plugin ما لم يكونوا أيضًا من معتمدي الـ Plugin.

• 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",
      },
    },
  },
}

​

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

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

​

أحداث الحضور

{
  channels: {
    slack: {
      presenceEvents: { mode: "auto" },
      channels: {
        C0123456789: { presenceEvents: { mode: "on" } },
        C0987654321: { presenceEvents: { mode: "off" } },
      },
    },
  },
}

• off (الافتراضي): لا يوجد مؤقت حضور أو استدعاءات Slack API.
• auto: راقب الرسائل المباشرة وMPIMs وسلاسل Slack النشطة خلال آخر 24 ساعة، بحد أقصى 8 مشاركين بشر تمت ملاحظتهم. تُستبعد جلسات القنوات ذات المستوى الأعلى.
• on: راقب المحادثات نفسها من دون حد للمشاركين، وأدرج جلسات القنوات ذات المستوى الأعلى. استخدم تجاوزًا خاصًا بكل قناة لفرض مراقبة قناة واحدة أو منعها.

​

مرجع الإعداد

​

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

{
  messages: {
    groupChat: {
      visibleReplies: "automatic",
    },
  },
}

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

openclaw pairing list slack

​

مرجع وسائط المرفقات

​

أنواع الوسائط المدعومة

​

مسار المعالجة الواردة

1. ينزّل OpenClaw الملف من عنوان URL الخاص في Slack باستخدام رمز البوت.
2. يُكتب الملف في مخزن الوسائط عند النجاح.
3. تُضاف مسارات الوسائط المنزّلة وأنواع محتواها إلى السياق الوارد.
4. تُوجّه المقاطع الصوتية إلى مسار النسخ المشترك؛ ويمكن لمسارات النماذج/الأدوات الداعمة للصور استخدام مرفقات الصور من السياق نفسه.
5. تظل الملفات الأخرى متاحة كبيانات وصفية للملفات أو مراجع وسائط للأدوات القادرة على التعامل معها.

​

توارث مرفقات جذر سلسلة المحادثة

• إذا لم يحتوِ الرد نفسه على وسائط مباشرة وكانت الرسالة الجذرية المضمّنة تحتوي على ملفات، فيمكن لـ Slack تحميل ملفات الجذر كسياق لبادئ سلسلة المحادثات.
• تُحمّل ملفات الجذر فقط عند تهيئة جلسة سلسلة محادثات جديدة أو معاد ضبطها. تعيد الردود النصية اللاحقة استخدام سياق الجلسة الحالي ولا تعيد إرفاق ملفات الجذر كوسائط جديدة.
• تأخذ مرفقات الرد المباشرة الأولوية على مرفقات الرسالة الجذرية.
• تُمثّل الرسالة الجذرية التي تحتوي ملفات فقط ولا تحتوي نصًا بعنصر نائب للمرفق، بحيث يمكن للخيار الاحتياطي تضمين ملفاتها مع ذلك.

​

معالجة المرفقات المتعددة

• يُعالج كل مرفق بصورة مستقلة عبر مسار الوسائط.
• تُجمّع مراجع الوسائط المنزّلة في سياق الرسالة.
• يتبع ترتيب المعالجة ترتيب ملفات Slack في حمولة الحدث.
• لا يمنع فشل تنزيل أحد المرفقات معالجة المرفقات الأخرى.

​

حدود الحجم والتنزيل والنموذج

• حد الحجم: الافتراضي 20 MB لكل ملف. قابل للتهيئة عبر channels.slack.mediaMaxMb.
• حد النسخ الصوتي: ينطبق tools.media.audio.maxBytes أيضًا عند إرسال الملف المنزّل إلى موفّر نسخ أو CLI.
• إخفاقات التنزيل: تُتخطى الملفات التي يتعذر على Slack توفيرها، وعناوين URL المنتهية الصلاحية، والملفات التي يتعذر الوصول إليها، والملفات التي تتجاوز الحجم، واستجابات HTML الخاصة بمصادقة/تسجيل دخول Slack، بدلًا من الإبلاغ عنها كتنسيقات غير مدعومة.
• نموذج الرؤية: يستخدم تحليل الصور نموذج الرد النشط عندما يدعم الرؤية، أو نموذج الصور المُعدّ في agents.defaults.imageModel.

​

القيود المعروفة

​

الوثائق ذات الصلة

• مسار فهم الوسائط
• الصوت والملاحظات الصوتية
• أداة PDF

​

ذات صلة