跳转到主要内容

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

​
首次运行（推荐）

OpenClaw 为代理使用专用工作区目录。默认：~/.openclaw/workspace（可通过 agents.defaults.workspace 配置）。
  1. 创建工作区（如果尚未存在）：
mkdir -p ~/.openclaw/workspace
  1. 将默认工作区模板复制到工作区中：
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. 可选：如果你想要个人助理技能清单，请用此文件替换 AGENTS.md：
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 可选：通过设置 agents.defaults.workspace 选择不同的工作区（支持 ~）：
{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​
安全默认设置

  • 不要将目录或秘密信息倾倒到聊天中。
  • 除非被明确要求，否则不要运行破坏性命令。
  • 不要向外部消息界面发送部分/流式回复（仅发送最终回复）。

​
会话开始（必需）

  • 读取 SOUL.md、USER.md 和 memory/ 中的今天+昨天记录。
  • 如果存在 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。
  • 捕获：决策、偏好、约束、未完成的事项。
  • 除非明确要求，否则避免记录秘密。

​
工具与 Skills

  • 工具存在于 Skills 中；需要时请遵循每个 Skill 的 SKILL.md。
  • 将特定于环境的笔记保留在 TOOLS.md（Skills 笔记）中。

​
备份提示（推荐）

如果您将此工作空间视为 Clawd 的“记忆”，请将其设为一个 git 仓库（最好是私有的），以便备份 AGENTS.md 和您的记忆文件。 
cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

​
OpenClaw 的作用

  • 运行 WhatsApp 网关 + Pi 编码代理，以便助手可以通过主机 Mac 读取/写入聊天、获取上下文并运行 Skills。
  • macOS 应用管理权限（屏幕录制、通知、麦克风），并通过其捆绑的二进制文件暴露 openclaw CLI。
  • 默认情况下，直接聊天会合并到代理的 main 会话中；群组保持隔离，作为 agent:<agentId>:<channel>:group:<id>（房间/频道：agent:<agentId>:<channel>:channel:<id>）；心跳信号使后台任务保持活动状态。

​
核心 Skills（在 Settings → Skills 中启用）

  • mcporter — 工具服务器运行时/CLI，用于管理外部技能后端。
  • Peekaboo — 快速截取 macOS 屏幕截图，并提供可选的 AI 视觉分析。
  • camsnap — 从 RTSP/ONVIF 安防摄像头捕获帧、剪辑或运动警报。
  • oracle — 支持 OpenAI 的代理 CLI，具备会话回放和浏览器控制功能。
  • eightctl — 在终端中控制你的睡眠。
  • imsg — 发送、读取、流式传输 iMessage 和短信。
  • 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 模型进行快速问答。
  • agent-tools — 用于自动化和辅助脚本的实用工具包。

​
使用说明

  • 脚本编写首选 openclaw CLI；Mac 应用程序负责处理权限。
  • 从 Skills 选项卡运行安装；如果二进制文件已存在，它会隐藏该按钮。
  • 保持心跳启用，以便助手可以安排提醒、监视收件箱并触发摄像头捕获。
  • 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（点击/输入需要快照引用；对 CSS 选择器使用 evaluate）。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026