Agent 工作区

概述

工作区是 Agent 的”家”，是文件工具的唯一工作目录，也是工作区上下文的来源。工作区与 ~/.openclaw/（配置、凭证、会话）是分开的两个目录。

默认路径：~/.openclaw/workspace（设置 OPENCLAW_PROFILE 时变为 ~/.openclaw/workspace-<profile>）
工作区是默认 cwd，不是硬沙箱——绝对路径仍可访问主机其他位置，需要隔离请启用 agents.defaults.sandbox
标准文件：
- AGENTS.md — 操作指令（每次会话加载）
- SOUL.md — 人格与语气（每次会话加载）
- USER.md — 用户画像（每次会话加载）
- IDENTITY.md — Agent 名称/风格/emoji
- TOOLS.md — 工具使用约定（仅指导，不控制可用性）
- HEARTBEAT.md — 心跳检查清单（保持简短）
- BOOT.md — 启动检查清单（Gateway 重启时自动运行）
- BOOTSTRAP.md — 首次运行仪式（完成后删除）
- memory/YYYY-MM-DD.md — 每日记忆日志
- MEMORY.md — 精选长期记忆（可选）
- skills/ — 工作区专属 Skills（最高优先级）
- canvas/ — Canvas UI 文件
引导文件截断限制：单文件 12000 chars（bootstrapMaxChars），总计 60000 chars（bootstrapTotalMaxChars）
不应放入工作区：openclaw.json、auth-profiles、session 记录、凭证

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      skipBootstrap: true  // 预置工作区时禁用引导文件创建
    }
  }
}

推荐将工作区放入私有 Git 仓库备份，避免提交 API Key、OAuth Token 等敏感信息。