智能体运行时与工作区

OpenClaw 自带一个内置的智能体运行时：内置的智能体循环、工具连接和提示组装，与把回合委派给外部 harness 进程不同。每个配置的智能体（可用多智能体路由运行多个）有自己的工作区、引导文件和会话存储。工作区（必需）：每个智能体用单个工作区目录（agents.defaults.workspace，或每个智能体的 agents.entries.*.workspace）作为工具和上下文的唯一工作目录（cwd）。推荐用 openclaw setup 在缺少时创建 ~/.openclaw/openclaw.json 并初始化工作区文件。工作区是智能体的「家」：保持私密并当作记忆来对待；它与存放配置、凭证和会话的 ~/.openclaw/ 是分开的。工作区是默认 cwd，不是硬沙箱：工具按工作区解析相对路径，但绝对路径仍能到达主机上的其他位置，除非启用沙箱；需要隔离请用 agents.defaults.sandbox（沙箱开启且 workspaceAccess 不是 "rw" 时，工具在 ~/.openclaw/sandboxes 下的沙箱工作区里运行，而不是你的主机工作区）。

默认位置：~/.openclaw/workspace；设置了不等于 default 的 OPENCLAW_PROFILE 时为 ~/.openclaw-<profile>/workspace；OPENCLAW_WORKSPACE_DIR 优先覆盖前两者；非默认的 OPENCLAW_STATE_DIR 让默认工作区位于 <state-dir>/workspace。openclaw onboard、openclaw configure、openclaw setup 会创建工作区并在缺少时播种引导文件。引导文件（在工作区里，可由你编辑，新会话第一回合注入系统提示的 Project Context）：

文件	作用
AGENTS.md	操作指令与「记忆」
SOUL.md	人格、边界、语气
IDENTITY.md	智能体名称/风格/表情
USER.md	用户档案与偏好的称呼
BOOTSTRAP.md	一次性的首次运行仪式（完成后删除）
MEMORY.md	根目录的长期记忆文件（仅在工作区根目录存在时注入）

另见：多智能体路由（智能体边界、渠道账号和绑定）、智能体绑定（把渠道账号和对话路由到正确的智能体）、上下文（模型看到什么、如何构建、如何检查）、压缩（总结长对话以保持在模型限制内）、受管 worktree（在隔离的 git 检出里运行智能体任务，带自动快照和清理）。