Appearance
OpenClaw 的默认 AGENTS.md 定义了个人助手工作区的初始行为和技能清单。按步骤执行 mkdir -p ~/.openclaw/workspace 和模板复制即可完成基础配置；记忆系统要求会话启动时读取 SOUL.md、USER.md 和当日/前一日日志。核心技能需在 Settings → Skills 中手动启用，包括 mcporter、Peekaboo、wacli 等。
OpenClaw 默认 AGENTS.md 配置参考 - 工作区初始化与核心技能
首次运行（推荐步骤）
OpenClaw 为 agent 使用专用工作区目录，默认路径为 ~/.openclaw/workspace（可通过 agents.defaults.workspace 修改）。
- 创建工作区（如果还不存在）：
bash
mkdir -p ~/.openclaw/workspace- 复制默认模板：
bash
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md- 可选：启用个人助手完整技能清单：用本文件替换 AGENTS.md：
bash
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md- 可选：指定不同工作区路径（支持
~）：
json5
{
agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}安全默认值
- 不得将目录内容或密钥信息转储到对话中。
- 未经明确要求，不执行破坏性命令。
- 不向外部消息界面发送流式/部分回复，只发送最终完整回复。
会话启动（必须执行）
- 读取
SOUL.md、USER.md以及memory/中今天和昨天的日志。 - 存在
MEMORY.md时读取MEMORY.md。 - 在响应之前完成上述读取。
Soul（必须遵守）
SOUL.md定义了身份、语气和边界，请保持最新。- 如果修改了
SOUL.md，需告知用户。 - 每次会话都是全新实例；连续性依赖于这些文件。
共享空间（推荐）
- 你不是用户的代言人，在群聊或公开频道中请谨慎发言。
- 不要分享私人数据、联系方式或内部备注。
记忆系统（推荐）
- 每日日志：
memory/YYYY-MM-DD.md（如有需要可创建memory/目录）。 - 长期记忆：
MEMORY.md，用于存储持久性事实、偏好和决策。 - 小写的
memory.md仅作为遗留修复输入，不要同时在根目录保留两个文件（MEMORY.md和memory.md）。 - 会话启动时，读取今天 + 昨天 +
MEMORY.md（存在时）。 - 需要记录的内容：决策、偏好、约束、未解决的待办事项。
- 除非被明确要求，避免记录敏感信息。
工具与技能
- 工具存放在 skill 中；使用某个 skill 时，请遵循其
SKILL.md的说明。 - 将环境相关的备注保存在
TOOLS.md（技能备注）中。
备份建议（推荐）
如果你把工作区当作 Clawd 的“记忆”，建议将其设为 git 仓库（最好是私有）以便备份 AGENTS.md 和记忆文件。
bash
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# 可选：添加私有远程仓库并推送OpenClaw 能做什么
- 运行 WhatsApp 网关 + Pi coding agent，让助手能读写聊天、获取上下文，并通过宿主 Mac 调用 skill。
- macOS 应用管理权限（屏幕录制、通知、麦克风），并通过内置二进制文件暴露
openclawCLI。 - 私聊默认合并到 agent 的
main会话；群组会话保持独立（agent:<agentId>:<channel>:group:<id>，房间/频道格式为agent:<agentId>:<channel>:channel:<id>）；心跳机制维持后台任务活跃。
核心技能（在 Settings → Skills 中启用）
- mcporter — 管理外部 skill 后端的工具服务器运行时/CLI。
- Peekaboo — 快速 macOS 截图，支持可选的 AI 视觉分析。
- camsnap — 从 RTSP/ONVIF 安防摄像头捕获帧、片段或动态告警。
- oracle — 支持会话回放和浏览器控制的 OpenAI 兼容 agent CLI。
- eightctl — 从终端控制睡眠状态。
- imsg — 发送、读取、流式接收 iMessage 和 SMS。
- wacli — WhatsApp CLI：同步、搜索、发送。
- discord — Discord 操作：表情回应、贴纸、投票。使用
user:<id>或channel:<id>作为目标（纯数字 ID 存在歧义）。 - gog — Google Suite CLI：Gmail、日历、Drive、联系人。
- spotify-player — 终端 Spotify 客户端，用于搜索/排队/控制播放。
- sag — 基于 ElevenLabs 的语音合成，默认流式输出到扬声器。
- Sonos CLI — 通过脚本控制 Sonos 音响（发现/状态/播放/音量/分组）。
- blucli — 通过脚本播放、分组和自动化 BluOS 播放器。
- OpenHue CLI — 飞利浦 Hue 灯光控制，支持场景和自动化。
- OpenAI Whisper — 本地语音转文字，用于快速听写和语音信箱转录。
- Gemini CLI — 终端使用 Google Gemini 模型，快速问答。
- agent-tools — 自动化和辅助脚本的实用工具包。
使用说明
- 脚本优先使用
openclawCLI；macOS 应用负责处理权限。 - 从 Skills 标签页安装技能；二进制已存在时按钮会自动隐藏。
- 保持心跳开启，以便助手调度提醒、监控收件箱、触发摄像头捕获。
- Canvas UI 全屏运行并包含原生覆盖层。避免在顶左/顶右/底部边缘放置关键控件；布局中须预留明确的间距，不要依赖 safe-area insets。
- 浏览器验证请使用
openclaw browser（标签页/状态/截图），搭配 OpenClaw 管理的 Chrome Profile。 - DOM 检查使用
openclaw browser eval|query|dom|snapshot（需要机器可读输出时加--json/--out）。 - 交互操作使用
openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run（click/type 需要快照引用；CSS 选择器场景用evaluate）。
常见问题
怎么把默认 AGENTS.md 换成个人助手模板？
运行 cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md。这会覆盖工作区中的 AGENTS.md，启用完整的个人助手技能清单。
记忆系统为什么不读取 memory.md？
大写 MEMORY.md 是官方推荐的长期记忆文件；小写 memory.md 仅作为遗留修复输入，不应与 MEMORY.md 同时存在。启动时优先读取 MEMORY.md。
核心技能怎么启用？
打开 OpenClaw 设置，进入 Settings → Skills 页面，找到对应 skill（如 mcporter、Peekaboo）并点击启用。多数 skill 的二进制文件已预置，按钮会自动隐藏。