English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

模板

默认 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
cp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md
  1. 可选：如果你想使用个人助手 Skills 名单，请用此文件替换 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 时读取它。
  • 在回复前完成这些操作。

Soul（必需）

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

共享空间（推荐）

  • 你不是用户的代言人；在群聊或公共渠道中要谨慎。
  • 不要分享私人数据、联系信息或内部备注。

记忆系统（推荐）

  • 每日日志：memory/YYYY-MM-DD.md（需要时创建 memory/）。
  • 长期记忆：MEMORY.md，用于持久事实、偏好和决策。
  • 小写的 memory.md 仅作为旧版修复输入；不要有意同时保留这两个根文件。
  • 会话开始时，读取今天 + 昨天 + 存在时的 MEMORY.md。
  • 捕获：决策、偏好、约束、未闭环事项。
  • 除非明确要求，否则避免保存密钥。

工具和 Skills

  • 工具存在于 Skills 中；需要某个 Skills 时，遵循其 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>）；heartbeats 让后台任务保持活跃。

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

  • mcporter - 用于管理外部 Skills 后端的工具服务器运行时/CLI。
  • Peekaboo - 快速 macOS 截图，可选 AI 视觉分析。
  • camsnap - 从 RTSP/ONVIF 安防摄像头捕获帧、片段或运动警报。
  • oracle - 支持会话重放和浏览器控制的 OpenAI 就绪智能体 CLI。
  • eightctl - 从终端控制你的睡眠。
  • imsg - 发送、读取、流式处理 iMessage 和 SMS。
  • wacli - WhatsApp CLI：同步、搜索、发送。
  • discord - Discord 操作：反应、贴纸、投票。使用 user:<id> 或 channel:<id> 目标（裸数字 id 有歧义）。
  • gog - Google Suite CLI：Gmail、Calendar、Drive、Contacts。
  • 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 选项卡运行安装；如果二进制文件已存在，它会隐藏按钮。
  • 保持 heartbeats 启用，以便助手可以安排提醒、监控收件箱并触发摄像头捕获。
  • 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 需要 snapshot 引用；CSS 选择器请使用 evaluate）。

相关