默认 AGENTS.md
首次运行(推荐)¶
OpenClaw 智能体使用工作区目录。默认:~/.openclaw/workspace(可通过 agents.defaults.workspace 配置,支持 ~)。
- 创建工作区:
- 将默认工作区模板复制到其中:
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.md
cp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
- 可选:使用此文件的个人助手技能清单,而不是通用模板:
- 可选:指向不同的工作区:
默认谨慎准则¶
- 不要在共享聊天中重复机密信息,除非用户明确要求你分享。登录码和配对码应私下传递。
- 对于用户并未要求的破坏性或不可逆操作,请先确认。
- 在修改配置或调度器(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 应用管理权限(屏幕录制、通知、麦克风),并通过其内置二进制文件暴露
openclawCLI。 - 默认情况下,直接聊天会合并到智能体的
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 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 - 用于自动化和辅助脚本的实用工具包。
使用说明¶
- 脚本编写优先使用
openclawCLI;桌面应用负责处理权限。 - 从“技能”选项卡运行安装;一旦所需的二进制文件已存在,安装按钮就会隐藏。
- 保持心跳(heartbeats)启用,以便助手能够安排提醒、监控收件箱并触发摄像头捕获。
- 对于浏览器驱动的验证,使用
openclaw browserCLI(随附的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以获取机器可读输出。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw