跳转至

事件与操作

OpenClaw 观察哪些 Slack 事件,以及它如何处理这些事件。

事件与运行行为

  • 消息编辑/删除会被映射为系统事件。
  • 线程广播(“同时发送到频道”线程回复)会作为普通用户消息处理。
  • 表情回应添加/移除事件会被映射为系统事件。
  • 成员加入/离开、频道创建/重命名以及置顶添加/移除事件会被映射为系统事件。
  • 当机器人本身加入一个允许的频道时,它会发布一条基于频道名称、用途或主题以及可用最近消息的介绍。介绍默认启用,绝不会在直接消息中运行,并可通过 channels.slack.joinIntro: false 禁用,或按账户通过 channels.slack.accounts.<accountId>.joinIntro 覆盖。有关历史记录限制、每房间一次的行为以及不受信任内容的处理,请参阅 群组加入介绍。
  • 可选的在线状态轮询可以将观察到的人类参与者的 away 到 active 转换映射到该参与者最近活跃的合格 Slack 会话。默认关闭。
  • 当启用 configWrites 时,channel_id_changed 可以迁移频道配置键。
  • 频道主题/用途元数据被视为不受信任的上下文,并可注入到路由上下文中。
  • Agent View 的 app_context 实体会按 Slack 相关性顺序验证,并且仅作为结构化不受信任上下文暴露;省略的上下文会清除当前轮次,而不是重用过期实体。
  • 线程发起者和初始线程历史上下文播种在适用时会根据配置的发送者允许列表进行过滤。
  • 用于检查、范围发现、会话分类和投递对账的专用 Web API 读取,每次请求尝试都有 30 秒的截止时间。瞬时故障仍可能重试,因此完整操作可能需要更长时间。共享的 Bolt 和具备变更能力的客户端不会获得此默认截止时间,因为 Slack 可能在迟到的响应到达 OpenClaw 之前提交变更。
  • 块操作、快捷方式和模态交互会发出带有丰富负载字段的结构化 Slack interaction: ... 系统事件:
  • 块操作:所选值、标签、选择器值以及 workflow_* 元数据
  • 全局快捷方式:回调和操作者元数据,路由到操作者的直接会话
  • 消息快捷方式:回调、操作者、频道、线程和所选消息上下文
  • 模态 view_submission 和 view_closed 事件,包含路由频道元数据和表单输入

在你的 Slack 应用配置中定义全局或消息快捷方式,并使用任意非空回调 ID。OpenClaw 会确认匹配的快捷方式负载,应用与其他 Slack 交互相同的 DM/频道发送者策略,并将已清理的事件入队到路由的代理会话。触发器 ID 和响应 URL 会从代理上下文中脱敏。

在线状态事件

Slack 不会通过 Events API 或 Socket Mode 发送在线状态变更。OpenClaw 可以改为轮询 users.getPresence,以获取其消息已通过常规 Slack 访问和路由检查的人类参与者。

{
  channels: {
    slack: {
      presenceEvents: {
        mode: "auto",
        prompt: "Do not send a greeting. Stay silent.",
      },
      channels: {
        C0123456789: { presenceEvents: { mode: "on" } },
        C0987654321: { presenceEvents: { mode: "off" } },
      },
    },
  },
}
  • off(默认):不启用在线状态计时器,也不调用 Slack API。
  • auto:监控过去 24 小时内活跃的 DM、MPIM 和 Slack 线程,最多观察 8 个人类参与者。顶级频道会话被排除。
  • on:监控相同的会话,但不限制参与者数量,并包含顶级频道会话。使用按频道覆盖来强制或抑制某个频道。

OpenClaw 每个 Slack 账户每分钟最多轮询 45 个唯一的工作区-用户配对,首次结果会播种而不唤醒代理,并且仅在观察到 away 到 active 转换时唤醒。每个 Slack 账户、工作区和用户都会应用持久的 8 小时冷却期,即使该人参与了多个线程。该事件仅路由到该人最近活跃的合格会话,并告知代理在决定是否发送一条简短问候之前,先查阅记忆/维基和已知时区上下文。代理可以保持沉默。

该事件包含 observed_away_at_ms、observed_active_at_ms 和 observed_away_duration_ms。持续时间是在当前监控运行中首次采样的 away 状态与之后采样的 active 状态之间的经过时间。它不是精确的离开时间,因为在线状态可能在轮询之间发生变化,并且在监控重启或目标过期后,观察会重新开始。该事件记录的是 Slack 报告的内容,而不是该人是否坐在键盘前;Slack 可以自动或手动将某人标记为离开,并且 users.getPresence 不会区分另一用户的这些情况。

presenceEvents.prompt 会在事件事实之后替换默认的问候指导。默认应用账户级值,并且 channels.<channel-id>.presenceEvents.prompt 可以为一个频道覆盖它。自定义值会按原样包含,并限制为 20,000 个字符,与默认的按文件 AGENTS.md 引导限制相匹配。将其设置为空字符串可省略特定于事件的指导,并让工作区指令(例如 AGENTS.md)决定如何处理该事件。在线状态事实始终包含在内。

机器人令牌需要 users:read,推荐清单中已包含该权限。Enterprise Grid 全组织安装仅在授权事件识别出该工作区后,才创建工作区范围的轮询客户端;在线状态、冷却期和投递目标仍按工作区分区。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw