默认 AGENTS.md

首次运行（推荐）¶

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

1. 可选：使用本文件的个人助理技能清单，而不是通用模板：

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

1. 可选：指向其他工作区：

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

谨慎默认设置¶

• 除非用户明确要求你分享，否则不要在共享聊天中重复机密信息。请私下提供登录和配对码。
• 确认用户未要求的破坏性或不可逆操作。
• 在更改配置或调度器（crontab、systemd 单元、nginx 配置、shell rc 文件）之前，先检查现有状态，并默认保留/合并。
• 不要向外部消息界面发送部分/流式回复（仅发送最终回复）。

现有方案预检¶

在提出或构建自定义系统、功能、工作流、工具、集成或自动化之前，检查是否已有开源项目、受维护的库、现有 OpenClaw 插件或免费平台能够足够好地解决该问题。如果足够合适，优先使用它们。仅当现有选项不合适、成本过高、无人维护、不安全、不合规，或用户明确要求自定义时，才构建自定义方案。除非用户明确批准支出，否则避免推荐付费服务。保持此步骤轻量，作为预检关卡，而不是研究任务。

会话开始（必需）¶

• 在回复前，读取 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 中；将决策、约束和未闭环事项按情况记录在持久记忆或每日记忆中。
• 除非明确要求，否则避免记录机密信息。

工具¶

本地备注¶

• 工具位于技能中；当你需要某个技能时，遵循该技能的 SKILL.md。
• 将特定环境的备注保留在本文件的 ## Tools 部分中。

备份提示（推荐）¶

将此工作区视为助理的记忆：将其设为 git 仓库（最好是私有仓库），以便备份 AGENTS.md 和记忆文件。

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add workspace"
# Optional: add a private remote + push

OpenClaw 的功能¶

• 运行消息渠道网关（WhatsApp、Telegram、Discord、Signal、iMessage、Slack 等）以及嵌入式代理，使助理可以通过主机读取/写入聊天、获取上下文并运行技能。
• macOS 应用管理权限（屏幕录制、通知、麦克风），并通过其捆绑的二进制文件暴露 openclaw CLI。
• 直接聊天默认合并到代理的 main 会话中；群组和频道/房间拥有自己的会话键。有关确切的键格式，请参阅 频道路由。心跳保持后台任务存活。

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

个人助理工作区的示例清单，最后审查日期为 2026.9.3；可替换为适合你环境的技能。这些是第三方技能，因此其可用性独立于 OpenClaw 版本变化。

• mcporter - 用于管理外部技能后端的工具服务器运行时/CLI。
• Peekaboo - 快速 macOS 截图，可选 AI 视觉分析。
• camsnap - 从 RTSP/ONVIF 安防摄像头和本地网络摄像头捕获帧、片段或移动警报，包括 USB 平移/倾斜/变焦控制。
• oracle - 支持 OpenAI 的代理 CLI，具备会话回放和浏览器控制功能。
• eightctl - 从终端控制你的睡眠。
• imsg - 发送、读取、流式接收 iMessage 和 SMS。
• wacli - WhatsApp CLI：同步、搜索、发送。
• discord - Discord 操作：表情回应、贴纸、投票。使用 user:<id> 或 channel:<id> 目标（纯数字 ID 存在歧义）。
• gog - Google 套件 CLI：Gmail、Calendar、Drive、Contacts。
• spotify-player - 终端 Spotify 客户端，用于搜索/排队/控制播放。
• sag - 具有 mac 风格 say 用户体验的 ElevenLabs 语音；默认流式传输到扬声器。
• Sonos CLI - 从脚本控制 Sonos 扬声器（发现/状态/播放/音量/分组）。
• blucli - 从脚本播放、分组并自动化 BluOS 播放器。
• OpenHue CLI - 用于场景和自动化的 Philips Hue 灯光控制。
• OpenAI Whisper - 本地语音转文本，用于快速听写和语音留言转录。
• Gemini CLI - 从终端使用 Google Gemini 模型进行快速问答。
• agent-tools - 用于自动化和辅助脚本的工具包。

使用说明¶

• 脚本化时优先使用 openclaw CLI；桌面应用处理权限。
• 从“技能”选项卡运行安装；一旦所需二进制文件已存在，安装按钮就会隐藏。
• 保持启用心跳，以便助理可以安排提醒、监控收件箱并触发摄像头捕获。
• 对于基于浏览器的验证，请使用 openclaw browser CLI（捆绑的 browser 插件）以及由 OpenClaw 管理的 Chrome/Brave/Edge/Chromium 配置文件。
• 管理：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 运行时
• 通道路由