# 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`修复

### 数据分析脚本
- 脚本仓库地址：https://git.valavala.com/vala/llm_offline_production
- 本地存储路径：/root/.openclaw/workspace/llm_offline_production
- 使用规则：每次调用仓库内的脚本执行数据分析前，必须先在脚本目录执行`git pull origin master`拉取最新版本，确保和远端Git仓库代码保持一致。

### Git仓库访问规则
- 所有`git.valavala.com`域名下的Git仓库，统一使用已配置的全局Git账号（存储在credential store中）访问，无需额外提供认证信息

### 业务知识管理
- 公司业务相关知识、文档、规则统一存放在 `/root/.openclaw/workspace/makee_vala/` 目录下，按业务分类归档
- 所有自定义封装的Skill统一存放在 `/root/.openclaw/workspace/skills/` 目录下，每个Skill单独创建子目录存放
- 对于重复出现的SOP式业务需求，优先封装为自定义Skill存放到上述目录复用，避免重复开发
- 业务知识更新后同步记录到对应目录，确保后续查询的准确性

### 用户行为数据导出规则（强制遵守）
- 组件配置数据（mid/core互动组件配置、知识点映射、story/lesson映射关系等）：读取test环境MySQL数据库
- 用户行为数据（互动组件记录、课程巩固/挑战/总结、音频数据、账户-角色ID映射）：读取线上PostgreSQL/ES/MySQL数据库

### Skill安装安全扫描规则（强制遵守）
所有新安装的Skill，必须先通过 `skill-vetter` 安全扫描，确认无高风险问题后再完成安装。
扫描命令：`npx skills vet <skill地址/名称>`
