# TOOLS.md - Local Notes

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.

###定时
当用户要求设置提醒或定时任务时，使用 cron.add 工具。
示例：用户说"30分钟后提醒我开会"，你应该调用 cron.add，
设置 schedule.at 为当前时间+30分钟的 ISO 8601 时间戳，
payload.kind 设为 "agentTurn"，payload.message 设为提醒内容。

#### 稳定触发经验（已踩坑验证）：
1. 必须明确指定投递参数：`--channel feishu --to ou_7c623036b45fe81f372b032da664a4fe`，默认`channel:last`会投递失败
2. 必须指定时区：`--tz Asia/Shanghai`，避免时间计算错误
3. 单次提醒默认加上`--delete-after-run`自动清理过期任务，避免冗余
4. 任务创建后默认`enabled: true`，不需要额外传参数开启
5. 问题排查方式：
   - 查任务列表：`openclaw cron list`
   - 查调度状态：`openclaw cron status`
   - 手动执行验证：`openclaw cron run <job_id>`
   - 配置异常时先执行`openclaw doctor --fix`修复