OpenClaw从入门到应用——Agent：消息（Messages）

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》本页整合了 OpenClaw 处理入站消息、会话、队列、流式传输以及推理可见性的方式。消息流程高层视图入站消息 - 路由/绑定 - 会话键 - 队列如果运行处于活动状态 - 代理运行流式传输 工具 - 出站回复频道限制 分块关键控制项位于配置文件中messages.*用于前缀、队列和群组行为。agents.defaults.*用于块流式传输和分块默认设置。频道覆盖设置channels.whatsapp.*、channels.telegram.*等用于能力限制和流式传输开关。完整架构请参阅 配置。入站去重频道可能在重新连接后重新投递同一条消息。OpenClaw 会维护一个短期缓存以频道/账户/对端/会话/消息 ID 为键这样重复投递不会触发另一次代理运行。入站防抖来自同一发送者的快速连续消息可以通过messages.inbound合并为单次代理轮次。防抖范围限定在每个频道 对话并使用最新的消息进行回复线程/ID 处理。配置全局默认 按频道覆盖{ messages: { inbound: { debounceMs: 2000, byChannel: { whatsapp: 5000, slack: 1500, discord: 1500, }, }, }, }注意防抖仅适用于纯文本消息媒体/附件会立即刷新。控制命令会绕过防抖以保持其独立执行。会话与设备会话由网关持有而非客户端。直接对话会合并到代理主会话键中。群组/频道拥有各自的会话键。会话存储和对话记录位于网关主机上。多个设备/频道可以映射到同一个会话但历史记录不会完全同步回每个客户端。建议对于较长的对话使用一个主设备以避免上下文分歧。Control UI 和 TUI 始终显示网关支持的会话记录因此它们是权威来源。详细信息会话管理。入站消息体与历史上下文OpenClaw 将提示词主体与命令主体分开Body发送给代理的提示文本。这可能包含频道信封和可选的历史记录包装。CommandBody用于指令/命令解析的原始用户文本。RawBodyCommandBody的旧别名为兼容性保留。当频道提供历史记录时它使用共享的包装器[自你上次回复以来的聊天消息 - 供上下文参考][当前消息 - 请回复此消息]对于非直接对话群组/频道/房间当前消息体会加上发送者标签前缀与历史条目使用的样式相同。这可以确保实时消息和排队/历史消息在代理提示中保持一致。历史记录缓冲区是仅待处理的它们包含未触发运行的群组消息例如仅提及触发的消息并且排除会话记录中已有的消息。指令剥离仅适用于当前消息部分以保持历史记录完整。包装历史记录的频道应将CommandBody或RawBody设置为原始消息文本并将Body保留为组合后的提示。历史记录缓冲区可通过messages.groupChat.historyLimit全局默认值以及按频道的覆盖设置如channels.slack.historyLimit或channels.telegram.accounts..historyLimit进行配置设置为0表示禁用。队列与后续消息如果某个运行已处于活动状态入站消息可以被排队、引导至当前运行中或收集起来用于后续轮次。通过messages.queue以及messages.queue.byChannel进行配置。模式interrupt、steer、followup、collect以及相应的背压变体。详细信息队列。流式传输、分块与批处理块流式传输会在模型生成文本块时发送部分回复。分块会遵守频道的文本长度限制并避免分割带栅栏的代码块。关键设置agents.defaults.blockStreamingDefaulton|off默认关闭agents.defaults.blockStreamingBreaktext_end|message_endagents.defaults.blockStreamingChunkminChars|maxChars|breakPreferenceagents.defaults.blockStreamingCoalesce基于空闲的批处理agents.defaults.humanDelay块回复之间类似人类的停顿频道覆盖设置*.blockStreaming和*.blockStreamingCoalesce非 Telegram 频道需要显式设置*.blockStreaming: true详细信息流式传输 分块。推理可见性与令牌OpenClaw 可以暴露或隐藏模型的推理/reasoning on|off|stream控制可见性。推理内容在由模型生成时仍然会计入令牌使用量。Telegram 支持将推理流式传输到草稿气泡中。详细信息思考 推理指令 以及 令牌使用。前缀、线程与回复出站消息的格式化在messages中集中处理messages.responsePrefix、channels..responsePrefix和channels..accounts..responsePrefix出站前缀级联以及channels.whatsapp.messagePrefixWhatsApp 入站前缀通过replyToMode和按频道的默认值进行回复线程处理详细信息配置 和频道文档。