Skill: ajingmiao/slonaide (version 3.0.3)

--- name: SlonAide 录音笔记 description: 智能录音笔记管理助手 - AI 自动转写和总结录音，支持知识库管理和语义搜索 version: 2.1.0 author: SlonAide Team capabilities: - 查询和搜索录音笔记 - 获取转写文本和 AI 总结 - 知识库管理和语义检索 - 文件夹分类和标签管理 - 安装和检查 AiDeNote OpenClaw 远程 bridge（macOS/Windows） --- # SlonAide 录音笔记技能 v2.1 ## 🚀 快速开始 ### 1. 安装技能 ```bash openclaw skills install slonaide ``` 或通过 ClawHub: ```bash npx clawhub install slonaide ``` ### 2. 获取 API Key 1. 访问 https://h5.aidenote.cn/ 并登录 2. 进入"我的"页面 → 点击"API Key" 3. 输入密钥名称（如：OpenClaw） 4. 点击"生成访问密钥" 5. 复制生成的 API Key（格式：`sk-xxxxxxxx...`） ### 3. 配置 API Key ```bash openclaw config set slonaide.apiKey "sk-你的API密钥" ``` ### 4. 测试连接 ```bash # 在 OpenClaw 会话中使用 slonaide_test_connection ``` ### 5. 安装远程对话 bridge（macOS/Windows） ```bash slonaide_setup_remote_bridge ``` 安装完成后，AiDeNote App 可以通过机器人图标连接当前电脑上的 OpenClaw。 ## 🛠️ 可用工具 ### 1. 获取录音笔记列表 ```bash slonaide_get_list ``` **参数：** - `page`: 页码（默认: 1） - `pageSize`: 每页数量（1-50，默认: 10） - `keyword`: 搜索关键词（可选） **示例：** ```bash # 获取第一页，每页10条 slonaide_get_list # 搜索包含"会议"的笔记 slonaide_get_list keyword="会议" # 获取第二页，每页20条 slonaide_get_list page=2 pageSize=20 ``` ### 2. 获取笔记详情 ```bash slonaide_get_detail fileId="笔记ID" ``` **参数：** - `fileId`: 录音笔记文件ID（必填） **示例：** ```bash slonaide_get_detail fileId="787760209850437" ``` ### 3. 获取最新笔记摘要 ```bash slonaide_get_summary ``` **参数：** - `count`: 要获取的记录数量（1-10，默认: 3） **示例：** ```bash # 获取最新3条笔记摘要 slonaide_get_summary # 获取最新5条笔记摘要 slonaide_get_summary count=5 ``` ### 4. 测试连接 ```bash slonaide_test_connection ``` 测试 API 连接和配置状态。 ### 5. 安装 OpenClaw 远程 bridge ```bash slonaide_setup_remote_bridge ``` **参数：** - `reinstall`: 是否重新安装 bridge（默认: false） 该工具会在 macOS 或 Windows 上安装 `aide-note-tunnel`，写入 `.aidenote/openclaw-tunnel.json`，并注册开机登录自启服务。 > ⚠️ **已知问题** > > bridge 安装脚本（v2.0 及之前）会向 tunnel 传入 `--token-endpoint` 参数， > 这会覆盖 tunnel 二进制内置的默认 token 交换地址，导致认证失败： > ``` > tunnel disconnected: auth rejected: invalid token > ``` > > **解决方法：** 编辑 `~/Library/LaunchAgents/cn.aidenote.openclaw-tunnel.plist`， > 删除 `--token-endpoint` 及其后面的 URL 参数行，然后重启服务： > ```bash > launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/cn.aidenote.openclaw-tunnel.plist > launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/cn.aidenote.openclaw-tunnel.plist > ``` ### 6. 检查 bridge 状态 ```bash slonaide_bridge_status ``` 检查 AiDeNote OpenClaw 远程 bridge 是否已安装并运行。 ## 🔧 配置说明 ### 配置文件位置 `~/.openclaw/openclaw.json` ### 配置示例 ```json { "plugins": { "entries": { "slonaide": { "enabled": true, "config": { "apiKey": "sk-你的API密钥", "baseUrl": "https://api.aidenote.cn", "bridgeInstallerUrl": "https://cdn.aidenote.cn/tunnel/install-macos.sh", "bridgeWindowsInstallerUrl": "https://cdn.aidenote.cn/tunnel/install-windows.ps1", "bridgeTunnelBaseUrl": "https://cdn.aidenote.cn/tunnel", "bridgeRelayHost": "api.aidenote.cn", "openClawLocalPort": 18789 } } } } } ``` ### 配置参数 - `apiKey`: SlonAide API Key（必填） - `baseUrl`: API 基础地址（默认: `https://api.aidenote.cn`） - `bridgeInstallerUrl`: macOS bridge 安装脚本地址 - `bridgeWindowsInstallerUrl`: Windows bridge 安装脚本地址 - `bridgeTunnelBaseUrl`: bridge 二进制下载目录 - `bridgeRelayHost`: AiDeNote relay host（默认: `api.aidenote.cn`） - ~~`tokenEndpoint`~~: 已废弃。tunnel 二进制内置了默认 token 交换地址，自定义此参数会导致认证失败 - `openClawLocalPort`: 本机 OpenClaw Gateway 端口（默认: `18789`） ## 🔒 安全规则 ### 隐私保护 - 笔记数据属于用户隐私，不在群聊中主动展示完整内容 - 转写文本默认只显示前500字符 - 敏感信息自动脱敏处理 ### API 安全 - API Key 加密存储 - 令牌自动缓存和刷新 - 请求失败时自动重试（最多3次） - 连接超时保护（15秒） ## 🐛 故障排除 ### 常见问题 #### 1. "未配置 API Key" **解决方案：** ```bash openclaw config set slonaide.apiKey "你的API密钥" ``` #### 2. "认证失败" **可能原因：** - API Key 无效或已过期 - 网络连接问题 - API 服务暂时不可用 **解决方案：** 1. 重新生成 API Key 2. 检查网络连接 3. 等待服务恢复 #### 3. "获取列表失败" **可能原因：** - 令牌过期 - API 响应格式变化 - 服务器错误 **解决方案：** ```bash # 测试连接 slonaide_test_connection # 如果测试失败，重新配置 openclaw config set slonaide.apiKey "新API密钥" ``` #### 4. "App 机器人远程对话连接不上" **解决方案：** ```bash slonaide_setup_remote_bridge slonaide_bridge_status ``` 如果安装脚本下载失败，请先发布 `install-macos.sh` 和 `aide-note-tunnel_darwin_*`，再配置： ```bash openclaw config set slonaide.bridgeInstallerUrl "https://cdn.aidenote.cn/tunnel/install-macos.sh" openclaw config set slonaide.bridgeTunnelBaseUrl "https://cdn.aidenote.cn/tunnel" ``` ### 调试模式 启用详细日志： ```bash openclaw config set slonaide.debug true ``` ## 📊 使用场景 ### 场景1：日常笔记管理 ```bash # 查看最新笔记 slonaide_get_summary count=5 # 查看某条笔记详情 slonaide_get_detail fileId="笔记ID" ``` ### 场景2：会议记录整理 ```bash # 搜索会议相关笔记 slonaide_get_list keyword="会议" # 获取未转写的会议记录 slonaide_get_list keyword="会议" pageSize=20 ``` ### 场景3：问题跟踪 ```bash # 查看异常记录 slonaide_get_list keyword="异常" # 获取技术问题记录 slonaide_get_list keyword="系统" keyword="错误" ``` ## 🔄 更新日志 ### v2.1.0 (2026-05-19) **新增：** - ✅ `slonaide_setup_remote_bridge`：安装本机 OpenClaw 远程 bridge - ✅ `slonaide_bridge_status`：检查 bridge 运行状态 - ✅ 支持 macOS launchd 登录自启动 - ✅ 支持 AiDeNote App 机器人入口直接远程连接 OpenClaw ### v2.0.0 (2026-03-26) **重大改进：** - ✅ 完整的 OpenClaw 工具实现 - ✅ 自动令牌管理和缓存 - ✅ 完善的错误处理和用户提示 - ✅ 优化的输出格式和可读性 - ✅ 连接测试工具 - ✅ 摘要统计功能 - ✅ 类型分析和建议 ### v1.0.0 (初始版本) - 基础技能框架 - Python 辅助脚本 - API 文档 ## 📝 技术细节 ### API 端点 - **Base URL**: `https://api.aidenote.cn` - **认证**: `POST /api/UserapikeyMstr/GetToken/{apiKey}` - **列表**: `POST /api/audiofileMstr/audiofileseleUserAllList` - **详情**: `GET /api/audiofileMstr/GetAudioFileDetail/{fileId}` ### 数据格式 ```json { "code": 200, "message": "成功", "result": { "total": 111, "records": [ { "id": "文件ID", "audiofileTitle": "标题", "audiofileFileName": "文件名", "createTime": "时间戳", "audiofileTimeLength": "时长(毫秒)", "transcriptStatus": 2, "summaryStatus": 2, "transcriptText": "转写文本", "aiSummary": "AI总结", "tags": ["标签1", "标签2"] } ] } } ``` ### 状态码 - `transcriptStatus`: 0=未开始, 1=进行中, 2=已完成 - `summaryStatus`: 0=未开始, 1=进行中, 2=已完成 ## 🤝 贡献指南 ### 报告问题 在 GitHub Issues 中报告问题，包括： 1. 问题描述 2. 复现步骤 3. 错误信息 4. 环境信息 ### 提交改进 1. Fork 仓库 2. 创建功能分支 3. 提交更改 4. 创建 Pull Request ## 📞 支持 ### 官方支持 - 网站: https://h5.aidenote.cn/ - API 文档: 内置文档 ### 社区支持 - GitHub Issues: 问题反馈 - OpenClaw 社区: 使用讨论 ## 📄 许可证 MIT License - 详见 LICENSE 文件 --- **提示**: 首次使用前请务必配置 API Key，否则工具无法正常工作。


Security scan verdicts — ClawScan: suspicious | static analysis: suspicious | VirusTotal:  | SkillSpector: suspicious (CRITICAL)