80 lines
3.3 KiB
Markdown
80 lines
3.3 KiB
Markdown
# 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地址/名称>`
|