会话工具

​

可用工具

{
  tools: {
    profile: "messaging",
    alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
  },
}

​

列出和读取会话

• assistant 文本在回忆前会被规范化：
  • thinking 标签会被剥离
  • <relevant-memories> / <relevant_memories> 脚手架块会被剥离
  • 纯文本工具调用 XML 负载块（如 <tool_call>...</tool_call>、 <function_call>...</function_call>、<tool_calls>...</tool_calls> 和 <function_calls>...</function_calls>）会被剥离，包括从未完整闭合的截断负载
  • 降级的工具调用/结果脚手架（如 [Tool Call: ...]、 [Tool Result ...] 和 [Historical context ...]）会被剥离
  • 泄露的模型控制 token（如 <|assistant|>、其他 ASCII <|...|> token，以及全角 <｜...｜> 变体）会被剥离
  • 形态异常的 MiniMax 工具调用 XML（如 <invoke ...> / </minimax:tool_call>）会被剥离
• 类似凭据/token 的文本在返回前会被脱敏
• 较长的文本块会被截断
• 非常大的历史记录可能会丢弃较早的行，或将过大的行替换为 [sessions_history omitted: message too large]
• 该工具会报告 truncated、droppedMessages、 contentTruncated、contentRedacted 和 bytes 等汇总标志

​

跨会话发送消息

• 即发即弃： 设置 timeoutSeconds: 0，即可入队并立即返回。
• 等待回复： 设置超时时间并内联获取响应。

​

状态和编排辅助工具

• origin 是会话创建的位置，或者在较旧状态缺少存储的 origin 元数据时，由可投递的会话 key 前缀推断出的提供方。
• active 是当前的实时运行路由。它只会针对当前正在处理的实时或当前会话报告。
• deliveryContext 是存储在会话上的持久化投递路由，OpenClaw 即使在活动表面不同的情况下也可以在后续投递中复用它。

​

生成子代理

• runtime: "subagent" (默认) 或 "acp" 用于外部宿主代理。
• model 和 thinking 可覆盖子会话设置。
• thread: true 用于将生成操作绑定到聊天线程（Discord、Slack 等）。
• sandbox: "require" 用于对子代理强制启用沙箱。
• context: "fork" 用于本地子代理，当子代理需要当前请求者转录时使用；如需一个干净的子代理，可省略或使用 context: "isolated"。 绑定线程的本地子代理默认使用 context: "fork"，除非 threadBindings.defaultSpawnContext 另有说明。

​

可见性

​

延伸阅读

• Session Management — 路由、生命周期、维护
• ACP Agents — 外部宿主生成
• Multi-agent — 多代理架构
• Gateway Configuration — 会话工具配置选项

​

相关内容

• Session management
• Session pruning