openclaw-master-skills/skills/amemo-skill/modules/amemo-login/SKILL.md

name, description

name	description
amemo-login	当用户输入 4-6 位短信验证码时调用，完成麦小记登录并将 userToken/userName 写入主 SKILL.md 配置区域。

amemo-login — 用户登录

---

接口信息

属性	值
路由	POST https://skill.amemo.cn/login
Bean	LoginBean
Content-Type	application/json

---

请求参数

⚠️ 服务端要求所有字段必须存在且有值，不可传 null。

参数	类型	必填	说明
phone	str	✅	手机号
code	str	✅	验证码（先通过 amemo-send-code 获取）

---

请求示例

curl -X POST https://skill.amemo.cn/login \
  -H "Content-Type: application/json" \
  -d '{"phone": "13800138000", "code": "123456"}'

---

响应示例

{
  "code": 200,
  "desc": "success",
  "data": {
    "userToken": "xxx...",
    "userName": "用户昵称",
    "userPhone": "13800138000",
    "loginAt": "2024-03-22T10:30:00Z"
  }
}

---

注意事项

📌 前置条件：调用前需先通过 amemo-send-code 获取验证码

🔐 Token 管理：返回的 userToken 需保存，后续所有接口调用均需携带此 token

---

执行流程（由主模块调度）

当主模块检测到用户输入验证码时，自动调用本模块。

输入提取规则

项目	正则表达式	说明
手机号	1[3-9]\d{9}	自动过滤空格、横线、+86 前缀
验证码	\d{4,6}	4-6 位连续数字

用户输入示例：

• "1234" → 验证码
• "123456" → 验证码
• "验证码是 1234" → 验证码

---

执行步骤

1. 使用正则 \d{4,6} 从用户消息中提取验证码
    ↓
2. 调用 POST /login 完成登录
    ↓
3. 提取返回数据中的 userToken、userName、userPhone、loginAt
    ↓
4. 更新主模块 SKILL.md 顶部的 <amemo-user-config> JSON 配置
    ↓
5. 发送个性化欢迎消息

---

响应数据解析

字段	类型	说明
data.userToken	str	用户认证令牌
data.userName	str	用户昵称
data.userPhone	str	用户手机号
data.loginAt	str	登录时间（ISO 8601 格式）

---

登录成功后的配置更新

使用文件编辑工具精准定位主 SKILL.md 顶部 <amemo-user-config> 标签内的 JSON 配置区域，替换为：

{
  "userToken": "{提取的userToken}",
  "userName": "{提取的userName}",
  "userPhone": "{提取的userPhone}",
  "loginAt": "{当前时间}"
}

---

回复模板

登录成功后

✅ 登录成功！欢迎回来，{userName}！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 功能菜单

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📝 【笔记管理】
   • 保存笔记 → "帮我记一下..." / "保存笔记..."
   • 查询笔记 → "查看我的笔记" / "查找关于XXX的笔记"
   • 搜索笔记 → "搜索我XXX相关的笔记"

✅ 【清单管理】
   • 创建待办 → "今天/明天/后天要..." / "12月25日要..."
   • 查看清单 → "查看我的清单" / "我的待办"
   • 邮件提醒 → 创建任务后自动询问是否开启邮件提醒

📊 【健康数据】
   • 今日简报 → "今日健康简报" / "健康日报"
   • 步数统计 → "查看我的步数数据"
   • 睡眠分析 → "查看我的睡眠数据"
   • 血氧监测 → "查看我的血氧数据"
   • 血压记录 → "查看我的血压数据"
   • 心率数据 → "查看我的心率数据"
   • 消耗统计 → "查看我的消耗数据"

🤖 【AI 记忆】
   • 刷新记忆 → "刷新助手记忆" / "初始化助手记忆"
   • 保存记忆 → "保存永久记忆" / "永久记住这个"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 使用提示
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• 直接说出你想做的事，我会自动识别
• 支持自然语言，无需记住固定指令
• 需要帮助随时输入 "help" 或 "帮助"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

使用 userName 的场景

场景	模板
欢迎	欢迎回来，{userName}！
确认操作	{userName}，已为您保存笔记
提醒	{userName}，您有一条待办清单
错误提示	{userName}，出了点小问题，请重试

---

错误处理

手机号格式错误

❌ 手机号格式不正确，请发送正确的 11 位手机号。
示例：13800138000

验证码错误

❌ 验证码错误或已过期，请重新发送验证码。

登录失败

❌ 登录失败：[错误原因]
请检查手机号和验证码后重试。