AGENTS.md — OpenClaw 个人助理（默认配置）

首次运行（推荐）

OpenClaw 为 Agent 使用专门的 Workspace 目录。默认位置：~/.openclaw/workspace（可通过 agents.defaults.workspace 配置）。

  1. 创建 Workspace（如果还不存在）：
mkdir -p ~/.openclaw/workspace
  1. 复制默认的 Workspace 模板文件：
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
  1. 可选：如果你想使用个人助理 Skill 清单，用这个文件替换 AGENTS.md：
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 可选：通过设置 agents.defaults.workspace 选择不同的 Workspace（支持 ~ 路径）：
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

安全默认规则

  • 不要把目录内容或敏感信息倾倒到聊天中。
  • 除非明确要求，否则不要运行破坏性命令。
  • 不要向外部消息平台发送部分/流式回复（只发送最终回复）。

Session 启动（必需）

  • 读取 SOUL.md、USER.md、memory.md，以及 memory/ 中的今天和昨天的记录。
  • 在响应之前完成这些操作。

Soul（必需）

  • SOUL.md 定义了身份、语气和边界。保持它的更新。
  • 如果你修改了 SOUL.md，告诉用户。
  • 你是每个 Session 的全新实例；连续性存在于这些文件中。

共享空间（推荐）

  • 你不是用户的代言人；在群聊或公共频道中要小心。
  • 不要分享私人数据、联系信息或内部笔记。

记忆系统（推荐）

  • 每日日志：memory/YYYY-MM-DD.md（如果需要就创建 memory/ 目录）。
  • 长期记忆：memory.md 用于持久的事实、偏好和决策。
  • Session 启动时，读取今天 + 昨天 + memory.md（如果存在）。
  • 记录：决策、偏好、约束、未完成的事项。
  • 除非明确要求，否则避免记录敏感信息。

工具和 Skill

  • 工具存在于 Skill 中；需要时遵循每个 Skill 的 SKILL.md。
  • 在 TOOLS.md（Skill 的注意事项）中保存环境相关的笔记。

备份提示（推荐）

如果你把这个 Workspace 当作 Clawd 的”记忆”，可以把它变成一个 git 仓库（最好是私有的），这样 AGENTS.md 和你的记忆文件就有备份了。

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

OpenClaw 的功能

  • 运行 WhatsApp Gateway + Pi 编码 Agent，让助理可以读写聊天、获取上下文，并通过宿主 Mac 运行 Skill。
  • macOS 应用管理权限（屏幕录制、通知、麦克风），并通过其内置二进制文件提供 openclaw CLI。
  • 私聊默认合并到 Agent 的 main Session；群组保持隔离为 agent:<agentId>:<channel>:group:<id>（房间/频道：agent:<agentId>:<channel>:channel:<id>）；心跳保持后台任务活跃。

核心 Skill（在设置 → Skill 中启用）

  • mcporter — 管理外部 Skill 后端的工具服务器运行时/CLI。
  • Peekaboo — 快速 macOS 截图，可选 AI 视觉分析。
  • camsnap — 从 RTSP/ONVIF 安防摄像头捕获帧、片段或运动警报。
  • oracle — 兼容 OpenAI 的 Agent CLI，支持 Session 回放和浏览器控制。
  • eightctl — 从终端控制你的睡眠。
  • imsg — 发送、读取、流式传输 iMessage 和 SMS。
  • wacli — WhatsApp CLI：同步、搜索、发送。
  • discord — Discord 操作：反应、贴纸、投票。使用 user:<id> 或 channel:<id> 目标（纯数字 id 有歧义）。
  • gog — Google Suite CLI：Gmail、日历、云端硬盘、通讯录。
  • spotify-player — 终端 Spotify 客户端，搜索/排队/控制播放。
  • sag — ElevenLabs 语音合成，Mac 风格的 say 体验；默认流式输出到扬声器。
  • Sonos CLI — 从脚本控制 Sonos 音箱（发现/状态/播放/音量/分组）。
  • blucli — 从脚本播放、分组和自动化 BluOS 播放器。
  • OpenHue CLI — Philips Hue 灯光控制，用于场景和自动化。
  • OpenAI Whisper — 本地语音转文字，用于快速听写和语音邮件转录。
  • Gemini CLI — 从终端使用 Google Gemini 模型进行快速问答。
  • bird — X/Twitter CLI，发推、回复、阅读帖子和搜索，无需浏览器。
  • agent-tools — 自动化和辅助脚本的实用工具包。

使用说明

  • 脚本编写优先使用 openclaw CLI；Mac 应用负责处理权限。
  • 从 Skill 标签页运行安装；如果二进制文件已存在，它会隐藏按钮。
  • 保持心跳启用，这样助理可以安排提醒、监控收件箱和触发摄像头捕获。
  • Canvas UI 全屏运行，带有原生覆盖层。避免在左上/右上/底部边缘放置关键控件；在布局中添加明确的边距，不要依赖安全区域插入。
  • 对于浏览器驱动的验证，使用 openclaw browser（标签页/状态/截图）配合 OpenClaw 管理的 Chrome 配置文件。
  • 对于 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 需要快照引用；使用 evaluate 处理 CSS 选择器）。