OpenClaw Slack 技能指南

OpenClaw Slack 技能概述

Slack 技能將 OpenClaw 連接到你的 Slack 工作區，讓你的 AI 智慧體透過自然語言傳送訊息、管理表情反應、釘選訊息和閱讀對話。無需在終端和 Slack 之間反覆切換，只需告訴 OpenClaw 即可在幾秒內完成常規訊息操作。

Slack 是最廣泛使用的團隊溝通平台之一，將其與 OpenClaw 整合可以解鎖強大的自動化工作流程。無論你需要傳送部署通知、對訊息做出反應，還是釘選重要決策，OpenClaw Slack 技能都能將多步驟 Slack 操作轉化為簡單對話。

典型工作流程：

1. 讓 OpenClaw 向 #releases 頻道傳送部署更新。
2. 智慧體透過設定的 Bot Token 呼叫 Slack API。
3. 訊息即刻傳送——無需切換情境。

該技能支援兩種連線模式：Socket Mode（建議用於開發和小型團隊）和 HTTP Events API（更適合防火牆後的正式環境部署）。兩種模式使用相同的 Bot Token，功能完全一致。

Slack 技能安裝前的準備

安裝 Slack 技能之前，請確保你具備以下條件：

• OpenClaw 已安裝並運行（v1.0+）
• 擁有一個你有權限安裝應用程式的 Slack 工作區
• 在 api.slack.com/apps 建立了一個 Slack 應用程式，並設定了所需的 OAuth 權限範圍
• 已安裝 clawhub CLI 用於技能管理——透過 clawhub 安裝

所需 OAuth 權限範圍（Bot Token）

建立 Slack 應用程式時，新增以下 Bot Token 權限範圍：

| 權限範圍 | 用途 | |---------|------| | chat:write | 傳送和編輯訊息 | | channels:history | 讀取頻道訊息歷史 | | channels:read | 列出和檢視頻道資訊 | | im:history | 讀取私訊歷史 | | im:write | 傳送私訊 | | reactions:read | 列出訊息的表情反應 | | reactions:write | 新增表情反應 | | pins:read | 列出已釘選的訊息 | | pins:write | 釘選和取消釘選訊息 | | emoji:read | 存取自訂 Emoji 列表 | | app_mentions:read | 回應 @提及 |

可選：新增 chat:write.customize 以自訂每則訊息的機器人顯示名稱，或新增 files:read 和 files:write 以支援檔案操作。

驗證你的環境：

# 檢查 OpenClaw 版本
openclaw --version

# 驗證 clawhub 已安裝
clawhub --version

如何安裝 Slack 技能

使用一條命令安裝 Slack 技能：

npx clawhub@latest install slack

驗證安裝：

clawhub list

你應該能在已安裝技能列表中看到 slack。該技能由 steipete 在 ClawHub 發布，並定期更新。

Slack 技能設定指南

Slack 技能需要 Bot Token 以及 Socket Mode 下的 App Token。OpenClaw 會自動從環境變數中讀取這些權杖。

環境設定

# 必需：Bot Token（以 xoxb- 開頭）
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Socket Mode 必需（以 xapp- 開頭）
export SLACK_APP_TOKEN=xapp-your-app-token-here

重要提示： 切勿將權杖硬編碼到設定檔中。請使用環境變數或金鑰管理器，例如 1Password 或 Bitwarden。

連線模式

Socket Mode（預設）：

• 需要 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN
• 不需要公開 URL——非常適合本機開發
• 使用 openclaw gateway 啟動

HTTP Events API：

• 需要 SLACK_BOT_TOKEN 和 Signing Secret
• 設定 Webhook 端點（預設：/slack/events）
• 更適合反向代理後的正式環境

存取控制

OpenClaw 為 Slack 互動提供精細的存取控制：

• 私訊策略： pairing（預設）、allowlist、open 或 disabled
• 頻道策略： open、allowlist 或 disabled
• 需要 @提及： 頻道中預設需要 @bot 提及

對於團隊環境，建議使用 pairing 私訊策略。使用者必須執行 openclaw pairing approve slack <code> 後機器人才會回應其私訊。查看安全檢查清單了解更多加固建議。

Slack 技能使用範例

1. 傳送部署通知

你： "向 #releases 頻道傳送訊息，說 2.4.0 版本已零停機部署到正式環境。"

智慧體呼叫 sendMessage，指定目標頻道和訊息內容。通知以機器人身分即刻出現在頻道中。

2. 對團隊決策做出反應

你： "對 #engineering-decisions 最新訊息新增一個勾選反應。"

智慧體使用 readMessages 讀取指定頻道的最新訊息，然後透過 react 新增 ✅ 反應。這非常適合確認決策或標記已審查的任務。

3. 釘選重要更新

你： "釘選 #product 頻道中關於 Q1 路線圖的訊息。"

智慧體在最近的訊息中搜尋匹配「Q1 路線圖」的內容，然後使用 pinMessage 釘選它。釘選的訊息會保留在頻道頂部，方便整個團隊存取。

4. 閱讀和摘要頻道動態

你： "摘要一下今天 #support 頻道發生了什麼。"

智慧體使用 readMessages 取得當天的訊息，然後分析並摘要關鍵主題、問題和解決方案。搭配 Summarize 技能使用效果更佳。

安全與最佳實踐

Slack 技能可以在你的工作區中傳送訊息和修改內容。請遵循以下指南確保安全：

• 最小權限原則。 只授予實際需要的 OAuth 權限範圍。如果只需要讀取頻道，跳過 chat:write 和 pins:write。
• 啟用配對模式。 預設的 pairing 私訊策略可防止未授權使用者在私訊中與機器人互動。
• 傳送前確認。 OpenClaw 預設會在傳送訊息前提示確認。不要在正式工作區中停用此功能。
• 限制頻道存取。 使用 allowlist 頻道策略將機器人限制在特定頻道，而非授予全工作區存取權限。
• 定期輪換權杖。 定期重新產生 Bot Token，並在 Slack 應用管理頁面撤銷不再使用的權杖。
• 稽核訊息活動。 檢查 Slack 工作區稽核日誌，審查機器人傳送的訊息。

Slack 技能常見錯誤與故障排除

"not_authed" 或 "invalid_auth"

Bot Token 遺失或無效。

# 驗證權杖已設定
echo $SLACK_BOT_TOKEN

# 如需重新匯出
export SLACK_BOT_TOKEN=xoxb-your-new-token

如果權杖最近被重新產生，請確保更新所有使用它的環境。

"channel_not_found"

機器人無法存取指定頻道。這通常意味著：

1. 機器人未被邀請到頻道——在頻道中輸入 /invite @your-bot-name。
2. 頻道 ID 不正確——使用 Slack API 或頻道的快捷選單取得正確的 ID。
3. 頻道是私有的，機器人缺少 groups:read 權限範圍。

"missing_scope"

Bot Token 缺少所需的 OAuth 權限範圍。

1. 前往 api.slack.com/apps → 你的應用程式 → OAuth & Permissions。
2. 新增錯誤訊息中列出的缺失權限範圍。
3. 重新安裝應用程式到工作區以套用新的權限範圍。