Mood CLI Skill#

技能说明#

调用 mood CLI 工具分析文本情绪，返回天气图标 + 治愈文案

---

触发条件#

方式 1：密语触发（大小写不敏感）⭐#

基本密语：

• mood / Mood / MOOD - 分析情绪
• 心情 / 心情分析 - 分析情绪
• 情绪 / 情绪分析 - 分析情绪
• 今天心情 - 分析今天的情绪

扩展密语：

• 心情怎么样 - 分析情绪
• 心情好吗 - 分析情绪
• 帮我看看情绪 - 分析情绪
• 看看我的心情 - 分析情绪
• 记录心情 - 记录情绪
• 今天天气 - 情绪天气

英文密语：

• analyze mood - 分析情绪
• my mood - 我的情绪
• how am I feeling - 我的心情

方式 2：单独输入 mood（显示帮助）#

当用户只输入 mood 或 心情 时，显示使用帮助

方式 3：关键词触发#

当消息包含以下关键词时也激活：

• "分析情绪"
• "心情怎么样"
• "情绪分析"
• "今天心情"
• "心情好/不好"
• "帮我看看这句话的情绪"

---

功能列表#

1. 情绪分析（基础功能）#

命令： mood "文本" 密语： mood 今天心情好 输出：天气图标 + 治愈文案 + 情绪类型

2. 查看帮助#

命令： mood --help 密语： mood 帮助 / mood help 输出：使用说明

3. 查看统计（待实现）#

命令： mood --stats 密语： 心情统计 / 我的情绪统计 输出：情绪分布统计

4. 查看历史（待实现）#

命令： mood --history 密语： 心情历史 / 我的情绪记录 输出：历史记录列表

5. 导出报告（待实现）#

命令： mood --report weekly 密语： 心情周报 / 情绪报告 输出：周期性情绪报告

---

使用示例#

基础情绪分析#

text

mood 今天心情超好的！
→ ☀️ 今天阳光灿烂，心情美美哒~

大小写不敏感#

text

Mood 今天完成了 CLI 工具
MOOD 好开心
mOoD 真有趣
→ 都能正常识别

查看帮助#

text

mood
→ 显示使用帮助

中文密语#

text

心情 今天工作很顺利
→ ☀️ 今天阳光灿烂，心情美美哒~

情绪 代码写完了
→ ☀️ 今天阳光灿烂，心情美美哒~

英文密语#

text

analyze mood I finished the project
→ ☀️ 今天阳光灿烂，心情美美哒~

my mood today is great
→ ☀️ 今天阳光灿烂，心情美美哒~

---

情绪 - 天气映射#

情绪天气图标治愈文案happy☀️今天阳光灿烂，心情美美哒~calm⛅微风不燥，内心平静confused🌫️有点看不清方向，需要一点光sad🌧️心里在下雨，想找个抱抱angry⛈️情绪有点爆炸，需要冷静一下hopeful🌈雨过天晴，看见彩虹啦

---

帮助文本#

当用户只输入 mood 时显示：

text

🌤️ Mood CLI Skill - 情绪分析助手

【基本用法】
mood 今天心情好          分析情绪
Mood 好难过              大小写都可以
心情 工作完成了          中文密语
analyze mood great       英文密语

【高级功能】
mood 帮助                显示这个帮助
心情统计                 查看情绪统计（开发中）
心情历史                 查看历史记录（开发中）
心情周报                 生成周报（开发中）

【示例】
mood 今天完成了第一个 agent 闭环工具
→ ☀️ 今天阳光灿烂，心情美美哒~

【提示】
- 密语大小写不敏感
- 支持中英文混合
- 自动识别情绪关键词

---

待开发功能#

1. 情绪统计 (--stats)#

• 记录每次分析结果
• 统计情绪分布
• 生成图表（可选）

2. 历史记录 (--history)#

• 保存分析历史
• 支持查询特定日期
• 支持导出

3. 情绪报告 (--report)#

• 日报/周报/月报
• 情绪趋势分析
• 建议和改进

4. 批量分析 (--batch)#

• 分析多段文字
• 文件导入分析
• 批量导出结果

---

配置说明#

API 配置#

• 文件： ~/.mood-weather-cli.env
• 内容： DEEPSEEK_API_KEY=你的密钥

用户识别（自动）#

优先级：

1. 环境变量 MOOD_USER_ID (手动指定)
2. 聊天渠道用户 ID (自动识别)
   • 钉钉： DINGTALK_USER_ID
   • 微信： WECHAT_USER_ID
   • Telegram： TELEGRAM_USER_ID
   • Discord： DISCORD_USER_ID
   • Slack： SLACK_USER_ID
3. 系统用户名 (降级逻辑)

示例：

• 钉钉用户： dingtalk:0124046821484330
• 微信用户： wechat:wx123456
• 手动指定： wanwan

重试机制#

• 自动重试 3 次
• 指数退避（1s → 2s → 4s）
• 失败后降级返回

输出格式#

• 天气图标 + 治愈文案
• 情绪类型（英文）
• 置信度（百分比）

---

🏥 运行时健康检查#

加载时门控（由 OpenClaw 自动执行）#

OpenClaw 加载技能时会自动检查：

• ✅ mood CLI 命令是否在 PATH 中
• ✅ DEEPSEEK_API_KEY 是否有值

如果门控检查失败：技能会被禁用，用户看到"技能不可用"提示。

运行时健康检查（技能内部逻辑）#

每次调用前/调用时检查：

检查项检查方式失败处理CLI 命令可执行which mood + 试运行返回"CLI 工具未安装"API 密钥有效调用 DeepSeek API 测试返回"API 密钥无效或过期"网络连接API 请求超时检测返回"网络异常，请检查连接"服务可用性HTTP 状态码检查返回"DeepSeek 服务暂时不可用"

健康检查命令（可选）#

用户可以主动运行健康检查：

bash

mood --healthcheck

输出示例：

text

🌤️ Mood CLI 健康检查

✅ CLI 工具：/opt/homebrew/bin/mood
✅ API 密钥：已配置 (sk-xxxx...xxxx)
✅ 网络连接：正常
✅ DeepSeek 服务：在线

所有检查通过，可以正常使用！

---

⚠️ 错误处理与用户提示#

错误类型与处理#

错误场景用户提示修复指引未配置 API 密钥❌ 未配置 DeepSeek API 密钥export DEEPSEEK_API_KEY=sk-xxx 或编辑 ~/.mood-weather-cli.envAPI 密钥无效❌ API 密钥无效或已过期检查密钥是否正确，或前往 DeepSeek 控制台重新生成CLI 工具未找到❌ 未找到 mood 命令运行安装脚本或检查 PATH 配置网络超时❌ 网络超时，请检查连接检查网络或稍后重试服务不可用❌ DeepSeek 服务暂时不可用稍后重试或查看服务状态页文本为空❌ 请输入要分析的文字mood 今天心情好配额用尽❌ API 配额已用尽等待配额重置或升级账户

降级策略#

当 DeepSeek API 不可用时，可以降级到：

1. 本地规则匹配（关键词 → 情绪）
2. 返回默认情绪（calm）
3. 明确告知用户"使用降级模式，结果可能不够准确"

---

📝 最佳实践#

1. 技能开发时：始终定义 metadata.openclaw.requires 门控
2. 调用技能前：检查技能状态（ openclaw skills list 查看是否 ready）
3. 失败时：给出清晰的修复指引，不要只说"失败了"
4. 敏感配置：使用环境变量或配置文件，不要硬编码
5. 日志记录：记录每次调用的结果，方便排查问题