Slack

​

Memilih transportasi

​

Mode relay

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

​

Instalasi seluruh organisasi Enterprise Grid

​

Socket Mode

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Konektor Slack untuk 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 },
      },
    },
  },
}

​

HTTP Request URLs

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Konektor Slack untuk 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 },
      },
    },
  },
}

​

Instalasi

openclaw plugins install @openclaw/slack

​

Penyiapan cepat

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Konektor Slack untuk 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 menghubungkan utas asisten Slack ke agen OpenClaw.",
      "suggested_prompts": [
        { "title": "Apa yang dapat Anda lakukan?", "message": "Apa yang dapat Anda bantu?" },
        {
          "title": "Ringkas channel ini",
          "message": "Ringkas aktivitas terbaru di channel ini."
        },
        { "title": "Buat draf balasan", "message": "Bantu saya membuat draf balasan." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Kirim pesan ke 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": "Konektor Slack untuk 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 menghubungkan utas asisten Slack ke agen OpenClaw.",
      "suggested_prompts": [
        { "title": "Apa yang dapat Anda lakukan?", "message": "Apa yang dapat Anda bantu?" },
        {
          "title": "Ringkas channel ini",
          "message": "Ringkas aktivitas terbaru di channel ini."
        },
        { "title": "Buat draf balasan", "message": "Bantu saya membuat draf balasan." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Kirim pesan ke 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": "Konektor Slack untuk 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 menghubungkan utas asisten Slack ke agen OpenClaw.",
      "suggested_prompts": [
        { "title": "Apa yang dapat Anda lakukan?", "message": "Apa yang dapat Anda bantu?" },
        {
          "title": "Ringkas channel ini",
          "message": "Ringkas aktivitas terbaru di channel ini."
        },
        { "title": "Buat draf balasan", "message": "Bantu saya membuat draf balasan." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Kirim pesan ke 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": "Konektor Slack untuk 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 menghubungkan utas asisten Slack ke agen OpenClaw.",
      "suggested_prompts": [
        { "title": "Apa yang dapat Anda lakukan?", "message": "Apa yang dapat Anda bantu?" },
        {
          "title": "Ringkas kanal ini",
          "message": "Ringkas aktivitas terbaru di kanal ini."
        },
        { "title": "Buat draf balasan", "message": "Bantu saya membuat draf balasan." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Kirim pesan ke 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

​

Identitas pengguna (kirim sebagai orang sungguhan)

1. Di bawah OAuth & Permissions -> User Token Scopes, tambahkan izin dengan cakupan pengguna berikut:
   • riwayat: channels:history, groups:history, im:history, mpim:history
   • pencarian percakapan: channels:read, groups:read, im:read, mpim:read
   • orang: users:read
   • pengiriman: chat:write (pesan dikirim sebagai pengguna yang mengotorisasi)
   • membuka DM: im:write, mpim:write
2. Di bawah Event Subscriptions -> Subscribe to events on behalf of users, tambahkan peristiwa pengguna berikut. Jangan hanya menambahkannya ke daftar peristiwa bot:
   • message.channels
   • message.groups
   • message.im
   • message.mpim
3. Pilih satu transport peristiwa:
   • Socket Mode: aktifkan Socket Mode dan buat token tingkat aplikasi dengan connections:write. Konfigurasikan sebagai appToken.
   • HTTP Request URL: arahkan Event Subscriptions ke endpoint Slack OpenClaw publik dan salin Basic Information -> App Credentials -> Signing Secret. Konfigurasikan sebagai signingSecret.
4. Instal atau instal ulang aplikasi, otorisasi sebagai manusia yang dimaksud, lalu salin token OAuth pengguna yang dihasilkan ke userToken.

{
  channels: {
    slack: {
      identity: "user",
      userToken: "<xoxp>",
      appToken: "<xapp>",
    },
  },
}

{
  channels: {
    slack: {
      identity: "user",
      mode: "http",
      userToken: "<xoxp>",
      signingSecret: "<signing-secret>",
      webhookPath: "/slack/events",
    },
  },
}

​

Penyesuaian transport Socket Mode

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

• socketMode diabaikan dalam mode HTTP Request URL.
• Pengaturan dasar channels.slack.socketMode berlaku untuk semua akun Slack kecuali ditimpa. Penimpaan per akun menggunakan channels.slack.accounts.<accountId>.socketMode; karena ini adalah penimpaan objek, sertakan setiap bidang penyesuaian soket yang Anda inginkan untuk akun tersebut.
• Hanya clientPingTimeout yang memiliki bawaan OpenClaw (15000). serverPingTimeout dan pingPongLoggingEnabled diteruskan ke Slack SDK hanya jika dikonfigurasi.
• Backoff mulai ulang Socket Mode dimulai sekitar 2 detik dan dibatasi sekitar 30 detik. Kegagalan pemulaian, penantian pemulaian, dan pemutusan yang dapat dipulihkan dicoba ulang hingga kanal berhenti. Kesalahan akun dan kredensial permanen seperti autentikasi tidak valid, token dicabut, atau cakupan tidak tersedia akan gagal dengan cepat, alih-alih terus mencoba ulang tanpa batas.

​

Daftar periksa manifes dan cakupan

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Konektor Slack untuk 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 menghubungkan utas asisten Slack ke agen OpenClaw.",
      "suggested_prompts": [
        { "title": "Apa yang dapat Anda lakukan?", "message": "Apa yang dapat Anda bantu?" },
        {
          "title": "Ringkas kanal ini",
          "message": "Ringkas aktivitas terbaru di kanal ini."
        },
        { "title": "Buat draf balasan", "message": "Bantu saya membuat draf balasan." }
      ]
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Kirim pesan ke 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": "Kirim pesan ke 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"
    }
  }
}

​

Pengaturan manifes tambahan

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Mulai sesi baru",
      "usage_hint": "[model]"
    },
    {
      "command": "/reset",
      "description": "Atur ulang sesi saat ini"
    },
    {
      "command": "/compact",
      "description": "Padatkan konteks sesi",
      "usage_hint": "[instructions]"
    },
    {
      "command": "/stop",
      "description": "Hentikan proses saat ini"
    },
    {
      "command": "/session",
      "description": "Kelola masa berlaku pengikatan utas",
      "usage_hint": "tidak aktif <duration|off> atau usia maksimum <duration|off>"
    },
    {
      "command": "/think",
      "description": "Tetapkan tingkat pemikiran",
      "usage_hint": "<level>"
    },
    {
      "command": "/verbose",
      "description": "Aktifkan atau nonaktifkan output mendetail",
      "usage_hint": "on|off|full"
    },
    {
      "command": "/fast",
      "description": "Tampilkan atau tetapkan mode cepat",
      "usage_hint": "[status|on|off]"
    },
    {
      "command": "/reasoning",
      "description": "Aktifkan atau nonaktifkan visibilitas penalaran",
      "usage_hint": "[on|off|stream]"
    },
    {
      "command": "/elevated",
      "description": "Aktifkan atau nonaktifkan mode dengan hak akses tinggi",
      "usage_hint": "[on|off|ask|full]"
    },
    {
      "command": "/exec",
      "description": "Tampilkan atau tetapkan default eksekusi",
      "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
    },
    {
      "command": "/approve",
      "description": "Setujui atau tolak permintaan persetujuan yang tertunda",
      "usage_hint": "<id> <decision>"
    },
    {
      "command": "/model",
      "description": "Tampilkan atau tetapkan model",
      "usage_hint": "[name|#|status]"
    },
    {
      "command": "/models",
      "description": "Cantumkan penyedia/model",
      "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
    },
    {
      "command": "/help",
      "description": "Tampilkan ringkasan bantuan singkat"
    },
    {
      "command": "/commands",
      "description": "Tampilkan katalog perintah yang dihasilkan"
    },
    {
      "command": "/tools",
      "description": "Tampilkan apa yang dapat digunakan agen saat ini",
      "usage_hint": "[compact|verbose]"
    },
    {
      "command": "/agentstatus",
      "description": "Tampilkan status runtime, termasuk penggunaan/kuota penyedia jika tersedia"
    },
    {
      "command": "/tasks",
      "description": "Cantumkan tugas latar belakang aktif/terbaru untuk sesi saat ini"
    },
    {
      "command": "/context",
      "description": "Jelaskan cara konteks disusun",
      "usage_hint": "[list|detail|json]"
    },
    {
      "command": "/whoami",
      "description": "Tampilkan identitas pengirim Anda"
    },
    {
      "command": "/skill",
      "description": "Jalankan skill berdasarkan nama",
      "usage_hint": "<name> [input]"
    },
    {
      "command": "/btw",
      "description": "Ajukan pertanyaan sampingan tanpa mengubah konteks sesi",
      "usage_hint": "<question>"
    },
    {
      "command": "/login",
      "description": "Pasangkan login Codex",
      "usage_hint": "[codex|openai]"
    },
    {
      "command": "/usage",
      "description": "Kendalikan catatan kaki penggunaan atau tampilkan ringkasan biaya",
      "usage_hint": "off|tokens|full|cost"
    }
  ]
}

{
  "slash_commands": [
    {
      "command": "/new",
      "description": "Mulai sesi baru",
      "usage_hint": "[model]",
      "url": "https://gateway-host.example.com/slack/events"
    },
    {
      "command": "/help",
      "description": "Tampilkan ringkasan bantuan singkat",
      "url": "https://gateway-host.example.com/slack/events"
    }
  ]
}

​

Model token

• Identitas bot (default) memerlukan botToken + appToken untuk Socket Mode, atau botToken + signingSecret untuk mode HTTP.
• Identitas pengguna memerlukan userToken + appToken untuk Socket Mode, atau userToken + signingSecret untuk mode HTTP. Identitas ini tidak menggunakan token bot.
• Mode relay memerlukan botToken beserta relay.url, relay.authToken, dan relay.gatewayId; mode ini tidak menggunakan token aplikasi atau rahasia penandatanganan.
• botToken, appToken, signingSecret, relay.authToken, dan userToken menerima string teks biasa atau objek SecretRef.
• Token konfigurasi menggantikan fallback env.
• Fallback env SLACK_BOT_TOKEN, SLACK_APP_TOKEN, dan SLACK_USER_TOKEN masing-masing hanya berlaku untuk akun default.
• userToken secara default berperilaku hanya-baca (userTokenReadOnly: true).

• Pemeriksaan akun Slack melacak kolom *Source dan *Status per kredensial (botToken, appToken, signingSecret, userToken).
• Statusnya adalah available, configured_unavailable, atau missing.
• configured_unavailable berarti akun dikonfigurasi melalui SecretRef atau sumber rahasia non-inline lainnya, tetapi jalur perintah/runtime saat ini tidak dapat menyelesaikan nilai sebenarnya.
• Dalam mode HTTP, signingSecretStatus disertakan. Socket Mode menggunakan botTokenStatus + appTokenStatus untuk identitas bot dan userTokenStatus + appTokenStatus untuk identitas pengguna.

​

Tindakan dan gerbang

​

Kontrol akses dan perutean

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

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

​

Utas, sesi, dan tag balasan

• DM dirutekan sebagai direct; saluran sebagai channel; MPIM sebagai group.
• Pengikatan rute Slack menerima ID peer mentah serta bentuk target Slack seperti channel:C12345678, user:U12345678, dan <@U12345678>.
• Dengan session.dmScope=main default, DM Slack digabungkan ke sesi utama agen.
• Sesi saluran: agent:<agentId>:slack:channel:<channelId>.
• Pesan saluran tingkat teratas biasa tetap berada dalam sesi per saluran, bahkan ketika replyToMode bukan off.
• Balasan utas Slack menggunakan thread_ts Slack induk untuk sufiks sesi (:thread:<threadTs>), bahkan ketika pengutasan balasan keluar dinonaktifkan dengan replyToMode="off".
• OpenClaw memasukkan akar saluran tingkat teratas yang memenuhi syarat ke agent:<agentId>:slack:channel:<channelId>:thread:<rootTs> ketika akar tersebut diperkirakan akan memulai utas Slack yang terlihat, sehingga akar dan balasan utas berikutnya berbagi satu sesi OpenClaw. Ini berlaku untuk peristiwa app_mention, kecocokan sebutan bot eksplisit atau pola sebutan yang dikonfigurasi, serta saluran requireMention: false dengan replyToMode non-off.
• Default channels.slack.thread.historyScope adalah thread; default thread.inheritParent adalah false.
• channels.slack.thread.initialHistoryLimit mengontrol jumlah pesan utas yang sudah ada yang diambil ketika sesi utas baru dimulai (default 20; atur ke 0 untuk menonaktifkan).
• channels.slack.implicitMentions.replyToBot mengontrol apakah balasan terhadap pesan bot sendiri melewati pembatasan sebutan (default true).
• channels.slack.implicitMentions.threadParticipation mengontrol apakah tindak lanjut dalam utas tempat bot telah membalas melewati pembatasan sebutan (default true). Atur ke false untuk mewajibkan sebutan eksplisit baru dalam tindak lanjut tersebut. openclaw doctor --fix memigrasikan kunci lama channels.slack.thread.requireExplicitMention ke flag kanonis positif ini.
• Penggantian tingkat akun berada di channels.slack.accounts.<id>.implicitMentions; default bersama berada di channels.defaults.implicitMentions.

• channels.slack.channels.<id>.replyToMode: penggantian per saluran untuk pesan saluran/saluran privat Slack
• channels.slack.replyToMode: off|first|all|batched (default off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• fallback lama untuk obrolan langsung: channels.slack.dm.replyToMode

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

​

Reaksi pengakuan

​

Emoji (ackReaction)

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback emoji identitas agen (agents.list[].identity.emoji, atau "eyes" / 👀)

• Slack mengharapkan kode pendek (misalnya "eyes").
• Gunakan "" untuk menonaktifkan reaksi bagi akun Slack atau secara global.

​

Cakupan (messages.ackReactionScope)

• "all": bereaksi dalam DM dan grup, termasuk peristiwa ruang ambien.
• "direct": hanya bereaksi dalam DM.
• "group-all": bereaksi pada setiap pesan grup kecuali peristiwa ruang ambien (tanpa DM).
• "group-mentions" (default): bereaksi dalam grup, tetapi hanya ketika bot disebut (atau dalam hal yang dapat disebut dalam grup yang memilih ikut serta). DM dikecualikan.
• "off" / "none": jangan pernah bereaksi.

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // bereaksi dalam DM dan grup
  },
}

​

Streaming teks

• off: menonaktifkan streaming pratinjau langsung.
• partial (default): mengganti teks pratinjau dengan keluaran parsial terbaru.
• block: menambahkan pembaruan pratinjau per potongan.
• progress: menampilkan teks status kemajuan selama pembuatan, lalu mengirim teks final.
• streaming.preview.toolProgress: ketika pratinjau draf aktif, merutekan pembaruan alat/kemajuan ke pesan pratinjau yang diedit yang sama (default: true). Atur false untuk mempertahankan pesan alat/kemajuan yang terpisah.
• streaming.preview.commandText / streaming.progress.commandText: atur ke status untuk mempertahankan baris kemajuan alat yang ringkas sambil menyembunyikan teks perintah/eksekusi mentah (default: raw).

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

• Utas balasan harus tersedia agar streaming teks bawaan dan status utas asisten Slack dapat muncul. Pemilihan utas tetap mengikuti replyToMode.
• Saluran, obrolan grup, dan akar DM tingkat teratas tetap dapat menggunakan pratinjau draf normal ketika streaming bawaan tidak tersedia atau tidak ada utas balasan.
• DM Slack tingkat teratas secara default tetap berada di luar utas, sehingga tidak menampilkan pratinjau streaming/status bawaan bergaya utas milik Slack; sebagai gantinya, OpenClaw memposting dan mengedit pratinjau draf di DM.
• Media dan payload nonteks menggunakan fallback ke pengiriman normal.
• Hasil akhir media/kesalahan membatalkan edit pratinjau yang tertunda; hasil akhir teks/blok yang memenuhi syarat hanya dikirim sepenuhnya ketika dapat mengedit pratinjau secara langsung.
• Jika streaming gagal di tengah balasan, OpenClaw menggunakan fallback ke pengiriman normal untuk payload yang tersisa.

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

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

• channels.slack.streamMode (replace | status_final | append) adalah alias lama untuk channels.slack.streaming.mode.
• channels.slack.streaming boolean adalah alias lama untuk channels.slack.streaming.mode dan channels.slack.streaming.nativeTransport.
• channels.slack.chunkMode dan channels.slack.nativeStreaming tingkat teratas adalah alias lama untuk channels.slack.streaming.chunkMode dan channels.slack.streaming.nativeTransport.
• Alias lama tidak dibaca saat runtime; jalankan openclaw doctor --fix untuk menulis ulang konfigurasi streaming Slack yang dipersistenkan ke kunci kanonis.

​

Reaksi cadangan saat mengetik

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

• Slack mengharapkan kode pendek (misalnya "hourglass_flowing_sand").
• Reaksi bersifat upaya terbaik dan pembersihan diupayakan secara otomatis setelah jalur balasan atau kegagalan selesai.

​

Masukan suara

• Dikte suara Slackbot berada di dalam percakapan Slackbot pribadi pengguna. Slack mengubah rekaman menjadi prompt Slackbot, tetapi tidak mengirimkan berkas audio, peristiwa dikte, prompt, atau penanda sumber masukan kepada aplikasi Slack pihak ketiga melalui Events API. Plugin Slack OpenClaw tidak dapat mengaktifkan atau menerimanya.
• Klip audio Slack disimpan sebagai berkas Slack yang dapat diposting di DM, kanal, atau utas OpenClaw. OpenClaw mengunduh klip yang dapat diakses dengan token bot, menormalkan metadata MIME klip Slack, dan mengirimkannya melalui pipeline transkripsi audio bersama. Manifes aplikasi yang direkomendasikan mencakup cakupan files:read yang diperlukan.

​

Media, pemotongan, dan pengiriman

​

Perintah dan perilaku garis miring

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

/openclaw /help

• Mode otomatis perintah native nonaktif untuk Slack, sehingga commands.native: "auto" tidak mengaktifkan perintah native Slack.

/help

• 3-5 opsi yang cukup pendek: menu luapan (”…”)
• lebih dari 100 opsi, dengan pemfilteran opsi asinkron tersedia: pilihan eksternal
• 1-2 opsi, atau opsi apa pun yang nilai terenkodenya terlalu panjang untuk pilihan: blok tombol
• selain itu (6-100 opsi, atau lebih dari 100 tanpa pemfilteran asinkron): menu pilihan statis, dipotong menjadi 100 opsi per menu

/think

​

Bagan native

{
  "blocks": [
    {
      "type": "chart",
      "chartType": "bar",
      "title": "Pendapatan triwulanan",
      "categories": ["Q1", "Q2"],
      "series": [{ "name": "Pendapatan", "values": [120, 145] }],
      "xLabel": "Triwulan"
    }
  ]
}

• judul dan label sumbu opsional: 50 karakter
• lingkaran: 1-12 segmen positif
• garis/batang/area: 1-12 seri dengan nama unik dan 1-20 kategori bersama
• label segmen, kategori, dan seri: 20 karakter
• setiap seri harus berisi satu nilai berhingga untuk setiap kategori; nilai non-lingkaran boleh negatif

​

Tabel native

{
  "blocks": [
    {
      "type": "table",
      "caption": "Pipeline terbuka",
      "headers": ["Akun", "Tahap", "ARR"],
      "rows": [
        ["Acme", "Menang", 125000],
        ["Globex", "Review", 82000]
      ],
      "rowHeaderColumnIndex": 0
    }
  ]
}

• 1-20 kolom
• 1-100 baris data, ditambah baris tajuk
• jumlah sel yang sama di setiap baris
• maksimal 10.000 karakter agregat di seluruh sel tabel dalam satu pesan

​

Balasan interaktif

{
  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(...)

• Ini adalah UI lama khusus Slack. Saluran lain tidak menerjemahkan direktif Slack Block Kit menjadi sistem tombolnya sendiri.
• Nilai callback interaktif adalah token opak yang dibuat OpenClaw, bukan nilai mentah yang dibuat agen.
• Jika blok interaktif yang dihasilkan akan melampaui batas Slack Block Kit, OpenClaw kembali menggunakan balasan teks asli alih-alih mengirim payload blok yang tidak valid.

​

Pengiriman modal yang dimiliki plugin

• Atur callback_id menjadi openclaw:<namespace>:<payload>.
• Atau pertahankan callback_id yang sudah ada dan masukkan pluginInteractiveData: "<namespace>:<payload>" ke dalam private_metadata modal.

​

Persetujuan native di Slack

• Persetujuan eksekusi dan plugin dapat dirender sebagai prompt Block Kit native Slack.
• channels.slack.execApprovals.* tetap menjadi konfigurasi pengaktifan klien persetujuan eksekusi native dan perutean DM/saluran.
• DM persetujuan eksekusi menggunakan channels.slack.execApprovals.approvers atau commands.ownerAllowFrom.
• Persetujuan plugin menggunakan tombol native Slack saat Slack diaktifkan sebagai klien persetujuan native untuk sesi asal, atau saat approvals.plugin diarahkan ke sesi Slack asal atau target Slack.
• DM persetujuan plugin menggunakan pemberi persetujuan plugin Slack dari channels.slack.allowFrom, allowFrom akun bernama, atau rute default akun.
• Otorisasi pemberi persetujuan tetap diberlakukan: pemberi persetujuan khusus eksekusi tidak dapat menyetujui permintaan plugin kecuali mereka juga merupakan pemberi persetujuan plugin.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (opsional; kembali menggunakan commands.ownerAllowFrom jika memungkinkan)
• channels.slack.execApprovals.target (dm | channel | both, default: dm)
• agentFilter, sessionFilter

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

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

​

Peristiwa dan perilaku operasional

• Pengeditan/penghapusan pesan dipetakan menjadi peristiwa sistem.
• Siaran utas (balasan utas “Also send to channel”) diproses sebagai pesan pengguna biasa.
• Peristiwa penambahan/penghapusan reaksi dipetakan menjadi peristiwa sistem.
• Peristiwa anggota bergabung/keluar, saluran dibuat/diubah namanya, serta pin ditambahkan/dihapus dipetakan menjadi peristiwa sistem.
• Polling kehadiran opsional dapat memetakan transisi away ke active milik peserta manusia yang diamati ke sesi Slack memenuhi syarat milik peserta tersebut yang terakhir aktif. Defaultnya nonaktif.
• channel_id_changed dapat memigrasikan kunci konfigurasi saluran saat configWrites diaktifkan.
• Metadata topik/tujuan saluran diperlakukan sebagai konteks tidak tepercaya dan dapat disuntikkan ke konteks perutean.
• Pemicu utas dan penyemaian konteks riwayat utas awal difilter berdasarkan daftar pengirim yang diizinkan dan telah dikonfigurasi jika berlaku.
• Tindakan blok, pintasan, dan interaksi modal menghasilkan peristiwa sistem Slack interaction: ... terstruktur dengan bidang payload yang kaya:
  • tindakan blok: nilai terpilih, label, nilai pemilih, dan metadata workflow_*
  • pintasan global: metadata callback dan pelaku, diarahkan ke sesi langsung pelaku
  • pintasan pesan: konteks callback, pelaku, saluran, utas, dan pesan terpilih
  • peristiwa modal view_submission dan view_closed dengan metadata saluran yang diarahkan dan input formulir

​

Peristiwa kehadiran

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

• off (default): tanpa pewaktu kehadiran atau panggilan API Slack.
• auto: pantau DM, MPIM, dan utas Slack yang aktif dalam 24 jam terakhir dengan paling banyak 8 peserta manusia yang diamati. Sesi saluran tingkat atas tidak disertakan.
• on: pantau percakapan yang sama tanpa batas peserta dan sertakan sesi saluran tingkat atas. Gunakan penggantian per saluran untuk memaksa atau menekan satu saluran.

​

Referensi konfigurasi

​

Pemecahan masalah

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

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

openclaw pairing list slack

​

Referensi media lampiran

​

Jenis media yang didukung

​

Pipeline masuk

1. OpenClaw mengunduh berkas dari URL privat Slack menggunakan token bot.
2. Berkas ditulis ke penyimpanan media setelah berhasil.
3. Jalur media yang diunduh dan jenis kontennya ditambahkan ke konteks masuk.
4. Klip audio dirutekan ke pipeline transkripsi bersama; jalur model/alat yang mendukung gambar dapat menggunakan lampiran gambar dari konteks yang sama.
5. Berkas lainnya tetap tersedia sebagai metadata berkas atau referensi media bagi alat yang dapat menanganinya.

​

Pewarisan lampiran akar utas

• Jika balasan itu sendiri tidak memiliki media langsung dan pesan akar yang disertakan memiliki berkas, Slack dapat memuat berkas akar sebagai konteks pembuka utas.
• Berkas akar hanya dimuat saat memulai sesi utas baru atau yang telah direset. Balasan berikutnya yang hanya berisi teks menggunakan kembali konteks sesi yang sudah ada dan tidak melampirkan kembali berkas akar sebagai media baru.
• Lampiran langsung pada balasan lebih diprioritaskan daripada lampiran pesan akar.
• Pesan akar yang hanya memiliki berkas tanpa teks direpresentasikan dengan placeholder lampiran agar fallback tetap dapat menyertakan berkasnya.

​

Penanganan banyak lampiran

• Setiap lampiran diproses secara independen melalui pipeline media.
• Referensi media yang diunduh digabungkan ke dalam konteks pesan.
• Urutan pemrosesan mengikuti urutan berkas Slack dalam payload peristiwa.
• Kegagalan mengunduh satu lampiran tidak memblokir lampiran lainnya.

​

Batas ukuran, pengunduhan, dan model

• Batas ukuran: Default 20 MB per berkas. Dapat dikonfigurasi melalui channels.slack.mediaMaxMb.
• Batas transkripsi audio: tools.media.audio.maxBytes juga berlaku ketika berkas yang diunduh dikirim ke penyedia transkripsi atau CLI.
• Kegagalan pengunduhan: Berkas yang tidak dapat disajikan oleh Slack, URL kedaluwarsa, berkas yang tidak dapat diakses, berkas yang terlalu besar, dan respons HTML autentikasi/login Slack dilewati, bukan dilaporkan sebagai format yang tidak didukung.
• Model visi: Analisis gambar menggunakan model balasan aktif jika mendukung visi, atau model gambar yang dikonfigurasi pada agents.defaults.imageModel.

​

Batas yang diketahui

​

Dokumentasi terkait

• Pipeline pemahaman media
• Catatan audio dan suara
• Alat PDF

​

Terkait