跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 为智能体提供跨会话工作、检查 Status，以及编排子智能体的工具。

​
可用工具

工具作用
sessions_list列出会话，并可选按 kind、label、agent、最近活动、preview 筛选
sessions_history读取特定会话的转录
sessions_send向另一个会话发送消息，并可选等待
sessions_spawn为后台工作生成一个隔离的子智能体会话
sessions_yield结束当前轮次，并等待后续子智能体结果
subagents列出、引导或终止此会话生成的子智能体
session_status显示 /status 风格的卡片，并可选设置每会话模型覆盖
这些工具仍受当前工具配置文件和允许/拒绝策略约束。tools.profile: "coding" 包含完整的会话编排工具集，包括 sessions_spawn、sessions_yield 和 subagents。tools.profile: "messaging" 包含跨会话消息工具（sessions_list、sessions_history、sessions_send、session_status），但不包含子智能体生成。若要保留消息配置文件并仍允许原生委托，请添加： 
{
  tools: {
    profile: "messaging",
    alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"],
  },
}
组、提供商、沙箱和每智能体策略仍可在配置文件阶段之后移除这些工具。可在受影响的会话中使用 /tools 检查实际工具列表。

​
列出和读取会话

sessions_list 返回会话及其 key、agentId、kind、渠道、模型、令牌计数和时间戳。可按 kind（main、group、cron、hook、node）、精确 label、精确 agentId、搜索文本或最近活动（activeMinutes）筛选。当你需要邮箱式分诊时，它还可以为每一行请求一个按可见性范围派生的标题、最后一条消息预览片段，或有界的最近消息。派生标题和预览仅为调用方在已配置的会话工具可见性策略下已经能看到的会话生成，因此不相关的会话会保持隐藏。 sessions_history 获取特定会话的对话转录。默认情况下会排除工具结果；传入 includeTools: true 可查看它们。返回视图有意设置边界并经过安全过滤：
  • 助手文本在召回前会被规范化：
    • 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 ...] 会被移除
    • 泄漏的模型控制令牌，例如 <|assistant|>、其他 ASCII <|...|> 令牌，以及全角 <｜...｜> 变体会被移除
    • 格式错误的 MiniMax 工具调用 XML，例如 <invoke ...> / </minimax:tool_call> 会被移除
  • 类似凭证/令牌的文本会在返回前被遮盖
  • 长文本块会被截断
  • 非常大的历史记录可能会丢弃较早的行，或用 [sessions_history omitted: message too large] 替换过大的行
  • 该工具会报告摘要标志，例如 truncated、droppedMessages、contentTruncated、contentRedacted 和 bytes
这两个工具都接受会话 key（例如 "main"）或来自先前列表调用的会话 ID。 如果你需要逐字节完全一致的转录，请检查磁盘上的转录文件，而不要把 sessions_history 当作原始转储。

​
发送跨会话消息

sessions_send 将消息递送到另一个会话，并可选等待响应：
  • 发送后即忘： 设置 timeoutSeconds: 0 入队后立即返回。
  • 等待回复： 设置超时并内联获取响应。
线程范围的聊天会话，例如以 :thread:<id> 结尾的 Slack 或 Discord key，不是有效的 sessions_send 目标。请使用父渠道会话 key 进行智能体间协调，以免工具路由消息出现在活跃的面向真人线程中。 消息和 A2A 后续回复会在接收提示（[Inter-session message ... isUser=false]）和转录来源中标记为会话间数据。接收智能体应将其视为工具路由数据，而不是直接由最终用户编写的指令。 目标响应后，OpenClaw 可以运行回传回复循环，让智能体交替发送消息（最多 5 轮）。目标智能体可以回复 REPLY_SKIP 提前停止。

​
Status 和编排辅助工具

session_status 是当前会话或另一个可见会话的轻量级 /status 等效工具。它会报告用量、时间、模型/运行时状态，以及存在时的关联后台任务上下文。与 /status 一样，它可以从最新的转录用量条目回填稀疏令牌/缓存计数，并且 model=default 会清除每会话覆盖。对调用方当前会话使用 sessionKey="current"；可见客户端标签（例如 openclaw-tui）不是会话 key。 sessions_yield 会有意结束当前轮次，以便下一条消息可以是你正在等待的后续事件。在生成子智能体后使用它，可让完成结果作为下一条消息到达，而不是构建轮询循环。 subagents 是已生成 OpenClaw 子智能体的控制平面辅助工具。它支持：
  • action: "list" 用于检查活跃/最近的运行
  • action: "steer" 用于向正在运行的子级发送后续指导
  • action: "kill" 用于停止一个子级或 all

​
生成子智能体

默认情况下，sessions_spawn 会为后台任务创建一个隔离会话。它始终非阻塞，会立即返回 runId 和 childSessionKey。 关键选项：
  • runtime: "subagent"（默认）或面向外部 harness 智能体的 "acp"。
  • 子会话的 model 和 thinking 覆盖。
  • thread: true 用于将生成绑定到聊天线程（Discord、Slack 等）。
  • sandbox: "require" 用于对子级强制执行沙箱隔离。
  • 当子级需要当前请求方转录时，原生子智能体可使用 context: "fork"；省略它或使用 context: "isolated" 可得到干净的子级。线程绑定的原生子智能体默认使用 context: "fork"，除非 threadBindings.defaultSpawnContext 另有指定。
默认叶子子智能体不会获得会话工具。当 maxSpawnDepth >= 2 时，深度为 1 的编排器子智能体还会收到 sessions_spawn、subagents、sessions_list 和 sessions_history，以便它们管理自己的子级。叶子运行仍不会获得递归编排工具。 完成后，公告步骤会将结果发布到请求方的渠道。完成递送会在可用时保留绑定的线程/主题路由；如果完成来源只标识了一个渠道，OpenClaw 仍可复用请求方会话存储的路由（lastChannel / lastTo）进行直接递送。 有关 ACP 特定行为，请参阅 ACP 智能体。

​
可见性

会话工具受范围限制，以限定智能体可以看到的内容：
级别范围
self仅当前会话
tree当前会话 + 已生成的子智能体
agent此智能体的所有会话
all所有会话（如已配置，则跨智能体）
默认值为 tree。无论配置如何，沙箱隔离的会话都会被限制为 tree。

​
延伸阅读

​
相关