跳转至

默认 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 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;桌面应用负责处理权限。
  • 从“技能”选项卡运行安装;一旦所需的二进制文件已存在,安装按钮就会隐藏。
  • 保持心跳(heartbeats)启用,以便助手能够安排提醒、监控收件箱并触发摄像头捕获。
  • 对于浏览器驱动的验证,使用 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 以获取机器可读输出。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw