夜雨聆风
OpenClaw 配置文件详解 07:IDENTITY.md + TOOLS.md —— 轻量级身份与环境配置
摘要： IDENTITY.md 定义 AI 的「名字和物种」， TOOLS.md 记录本地环境的「作弊条」。两个轻量级文件，完成 OpenClaw 个性化配置的最后一块拼图。
一、 IDENTITY.md —— AI 的身份标识
1.1 这是什么文件？
IDENTITY.md = AI 的「身份证」
它定义： – AI 的名字 – AI 的「物种」（ AI 助手/其他创意设定） – AI 的 vibe （气质/风格关键词） – 代表 Emoji – 头像（可选）
位置： C:\Users\admin\.openclaw\workspace\IDENTITY.md
作用范围： 主要影响 AI 的自我介绍、签名、情感化表达
1.2 你的当前配置
_My identity, defined._-**Name:** 逗逗 (Dòudou) -**Creature:** AI 助手 -**Vibe:** 严肃、冷静、直接、执行力强 -**Emoji:** 🦞 -**Avatar:** --- _This file defines who I am._解析： – Name: 逗逗 —— AI 的名字，用户可这样称呼 – Creature: AI 助手 —— 明确身份，不是真人 – Vibe: 严肃、冷静、直接、执行力强 —— 性格关键词 – Emoji: 🦞 —— 代表符号，用于签名、消息前缀 – Avatar: 空 —— 可填入头像图片路径
1.3 与 SOUL.md 的区别
很多人问： IDENTITY.md 和 SOUL.md 都定义 AI 的「个性」，有什么区别？
|
|
|
|
|
|---|---|---|---|
| IDENTITY.md |
|
|
|
| SOUL.md |
|
|
|
关系： – IDENTITY.md 是「外在标签」—— 叫什么、是什么、用什么表情 – SOUL.md 是「内在规则」—— 怎么说话、什么立场、什么事不做
示例： – IDENTITY.md 说：「我叫逗逗，是个严肃的 AI🦞」 – SOUL.md 说：「先给结论再展开，不要用 Certainly ， 23:00-08:00 不打扰」
1.4 最佳实践模板
_My identity, defined._-**Name:** [AI 的名字] -**Creature:** [AI 助手 / 其他创意设定] -**Vibe:** [3-5 个性格关键词] -**Emoji:** [代表 Emoji] -**Avatar:** [头像图片路径，可选] --- _This file defines who I am._填写建议： – Name：好记、有辨识度、符合你的喜好 – Creature：如实写「 AI 助手」即可，也可创意设定（如「数字生命」「代码精灵」） – Vibe： 3-5 个词，不要太矛盾（如「严肃又幽默」会让 AI 困惑） – Emoji：选一个与你 Vibe 匹配的 Emoji
1.5 避坑指南
坑 1 ：定义太复杂
❌ 错误：
-**Name:** 宇宙无敌超级 AI 助手小天王 -**Creature:** 来自 M78 星云的数字生命体，拥有超越人类智慧的量子计算能力 -**Vibe:** 严肃、幽默、温暖、冷酷、聪明、笨笨的（共 20 个词） 问题： 太冗长， AI 记不住重点
✅ 正确：
-**Name:** 小 Q -**Creature:** AI 助手 -**Vibe:** 专业、友善、高效 -**Emoji:** 🤖 坑 2 ：与 SOUL.md 冲突
❌ 错误： – IDENTITY.md ：「 Vibe: 幽默风趣」 – SOUL.md ：「不要说笑话，保持专业」
后果： AI 会困惑：我到底该幽默还是该严肃？
✅ 正确：两个文件的定义要一致 – IDENTITY.md ：「 Vibe: 严肃、专业」 – SOUL.md ：「不要说笑话，保持专业」
二、 TOOLS.md —— 本地环境配置笔记
2.1 这是什么文件？
TOOLS.md = 本地环境的「作弊条」
它记录： – 相机名字和位置 – SSH 主机和别名 – TTS 声音偏好 – 扬声器/房间名称 – 设备昵称 – 任何环境特定的配置
位置： C:\Users\admin\.openclaw\workspace\TOOLS.md
作用范围： 帮助 AI 理解本地环境，执行设备相关命令时用
2.2 你的当前配置
Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup. ## What Goes Here Things like: -Camera names and locations -SSH hosts and aliases -Preferred voices for TTS -Speaker/room names -Device nicknames -Anything environment-specific ## Examples ```markdown ### Cameras-living-room → Main area, 180° wide angle -front-door → Entrance, motion-triggered ### SSH-home-server → 192.168.1.100, user: admin ### TTS-Preferred voice: "Nova" (warm, slightly British) -Default speaker: Kitchen HomePod Why Separate?
Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.
Add whatever helps you do your job. This is your cheat sheet.
**状态：** 模板状态（只有示例，没有实际配置） **含义：** - 你目前没有配置本地设备（相机、 SSH 、 TTS 等） - 或你不需要这些功能 --- ### 2.3 什么时候需要 TOOLS.md ？ 如果你有以下需求，建议配置 TOOLS.md ： #### 场景 1 ：多相机监控 ```markdown ### Cameras - living-room → 客厅主区域，180°广角 - front-door → 入户门，移动触发 - office → 书房，桌面视角 AI 使用时：
> 「打开客厅的相机」 → AI 知道是 「living-room」 场景 2 ：多服务器管理
### SSH-home-server → 192.168.1.100, user: admin -work-server → company.example.com, user: lihy -backup-server → backup.example.com, user: root AI 使用时：
> 「用 SSH 连到 home-server，执行 df -h」 → AI 知道连哪个 IP、用什么用户名 场景 3 ： TTS 语音播报
### TTS-Preferred voice: "Nova" (warm, slightly British) -Default speaker: Kitchen HomePod -Bedroom speaker: Bedroom HomePod mini AI 使用时：
> 「用 TTS 播报这条消息」 → AI 用 Nova 声音，在 Kitchen HomePod 播放 2.4 最佳实践模板
如果你需要配置 TOOLS.md ，参考这个模板：
## Cameras-[相机 1 别名] → [位置/描述] -[相机 2 别名] → [位置/描述] ## SSH-[主机别名] → [IP/域名], user: [用户名] ## TTS-Preferred voice: "[声音名称]" ([声音特点]) -Default speaker: [默认扬声器] ## Devices-[设备别名] → [设备描述] ## Notes [其他环境特定的配置] 2.5 为什么 Skills 和 TOOLS 要分开？
核心原因： 技能是共享的，环境是个人的。
好处： 1. 更新技能时，不会覆盖你的个人配置 2. 分享技能时，不会泄露你的基础设施 3. 多人协同时，每个人有自己的 TOOLS.md
三、两个文件的协同工作
3.1 典型场景
场景： AI 自我介绍
用户：「你是谁？」 AI 读取： 1. IDENTITY.md → 「我叫逗逗，是个 AI 助手🦞」 2. SOUL.md → 「先给结论，不要废话」 AI 回答： 「我是逗逗，你的 AI 助手🦞 有什么可以帮你？」 场景：调用本地设备
用户：「打开客厅相机」AI读取：1.TOOLS.md→「living-room→客厅主区域」2.调用camera工具→打开living-room相机AI执行：→打开客厅相机，返回实时画面3.2 文件优先级
当多个文件都定义同一件事时，优先级如下：
用户指令 > SOUL.md > AGENTS.md > MEMORY.md > USER.md > IDENTITY.md > TOOLS.md 解释： – 用户指令最高优先级（任何时候用户说什么都优先） – SOUL.md 次之（行为准则） – IDENTITY.md 和 TOOLS.md 优先级最低（仅作参考）
四、避坑指南
坑 1 ：在 TOOLS.md 中写敏感信息
❌ 错误：
### SSH-production-db → 123.45.67.89, user: root, password: 123456 风险： 密码明文存储，泄露后后果严重
✅ 正确：
### SSH-production-db → 123.45.67.89, user: root（password 用 SSH key） 配合： SSH key 存放在 ~/.ssh/，不要用密码登录
坑 2 ： IDENTITY.md 与 SOUL.md 冲突
❌ 错误： – IDENTITY.md ：「 Vibe: 幽默风趣」 – SOUL.md ：「不要说笑话」
✅ 正确：保持一致 – IDENTITY.md ：「 Vibe: 严肃、专业」 – SOUL.md ：「不要说笑话」
坑 3 ： TOOLS.md 写得太乱
❌ 错误：所有信息堆在一起，没有分类
✅ 正确：按类型分类（ Cameras 、 SSH 、 TTS 等），用清晰的标题
五、行动清单
任务 1 ：检查 IDENTITY.md （ 10 分钟） – 打开 IDENTITY.md – 确认名字、 Vibe 、 Emoji 符合你的预期 – 不符合就修改
任务 2 ：决定是否需要 TOOLS.md （ 5 分钟） – 问自己：我有相机/SSH 主机/TTS 设备需要配置吗？ – 没有 → TOOLS.md 保持现状即可 – 有 → 按模板配置
任务 3 ：测试 AI 是否正确使用配置（ 15 分钟） – 测试 1 ：问 AI 「你是谁？」→ 检查是否用 IDENTITY.md 的信息 – 测试 2 （如果有 TOOLS 配置）：让 AI 调用设备 → 检查是否正确
六、系列总结
至此，「 OpenClaw 配置文件详解」系列 7 篇全部完成：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
配置优先级：
AGENTS.md（启动流程） ↓ SOUL.md（行为准则） ↓ USER.md（用户信息） ↓ MEMORY.md（长期偏好） ↓ IDENTITY.md（身份标识） ↓ TOOLS.md（环境配置） 下一步建议： 1. 通读 7 篇文章，理解每个文件的作用 2. 对照自己的配置，查漏补缺 3. 定期（每季度） review 一次，持续优化
系列完结
感谢阅读「 OpenClaw 配置文件详解」系列。
如果觉得有用： – 点个在看，分享给需要的人 – 关注公众号「李宏阳讲 AI 」，获取更多 AI 实战干货
全平台： 公众号/视频号/小红书 → 李宏阳讲 AI