# 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 的首选声音
- 扬声器/房间名称
- 设备昵称
- 任何环境特定的信息

### 示例

```markdown
### 摄像头

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

### SSH

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

### TTS

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

### 为什么要分开？

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

---

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