OpenClaw队列模式配置指南

OpenClaw 队列系统概览
OpenClaw 为 AI 交互提供了灵活的消息队列机制，帮助在模型忙碌时高效管理多条指令。不同模式下，系统会以中断、转向、合并或排队的方式处理新消息，满足实时打断、批量合并、逐步执行等多种使用场景。

核心机制

OpenClaw 的消息队列负责在 AI 正在生成回复时暂存新的请求，并根据所选模式决定何时以及如何处理这些请求。

队列模式

📦 collect 收集模式深度解析

工作流程

1
2
3
4
5
6
7
8

你发消息1 → AI 运行中 → 存入队列
你发消息2 → AI 运行中 → 存入队列
你发消息3 → AI 运行中 → 存入队列
    ↓
AI 空闲
    ↓
✅ 合并所有排队消息为一条
✅ 统一回复

合并后提示词格式

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

[Queued messages while agent was busy]
---
Queued #1
你的第一条消息内容
---
Queued #2
你的第二条消息内容
---
Queued #3
你的第三条消息内容

📏 depth 0 深度含义

深度指当前队列中等待处理的消息数量。

⚙️ 队列的其他配置参数

溢出处理策略（Drop Policy）

• summarize：超过容量时，旧消息自动总结为摘要
• old：丢弃最旧的消息
• new：丢弃最新的消息

🎮 如何切换队列模式

在聊天中直接输入：

1
2
3
4

/queue collect        # 切换到收集模式
/queue interrupt      # 切换到中断模式
/queue followup       # 切换到后续模式
/queue steer          # 切换到转向模式

带自定义参数的示例：

1

/queue collect debounce=500 cap=10 drop=summarize

💡 使用建议

当前状态：Queue: collect (depth 0) → 队列空、响应及时。

高级技巧

• 飞书/微信等即时聊天使用 collect
• 终端开发场景使用 interrupt
• 批量任务处理建议 followup

为什么需要 interrupt？

默认情况下，新消息会排队等待当前生成完成。interrupt 模式可在生成过程中直接终止当前任务，立刻处理最新指令，提高交互效率。

配置方式一：全局/永久配置文件

编辑 openclaw.json：

按渠道单独设置

仅在特定渠道使用不同模式：

配置方式二：聊天命令（会话临时）

1
2
3

/queue interrupt          # 切换为 interrupt
/queue default            # 恢复默认
/queue interrupt debounce:2s cap:25 drop:summarize

debounceMs 的重要性

在 interrupt 模式下，强烈建议开启防抖，以防用户连发短消息导致多次不必要的中断。示例防抖设置（1.5 秒）：