代理运行?🤖

OpenClaw 运行一个基?pi-mono 的单一嵌入式代理运行时?

工作区（必需?

OpenClaw 使用单一代理工作区目录（agents.defaults.workspace）作为代理的唯一工作目录（cwd），用于工具和上下文?

推荐：如果缺失，使用 openclaw setup 创建 ~/.openclaw/openclaw.json 并初始化工作区文件?

完整工作区布局 + 备份指南：代理工作区

如果启用?agents.defaults.sandbox，非主会话可以使?agents.defaults.sandbox.workspaceRoot 下的每会话工作区覆盖此设置（请参阅网关配置）?

引导文件（注入）

?agents.defaults.workspace 中，OpenClaw 期望这些用户可编辑的文件?

  • AGENTS.md ?操作说明 + “记忆”
  • SOUL.md ?人设、边界、语?
  • TOOLS.md ?用户维护的工具说明（例如 imsg、sag、约定）
  • BOOTSTRAP.md ?一次性首次运行仪式（完成后删除）
  • IDENTITY.md ?代理名称/风格/emoji
  • USER.md ?用户个人资料 + 首选称?

在新会话的第一轮，OpenClaw 将这些文件的内容直接注入代理上下文?

空白文件会被跳过。大型文件会被修剪并带有标记截断，以便提示保持简洁（阅读文件获取完整内容）?

如果文件缺失，OpenClaw 注入单个”缺失文件”标记行（并且 openclaw setup 将创建安全的默认模板）?

BOOTSTRAP.md 仅在?*全新工作?*创建（没有其他引导文件存在）。如果完成仪式后删除它，它不应该在后续重启时重新创建?

要完全禁用引导文件创建（用于预种子工作区），请设置：

{ agent: { skipBootstrap: true } }

内置工具

核心工具（read/exec/edit/write 和相关系统工具）始终可用，受工具策略约束。apply_patch 是可选的，由 tools.exec.applyPatch 门控。TOOLS.md **?*控制存在哪些工具；它是关于您希望如何使用的指南?

技?

OpenClaw 从三个位置加载技能（名称冲突时工作区优先）：

  • 捆绑（随安装一起提供）
  • 托管/本地：~/.openclaw/skills
  • 工作区：<workspace>/skills

技能可以通过配置/环境门控（请参阅网关配置中的 skills）?

pi-mono 集成

OpenClaw 重用 pi-mono 代码库的片段（模?工具），?会话管理、发现和工具连接?OpenClaw 自己??

  • 没有 pi-coding 代理运行时?
  • 不读?~/.pi/agent ?<workspace>/.pi 设置?

会话

会话转录存储?JSONL 在：

  • ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

会话 ID 是稳定的，由 OpenClaw 选择?

传统?Pi/Tau 会话文件?不被读取*?

配置

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      sandbox: {
        enabled: false,
      },
    },
  },
}

工作区文?

AGENTS.md

这是代理的主要指令文件。它包含?

  • 代理应该如何行为
  • 可用的工?
  • 任务的具体说?
  • 记忆信息

SOUL.md

定义代理的人设：

  • 个性特?
  • 沟通风?
  • 边界和限?

TOOLS.md

用户维护的工具说明：

  • 常用命令
  • 约定
  • 自定义工具用?

IDENTITY.md

代理的身份：

  • 名称
  • 风格
  • emoji

USER.md

用户信息?

  • 名称
  • 偏好
  • 地址

故障排除

工作区缺?

# 创建工作?
openclaw setup

引导文件问题

  • 检查文件是否存?
  • 验证权限
  • 检查文件大?

权限问题

# 检查工作区权限
ls -la ~/.openclaw/workspace

# 修复权限
chmod -R 755 ~/.openclaw/workspace

相关链接