使用Slack Bolt SDK示例

openclaw openclaw官方 2026-04-09 1

OpenClaw 与 Slack 集成主要通过以下方式实现：

使用Slack Bolt SDK示例-第1张图片-OpenClaw开源下载|官方OpenClaw下载

主要集成方式

Webhook 集成

配置步骤：
1. Slack端：创建Incoming Webhook
   - 进入Slack App目录 → "Incoming Webhooks"
   - 选择频道 → 获取Webhook URL
2. OpenClaw端配置：
   - 设置Webhook端点
   - 配置消息模板
   - 定义触发条件

Slack App 集成

app = App(token="xoxb-your-token")
# 监听OpenClaw事件
@app.event("app_mention")
def handle_mention(event, say):
    # 调用OpenClaw API
    response = openclaw_process(event['text'])
    say(response)

API 直接调用

# 使用cURL发送消息
curl -X POST -H 'Content-type: application/json' \
--data '{"text":"OpenClaw告警: 系统异常"}' \
https://hooks.slack.com/services/YOUR/WEBHOOK/URL

功能集成场景

🔔 通知与告警

监控告警推送
任务完成通知
异常状态提醒
日报/周报自动发送

🤖 Slack Bot

通过Slack命令调用OpenClaw功能
自然语言查询处理
自动化工作流触发
数据查询和报告生成

🔄 双向同步

将Slack消息同步到OpenClaw工单
从OpenClaw更新Slack频道状态
用户和权限同步管理

详细配置步骤

步骤1：创建Slack App

访问 api.slack.com/apps
点击 "Create New App"
选择 "From scratch"
配置权限范围（OAuth Scopes）：
- chat:write
- commands
- incoming-webhook
- channels:read

步骤2：配置OpenClaw

# OpenClaw配置示例
slack:
  webhook_url: "https://hooks.slack.com/services/..."
  bot_token: "xoxb-..."
  signing_secret: "your_signing_secret"
  channels:
    alerts: "#alerts-channel"
    reports: "#daily-reports"
    general: "#general"

步骤3：实现消息处理器

# Python示例
import requests
import json
class SlackIntegrator:
    def __init__(self, webhook_url):
        self.webhook_url = webhook_url
    def send_message(self, channel, message, attachments=None):
        payload = {
            "channel": channel,
            "text": message,
            "attachments": attachments or []
        }
        response = requests.post(
            self.webhook_url,
            data=json.dumps(payload),
            headers={'Content-Type': 'application/json'}
        )
        return response.status_code == 200

常用消息格式

基础消息

{
  "text": "OpenClaw任务已完成",
  "blocks": [
    {
      "type": "section",
      "text": {
        "type": "mrkdwn",
        "text": "*任务状态更新*"
      }
    }
  ]
}

告警消息

{
  "attachments": [
    {
      "color": "#ff0000",
      "title": "🔴 紧急告警",
      "fields": [
        {"title": "系统", "value": "OpenClaw", "short": true},
        {"title": "级别", "value": "CRITICAL", "short": true}
      ]
    }
  ]
}

最佳实践

✅ 推荐做法

使用环境变量存储敏感信息
实现消息队列避免速率限制
添加重试机制提高可靠性
记录日志便于调试
使用Blocks构建丰富消息

⚠️ 注意事项

Slack API有速率限制（Tier 1: 50次/分钟）
消息长度限制：4000字符
及时处理交互式组件的响应
定期轮换令牌和密钥

故障排查

问题	检查点
消息未发送	Webhook URL是否正确网络连接权限配置
格式错误	JSON格式验证特殊字符转义
速率限制	实现退避重试批量发送消息