​

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

​

首次运行（推荐）

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

mkdir -p ~/.cryptoclaw/workspace

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

cp docs/reference/templates/AGENTS.md ~/.cryptoclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.cryptoclaw/workspace/SOUL.md
cp docs/reference/templates/TOOLS.md ~/.cryptoclaw/workspace/TOOLS.md

3. 可选：如果你想要个人助手 Skills 列表，用此文件替换 AGENTS.md：

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

4. 可选：通过设置 agents.defaults.workspace 选择不同的工作区（支持 ~）：

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

​

安全默认值

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

​

会话开始（必需）

• 读取 SOUL.md、USER.md、memory.md，以及 memory/ 中的今天和昨天的文件。
• 在回复之前完成此操作。

​

Soul（必需）

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

​

共享空间（推荐）

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

​

记忆系统（推荐）

• 每日日志：memory/YYYY-MM-DD.md（如需要请创建 memory/）。
• 长期记忆：memory.md 用于持久的事实、偏好和决定。
• 会话开始时，读取今天 + 昨天 + memory.md（如果存在）。
• 捕获：决定、偏好、约束、待办事项。
• 除非明确要求，否则避免存储密钥。

​

工具和 Skills

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

​

备份提示（推荐）

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

​

OpenClaw 的功能

• 运行 WhatsApp Gateway 网关 + Pi 编程智能体，使助手可以读写聊天、获取上下文，并通过主机 Mac 运行 Skills。
• macOS 应用管理权限（屏幕录制、通知、麦克风）并通过其内置二进制文件暴露 openclaw CLI。
• 私聊默认折叠到智能体的 main 会话；群组保持隔离为 agent:<agentId>:<channel>:group:<id>（房间/频道：agent:<agentId>:<channel>:channel:<id>）；心跳保持后台任务存活。

​

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

• mcporter — 用于管理外部 Skill 后端的工具服务器运行时/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 — 具有 mac 风格 say UX 的 ElevenLabs 语音；默认流式输出到扬声器。
• Sonos CLI — 从脚本控制 Sonos 扬声器（发现/状态/播放/音量/分组）。
• blucli — 从脚本播放、分组和自动化 BluOS 播放器。
• OpenHue CLI — 用于场景和自动化的 Philips Hue 照明控制。
• OpenAI Whisper — 本地语音转文字，用于快速听写和语音邮件转录。
• Gemini CLI — 从终端使用 Google Gemini 模型进行快速问答。
• bird — X/Twitter CLI，无需浏览器即可发推、回复、阅读话题和搜索。
• agent-tools — 用于自动化和辅助脚本的实用工具包。

​

使用说明

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