Slack

พร้อมใช้งานในระบบจริงสำหรับ DM และช่องต่าง ๆ ผ่านการผสานรวมแอป Slack โหมดเริ่มต้นคือ Socket Mode และรองรับ HTTP Request URLs ด้วย

# การเลือก Socket Mode หรือ HTTP Request URLs

ทรานสปอร์ตทั้งสองแบบพร้อมใช้งานในระบบจริงและมีความสามารถเทียบเท่ากันสำหรับการส่งข้อความ คำสั่ง Slash, App Home และการโต้ตอบ เลือกตามรูปแบบการปรับใช้ ไม่ใช่ตามฟีเจอร์

# การตั้งค่าอย่างรวดเร็ว

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to 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",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to 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",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
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=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to 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",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to 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",
"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=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# การปรับแต่งการรับส่งข้อมูล Socket Mode

OpenClaw ตั้งค่า timeout สำหรับ pong ของไคลเอนต์ Slack SDK เป็น 15 วินาทีโดยค่าเริ่มต้นสำหรับ Socket Mode ให้ override การตั้งค่าการรับส่งข้อมูลเฉพาะเมื่อคุณต้องปรับแต่งตามเวิร์กสเปซหรือโฮสต์เท่านั้น:

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

ใช้ตัวเลือกนี้เฉพาะกับเวิร์กสเปซ Socket Mode ที่บันทึก timeout ของ Slack websocket pong/server-ping หรือทำงานบนโฮสต์ที่ทราบว่ามี event loop starvation clientPingTimeout คือเวลารอ pong หลังจาก SDK ส่ง client ping; serverPingTimeout คือเวลารอ ping จากเซิร์ฟเวอร์ Slack ข้อความและเหตุการณ์ของแอปยังคงเป็นสถานะของแอปพลิเคชัน ไม่ใช่สัญญาณความพร้อมทำงานของการรับส่งข้อมูล

# รายการตรวจสอบ manifest และ scope

manifest พื้นฐานของแอป Slack เหมือนกันสำหรับ Socket Mode และ HTTP Request URLs มีเฉพาะบล็อก settings (และ url ของคำสั่ง Slash) ที่ต่างกัน

manifest พื้นฐาน (ค่าเริ่มต้น Socket Mode):

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for 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
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to 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",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

สำหรับ โหมด HTTP Request URLs ให้แทนที่ settings ด้วยตัวแปร HTTP และเพิ่ม url ให้คำสั่ง Slash แต่ละรายการ ต้องมี URL สาธารณะ:

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to 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",
        "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"
    }
  }
}

# การตั้งค่า manifest เพิ่มเติม

แสดงฟีเจอร์ต่าง ๆ ที่ขยายจากค่าเริ่มต้นข้างต้น

manifest เริ่มต้นเปิดใช้แท็บ Home ของ Slack App Home และสมัครรับ app_home_opened เมื่อสมาชิกเวิร์กสเปซเปิดแท็บ Home, OpenClaw จะเผยแพร่มุมมอง Home เริ่มต้นที่ปลอดภัยด้วย views.publish; ไม่มี payload การสนทนาหรือการกำหนดค่าส่วนตัวรวมอยู่ด้วย แท็บ Messages ยังคงเปิดใช้สำหรับ DM ของ Slack

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# โมเดลโทเค็น

• botToken + appToken จำเป็นสำหรับ Socket Mode
• โหมด HTTP ต้องใช้ botToken + signingSecret
• botToken, appToken, signingSecret และ userToken รับสตริงข้อความธรรมดา หรือออบเจ็กต์ SecretRef
• โทเค็นในคอนฟิกจะแทนที่ env fallback
• env fallback ของ SLACK_BOT_TOKEN / SLACK_APP_TOKEN ใช้กับบัญชีเริ่มต้นเท่านั้น
• userToken (xoxp-...) ใช้ได้เฉพาะในคอนฟิก (ไม่มี env fallback) และค่าเริ่มต้นเป็นพฤติกรรมอ่านอย่างเดียว (userTokenReadOnly: true)

พฤติกรรมของสแนปช็อตสถานะ:

• การตรวจสอบบัญชี Slack ติดตามฟิลด์ *Source และ *Status ตามข้อมูลรับรองแต่ละรายการ (botToken, appToken, signingSecret, userToken)
• สถานะคือ available, configured_unavailable หรือ missing
• configured_unavailable หมายความว่าบัญชีถูกกำหนดค่าผ่าน SecretRef หรือแหล่งซีเคร็ตแบบไม่อินไลน์อื่น แต่เส้นทางคำสั่ง/รันไทม์ปัจจุบัน ไม่สามารถ resolve ค่าจริงได้
• ในโหมด HTTP จะรวม signingSecretStatus; ใน Socket Mode คู่ที่จำเป็นคือ botTokenStatus + appTokenStatus

# การดำเนินการและเกต

การดำเนินการของ Slack ถูกควบคุมโดย channels.slack.actions.*

กลุ่มการดำเนินการที่พร้อมใช้ในเครื่องมือ Slack ปัจจุบัน:

การดำเนินการข้อความ Slack ปัจจุบันรวมถึง send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info และ emoji-list download-file รับ ID ไฟล์ Slack ที่แสดงใน placeholder ไฟล์ขาเข้า และคืนค่าตัวอย่างรูปภาพสำหรับรูปภาพหรือเมทาดาทาไฟล์ภายในเครื่องสำหรับไฟล์ประเภทอื่น

# การควบคุมการเข้าถึงและการกำหนดเส้นทาง

# เธรด เซสชัน และแท็กตอบกลับ

• DM กำหนดเส้นทางเป็น direct; ช่องเป็น channel; MPIM เป็น group
• การผูกเส้นทาง Slack รับ ID เพียร์ดิบ รวมถึงรูปแบบเป้าหมาย Slack เช่น channel:C12345678, user:U12345678 และ <@U12345678>
• ด้วยค่าเริ่มต้น session.dmScope=main DM ของ Slack จะรวมเป็นเซสชันหลักของเอเจนต์
• เซสชันช่อง: agent:<agentId>:slack:channel:<channelId>
• การตอบกลับในเธรดสามารถสร้าง suffix ของเซสชันเธรด (:thread:<threadTs>) เมื่อใช้ได้
• ค่าเริ่มต้นของ channels.slack.thread.historyScope คือ thread; ค่าเริ่มต้นของ thread.inheritParent คือ false
• channels.slack.thread.initialHistoryLimit ควบคุมจำนวนข้อความเธรดเดิมที่จะดึงเมื่อเซสชันเธรดใหม่เริ่มต้น (ค่าเริ่มต้น 20; ตั้ง 0 เพื่อปิดใช้งาน)
• channels.slack.thread.requireExplicitMention (ค่าเริ่มต้น false): เมื่อเป็น true จะระงับการกล่าวถึงเธรดโดยนัย เพื่อให้บอตตอบเฉพาะการกล่าวถึง @bot อย่างชัดเจนภายในเธรด แม้บอตจะเคยเข้าร่วมเธรดแล้วก็ตาม หากไม่มีค่านี้ การตอบกลับในเธรดที่บอตเข้าร่วมจะข้ามการ gate ของ requireMention

การควบคุมเธรดการตอบกลับ:

• channels.slack.replyToMode: off|first|all|batched (ค่าเริ่มต้น off)
• channels.slack.replyToModeByChatType: ต่อ direct|group|channel
• fallback legacy สำหรับแชตโดยตรง: channels.slack.dm.replyToMode

รองรับแท็กตอบกลับแบบกำหนดเอง:

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

# รีแอ็กชัน Ack

ackReaction ส่งอีโมจิรับทราบขณะที่ OpenClaw กำลังประมวลผลข้อความขาเข้า

ลำดับการ resolve:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• fallback อีโมจิตัวตนของเอเจนต์ (agents.list[].identity.emoji, มิฉะนั้น "👀")

หมายเหตุ:

• Slack คาดหวัง shortcode (เช่น "eyes")
• ใช้ "" เพื่อปิดใช้งานรีแอ็กชันสำหรับบัญชี Slack หรือแบบทั่วทั้งระบบ

# การสตรีมข้อความ

channels.slack.streaming ควบคุมพฤติกรรม live preview:

• off: ปิดใช้งานการสตรีม live preview
• partial (ค่าเริ่มต้น): แทนที่ข้อความ preview ด้วยเอาต์พุตบางส่วนล่าสุด
• block: เพิ่มอัปเดต preview แบบแบ่งชิ้นต่อท้าย
• progress: แสดงข้อความสถานะความคืบหน้าระหว่างสร้าง แล้วส่งข้อความสุดท้าย
• streaming.preview.toolProgress: เมื่อ draft preview ใช้งานอยู่ ให้กำหนดเส้นทางอัปเดต tool/progress เข้าไปยังข้อความ preview เดียวกันที่ถูกแก้ไข (ค่าเริ่มต้น: true) ตั้ง false เพื่อแยกข้อความ tool/progress
• streaming.preview.commandText / streaming.progress.commandText: ตั้งเป็น status เพื่อคงบรรทัด tool-progress แบบกะทัดรัดไว้ ขณะซ่อนข้อความคำสั่ง/exec ดิบ (ค่าเริ่มต้น: raw)

ซ่อนข้อความคำสั่ง/exec ดิบ โดยยังคงบรรทัดความคืบหน้าแบบกะทัดรัด:

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

channels.slack.streaming.nativeTransport ควบคุมการสตรีมข้อความ native ของ Slack เมื่อ channels.slack.streaming.mode เป็น partial (ค่าเริ่มต้น: true)

• ต้องมีเธรดตอบกลับพร้อมใช้งานเพื่อให้การสตรีมข้อความ native และสถานะเธรดผู้ช่วยของ Slack ปรากฏ การเลือกเธรดยังคงตาม replyToMode
• ช่อง group-chat และรูท DM ระดับบนสุดยังสามารถใช้ draft preview ปกติได้เมื่อ native streaming ไม่พร้อมใช้งานหรือไม่มีเธรดตอบกลับอยู่
• DM ระดับบนสุดของ Slack ยังคงอยู่นอกเธรดเป็นค่าเริ่มต้น ดังนั้นจึงไม่แสดง native stream/status preview แบบสไตล์เธรดของ Slack; OpenClaw จะโพสต์และแก้ไข draft preview ใน DM แทน
• เพย์โหลดสื่อและเพย์โหลดที่ไม่ใช่ข้อความจะ fallback เป็นการส่งมอบปกติ
• ผลลัพธ์สุดท้ายที่เป็นสื่อ/ข้อผิดพลาดจะยกเลิกการแก้ไข preview ที่ค้างอยู่; ผลลัพธ์สุดท้ายที่เป็น text/block และเข้าเกณฑ์จะ flush เฉพาะเมื่อสามารถแก้ไข preview เดิมได้
• หากการสตรีมล้มเหลวกลางการตอบกลับ OpenClaw จะ fallback เป็นการส่งมอบปกติสำหรับเพย์โหลดที่เหลือ

ใช้ draft preview แทนการสตรีมข้อความ native ของ Slack:

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

คีย์ legacy:

• channels.slack.streamMode (replace | status_final | append) เป็นนามแฝงรันไทม์แบบเดิมสำหรับ channels.slack.streaming.mode
• บูลีน channels.slack.streaming เป็นนามแฝงรันไทม์แบบเดิมสำหรับ channels.slack.streaming.mode และ channels.slack.streaming.nativeTransport
• channels.slack.nativeStreaming แบบเดิมเป็นนามแฝงรันไทม์สำหรับ channels.slack.streaming.nativeTransport
• เรียกใช้ openclaw doctor --fix เพื่อเขียนการกำหนดค่า Slack streaming ที่คงไว้ใหม่ให้เป็นคีย์มาตรฐาน

# การสำรองปฏิกิริยากำลังพิมพ์

typingReaction เพิ่มปฏิกิริยาชั่วคราวให้กับข้อความ Slack ขาเข้าในขณะที่ OpenClaw กำลังประมวลผลการตอบกลับ แล้วลบออกเมื่อการรันเสร็จสิ้น สิ่งนี้มีประโยชน์มากที่สุดนอกการตอบกลับในเธรด ซึ่งใช้ตัวบ่งชี้สถานะเริ่มต้น "กำลังพิมพ์..."

ลำดับการแก้ค่า:

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

หมายเหตุ:

• Slack คาดหวัง shortcode (ตัวอย่างเช่น "hourglass_flowing_sand")
• ปฏิกิริยานี้เป็นแบบพยายามให้ดีที่สุด และจะพยายามล้างข้อมูลโดยอัตโนมัติหลังจากเส้นทางตอบกลับหรือเส้นทางล้มเหลวเสร็จสมบูรณ์

# สื่อ การแบ่งส่วน และการส่งมอบ

# คำสั่งและพฤติกรรม slash

คำสั่ง slash จะปรากฏใน Slack เป็นคำสั่งที่กำหนดค่าไว้คำสั่งเดียวหรือเป็นคำสั่ง native หลายคำสั่ง กำหนดค่า channels.slack.slashCommand เพื่อเปลี่ยนค่าเริ่มต้นของคำสั่ง:

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

/openclaw /help

คำสั่ง native ต้องใช้ การตั้งค่า manifest เพิ่มเติม ในแอป Slack ของคุณ และเปิดใช้ด้วย channels.slack.commands.native: true หรือ commands.native: true ในการกำหนดค่าระดับ global แทน

• โหมดอัตโนมัติของคำสั่ง native ปิดอยู่สำหรับ Slack ดังนั้น commands.native: "auto" จะไม่เปิดใช้คำสั่ง native ของ Slack

/help

เมนูอาร์กิวเมนต์ native ใช้กลยุทธ์การแสดงผลแบบปรับตัวได้ ซึ่งแสดงโมดัลยืนยันก่อนส่งค่าตัวเลือกที่เลือก:

• สูงสุด 5 ตัวเลือก: บล็อกปุ่ม
• 6-100 ตัวเลือก: เมนู static select
• มากกว่า 100 ตัวเลือก: external select พร้อมการกรองตัวเลือกแบบ async เมื่อมีตัวจัดการตัวเลือกของ interactivity
• เกินขีดจำกัดของ Slack: ค่าตัวเลือกที่เข้ารหัสจะถอยกลับไปใช้ปุ่ม

/think

เซสชัน slash ใช้คีย์แบบแยก เช่น agent:<agentId>:slack:slash:<userId> และยังคง route การดำเนินคำสั่งไปยังเซสชันการสนทนาเป้าหมายโดยใช้ CommandTargetSessionKey

# การตอบกลับแบบโต้ตอบ

Slack สามารถแสดงผลตัวควบคุมการตอบกลับแบบโต้ตอบที่เอเจนต์เขียนได้ แต่ฟีเจอร์นี้ถูกปิดโดยค่าเริ่มต้น

เปิดใช้แบบ global:

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

หรือเปิดใช้เฉพาะบัญชี Slack หนึ่งบัญชี:

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

เมื่อเปิดใช้ เอเจนต์สามารถปล่อย directive การตอบกลับเฉพาะ Slack ได้:

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

directive เหล่านี้จะคอมไพล์เป็น Slack Block Kit และ route การคลิกหรือการเลือกกลับผ่านเส้นทางเหตุการณ์ interaction ของ Slack ที่มีอยู่

หมายเหตุ:

• นี่คือ UI เฉพาะ Slack ช่องอื่นจะไม่แปล directive ของ Slack Block Kit เป็นระบบปุ่มของตนเอง
• ค่า callback แบบโต้ตอบเป็นโทเค็นทึบที่ OpenClaw สร้างขึ้น ไม่ใช่ค่าดิบที่เอเจนต์เขียน
• หากบล็อกแบบโต้ตอบที่สร้างขึ้นจะเกินขีดจำกัดของ Slack Block Kit OpenClaw จะถอยกลับไปใช้ข้อความตอบกลับเดิมแทนการส่ง payload บล็อกที่ไม่ถูกต้อง

# การอนุมัติ exec ใน Slack

Slack สามารถทำหน้าที่เป็นไคลเอนต์อนุมัติ native พร้อมปุ่มและ interaction แบบโต้ตอบ แทนการถอยกลับไปใช้ Web UI หรือเทอร์มินัล

• การอนุมัติ exec ใช้ channels.slack.execApprovals.* สำหรับการ route DM/ช่องแบบ native
• การอนุมัติ Plugin ยังสามารถแก้ค่าได้ผ่านพื้นผิวปุ่มแบบ Slack-native เดียวกัน เมื่อคำขอนั้นมาถึง Slack อยู่แล้วและชนิด id ของการอนุมัติเป็น plugin:
• การอนุญาตผู้อนุมัติยังคงถูกบังคับใช้: เฉพาะผู้ใช้ที่ระบุว่าเป็นผู้อนุมัติเท่านั้นที่สามารถอนุมัติหรือปฏิเสธคำขอผ่าน Slack ได้

สิ่งนี้ใช้พื้นผิวปุ่มอนุมัติร่วมเดียวกันกับช่องอื่น เมื่อเปิดใช้ interactivity ในการตั้งค่าแอป Slack ของคุณ พรอมป์การอนุมัติจะแสดงผลเป็นปุ่ม Block Kit โดยตรงในการสนทนา เมื่อมีปุ่มเหล่านั้นอยู่ ปุ่มเหล่านั้นคือ UX การอนุมัติหลัก OpenClaw ควรรวมคำสั่ง /approve แบบ manual เฉพาะเมื่อผลลัพธ์ของเครื่องมือระบุว่าการอนุมัติทางแชตไม่พร้อมใช้งาน หรือการอนุมัติแบบ manual เป็นเส้นทางเดียวเท่านั้น

พาธการกำหนดค่า:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (ไม่บังคับ; ถอยกลับไปใช้ commands.ownerAllowFrom เมื่อทำได้)
• channels.slack.execApprovals.target (dm | channel | both, ค่าเริ่มต้น: dm)
• agentFilter, sessionFilter

Slack จะเปิดใช้การอนุมัติ exec แบบ native โดยอัตโนมัติเมื่อไม่ได้ตั้งค่า enabled หรือเป็น "auto" และมีผู้อนุมัติอย่างน้อยหนึ่งรายที่แก้ค่าได้ ตั้งค่า enabled: false เพื่อปิดใช้ Slack เป็นไคลเอนต์อนุมัติ native อย่างชัดเจน ตั้งค่า enabled: true เพื่อบังคับเปิดการอนุมัติ native เมื่อผู้อนุมัติแก้ค่าได้

พฤติกรรมเริ่มต้นเมื่อไม่มีการกำหนดค่าการอนุมัติ exec ของ Slack อย่างชัดเจน:

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

การกำหนดค่า Slack-native แบบชัดเจนจำเป็นเฉพาะเมื่อคุณต้องการแทนที่ผู้อนุมัติ เพิ่มตัวกรอง หรือ เลือกใช้การส่งมอบผ่านแชตต้นทาง:

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

การส่งต่อ approvals.exec ร่วมเป็นคนละส่วนกัน ใช้เฉพาะเมื่อพรอมป์การอนุมัติ exec ต้อง route ไปยังแชตอื่นหรือเป้าหมาย out-of-band ที่ระบุอย่างชัดเจนด้วย การส่งต่อ approvals.plugin ร่วมก็เป็น คนละส่วนเช่นกัน ปุ่ม Slack-native ยังสามารถแก้ค่าการอนุมัติ Plugin ได้เมื่อคำขอเหล่านั้นมาถึง Slack อยู่แล้ว

/approve ในแชตเดียวกันยังทำงานในช่อง Slack และ DM ที่รองรับคำสั่งอยู่แล้ว ดู การอนุมัติ Exec สำหรับโมเดลการส่งต่อการอนุมัติฉบับเต็ม

# เหตุการณ์และพฤติกรรมการปฏิบัติการ

• การแก้ไข/ลบข้อความจะถูกแมปเป็นเหตุการณ์ระบบ
• การ broadcast ในเธรด (การตอบกลับเธรดแบบ "ส่งไปยังช่องด้วย") จะถูกประมวลผลเป็นข้อความผู้ใช้ตามปกติ
• เหตุการณ์เพิ่ม/ลบปฏิกิริยาจะถูกแมปเป็นเหตุการณ์ระบบ
• เหตุการณ์สมาชิกเข้าร่วม/ออก ช่องถูกสร้าง/เปลี่ยนชื่อ และเพิ่ม/ลบ pin จะถูกแมปเป็นเหตุการณ์ระบบ
• channel_id_changed สามารถย้ายคีย์การกำหนดค่าช่องได้เมื่อเปิดใช้ configWrites
• เมทาดาทา topic/purpose ของช่องถือเป็นบริบทที่ไม่น่าเชื่อถือและสามารถถูกฉีดเข้าในบริบทการ route ได้
• ตัวเริ่มเธรดและการตั้งค่าบริบทประวัติเธรดเริ่มต้นจะถูกกรองตาม allowlist ผู้ส่งที่กำหนดค่าไว้เมื่อใช้ได้
• Block actions และ modal interactions ปล่อยเหตุการณ์ระบบ Slack interaction: ... แบบมีโครงสร้างพร้อมฟิลด์ payload ที่ครบถ้วน:
  • block actions: ค่าที่เลือก label ค่าของ picker และเมทาดาทา workflow_*
  • เหตุการณ์ modal view_submission และ view_closed พร้อมเมทาดาทาช่องที่ route แล้วและอินพุตฟอร์ม

# เอกสารอ้างอิงการกำหนดค่า

เอกสารอ้างอิงหลัก: เอกสารอ้างอิงการกำหนดค่า - Slack

# การแก้ไขปัญหา

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

openclaw pairing list slack

# เอกสารอ้างอิงวิชันของไฟล์แนบ

Slack สามารถแนบสื่อที่ดาวน์โหลดแล้วเข้ากับรอบของเอเจนต์ได้เมื่อดาวน์โหลดไฟล์จาก Slack สำเร็จและขีดจำกัดขนาดอนุญาต ไฟล์รูปภาพสามารถส่งผ่านเส้นทางการทำความเข้าใจสื่อหรือส่งตรงไปยังโมเดลตอบกลับที่รองรับการมองเห็นได้ ส่วนไฟล์อื่นจะถูกเก็บไว้เป็นบริบทไฟล์ที่ดาวน์โหลดได้ แทนที่จะถูกปฏิบัติเป็นอินพุตรูปภาพ

# ประเภทสื่อที่รองรับ

# ไปป์ไลน์ขาเข้า

เมื่อข้อความ Slack ที่มีไฟล์แนบมาถึง:

1. OpenClaw ดาวน์โหลดไฟล์จาก URL ส่วนตัวของ Slack โดยใช้โทเค็นบอต (xoxb-...)
2. เมื่อสำเร็จ ไฟล์จะถูกเขียนไปยังที่เก็บสื่อ
3. เส้นทางสื่อที่ดาวน์โหลดและชนิดเนื้อหาจะถูกเพิ่มลงในบริบทขาเข้า
4. เส้นทางโมเดล/เครื่องมือที่รองรับรูปภาพสามารถใช้ไฟล์แนบรูปภาพจากบริบทนั้นได้
5. ไฟล์ที่ไม่ใช่รูปภาพยังคงพร้อมใช้งานเป็นข้อมูลเมตาของไฟล์หรือการอ้างอิงสื่อสำหรับเครื่องมือที่จัดการได้

# การสืบทอดไฟล์แนบจากรากของเธรด

เมื่อข้อความมาถึงในเธรด (มีพาเรนต์ thread_ts):

• หากข้อความตอบกลับเองไม่มีสื่อโดยตรงและข้อความรากที่รวมมามีไฟล์ Slack สามารถเติมไฟล์รากเป็นบริบทของข้อความเริ่มเธรดได้
• ไฟล์แนบโดยตรงในข้อความตอบกลับจะมีลำดับความสำคัญเหนือไฟล์แนบจากข้อความราก
• ข้อความรากที่มีเฉพาะไฟล์และไม่มีข้อความจะถูกแทนด้วยตัวยึดตำแหน่งไฟล์แนบ เพื่อให้ทางเลือกสำรองยังสามารถรวมไฟล์ของข้อความนั้นได้

# การจัดการไฟล์แนบหลายรายการ

เมื่อข้อความ Slack เดียวมีไฟล์แนบหลายรายการ:

• ไฟล์แนบแต่ละรายการจะถูกประมวลผลแยกกันผ่านไปป์ไลน์สื่อ
• การอ้างอิงสื่อที่ดาวน์โหลดแล้วจะถูกรวมไว้ในบริบทข้อความ
• ลำดับการประมวลผลเป็นไปตามลำดับไฟล์ของ Slack ในเพย์โหลดเหตุการณ์
• ความล้มเหลวในการดาวน์โหลดไฟล์แนบหนึ่งรายการจะไม่บล็อกไฟล์อื่น

# ขนาด การดาวน์โหลด และขีดจำกัดของโมเดล

• ขีดจำกัดขนาด: ค่าเริ่มต้น 20 MB ต่อไฟล์ กำหนดค่าได้ผ่าน channels.slack.mediaMaxMb
• ความล้มเหลวในการดาวน์โหลด: ไฟล์ที่ Slack ให้บริการไม่ได้, URL หมดอายุ, ไฟล์ที่เข้าถึงไม่ได้, ไฟล์เกินขนาด และการตอบกลับ HTML สำหรับการยืนยันตัวตน/เข้าสู่ระบบของ Slack จะถูกข้าม แทนที่จะถูกรายงานว่าเป็นรูปแบบที่ไม่รองรับ
• โมเดลการมองเห็น: การวิเคราะห์รูปภาพใช้โมเดลตอบกลับที่ใช้งานอยู่เมื่อโมเดลนั้นรองรับการมองเห็น หรือใช้โมเดลรูปภาพที่กำหนดค่าไว้ที่ agents.defaults.imageModel

# ข้อจำกัดที่ทราบ

# เอกสารที่เกี่ยวข้อง

• ไปป์ไลน์การทำความเข้าใจสื่อ
• เครื่องมือ PDF
• มหากาพย์: #51349 — การเปิดใช้การมองเห็นสำหรับไฟล์แนบ Slack
• การทดสอบการถดถอย: #51353
• การตรวจสอบแบบสด: #51354

# ที่เกี่ยวข้อง