TOOLS.md - 本地工具箱和设置 (工作技巧)

Git 配置

• Git 根目录: 当前工作空间 ~/.openclaw/workspace/ 的父目录，即 ~/.openclaw/
• 提交时需要在 ~/.openclaw/workspace/ 目录下执行

搜索方法

• 搜索新闻时，优先使用技能 tavily-search 而不是 web_fetch

记忆技能触发规则

memory-md-hot 热记忆更新

• 触发时机: 每日晚上10点后（心跳任务）
• 执行命令: python skills/memory-md-hot/scripts/daily_maintenance.py update
• 功能: 扫描当日记忆，更新事件流水，保留所有历史

memory-md-archive 归档控制

• 触发时机: 每日热记忆更新后（心跳任务）
• 执行命令: python skills/memory-md-archive/scripts/archive.py
• 功能: 归档8天前内容、超过30条的重要/学习事件、体积控制（4KB限制）

memory-md-learning 学习记录

自动触发场景（解决问题后立即调用）：
- 修复了难以发现的 bug
- 解决了配置冲突问题
- 找到了更优的解决方案
- 翻过陷阱或踩坑后

用户主动触发（用户说以下关键词时）：
- "学习一下"
- "记录下来"
- "记住这个"
- "总结经验"
- "这个要记"

执行命令:
bash python skills/memory-md-learning/scripts/learning.py \ --trap "现象描述" \ --cause "根本原因" \ --fix "解决方案" \ --prevent "预防措施" \ --principle "行为准则" \ --trigger "触发条件" \ --action "具体行动" \ --tag "标签" \ --summary "一句话概要" \ --keywords "关键词1,关键词2"

学习内容:
1. 技术层（长期记忆）: 陷阱、原因、修复、预防
2. 原则层（长期记忆）: 决策原则、触发条件、行动
3. 学习事件（MEMORY.md）: 日期+概要+关键词

这里记什么

技能定义了工具如何工作，这个文件是用来记录那些只属于你的设置的东西

比如：
- 摄像头名称和位置
- SSH 主机和别名
- TTS 的首选声音
- 扬声器/房间名称
- 设备昵称
- 任何环境特定的信息

示例

### 摄像头

- 客厅 → 主区域，180° 广角
- 前门 → 入口，运动触发

### SSH

- 家用服务器 → 192.168.1.100，用户: admin

### TTS

- 首选声音: "Nova"（温暖，略带英音）
- 默认扬声器: 厨房 HomePod

为什么要分开？

技能是共享的。你的设置是你的。把它们分开意味着你可以更新技能而不丢失你的笔记，分享技能而不泄露你的基础设施

添加任何有助于我工作的内容，这是我的速查表