Memmos 技能的 SKILL.md

用途

该技能为 Memos API（https://usememos.com/docs/api）提供了一个简易接口，支持通过 OpenClaw 创建、读取、删除和列出备忘录（memo）。

工作原理

• 该技能使用 Python 实现，并依赖 requests 库。
• 它需要设置两个环境变量：
  • MEMOS_URL — 必需。你的 Memos 实例的基础 URL（例如：https://demo.usememos.com）。
  • MEMOS_TOKEN — 必需。用于身份验证的个人访问令牌（Personal Access Token）。
• 若未设置 MEMOS_URL 或 MEMOS_TOKEN 中的任意一个，技能将中止执行，并输出明确的错误信息。

命令

直接使用 Python 调用

你也可以直接通过 Python 运行各命令：

# 创建备忘录
python3 skills/memos/memos.py create "My memo content" "PUBLIC"

# 根据 ID 获取备忘录
python3 skills/memos/memos.py get j9THXDmYtueosTTeHcC5NA

# 删除备忘录
python3 skills/memos/memos.py delete j9THXDmYtueosTTeHcC5NA

# 强制删除备忘录
python3 skills/memos/memos.py delete j9THXDmYtueosTTeHcC5NA true

# 列出备忘录（默认每页 20 条）
python3 skills/memos/memos.py list

# 自定义分页大小
python3 skills/memos/memos.py list 50

所有命令在成功时返回 JSON 格式输出；发生错误时，错误信息将以 JSON 格式输出至 stderr。

在 OpenClaw 中引用备忘录

当你创建或获取一条备忘录时，API 返回的备忘录对象中包含 uid 字段。如需在 OpenClaw 的输出中引用该备忘录，请将其格式化为 Markdown 链接：

[memo description](https://demo.usememos.com/memos/{uid})

示例：
若 API 返回 {"uid": "ABC123xyz", "name": "memos/ABC123xyz", ...}，则应按如下方式引用：

Created [your memo](https://demo.usememos.com/memos/ABC123xyz)

URL 格式为：{MEMOS_URL}/memos/{uid}，其中 uid 从 API 响应中提取。

错误处理

该技能内置全面的错误处理机制：

• API 错误：返回详细错误信息，包括 HTTP 状态码及 API 响应内容
• 网络错误：处理超时（默认 30 秒）与连接失败
• 参数校验：在发起 API 请求前校验参数（例如 visibility 取值范围、pageSize 合法性等）
• 退出码：命令行运行时，成功返回 0，失败返回 1
• 错误输出：所有错误均以 JSON 格式输出至 stderr，便于程序解析

错误响应示例：

{
  "error": "Memos API Error",
  "message": "HTTP 404: Not Found - Memo not found",
  "status_code": 404
}

扩展该技能

• 新增命令时，请遵循现有命令的实现模式。
• 若 Memos API 新增了端点（endpoint），可为其添加对应的功能函数。

注意：本技能仅供个人使用；切勿将你的 MEMOS_TOKEN 公开分享。