AGENTS.md - OpenClaw 个人助手（默认模板）

首次运行（推荐步骤）

OpenClaw 为 agent 使用专用工作区目录，默认路径为 ~/.openclaw/workspace（可通过 agents.defaults.workspace 修改）。

1. 创建工作区（如果还不存在）：

mkdir -p ~/.openclaw/workspace

2. 将默认工作区模板复制到工作区：

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

3. 可选：如果想启用个人助手完整技能清单，用本文件替换 AGENTS.md：

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. 可选：通过 agents.defaults.workspace 指定不同的工作区路径（支持 ~）：

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

安全默认值

• 不得将目录内容或密钥信息转储到对话中。
• 未经明确要求，不执行破坏性命令。
• 不向外部消息界面发送流式/部分回复，只发送最终完整回复。

会话启动（必须执行）

• 读取 SOUL.md、USER.md 以及 memory/ 中今天和昨天的日志。
• 存在 MEMORY.md 时读取 MEMORY.md；仅当 MEMORY.md 不存在时才回退到小写的 memory.md。
• 在响应之前完成上述读取。

Soul（必须遵守）

• SOUL.md 定义了龙虾的身份、语气和边界，请保持最新。
• 如果修改了 SOUL.md，需告知用户。
• 每次会话都是全新实例；连续性依赖于这些文件。

共享空间（推荐）

• 你不是用户的代言人，在群聊或公开频道中请谨慎发言。
• 不要分享私人数据、联系方式或内部备注。

记忆系统（推荐）

• 每日日志：memory/YYYY-MM-DD.md（如有需要可创建 memory/ 目录）。
• 长期记忆：MEMORY.md，用于存储持久性事实、偏好和决策。
• 小写的 memory.md 仅作遗留回退，不要同时在根目录保留两个文件。
• 会话启动时，读取今天 + 昨天 + MEMORY.md（存在时），否则读 memory.md。
• 需要记录的内容：决策、偏好、约束、未解决的待办事项。
• 除非被明确要求，避免记录敏感信息。

工具与技能

• 工具存放在 skill 中；使用某个 skill 时，请遵循其 SKILL.md 的说明。
• 将环境相关的备注保存在 TOOLS.md（技能备注）中。

备份建议（推荐）

如果你把这个工作区当作 Clawd 的"记忆"，建议将其设为 git 仓库（最好是私有），这样 AGENTS.md 和记忆文件都有备份。

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# 可选：添加私有远程仓库并推送

OpenClaw 能做什么

• 运行 WhatsApp 网关 + Pi coding agent，让助手能读写聊天、获取上下文，并通过宿主 Mac 调用 skill。
• macOS 应用管理权限（屏幕录制、通知、麦克风），并通过内置二进制文件暴露 openclaw CLI。
• 私聊默认合并到 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 和短信。
• 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 — 自动化和辅助脚本的实用工具包。

使用说明

• 脚本优先使用 openclaw CLI；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）。