默认 AGENTS.md

​

首次运行（推荐）

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

3. 可选：使用此文件中的个人助手技能清单，而不是通用模板：

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

4. 可选：指向不同的工作区：

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

​

安全默认设置

• 不要将目录或机密信息转储到聊天中。
• 除非明确要求，不要运行破坏性命令。
• 在更改配置或调度器（crontab、systemd 单元、nginx 配置、shell rc 文件）之前，先检查现有状态，并默认进行保留/合并。
• 不要向外部消息传递渠道发送部分/流式回复（仅发送最终回复）。

​

现有解决方案预检

​

会话开始（必需）

• 在回复之前阅读 SOUL.md、USER.md 以及 memory/ 中今天和昨天的内容。
• 如存在 MEMORY.md，请阅读。

​

灵魂（必需）

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

​

共享空间（推荐）

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

​

记忆系统（推荐）

• 每日日志：memory/YYYY-MM-DD.md（如有需要，请创建 memory/）。
• 用户模型：USER.md，用于记录带日期的、仍然有效或已被取代的关于稳定偏好和个人资料事实的指令。
• 长期记忆：MEMORY.md，用于记录持久的、非个人资料类事实和决策。
• 小写的 memory.md 仅作为旧版修复输入；不要有意同时保留这两个根目录文件。
• 在会话开始时，读取今天 + 昨天 + MEMORY.md（如果存在）。
• 在写入记忆文件之前，先读取它们；只写入具体更新，不要写空占位内容。
• 将偏好作为指令记录到 USER.md；将决策、约束和未闭环事项按适当方式记录到持久记忆或每日记忆中。
• 除非明确要求，否则避免记录机密信息。

​

工具

​

本地说明

• 工具存在于 skills 中；在需要时请遵循每个 skill 的 SKILL.md。
• 将环境相关的说明保留在此文件的 ## 工具 部分。

​

备份提示（推荐）

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

​

OpenClaw 的作用

• 运行一个消息渠道网关（WhatsApp、Telegram、Discord、Signal、iMessage、Slack 等）以及一个嵌入式 agent，使助手能够读写聊天、获取上下文，并通过主机运行技能。
• macOS 应用负责管理权限（屏幕录制、通知、麦克风），并通过其捆绑的二进制文件公开 openclaw CLI。
• 直接聊天默认会合并到 agent 的 main 会话；群组和频道/房间会有各自的会话键。有关确切的键格式，请参见 Channel routing。心跳会保持后台任务处于活跃状态。

​

核心技能（在 设置 → 技能 中启用）

• mcporter - 用于管理外部技能后端的工具服务器运行时/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、日历、云端硬盘、联系人。
• 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 进行脚本编写；桌面应用负责处理权限。
• 从 Skills 选项卡运行安装；当所需二进制文件已存在时，安装按钮会被隐藏。
• 保持心跳功能启用，这样助手才能安排提醒、监控收件箱并触发摄像头拍摄。
• Canvas UI 以原生覆盖层全屏运行。避免将关键控件放在左上/右上/底部边缘；请添加显式布局边距，不要依赖安全区域内边距。
• 对于由浏览器驱动的验证，请使用带有 OpenClaw 管理的 Chrome/Brave/Edge/Chromium 配置文件的 openclaw browser CLI（捆绑的 browser 插件）。
• 管理：status、doctor [--deep]、start [--headless]、stop、tabs、tab [new|select|close]、open <url>、focus <id>、close <id>。
• 检查：screenshot [--full-page|--ref|--labels]、snapshot [--format ai|aria|--interactive|--efficient]、console、errors、requests、pdf、responsebody。
• 操作：navigate、click <ref>、type <ref> <text>、press、hover、drag、select、upload、download、fill、dialog、wait、evaluate --fn <js>、highlight。操作需要来自 snapshot 的 ref（不接受用于操作的 CSS 选择器）；当需要 document.querySelector 风格的定位时，请使用 evaluate。
• 在任何检查命令中添加 --json 以获得机器可读输出。

​

相关

• Agent 工作区
• Agent 运行时
• Channel 路由