التكوين — القنوات

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

القنوات

​

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

​

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

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

​

افتراضيات القناة و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"],
    },
  },
}

{
  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: off; opt in explicitly to avoid preview-edit rate limits)
      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,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          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 كخيار احتياطي للحساب الافتراضي.
• تستخدم المكالمات الصادرة المباشرة التي توفّر Discord token صريحا ذلك الرمز المميّز للمكالمة؛ وتظل إعدادات إعادة المحاولة/السياسة الخاصة بالحساب مأخوذة من الحساب المحدد في لقطة وقت التشغيل النشطة.
• يتجاوز channels.discord.defaultAccount الاختياري اختيار الحساب الافتراضي عندما يطابق معرف حساب مكوّنا.
• استخدم user:<id> (رسالة مباشرة) أو channel:<id> (قناة guild) لأهداف التسليم؛ تُرفض المعرفات الرقمية المجرّدة.
• تكون مختصرات guild بأحرف صغيرة مع استبدال المسافات بـ -؛ وتستخدم مفاتيح القنوات الاسم المختصر (من دون #). فضّل معرفات guild.
• تُتجاهل الرسائل التي كتبها البوت افتراضيا. يفعّلها allowBots: true؛ استخدم allowBots: "mentions" لقبول رسائل البوت التي تذكر البوت فقط (تظل الرسائل الذاتية مرشّحة).
• يُسقط channels.discord.guilds.<id>.ignoreOtherMentions (وتجاوزات القناة) الرسائل التي تذكر مستخدما آخر أو دورا آخر ولكن لا تذكر البوت (باستثناء @everyone/@here).
• يربط channels.discord.mentionAliases نص @handle الصادر الثابت بمعرفات مستخدمي Discord قبل الإرسال، بحيث يمكن ذكر الزملاء المعروفين بصورة حتمية حتى عندما تكون ذاكرة التخزين المؤقتة العابرة للدليل فارغة. توجد التجاوزات لكل حساب ضمن channels.discord.accounts.<accountId>.mentionAliases.
• يقسم maxLinesPerMessage (الافتراضي 17) الرسائل الطويلة حتى عندما تكون أقل من 2000 حرف.
• يتحكم 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.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 إتاحة وقت التشغيل بحضور البوت (healthy => online وdegraded => idle وexhausted => dnd) ويسمح بتجاوزات اختيارية لنص الحالة.
• يعيد 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).
• خيارات env الاحتياطية: 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 كخيار env احتياطي للحساب الافتراضي).
• يتطلب وضع HTTP botToken بالإضافة إلى signingSecret (على الجذر أو لكل حساب).
• يمرّر socketMode ضبط نقل وضع Socket في Slack SDK إلى واجهة Bolt receiver API العامة. استخدمه فقط عند التحقيق في مهلة ping/pong أو سلوك websocket القديم.
• تقبل 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 قيم Slack المنطقية لفرد روابط ووسائط chat.postMessage لردود البوت. احذفهما للإبقاء على سلوك Slack الافتراضي؛ عيّنهما في channels.slack.accounts.<accountId> لتجاوز الافتراضي على المستوى الأعلى لحساب واحد.
• استخدم user:<id> (رسالة مباشرة) أو channel:<id> لأهداف التسليم.

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

​

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",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
      catchup: {
        enabled: false,
      },
    },
  },
}

• يتجاوز 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.actions.*: تمكين إجراءات API الخاصة التي تخضع أيضًا لبوابة imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments معطل افتراضيًا؛ اضبطه على true قبل توقع وسائط واردة في أدوار الوكيل.
• channels.imessage.catchup.enabled: الاشتراك في إعادة تشغيل الرسائل الواردة التي وصلت أثناء تعطل Gateway.
• 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 حركة HTTP الخاصة بـ Matrix عبر وكيل HTTP(S) صريح. يمكن للحسابات المسماة تجاوزه باستخدام channels.matrix.accounts.<id>.proxy.
• يسمح channels.matrix.network.dangerouslyAllowPrivateNetwork بخوادم المنازل الخاصة/الداخلية. 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: أنماط مفاتيح جلسة اختيارية (سلسلة فرعية أو regex).
  • 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 الذاتية.
• أنماط النص: أنماط regex آمنة في agents.list[].groupChat.mentionPatterns. يتم تجاهل الأنماط غير الصالحة والتكرار المتداخل غير الآمن.
• لا يُفرض تقييد الإشارات إلا عندما يكون الاكتشاف ممكنًا (الإشارات الأصلية أو نمط واحد على الأقل).

{
  messages: {
    visibleReplies: "automatic", // global default for direct/source chats; Codex harness defaults unset direct chats to message_tool
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // default; use "automatic" for legacy final 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,
  },
}

​

ذات صلة

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