Configuration — القنوات

​

القنوات

​

الوصول إلى الرسائل المباشرة والمجموعات

​

تجاوزات نموذج القناة

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.5",
        "user:U12345": "openai/gpt-5.4-mini",
      },
      telegram: {
        "-1001234567890": "openai/gpt-5.4-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
        "123456789": "openai/gpt-4.1",
      },
    },
  },
}

​

افتراضيات القناة وHeartbeat

{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: سياسة المجموعة الاحتياطية عندما تكون groupPolicy على مستوى المزوّد غير مضبوطة.
• channels.defaults.contextVisibility: وضع رؤية السياق التكميلي الافتراضي لكل القنوات. القيم: all (الافتراضي، تضمين كل سياق الاقتباس/السلسلة/السجل)، وallowlist (تضمين السياق من المرسلين الموجودين في قائمة السماح فقط)، وallowlist_quote (مثل قائمة السماح لكن مع إبقاء سياق الاقتباس/الرد الصريح). التجاوز لكل قناة: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: تضمين حالات القنوات السليمة في مخرجات Heartbeat.
• channels.defaults.heartbeat.showAlerts: تضمين حالات التدهور/الأخطاء في مخرجات Heartbeat.
• channels.defaults.heartbeat.useIndicator: عرض مخرجات Heartbeat بأسلوب مؤشرات مضغوط.

​

WhatsApp

{
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // blue ticks (false in self-chat mode)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

• تهيئ إدخالات bindings[] العليا ذات type: "acp" روابط ACP دائمة لرسائل ومجموعات WhatsApp المباشرة. استخدم رقماً مباشراً بصيغة E.164 أو JID لمجموعة WhatsApp في match.peer.id. دلالات الحقول مشتركة في وكلاء ACP.

{
  channels: {
    whatsapp: {
      accounts: {
        default: {},
        personal: {},
        biz: {
          // authDir: "~/.openclaw/credentials/whatsapp/biz",
        },
      },
    },
  },
}

​

Telegram

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-bot-token",
      dmPolicy: "pairing",
      allowFrom: ["tg:123456789"],
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {
          allowFrom: ["@admin"],
          systemPrompt: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: "partial", // off | partial | block | progress (default: partial)
      actions: { reactions: true, sendMessage: true },
      reactionNotifications: "own", // off | own | all
      mediaMaxMb: 100,
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
      network: {
        autoSelectFamily: true,
        dnsResultOrder: "ipv4first",
      },
      apiRoot: "https://api.telegram.org",
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• رمز البوت: channels.telegram.botToken أو channels.telegram.tokenFile (ملف عادي فقط؛ تُرفض الروابط الرمزية)، مع TELEGRAM_BOT_TOKEN كاحتياطي للحساب الافتراضي.
• apiRoot هو جذر Telegram Bot API فقط. استخدم https://api.telegram.org أو جذر الاستضافة الذاتية/الوكيل لديك، وليس https://api.telegram.org/bot<TOKEN>؛ يزيل openclaw doctor --fix لاحقة /bot<TOKEN> الزائدة بالخطأ.
• يتجاوز channels.telegram.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرّف حساب مهيأ.
• في إعدادات الحسابات المتعددة (معرّفا حساب أو أكثر)، اضبط افتراضياً صريحاً (channels.telegram.defaultAccount أو channels.telegram.accounts.default) لتجنب التوجيه الاحتياطي؛ يحذر openclaw doctor عندما يكون هذا مفقوداً أو غير صالح.
• يحظر configWrites: false عمليات كتابة التهيئة التي يبدأها Telegram (ترحيلات معرّفات المجموعات الفائقة، و/config set|unset).
• تهيئ إدخالات bindings[] العليا ذات type: "acp" روابط ACP دائمة لموضوعات المنتدى (استخدم chatId:topic:topicId القياسي في match.peer.id). دلالات الحقول مشتركة في وكلاء ACP.
• تستخدم معاينات بث Telegram sendMessage + editMessageText (تعمل في المحادثات المباشرة والجماعية).
• سياسة إعادة المحاولة: راجع سياسة إعادة المحاولة.

​

Discord

{
  channels: {
    discord: {
      enabled: true,
      token: "your-bot-token",
      mediaMaxMb: 100,
      allowBots: false,
      actions: {
        reactions: true,
        stickers: true,
        polls: true,
        permissions: true,
        messages: true,
        threads: true,
        pins: true,
        search: true,
        memberInfo: true,
        roleInfo: true,
        roles: false,
        channelInfo: true,
        voiceStatus: true,
        events: true,
        moderation: false,
      },
      replyToMode: "off", // off | first | all | batched
      dmPolicy: "pairing",
      allowFrom: ["1234567890", "123456789012345678"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          ignoreOtherMentions: true,
          reactionNotifications: "own",
          users: ["987654321098765432"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321098765432"],
              skills: ["docs"],
              systemPrompt: "Short answers only.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      suppressEmbeds: true,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          toolProgress: true,
        },
      },
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        connectTimeoutMs: 30000,
        reconnectGraceMs: 15000,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
        },
      },
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["987654321098765432"],
        agentFilter: ["default"],
        sessionFilter: ["discord:"],
        target: "dm", // dm | channel | both
        cleanupAfterResolve: false,
      },
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

• الرمز المميز: channels.discord.token، مع DISCORD_BOT_TOKEN كخيار احتياطي للحساب الافتراضي.
• تستخدم الاستدعاءات الصادرة المباشرة التي توفر token صريحا لـ Discord ذلك الرمز المميز للاستدعاء؛ وتظل إعدادات إعادة المحاولة/السياسة الخاصة بالحساب مأخوذة من الحساب المحدد في لقطة وقت التشغيل النشطة.
• يتجاوز channels.discord.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مكوّنا.
• استخدم user:<id> (رسالة مباشرة) أو channel:<id> (قناة خادم) لأهداف التسليم؛ تُرفض المعرفات الرقمية المجردة.
• تكون أسماء الخوادم المختصرة بأحرف صغيرة مع استبدال المسافات بـ -؛ وتستخدم مفاتيح القنوات الاسم المختصر (من دون #). يُفضّل استخدام معرفات الخوادم.
• تُتجاهل الرسائل التي كتبها الروبوت افتراضيا. يفعّلها allowBots: true؛ استخدم allowBots: "mentions" لقبول رسائل الروبوت التي تذكر الروبوت فقط (مع استمرار تصفية رسائله الذاتية).
• يمكن للقنوات التي تدعم الرسائل الواردة المكتوبة بواسطة الروبوت استخدام حماية حلقة الروبوت المشتركة. اضبط channels.defaults.botLoopProtection لميزانيات الأزواج الأساسية، ثم تجاوز القناة أو الحساب فقط عندما يحتاج سطح واحد إلى حدود مختلفة.
• يُسقط channels.discord.guilds.<id>.ignoreOtherMentions (وتجاوزات القنوات) الرسائل التي تذكر مستخدما آخر أو دورا آخر ولكن لا تذكر الروبوت (باستثناء @everyone/@here).
• يربط channels.discord.mentionAliases نص @handle الصادر المستقر بمعرفات مستخدمي Discord قبل الإرسال، بحيث يمكن ذكر الزملاء المعروفين بصورة حتمية حتى عندما تكون ذاكرة التخزين المؤقت العابرة للدليل فارغة. توجد تجاوزات كل حساب ضمن channels.discord.accounts.<accountId>.mentionAliases.
• يقسّم maxLinesPerMessage (الافتراضي 17) الرسائل الطويلة حتى عندما تكون أقل من 2000 حرف.
• يكون channels.discord.suppressEmbeds افتراضيا true، لذلك لا تتوسع عناوين URL الصادرة إلى معاينات روابط Discord ما لم يُعطّل ذلك. تظل حمولات embeds الصريحة تُرسل بشكل طبيعي؛ ويمكن لاستدعاءات الأدوات لكل رسالة التجاوز باستخدام suppressEmbeds.
• يتحكم channels.discord.threadBindings في توجيه Discord المرتبط بالخيوط:
  • enabled: تجاوز Discord لميزات الجلسات المرتبطة بالخيوط (/focus و/unfocus و/agents و/session idle و/session max-age والتسليم/التوجيه المرتبط)
  • idleHours: تجاوز Discord لإلغاء التركيز التلقائي بسبب عدم النشاط بالساعات (0 يعطّل)
  • maxAgeHours: تجاوز Discord للحد الأقصى الصارم للعمر بالساعات (0 يعطّل)
  • spawnSessions: مفتاح لـ sessions_spawn({ thread: true }) وإنشاء/ربط الخيط التلقائي عند إنشاء خيط ACP (الافتراضي: true)
  • defaultSpawnContext: سياق الوكيل الفرعي الأصلي لعمليات الإنشاء المرتبطة بالخيوط ("fork" افتراضيا)
• تُكوّن إدخالات bindings[] ذات المستوى الأعلى مع type: "acp" ارتباطات ACP دائمة للقنوات والخيوط (استخدم معرف القناة/الخيط في match.peer.id). تشترك دلالات الحقول في وكلاء ACP.
• يضبط channels.discord.ui.components.accentColor لون التمييز لحاويات مكونات Discord v2.
• يتحكم channels.discord.agentComponents.ttlMs في مدة بقاء استدعاءات مكونات Discord المرسلة مسجلة. القيمة الافتراضية هي 1800000 (30 دقيقة)، والحد الأقصى هو 86400000 (24 ساعة)، وتوجد تجاوزات كل حساب ضمن channels.discord.accounts.<accountId>.agentComponents.ttlMs. تُبقي القيم الأطول الأزرار/القوائم/النماذج القديمة قابلة للاستخدام لمدة أطول، لذلك فضّل أقصر مدة TTL تناسب سير العمل.
• يفعّل channels.discord.voice محادثات قنوات الصوت في Discord وتجاوزات اختيارية للانضمام التلقائي + LLM + TTS. تترك إعدادات Discord النصية فقط الصوت متوقفا افتراضيا؛ اضبط channels.discord.voice.enabled=true للاشتراك.
• يتجاوز channels.discord.voice.model اختياريا نموذج LLM المستخدم لاستجابات قنوات الصوت في Discord.
• يمرر channels.discord.voice.daveEncryption وchannels.discord.voice.decryptionFailureTolerance إلى خيارات DAVE في @discordjs/voice (true و24 افتراضيا).
• يتحكم channels.discord.voice.connectTimeoutMs في انتظار Ready الأولي لـ @discordjs/voice لمحاولات /vc join والانضمام التلقائي (30000 افتراضيا).
• يتحكم channels.discord.voice.reconnectGraceMs في المدة التي يمكن أن تستغرقها جلسة صوت منفصلة للدخول في إشارات إعادة الاتصال قبل أن يدمرها OpenClaw (15000 افتراضيا).
• لا تتم مقاطعة تشغيل صوت Discord بحدث بدء تحدث مستخدم آخر. لتجنب حلقات التغذية الراجعة، يتجاهل OpenClaw التقاط الصوت الجديد أثناء تشغيل TTS.
• يحاول OpenClaw أيضا استعادة استقبال الصوت بمغادرة جلسة صوت وإعادة الانضمام إليها بعد تكرار فشل فك التشفير.
• channels.discord.streaming هو مفتاح وضع البث المعياري. يستخدم Discord افتراضيا streaming.mode: "progress" بحيث يظهر تقدم الأدوات/العمل في رسالة معاينة واحدة محررة؛ اضبط streaming.mode: "off" لتعطيله. تظل قيم streamMode القديمة وقيم streaming المنطقية أسماء مستعارة وقت التشغيل؛ شغّل openclaw doctor --fix لإعادة كتابة الإعدادات المحفوظة.
• يربط channels.discord.autoPresence إتاحة وقت التشغيل بحالة حضور الروبوت (سليم => متصل، متدهور => خامل، مستنفد => عدم الإزعاج) ويسمح بتجاوزات اختيارية لنص الحالة.
• يعيد channels.discord.dangerouslyAllowNameMatching تفعيل مطابقة الاسم/الوسم القابلة للتغيير (وضع توافق لكسر الزجاج).
• channels.discord.execApprovals: تسليم موافقات التنفيذ الأصلية في Discord وتفويض الموافقين.
  • enabled: true أو false أو "auto" (الافتراضي). في الوضع التلقائي، تنشط موافقات التنفيذ عندما يمكن حل الموافقين من approvers أو commands.ownerAllowFrom.
  • approvers: معرفات مستخدمي Discord المسموح لهم بالموافقة على طلبات التنفيذ. يعود إلى commands.ownerAllowFrom عند حذفه.
  • agentFilter: قائمة سماح اختيارية لمعرفات الوكلاء. احذفها لتمرير الموافقات لجميع الوكلاء.
  • sessionFilter: أنماط اختيارية لمفاتيح الجلسات (سلسلة فرعية أو تعبير نمطي).
  • target: مكان إرسال مطالبات الموافقة. يرسل "dm" (الافتراضي) إلى الرسائل المباشرة للموافق، ويرسل "channel" إلى القناة الأصلية، ويرسل "both" إلى الاثنين معا. عندما يتضمن الهدف "channel"، لا تكون الأزرار قابلة للاستخدام إلا من قِبل الموافقين المحلولين.
  • cleanupAfterResolve: عندما تكون true، تحذف رسائل الموافقة المباشرة بعد الموافقة أو الرفض أو انتهاء المهلة.

​

Google Chat

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url", // app-url | project-number
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890",
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["users/1234567890"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• JSON حساب الخدمة: مضمّن (serviceAccount) أو قائم على ملف (serviceAccountFile).
• SecretRef لحساب الخدمة مدعوم أيضا (serviceAccountRef).
• بدائل البيئة: GOOGLE_CHAT_SERVICE_ACCOUNT أو GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• استخدم spaces/<spaceId> أو users/<userId> لأهداف التسليم.
• يعيد channels.googlechat.dangerouslyAllowNameMatching تفعيل مطابقة كيان البريد الإلكتروني القابلة للتغيير (وضع توافق لكسر الزجاج).

​

Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      socketMode: {
        clientPingTimeout: 15000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
      dmPolicy: "pairing",
      allowFrom: ["U123", "U456", "*"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
      channels: {
        C123: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      actions: {
        reactions: true,
        messages: true,
        pins: true,
        memberInfo: true,
        emojiList: true,
      },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
      typingReaction: "hourglass_flowing_sand",
      unfurlLinks: false,
      unfurlMedia: false,
      textChunkLimit: 4000,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // use Slack native streaming API when mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• يتطلب وضع Socket كلًا من botToken وappToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN لاستخدام حساب fallback الافتراضي من env).
• يتطلب وضع HTTP وجود botToken بالإضافة إلى signingSecret (في الجذر أو لكل حساب).
• يمرر socketMode ضبط نقل Slack SDK Socket Mode إلى واجهة Bolt receiver API العامة. استخدمه فقط عند التحقيق في مهلة ping/pong أو سلوك websocket القديم. القيمة الافتراضية لـ clientPingTimeout هي 15000؛ ولا يتم تمرير serverPingTimeout وpingPongLoggingEnabled إلا عند ضبطهما.
• تقبل botToken وappToken وsigningSecret وuserToken سلاسل نصية عادية أو كائنات SecretRef.
• تعرض لقطات حساب Slack حقول المصدر/الحالة لكل اعتماد، مثل botTokenSource وbotTokenStatus وappTokenStatus، وفي وضع HTTP، signingSecretStatus. تعني configured_unavailable أن الحساب مضبوط عبر SecretRef لكن مسار الأمر/التشغيل الحالي لم يتمكن من حل قيمة السر.
• يمنع configWrites: false عمليات كتابة الإعدادات التي يبدأها Slack.
• يتجاوز channels.slack.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مضبوطًا.
• channels.slack.streaming.mode هو مفتاح وضع بث Slack القياسي. يتحكم channels.slack.streaming.nativeTransport في نقل البث الأصلي في Slack. تبقى قيم streamMode القديمة، وstreaming المنطقية، وnativeStreaming أسماء بديلة في وقت التشغيل؛ شغّل openclaw doctor --fix لإعادة كتابة الإعدادات المحفوظة.
• يمرر unfurlLinks وunfurlMedia القيم المنطقية الخاصة بفك روابط ووسائط chat.postMessage في Slack لردود البوت. القيمة الافتراضية لـ unfurlLinks هي false حتى لا تتوسع روابط البوت الصادرة داخل السطر ما لم يتم تفعيل ذلك؛ ويتم حذف unfurlMedia ما لم يُضبط. عيّن أيًا من القيمتين في channels.slack.accounts.<accountId> لتجاوز قيمة المستوى الأعلى لحساب واحد.
• استخدم user:<id> (DM) أو channel:<id> لأهداف التسليم.

• يتطلب البث الأصلي في Slack مع حالة الخيط بأسلوب مساعد Slack “is typing…” هدف خيط للرد. تبقى رسائل DM في المستوى الأعلى خارج الخيط افتراضيًا، لذلك لا يزال بإمكانها البث عبر معاينات منشور مسودة Slack وتحريرها بدلًا من إظهار معاينة البث/الحالة الأصلية بأسلوب الخيط.
• يضيف typingReaction تفاعلًا مؤقتًا إلى رسالة Slack الواردة أثناء تشغيل الرد، ثم يزيله عند الاكتمال. استخدم اختصار رمز تعبيري في Slack مثل "hourglass_flowing_sand".
• channels.slack.execApprovals: تسليم عميل الموافقات الأصلي في Slack وتخويل موافق التنفيذ. المخطط نفسه كما في Discord: enabled (true/false/"auto")، وapprovers (معرفات مستخدمي Slack)، وagentFilter، وsessionFilter، وtarget ("dm" أو "channel" أو "both"). يمكن لموافقات Plugin استخدام مسار العميل الأصلي هذا للطلبات الصادرة من Slack عندما يتم حل موافقي Slack plugin؛ كما يمكن تفعيل تسليم موافقات Plugin الأصلية في Slack عبر approvals.plugin لجلسات منشؤها Slack أو أهداف Slack. تستخدم موافقات Plugin موافقي Slack plugin من allowFrom والتوجيه الافتراضي، وليس موافقي التنفيذ.

​

Mattermost

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // opt-in
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Optional explicit URL for reverse-proxy/public deployments
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

• يجب أن يكون commands.callbackPath مسارًا (على سبيل المثال /api/channels/mattermost/command)، وليس URL كاملًا.
• يجب أن يحل commands.callbackUrl إلى نقطة نهاية OpenClaw Gateway وأن يكون قابلًا للوصول من خادم Mattermost.
• تتم مصادقة استدعاءات الشرطة المائلة الأصلية باستخدام الرموز المميزة لكل أمر التي يعيدها Mattermost أثناء تسجيل أمر الشرطة المائلة. إذا فشل التسجيل أو لم يتم تفعيل أي أوامر، يرفض OpenClaw الاستدعاءات باستخدام Unauthorized: invalid command token.
• بالنسبة لمضيفي الاستدعاء الخاصين/داخل tailnet/الداخليين، قد يتطلب Mattermost أن يتضمن ServiceSettings.AllowedUntrustedInternalConnections مضيف/نطاق الاستدعاء. استخدم قيم المضيف/النطاق، وليس عناوين URL كاملة.
• channels.mattermost.configWrites: السماح بعمليات كتابة الإعدادات التي يبدأها Mattermost أو رفضها.
• channels.mattermost.requireMention: يتطلب @mention قبل الرد في القنوات.
• channels.mattermost.groups.<channelId>.requireMention: تجاوز بوابة الإشارة لكل قناة ("*" للافتراضي).
• يتجاوز channels.mattermost.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مضبوطًا.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // optional account binding
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

• channels.signal.account: تثبيت بدء تشغيل القناة على هوية حساب Signal محددة.
• channels.signal.configWrites: السماح بعمليات كتابة الإعدادات التي يبدأها Signal أو رفضها.
• يتجاوز channels.signal.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مضبوطًا.

​

iMessage

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],
      historyLimit: 50,
      includeAttachments: false,
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      mediaMaxMb: 16,
      service: "auto",
      sendTransport: "auto",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
    },
  },
}

• يتجاوز channels.imessage.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مضبوطًا.
• يتطلب Full Disk Access إلى قاعدة بيانات Messages.
• فضّل أهداف chat_id:<id>. استخدم imsg chats --limit 20 لسرد الدردشات.
• يمكن أن يشير cliPath إلى مغلف SSH؛ عيّن remoteHost (host أو user@host) لجلب المرفقات عبر SCP.
• يقيّد attachmentRoots وremoteAttachmentRoots مسارات المرفقات الواردة (الافتراضي: /Users/*/Library/Messages/Attachments).
• يستخدم SCP تحققًا صارمًا من مفتاح المضيف، لذا تأكد من أن مفتاح مضيف الترحيل موجود مسبقًا في ~/.ssh/known_hosts.
• channels.imessage.configWrites: السماح بعمليات كتابة الإعدادات التي يبدأها iMessage أو رفضها.
• channels.imessage.sendTransport: نقل إرسال imsg RPC المفضل للردود الصادرة العادية. يستخدم auto (الافتراضي) جسر IMCore للدردشات الموجودة عندما يكون قيد التشغيل، ثم يعود إلى AppleScript؛ يتطلب bridge تسليمًا عبر API خاص؛ ويفرض applescript مسار Automation العام في Messages.
• channels.imessage.actions.*: تفعيل إجراءات API الخاصة المحكومة أيضًا بواسطة imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments معطل افتراضيًا؛ عيّنه إلى true قبل توقع وسائط واردة في دورات الوكيل.
• الاسترداد الوارد بعد إعادة تشغيل الجسر/gateway تلقائي (إزالة تكرار GUID بالإضافة إلى حد عمر لسجل متأخر قديم). لا تزال إعدادات channels.imessage.catchup.enabled: true الحالية محترمة كملف توافق مهجور.
• channels.imessage.groups: سجل المجموعات وإعدادات كل مجموعة. مع groupPolicy: "allowlist"، اضبط إما مفاتيح chat_id صريحة أو إدخال بدل "*" حتى تتمكن رسائل المجموعة من اجتياز بوابة السجل.
• يمكن لإدخالات bindings[] في المستوى الأعلى ذات type: "acp" ربط محادثات iMessage بجلسات ACP مستمرة. استخدم مقبضًا موحدًا أو هدف دردشة صريحًا (chat_id:*، chat_guid:*، chat_identifier:*) في match.peer.id. دلالات الحقول المشتركة: وكلاء ACP.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

​

Matrix

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
      encryption: true,
      initialSyncLimit: 20,
      defaultAccount: "ops",
      accounts: {
        ops: {
          name: "Ops",
          userId: "@ops:example.org",
          accessToken: "syt_ops_xxx",
        },
        alerts: {
          userId: "@alerts:example.org",
          password: "secret",
          proxy: "http://127.0.0.1:7891",
        },
      },
    },
  },
}

• تستخدم مصادقة الرمز accessToken؛ وتستخدم مصادقة كلمة المرور userId + password.
• يوجّه channels.matrix.proxy حركة مرور Matrix HTTP عبر وكيل HTTP(S) صريح. يمكن للحسابات المسماة تجاوزه باستخدام channels.matrix.accounts.<id>.proxy.
• يسمح channels.matrix.network.dangerouslyAllowPrivateNetwork بخوادم homeserver الخاصة/الداخلية. يُعد proxy وهذا الاشتراك الشبكي عنصرَي تحكم مستقلين.
• يحدد channels.matrix.defaultAccount الحساب المفضل في إعدادات الحسابات المتعددة.
• تكون القيمة الافتراضية لـ channels.matrix.autoJoin هي off، لذلك تُتجاهل الغرف المدعو إليها والدعوات الجديدة ذات نمط الرسائل المباشرة حتى تضبط autoJoin: "allowlist" مع autoJoinAllowlist أو autoJoin: "always".
• channels.matrix.execApprovals: تسليم موافقات التنفيذ الأصلية في Matrix وتخويل الموافقين.
  • enabled: true أو false أو "auto" (افتراضي). في الوضع التلقائي، تُفعّل موافقات التنفيذ عندما يمكن حل الموافقين من approvers أو commands.ownerAllowFrom.
  • approvers: معرّفات مستخدمي Matrix (مثل @owner:example.org) المسموح لهم بالموافقة على طلبات التنفيذ.
  • agentFilter: قائمة سماح اختيارية لمعرّفات الوكلاء. احذفها لتمرير الموافقات لجميع الوكلاء.
  • sessionFilter: أنماط مفاتيح جلسات اختيارية (سلسلة فرعية أو تعبير نمطي).
  • target: مكان إرسال مطالبات الموافقة. "dm" (افتراضي)، أو "channel" (الغرفة الأصلية)، أو "both".
  • تجاوزات لكل حساب: channels.matrix.accounts.<id>.execApprovals.
• يتحكم channels.matrix.dm.sessionScope في كيفية تجميع رسائل Matrix المباشرة ضمن الجلسات: يشارك per-user (افتراضي) حسب النظير الموجّه، بينما يعزل per-room كل غرفة رسائل مباشرة.
• تستخدم فحوصات حالة Matrix وعمليات البحث المباشر في الدليل سياسة الوكيل نفسها مثل حركة مرور وقت التشغيل.
• وُثّقت تهيئة Matrix الكاملة وقواعد الاستهداف وأمثلة الإعداد في Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• مسارات المفاتيح الأساسية المغطاة هنا: channels.msteams، channels.msteams.configWrites.
• وُثّقت تهيئة Teams الكاملة (بيانات الاعتماد، Webhook، سياسة الرسائل المباشرة/المجموعات، وتجاوزات كل فريق/كل قناة) في Microsoft Teams.

​

IRC

{
  channels: {
    irc: {
      enabled: true,
      dmPolicy: "pairing",
      configWrites: true,
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "${IRC_NICKSERV_PASSWORD}",
        register: false,
        registerEmail: "bot@example.com",
      },
    },
  },
}

• مسارات المفاتيح الأساسية المغطاة هنا: channels.irc، channels.irc.dmPolicy، channels.irc.configWrites، channels.irc.nickserv.*.
• يتجاوز channels.irc.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرّف حساب مهيأ.
• وُثّقت تهيئة قناة IRC الكاملة (المضيف/المنفذ/TLS/القنوات/قوائم السماح/بوابة الإشارات) في IRC.

​

الحسابات المتعددة (كل القنوات)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• يُستخدم default عند حذف accountId (CLI + التوجيه).
• تنطبق رموز البيئة فقط على الحساب الافتراضي.
• تنطبق إعدادات القناة الأساسية على جميع الحسابات ما لم تُتجاوز لكل حساب.
• استخدم bindings[].match.accountId لتوجيه كل حساب إلى وكيل مختلف.
• إذا أضفت حسابًا غير افتراضي عبر openclaw channels add (أو إعداد القناة) بينما لا تزال تستخدم تهيئة قناة علوية لحساب واحد، فإن OpenClaw يرقّي أولًا قيم الحساب الواحد العلوية ذات نطاق الحساب إلى خريطة حسابات القناة حتى يستمر الحساب الأصلي في العمل. تنقلها معظم القنوات إلى channels.<channel>.accounts.default؛ ويمكن لـ Matrix بدلًا من ذلك الحفاظ على هدف مسمى/افتراضي مطابق موجود.
• تستمر ارتباطات القناة فقط الموجودة (بدون accountId) في مطابقة الحساب الافتراضي؛ وتبقى الارتباطات ذات نطاق الحساب اختيارية.
• يصلح openclaw doctor --fix أيضًا الأشكال المختلطة عبر نقل قيم الحساب الواحد العلوية ذات نطاق الحساب إلى الحساب المرَقّى المختار لتلك القناة. تستخدم معظم القنوات accounts.default؛ ويمكن لـ Matrix بدلًا من ذلك الحفاظ على هدف مسمى/افتراضي مطابق موجود.

​

قنوات Plugin الأخرى

​

بوابة الإشارات في دردشة المجموعات

• إشارات البيانات الوصفية: إشارات @ الأصلية للمنصة. تُتجاهل في وضع الدردشة الذاتية في WhatsApp.
• أنماط النص: أنماط تعبيرات نمطية آمنة في agents.list[].groupChat.mentionPatterns. تُتجاهل الأنماط غير الصالحة والتكرارات المتداخلة غير الآمنة.
• تُفرض بوابة الإشارات فقط عندما يكون الاكتشاف ممكنًا (إشارات أصلية أو نمط واحد على الأقل).

{
  messages: {
    visibleReplies: "automatic", // force old automatic final replies for direct/source chats
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context
      visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

حدود سجل الرسائل المباشرة

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

​

وضع الدردشة الذاتية

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

​

الأوامر (معالجة أوامر الدردشة)

{
  commands: {
    native: "auto", // register native commands when supported
    nativeSkills: "auto", // register native skill commands when supported
    text: true, // parse /commands in chat messages
    bash: false, // allow ! (alias: /bash)
    bashForegroundMs: 2000,
    config: false, // allow /config
    mcp: false, // allow /mcp
    plugins: false, // allow /plugins
    debug: false, // allow /debug
    restart: true, // allow /restart + gateway restart tool
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

ذو صلة

• مرجع الإعدادات — مفاتيح المستوى الأعلى
• الإعدادات — الوكلاء
• نظرة عامة على القنوات