Omi.me 与 OpenClaw 的集成

完整集成 Omi.me，用于同步和管理记忆（memories）、待办事项（action items / tasks）以及对话（conversations），并提供命令行工具（CLI tools）。

目录

• 安装配置（Setup）
• 令牌管理（Token Management）
• CLI 命令
  • 记忆（Memories）
  • 待办事项 / 任务（Action Items / Tasks）
  • 对话（Conversations）
  • 同步（Sync）
• 使用示例（Usage Examples）

安装配置

自动配置

# 运行配置脚本
bash /home/ubuntu/.openclaw/workspace/skills/omi-me/scripts/setup.sh

该配置脚本将执行以下操作：

1. 创建配置目录 ~/.config/omi-me/
2. 引导您完成 API 令牌的配置
3. 为 omi 和 omi-token 命令创建符号链接（symlinks）

手动配置

# 创建配置目录
mkdir -p ~/.config/omi-me

# 保存您的 API 令牌
echo "omi_dev_your_token_here" > ~/.config/omi-me/token
chmod 600 ~/.config/omi-me/token

获取 API 令牌

1. 访问 https://docs.omi.me/doc/developer/api/overview
2. 生成开发者 API 密钥（developer API key）
3. 通过以下方式完成配置：

# 交互式配置（推荐）
omi-token.sh set

# 或手动配置
echo "your-token" > ~/.config/omi-me/token

令牌管理

omi-token.sh set    # 交互式配置 API 令牌
omi-token.sh get    # 输出当前令牌
omi-token.sh test   # 测试与 Omi.me 的连接

令牌文件

默认路径：~/.config/omi-me/token

您也可以通过环境变量设置：

export OMI_API_TOKEN="your-token"

相关文件

• ~/.config/omi-me/token —— 存储 API 令牌

CLI 命令

令牌管理

记忆（Memories）

待办事项 / 任务（Action Items / Tasks）

对话（Conversations）

同步（Sync）

使用示例

令牌配置

交互式配置：

omi-token.sh set

测试连接：

omi-token.sh test

查看当前令牌：

omi-token.sh get

CLI 使用示例

列出所有记忆：

omi memories list

创建一条记忆：

omi memories create "Caio prefers working in English" --type preference

创建一项任务：

omi tasks create "Review Omi integration" --desc "Check if sync is working" --due "2024-02-01"

标记任务为已完成：

omi tasks complete 

创建对话：

omi conversations create --title "Team Sync" --participants "alice,bob" --message "Let's discuss the project"

向对话中添加消息：

omi conversations add-message  user "I agree!"

同步全部数据：

omi sync all

速率限制（Rate Limits）

Omi.me API 的速率限制如下：

• 每个 API 密钥每分钟最多 100 次请求
• 每个用户每日最多 10,000 次请求

客户端会自动跟踪响应头中的速率限制字段，并对 HTTP 429（Too Many Requests）响应进行自动处理。

故障排查（Troubleshooting）

“令牌未配置”（"Token not configured"）

# 交互式配置
omi-token.sh set

# 或手动检查
cat ~/.config/omi-me/token

# 若为空，请写入您的令牌
echo "omi_dev_your_token" > ~/.config/omi-me/token

“连接失败”或返回 401 错误

# 测试连接
omi-token.sh test

# 如需重新配置，请运行
omi-token.sh set

符号链接权限被拒绝（Permission denied for symlink）

# 改用完整路径调用
bash /home/ubuntu/.openclaw/workspace/skills/omi-me/scripts/omi-cli.sh memories list