889f7a8e27
上传核心文件： - IDENTITY.md, USER.md, SOUL.md, AGENTS.md, TOOLS.md, HEARTBEAT.md, MEMORY.md - memory/: 日志和工作记录 - skills/: 技能配置 - .gitignore
131 lines
4.4 KiB
Markdown
131 lines
4.4 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.
|
||
|
||
## 钉钉应用配置（企业内部应用）
|
||
|
||
用于操作日历、查看日志、文档等企业钉钉功能。
|
||
|
||
```markdown
|
||
AgentId: 4404185308
|
||
Client ID (AppKey): dingklemniq8uqk5qbgx
|
||
Client Secret (AppSecret): _8EHgyhvHRHRMx6fZbh9LNpQoxyYl3At0b-fXXlQiahwupbt9oY5P6Grj8IM9Dx8
|
||
```
|
||
|
||
## MCP 服务配置
|
||
|
||
已配置 5 个钉钉 MCP 服务：
|
||
|
||
### 钉钉日志 MCP
|
||
- URL: `https://mcp-gw.dingtalk.com/server/e773f33a72809ae9a1272da0eb203a4e4647512e168c411bd17c5a26212422ca?key=0450857ec796591204d2d030dfff95e1`
|
||
- **用途**：钉钉日志查询（查询用户发送的日志）
|
||
- **主要工具**：通过 mcporter 调用
|
||
|
||
### 钉钉文档
|
||
- URL: `https://mcp-gw.dingtalk.com/server/fcf2405ec27cd4428220e0515ff8e04ee52ba7e11578aabbd1ef57651ad9c4d4?key=70fb66762bdf5b10a304a3d1a270aebb`
|
||
- **用途**：钉钉文档操作（创建/读取/写入/管理文档和表格）
|
||
|
||
### 钉钉日历/日程
|
||
- URL: `https://mcp-gw.dingtalk.com/server/6efc2da975c4393ba3ad307bad77180a09e28f0c660b247bf0b2258804dc034b?key=1ef173d18cfc53aec32435c06a06908b`
|
||
- **用途**：日历/日程管理
|
||
- **主要工具**：
|
||
- `create_calendar_event` - 创建日程
|
||
- `list_calendar_events` - 查询日程列表
|
||
- `get_calendar_detail` - 获取日程详情
|
||
- `update_calendar_event` - 修改日程
|
||
- `delete_calendar_event` - 删除日程
|
||
- `add_calendar_participant` - 添加参与人
|
||
- `query_busy_status` - 查询用户闲忙状态
|
||
- `query_available_meeting_room` - 查询空闲会议室
|
||
|
||
### 钉钉M通讯录
|
||
- URL: `https://mcp-gw.dingtalk.com/server/d0050f4b18d11aa780d304f2707e7bbb24794237a4f0a41d0f1dfdb40bc8bd27?key=ec174881fd525c64726e41b22892a7cf`
|
||
- **用途**：通讯录/用户管理
|
||
- **主要工具**：
|
||
- `get_user_info_by_user_ids` - 批量获取用户详情
|
||
- `search_user_by_key_word` - 搜索成员
|
||
- `search_user_by_mobile` - 通过手机号获取成员
|
||
- `get_sub_depts_by_dept_id` - 获取子部门
|
||
- `get_dept_members_by_deptId` - 获取部门下所有成员
|
||
- `search_dept_by_keyword` - 搜索部门
|
||
- `get_current_user_profile` - 获取当前用户详情
|
||
- `search_contact_by_key_word` - 搜索好友和同事
|
||
|
||
### 钉钉待办
|
||
- URL: `https://mcp-gw.dingtalk.com/server/e594739312cbde234b7d9fcfbe0badd0e797d46dd401fa93e71b6338fd2d0aa6?key=7f8ad91c1f1b50cdd4b896a29803a64b`
|
||
- **用途**：待办事项管理
|
||
- **主要工具**：
|
||
- `create_personal_todo` - 创建个人待办
|
||
- `get_user_todos_in_current_org` - 查询个人待办列表
|
||
- `query_todo_detail` - 查询待办详情
|
||
- `update_todo_task` - 修改待办任务
|
||
- `update_todo_done_status` - 修改待办完成状态
|
||
- `delete_todo` - 删除待办
|
||
|
||
### ⚠️ 钉钉功能与工具映射规则
|
||
|
||
| 钉钉功能 | 操作工具 |
|
||
|---------|---------|
|
||
| 钉钉日志 | 钉钉日志 MCP |
|
||
| 钉钉文档 | 钉钉文档 MCP |
|
||
| 钉钉日程 | 钉钉日程 MCP |
|
||
| 钉钉待办 | 钉钉待办 MCP |
|
||
| 钉钉通讯录 | 钉钉通讯录 MCP |
|
||
| 其他钉钉操作 | 通过相应 skill 调用 API |
|
||
|
||
## MiniMax TTS 语音回复
|
||
**脚本**: `scripts/dingtalk_tts.sh`
|
||
**默认音色**: `xiaocun_tianmei`（罗小寸克隆音色）
|
||
**使用方式**: 用户要求语音回复时，执行：
|
||
```bash
|
||
bash scripts/dingtalk_tts.sh "要说的内容"
|
||
**注意**: duration 参数使用秒（整数），不是毫秒
|
||
|
||
## 语音识别（Whisper）
|
||
**命令**: `whisper <音频文件> --language Chinese --model small`
|
||
**支持格式**: AMR, OGG, MP3, WAV 等（ffmpeg 支持的格式）
|
||
**用途**: 用户发来的语音消息 → 用 Whisper 转文字 → 处理回复
|
||
**示例**:
|
||
```bash
|
||
whisper /root/.openclaw/workspace-assistant/media/inbound/audio-xxx.ogg --language Chinese --model small
|
||
```
|
||
|
||
|