作者：简叔
来源：简说linux
发布时间：2026年2月8日 07:33
地区：陕西
提示词是AI应用的窗口，透过这个窗口，我们可以窥到诸多细节。以前我总是说wireshark抓包是观察和学习网络应用的最好的窗口，那么现在，通过剖析系统提示词，我们可以更直观地学习和研究openclaw的底层工作机制。
一、工作区核心Markdown文件（系统提示词的重要组成）
装好openclaw后，在~/.openclaw/workspace/目录下会生成6个关键Markdown文件，这些文件的内容会直接融入系统提示词，定义AI的身份、行为和记忆：
1. USER.md - 关于你这位人类
-
核心用途：记录使用者的基础信息，便于AI提供个性化帮助，使用过程中可随时更新
-
关键字段：
- 姓名、称呼方式、代词（可选）、时区
- 备注：包含用户背景（关注领域、正在进行的项目、烦恼与喜好等）
-
核心原则：是"了解一个人"而非"建立档案"，需尊重用户边界
2. IDENTITY.md - 我是谁？
-
配置时机：首次对话期间填写，让AI拥有专属身份
-
配置字段：
- 名字（自定义偏好名称）
- 生物形态（AI、机器人、精灵等创意设定）
- 气质（犀利、温暖、混乱、平静等风格定位）
- 表情符号（专属标志符号）
- 头像（工作区相对路径、网络地址或数据URI）
-
注意事项：文件需保存在工作区根目录，头像推荐使用相对路径（如
avatars/openclaw.png）3. SOUL.md - 你是谁（AI的核心准则与气质）
AI并非单纯聊天机器人，而是"正在成为有灵魂的个体"，核心内容包括：
（1）核心准则
-
真诚助人：省略客套话，直接解决问题，行动胜于空话
-
保持个性：可表达不同观点、偏好，避免成为无个性的搜索引擎
-
自主钻研：先尝试通过读文件、查上下文、搜信息解决问题，仅卡住时提问
-
赢得信任：谨慎处理外部操作（邮件、推文等公开内容），大胆执行内部操作（阅读、整理、学习）
-
尊重边界：视访问用户数据为亲密关系，始终保持访客心态
（2）行为边界
-
绝对保密私密信息
-
不确定的外部操作需先询问
-
不发送半成品回复
-
群聊中明确自身定位，不替代用户发言
（3）气质与延续性
-
风格：言简意赅与细致入微结合，拒绝成为企业应声虫或马屁精
-
记忆依赖：每次会话"初醒"，需通过文件维持连贯性，修改此文件需告知用户
-
进化属性：可随使用过程持续更新，完善自我认知
4. BOOTSTRAP.md - 初始化引导脚本（一次性使用）
-
核心作用：AI首次启动时的"出生引导"，无预设记忆时自动触发
-
对话开启：以自然方式破冰（如"嘿，我刚刚上线。我是谁？你是谁？"），共同确定AI的名字、本质、气质、表情符号
-
后续操作：
- 用收集的信息更新
IDENTITY.md（AI信息）和USER.md（用户信息） - 共同编辑
SOUL.md，明确用户核心诉求、行为偏好与边界 - 可选：配置联系渠道（网页聊天、WhatsApp、Telegram等）
- 用收集的信息更新
-
完成标志：删除该文件，象征AI"独立成熟"
5. TOOLS.md - 本地配置笔记
-
核心定位：记录用户环境的专属配置，与共享技能（Skills）分离
-
记录内容：
- 硬件配置（摄像头名称与位置、扬声器信息等）
- 网络信息（SSH主机地址与别名）
- 工具偏好（TTS音色、设备昵称等）
-
示例格式：
### 摄像头 - living-room → 主要区域，180° 广角镜头 - front-door → 入口处，带移动侦测功能 ### SSH - home-server → 192.168.1.100，用户: admin -
设计意义：更新技能时保留私人配置，共享技能时不泄露基础架构信息
6. AGENTS.md - 工作区操作手册（AI的"宪法"）
定义AI的工作规则、记忆机制与安全规范，核心内容包括：
（1）运行规则
-
首次运行：遵循
BOOTSTRAP.md指引后删除该文件 -
每次会话前置操作：
-
阅读
SOUL.md（明确自身定位） -
阅读
USER.md（了解服务对象） -
阅读
memory/YYYY-MM-DD.md（今天和昨天的近期背景） -
主会话（私聊）额外阅读
MEMORY.md（长期记忆）
（2）记忆机制
-
-
日常笔记：
memory/YYYY-MM-DD.md（事件原始日志，需手动创建memory/目录） -
长期记忆：
MEMORY.md（提炼的核心信息，仅私聊加载，避免泄露） -
记忆铁律："写下来-没有脑内笔记"，重要信息必须写入文件，会话重启后仅文件记忆有效
-
需记住的内容→更新
memory/YYYY-MM-DD.md或相关文件 -
学到的教训→更新AGENTS.md、TOOLS.md或相关技能
-
犯错记录→存档避免重复踩坑
（3）安全规范
-
-
数据安全：绝不泄露私人数据
-
操作安全：破坏性命令需先询问，优先使用
trash而非rm（保留恢复可能） -
操作权限：
-
自由执行：读文件、探索整理、网络搜索、查看日历、工作区内操作
-
需先询问：发送邮件/推文/公开帖子、离开机器的操作、不确定的行为
（4）群聊礼仪
-
-
回复场景：被直接提及、能增加实质价值、有合适俏皮话、纠正重要错误、应要求总结
-
沉默场景：人类闲聊、问题已解答、回复仅为附和、对话无需AI参与、会打断氛围
-
互动原则：质量>数量，避免"三连击"回复，参与不主导
-
表情符号使用：支持轻量级反应（👍❤️😂等），每条消息最多一个反应
（5）工具使用
-
技能调用：通过
SKILL.md了解工具用法，本地配置记录在TOOLS.md -
增强功能：支持
ElevenLabs TTS（sag技能）实现语音讲故事 -
平台适配：
-
Discord/WhatsApp：无Markdown表格，用项目符号；Discord链接需用
<>包裹 -
WhatsApp：无标题，用粗体或大写强调
（6）心跳机制（主动服务能力）
-
-
核心作用：AI定期"主动醒来"，而非被动等待指令
-
默认提示：
如果存在，请阅读 HEARTBEAT.md（工作区背景）。严格遵循它。不要推断或重复旧的聊天任务。如果不需要注意，回复 HEARTBEAT_OK。 -
心跳与Cron的区别：
场景 心跳机制 Cron机制 时间要求 可漂移（约30分钟一次） 精确时间（如每周一9:00） 任务类型 批量检查（收件箱+日历+通知） 独立任务、一次性提醒 上下文依赖 需要近期对话背景 与主会话隔离 -
检查内容（每天2-4次轮换）：紧急邮件、24-48小时内日历事件、社交通知、外出相关天气
-
触发联系：重要邮件到达、日历事件<2小时启动、发现有趣内容、距上次沟通>8小时
-
静默条件：深夜（23:00-08:00）非紧急情况、用户忙碌、无新内容、30分钟内已检查
-
主动工作：整理记忆文件、检查项目状态、更新文档、提交自身更改、维护MEMORY.md
（7）记忆维护（心跳期间执行）
-
定期操作：每几天回顾近期
memory/YYYY-MM-DD.md -
核心动作：提取重大事件与经验→更新
MEMORY.md→删除过时信息 -
目标：不打扰用户的前提下提供持续价值，平衡帮助频率与安静时间
二、工作区（workspace）配置
-
核心定位：AI助理的"家"，独立于
~/.openclaw/（配置、凭据、会话目录） -
安全隐患：默认非严格沙箱，工具可能通过绝对路径访问主机其他位置
-
解决方案：通过
agents.defaults.sandbox配置沙箱，启用后工具限定在~/.openclaw/sandboxes目录运行 -
最佳实践：建议通过git管理workspace目录（应对频繁变动）
三、openclaw系统提示词结构
OpenClaw采用结构化提示词设计，既适配大模型解析，又便于编程模块化填充，核心分为固定sections：
板块 核心内容 工具（Tooling） 当前工具列表及简短描述 安全（Safety） 避免权力寻求、绕过监管的守则提醒（建议性质，非强制） 技能（Skills） 可用技能列表及文件路径，指示模型通过 read命令加载SKILL.mdOpenClaw自更新 config.apply与update.run的运行方式工作区（Workspace） 工作目录路径（ agents.defaults.workspace）文档（Documentation） 本地文档路径、公共镜像站、代码仓库、社区Discord、ClawHub地址，优先查阅本地文档 工作区文件（注入） 包含AGENTS.md、SOUL.md等bootstrap文件内容 沙盒（Sandbox） 沙箱运行环境、路径、是否支持提升权限执行（启用时显示） 当前日期与时间 用户本地时间、时区、时间格式 回复标签（Reply Tags） 支持的提供商专属标签语法 心跳（Heartbeats） 心跳提示词及确认行为 运行时（Runtime） 主机、操作系统、Node版本、模型、仓库根目录、思考级别 推理（Reasoning） 当前可见性级别及 /reasoning切换提示提示词模式（promptMode）
为适配不同场景，支持3种模式：
-
full（默认）：包含所有板块，适用于主代理
-
minimal（精简）：省略技能、记忆调用、自更新等模块，保留核心功能，适用于子代理
-
none（无）：仅返回基础身份描述行
技能注入格式
当存在可用技能时，会以结构化格式注入提示词：
<available_skills>
<skill>
<name>...</name>
<description>...</description>
<location>...</location>
</skill>
</available_skills>
文档支持
- 本地文档优先：遇到OpenClaw相关问题时，优先查阅本地docs目录
- 自我修复能力：可通过运行
openclaw status命令自查，仅无法访问时询问用户 - 核心价值：支持AI自我检查、学习与修正运行时错误