omi-me

核心用法

Omi-me 是 OpenClaw 生态中的 Omi.me 服务集成 Skill，提供完整的命令行工具集来管理个人 AI 助手数据。用户通过 omi-token.sh 配置 API 凭证后，可使用 omi 主命令对三类核心数据进行 CRUD 操作：Memories（记忆片段）、Action Items（任务事项）、Conversations（对话记录）。支持数据双向同步，包括单条操作（创建、更新、删除）和批量同步（omi sync all）。

显著优点

1. 功能覆盖完整：涵盖 Omi.me 三大核心数据类型的全生命周期管理，满足个人知识库维护需求
2. CLI 体验统一：采用一致的命令结构（omi <资源> <操作>>），学习成本低
3. 灵活配置方式：支持文件存储和环境变量两种 Token 配置模式，适应不同安全策略
4. 速率限制透明：内置 API 限速说明（100/分钟、10000/天），帮助用户合理规划调用
5. 社区生态集成：作为 OpenClaw 官方 skills 仓库成员，与 OpenClaw CLI 工具链深度整合

潜在缺点与局限性

1. 关键文件缺失：文档引用的 setup.sh、omi-cli.sh、omi-token.sh 等核心脚本未包含在 Skill 包中，用户按文档执行将直接报错
2. 硬编码路径风险：文档中使用 /home/ubuntu/.openclaw/workspace/skills/omi-me/scripts// 绝对路径，跨环境兼容性差
3. 外部依赖未验证：依赖的 omi/omi-token 二进制文件无来源校验机制，存在供应链攻击风险
4. 非官方维护：由社区贡献者 dexiaong 维护，非 Omi.me 官方出品，功能更新和兼容性保障有限
5. 数据隐私顾虑：用户记忆、对话等敏感数据需经第三方 CLI 工具传输至 Omi.me 云服务

适合的目标群体

• 已使用 Omi.me 服务且希望获得命令行管理能力的效率型用户
• OpenClaw 生态的忠实用户，习惯通过 CLI 进行自动化工作流编排
• 需要将 Omi.me 数据与其他本地工具链集成的开发者
• 对 API 限速和批量同步有明确需求的数据管理用户

使用风险

• 执行失败风险：因引用脚本缺失，首次使用大概率遭遇命令未找到错误
• 凭证泄露风险：Token 文件默认存储于 ~/.config/omi-me/token，多用户环境需严格权限控制
• 供应链风险：外部二进制工具无完整性校验，可能被恶意替换
• 服务依赖风险：Omi.me API 变更或停服将直接导致 Skill 失效
• 数据合规风险：个人记忆和对话数据上传至第三方云服务，需确认符合组织数据政策

核心用法

omi-me 是 OpenClaw 生态中专为 Omi.me 记忆管理平台打造的官方集成工具，提供完整的命令行接口实现记忆（Memories）、行动项（Tasks）和对话（Conversations）的全生命周期管理。

三大核心模块：

1. 记忆管理 — 支持创建、查询、更新、删除记忆条目，可按类型标记（如 preference），并提供全文搜索能力，构建个人知识库
2. 任务追踪 — 完整的待办事项系统，支持标题、描述、截止日期字段，状态流转（pending/complete），适合 GTD 工作流
3. 对话同步 — 管理多参与者对话线程，支持消息追加与历史检索，便于团队协作记录留存

同步机制提供双向数据同步能力，omi sync all 一键拉取云端数据至本地环境，确保离线可用与数据备份。

---

显著优点

| 维度 | 优势 |

|------|------|

安全架构 | S级安全认证（92分），零依赖、无敏感信息硬编码，Token 本地隔离存储（chmod 600） |
来源可信 | T2级别可信来源，由 OpenClaw 官方组织维护，对接 Omi.me 官方 API |
隐私合规 | 通过 GDPR/CCPA 审计，数据最小化原则，用户自主掌控 API Token |
运维友好 | 纯文档型 Skill 无侵入性代码，提供交互式配置脚本（omi-token.sh），降低上手门槛 |
功能完整 | 覆盖 CRUD 全操作，支持类型标注、日期字段、多参与者等丰富元数据 |

---

潜在局限

• 外部依赖单一：核心功能绑定 Omi.me 云服务，离线场景下仅依赖本地缓存数据
• 速率限制：API 存在 100 req/min 与 10,000 req/day 配额，高频自动化场景需自行限流
• 无数据加密存储：Token 以明文形式存储于本地文件，建议配合系统 keychain 二次加固
• 平台绑定：暂未提及多后端适配能力，迁移成本需评估

---

适合人群

• 开发者/工程师：偏好 CLI 工作流，需要将记忆管理整合到终端环境
• 效率工具用户：已使用 Omi.me 硬件（如 Omi 项链）或应用，需自动化数据导出
• 隐私敏感用户：希望数据通过官方 API 流转，避免第三方中转
• OpenClaw 生态用户：寻求与现有 CLI 工具链（如 claude 命令）协同的解决方案

---

常规风险

| 风险类型 | 说明 | 缓解措施 |

|----------|------|----------|

Token 泄露 | ~/.config/omi-me/token 明文存储，多用户系统存在读取风险 | 严格设置 600 权限，定期轮换 Token |
API 滥用 | 误操作或脚本循环导致速率超限 | 客户端已内置 429 响应处理，建议监控调用日志 |
供应链攻击 | 依赖 scripts/setup.sh 等外部脚本 | 校验脚本来源，优先使用手动配置流程 |
数据一致性 | 双向同步冲突或网络中断导致状态漂移 | 定期执行 omi sync all 校验，关键操作前备份 |

---

权限配置建议

在 .claude/settings.local.json 中配置最小权限集：

{
  "permissions": {
    "allow": [
      "Bash:omi*",
      "Bash:cat ~/.config/omi-me/*"
    ]
  }
}