本页内容
本页内容
模板
默认 AGENTS.md
首次运行(推荐)
OpenClaw 代理使用工作区目录。默认值:~/.openclaw/workspace(可通过 agents.defaults.workspace 配置,支持 ~)。
- 创建工作区:
- 将默认工作区模板复制到其中:
- 可选:使用此文件中的个人助手技能清单,而不是通用模板:
- 可选:指向不同的工作区:
Care 默认值
- 不要在共享聊天中重复秘密,除非用户明确要求您共享它们。私下提供登录和配对代码。
- 确认用户未要求的破坏性或不可逆转的操作。
- 在更改配置或调度程序(crontab、systemd 单元、nginx 配置、shell rc 文件)之前,首先检查现有状态,默认情况下检查 preserve/merge。
- 不要将 partial/streaming 回复发送到外部消息表面(仅最终回复)。
现有解决方案预检
在提出或构建自定义系统、功能、工作流、工具、集成或自动化之前,请检查是否已有开源项目、维护中的库、现有的 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;将决策、约束和未闭环事项按适当方式记录到持久记忆或每日记忆中。 - 除非明确要求,否则避免记录机密信息。
工具
本地说明
- 工具存在于 skills 中;在需要时请遵循每个 skill 的
SKILL.md。 - 在此文件的
## Tools部分中保留特定于环境的注释。
备份提示(推荐)
将此工作区视为助手的记忆:把它做成一个 git 仓库(最好是私有仓库),这样 AGENTS.md 和记忆文件就会被备份。
OpenClaw 的作用
- 运行消息通道网关(WhatsApp、Telegram、Discord、Signal、iMessage、Slack等)以及嵌入式代理,因此助手可以与read/write聊天,获取上下文,并通过主机运行技能。
- macOS 应用负责管理权限(屏幕录制、通知、麦克风),并通过其捆绑的二进制文件公开
openclawCLI。 - 默认情况下,直接聊天会折叠到代理的
main会话中; groups 和 channels/rooms 获得自己的会话密钥。请参阅 通道路由 了解确切的密钥格式。心跳使后台任务保持活动状态。
核心技能(在设置 → 技能中启用)
个人助理工作区名册示例,最后一次审查为 2026.9.3;交换适合您的设置的技能。这些是第三方技能,因此可用性的变化独立于 OpenClaw 版本。
- mcporter - 用于管理外部技能后端的工具服务器 runtime/CLI。
- Peekaboo - 快速的 macOS 截图,支持可选的 AI 视觉分析。
- camsnap - 从 RTSP/ONVIF 安全摄像头和本地网络摄像头(包括 USB pan/tilt/zoom 控制)捕获帧、剪辑或运动警报。
- oracle - OpenAI- 就绪代理 CLI 具有会话重播和浏览器控制。
- eightctl - 在终端中控制你的睡眠。
- imsg - 发送、读取、流式接收 iMessage 和 SMS。
- wacli - WhatsApp CLI:同步、搜索、发送。
- discord - Discord 操作:表情回应、贴纸、投票。使用
user:<id>或channel:<id>作为目标(纯数字 id 容易产生歧义)。 - gog - Google Suite CLI:Gmail、日历、云端硬盘、联系人。
- spotify-player - 终端 Spotify 客户端到 search/queue/control 播放。
- sag - ElevenLabs 语音,使用 mac 风格说 UX;默认情况下流向扬声器。
- Sonos CLI - 通过脚本控制 Sonos 扬声器 (discover/status/playback/volume/grouping)。
- blucli - 从脚本中播放、分组并自动化 BluOS 播放器。
- OpenHue CLI - Philips Hue 照明控制,用于场景和自动化。
- OpenAI Whisper - 本地语音转文字,用于快速听写和语音信箱转录。
- Gemini CLI - 在终端中使用 Google Gemini 模型进行快速问答。
- agent-tools - 用于自动化和辅助脚本的实用工具包。
使用说明
- 优先使用
openclawCLI 进行脚本编写;桌面应用负责处理权限。 - 从 Skills 选项卡运行安装;当所需二进制文件已存在时,安装按钮会被隐藏。
- 保持心跳功能启用,这样助手才能安排提醒、监控收件箱并触发摄像头拍摄。
- 对于浏览器驱动的验证,请将
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以获得机器可读输出。
相关内容
本页有帮助吗?