英文 Agent 概念
- 原始链接：https://docs.openclaw.ai/concepts/agent
- 来源章节：4. 官方文档：核心概念、模型与安全
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/concepts/agent
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
代理运行时 - OpenClaw
[OpenClaw主页！图片1：深色徽标！图片2：深色徽标](http://docs.openclaw.ai/)
英语
搜索...
⌘K
搜索...
导航
基础知识
代理运行时
基础知识
会话和内存
多代理
消息和传递
在此页面上
基础知识
代理运行时
代理运行时
OpenClaw 运行单个嵌入式代理运行时。
工作空间（必填）
OpenClaw 使用单个代理工作区目录（agents.defaults.workspace）作为代理的工具和上下文的唯一工作目录（cwd）。建议：使用openclaw setup创建~/.openclaw/openclaw.json（如果丢失）并初始化工作区文件。完整工作区布局+备份指南：Agent工作区如果agents.defaults.sandbox 已启用，非主会话可以使用 agents.defaults.sandbox.workspaceRoot 下的每个会话工作区覆盖此设置（请参阅网关配置）。
引导文件（注入）
在“agents.defaults.workspace”内部，OpenClaw 需要这些用户可编辑的文件：
AGENTS.md— 操作说明+“内存”SOUL.md— 角色、界限、语气TOOLS.md— 用户维护的工具注释（例如imsg、sag、约定）BOOTSTRAP.md— 一次性首次运行仪式（完成后删除）IDENTITY.md— 代理名称/氛围/表情符号USER.md— 用户个人资料 + 首选地址
在新会话的第一次启动时，OpenClaw 会将这些文件的内容直接注入到代理上下文中。空白文件将被跳过。大文件会用标记进行修剪和截断，以便提示保持精简（阅读文件以获取完整内容）。如果文件丢失，OpenClaw 会注入单个“丢失文件”标记行（并且“openclaw setup”将创建一个安全的默认模板）。“BOOTSTRAP.md”仅为全新工作区创建（不存在其他引导文件）。如果您在完成仪式后删除它，则不应在以后重新启动时重新创建它。要完全禁用引导文件创建（对于预先播种的工作区），请设置：
{ 代理：{skipBootstrap：true } }
内置工具
核心工具（读/执行/编辑/写和相关系统工具）始终可用，但须遵守工具策略。 apply_patch 是可选的，并由 tools.exec.applyPatch 控制。 TOOLS.md 不**控制哪些工具存在；这是您希望如何使用它们的指南。
技能
OpenClaw 从这些位置加载技能（优先级最高）：
- 工作空间：
<工作空间>/技能 - 项目代理技能：
<workspace>/.agents/skills - 个人代理技能：
~/.agents/skills - 托管/本地：
~/.openclaw/skills - 捆绑（随安装一起提供）
- 额外技能文件夹：
skills.load.extraDirs
技能可以通过 config/env 进行门控（请参阅网关配置中的“技能”）。
运行时边界
嵌入式代理运行时构建在 Pi 代理核心（模型、工具和提示管道）上。会话管理、发现、工具连接和通道交付是位于该核心之上的 OpenClaw 拥有的层。
会议
会话记录以 JSONL 形式存储在：
~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl
会话 ID 是稳定的，由 OpenClaw 选择。不会读取其他工具中的旧会话文件夹。
流媒体时转向
当队列模式为“steer”时，入站消息将注入到当前运行中。 在当前助理轮次完成执行其工具调用之后、在下一个 LLM 调用之前交付排队转向。转向不再跳过当前助理消息中的剩余工具调用；相反，它会在下一个模型边界注入排队的消息。当队列模式为“followup”或“collect”时，入站消息将被保留，直到当前轮次结束，然后新的代理轮次以排队的有效负载开始。请参阅 Queue 了解模式 + debounce/cap 行为。块流式传输完成后立即发送已完成的辅助块；默认情况下它是关闭的（agents.defaults.blockStreamingDefault: "off"）。通过 agents.defaults.blockStreamingBreak 调整边界（text_end 与 message_end；默认为 text_end）。使用“agents.defaults.blockStreamingChunk”控制软块分块（默认为 800-1200 个字符；首选段落分隔符，然后是换行符；最后是句子）。使用“agents.defaults.blockStreamingCoalesce”合并流式块以减少单行垃圾邮件（发送前基于空闲的合并）。非 Telegram 通道需要显式 `*.blockStreaming
: true` 启用阻止回复。在工具启动时发出详细的工具摘要（无反跳）；通过代理事件控制 UI 流工具输出（如果可用）。更多详细信息：流+分块。
型号参考
配置中的模型引用（例如 agents.defaults.model 和 agents.defaults.models）通过在 first/ 上拆分来解析。
- 配置模型时使用
provider/model。 - 如果模型 ID 本身包含“/”（OpenRouter 样式），请包含提供程序前缀（例如：“openrouter/moonshotai/kimi-k2”）。
- 如果您省略提供程序，OpenClaw 首先尝试别名，然后尝试与该确切模型 ID 匹配的唯一配置提供程序，然后才回退到配置的默认提供程序。如果该提供程序不再公开配置的默认模型，OpenClaw 会回退到第一个配置的提供程序/模型，而不是显示陈旧的已删除提供程序默认值。
配置（最低）
至少设置：
agents.defaults.workspacechannels.whatsapp.allowFrom（强烈推荐）
下一篇：【群聊】(http://docs.openclaw.ai/channels/group-messages) 🦞
⌘我