本页内容

本页内容

模板

默认 AGENTS.md

首次运行(推荐)

OpenClaw 代理使用工作区目录。默认值:~/.openclaw/workspace(可通过 agents.defaults.workspace 配置,支持 ~)。

  1. 创建工作区:
bash
mkdir -p ~/.openclaw/workspace
  1. 将默认工作区模板复制到其中:
bash
cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.md
  1. 可选:使用此文件中的个人助手技能清单,而不是通用模板:
bash
cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md
  1. 可选:指向不同的工作区:
json5
{  agents: { defaults: { workspace: "~/.openclaw/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 和记忆文件就会被备份。

bash
cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "Add workspace"# Optional: add a private remote + push

OpenClaw 的作用

  • 运行消息通道网关(WhatsApp、Telegram、Discord、Signal、iMessage、Slack等)以及嵌入式代理,因此助手可以与read/write聊天,获取上下文,并通过主机运行技能。
  • macOS 应用负责管理权限(屏幕录制、通知、麦克风),并通过其捆绑的二进制文件公开 openclaw CLI。
  • 默认情况下,直接聊天会折叠到代理的 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 - 用于自动化和辅助脚本的实用工具包。

使用说明

  • 优先使用 openclaw CLI 进行脚本编写;桌面应用负责处理权限。
  • 从 Skills 选项卡运行安装;当所需二进制文件已存在时,安装按钮会被隐藏。
  • 保持心跳功能启用,这样助手才能安排提醒、监控收件箱并触发摄像头拍摄。
  • 对于浏览器驱动的验证,请将 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 以获得机器可读输出。

相关内容

本页有帮助吗?