← Back to Notes & PKM
Notes & PKM by @caioiscoding

omi-me

Complete Omi.me integration for memories, action items (tasks)

0
Source Code

Omi.me Integration for OpenClaw

Complete integration with Omi.me to sync and manage memories, action items (tasks), and conversations. Provides CLI tools.

Table of Contents

Setup

Automated Setup

# Run the setup script
bash /home/ubuntu/.openclaw/workspace/skills/omi-me/scripts/setup.sh

The setup script will:

  1. Create config directory ~/.config/omi-me/
  2. Guide you to configure your API token
  3. Create symlinks for omi and omi-token commands

Manual Setup

# Create config directory
mkdir -p ~/.config/omi-me

# Save your API token
echo "omi_dev_your_token_here" > ~/.config/omi-me/token
chmod 600 ~/.config/omi-me/token

Get API Token

  1. Visit https://docs.omi.me/doc/developer/api/overview
  2. Generate a developer API key
  3. Configure using:
# Interactive (recommended)
omi-token.sh set

# Or manually
echo "your-token" > ~/.config/omi-me/token

Token Management

omi-token.sh set    # Configure API token interactively
omi-token.sh get    # Print current token
omi-token.sh test   # Test connection to Omi.me

Token File

Default location: ~/.config/omi-me/token

You can also set via environment variable:

export OMI_API_TOKEN="your-token"

Files

  • ~/.config/omi-me/token - API token storage

CLI Commands

Token Management

Command Description
omi-token.sh set Configure API token interactively
omi-token.sh get Print current API token
omi-token.sh test Test connection to Omi.me

Memories

Command Description
omi memories list List all memories
omi memories get <id> Get specific memory
omi memories create "content" Create new memory
omi memories create "content" --type preference Create with type
omi memories update <id> "new content" Update memory content
omi memories delete <id> Delete a memory
omi memories search "query" Search memories

Action Items / Tasks

Command Description
omi tasks list List all action items
omi tasks get <id> Get specific task
omi tasks create "title" Create new task
omi tasks create "title" --desc "description" --due "2024-01-15" Create with details
omi tasks update <id> --title "new title" Update task
omi tasks complete <id> Mark as completed
omi tasks pending <id> Mark as pending
omi tasks delete <id> Delete a task

Conversations

Command Description
omi conversations list List all conversations
omi conversations get <id> Get specific conversation
omi conversations create --title "My Chat" --participants "user1,user2" Create conversation
omi conversations create --participants "user1,user2" --message "Hello!" Create with initial message
omi conversations add-message <id> user "Hello world" Add message to conversation
omi conversations delete <id> Delete a conversation
omi conversations search "query" Search conversations

Sync

Command Description
omi sync memories Sync memories from Omi.me
omi sync tasks Sync action items from Omi.me
omi sync conversations Sync conversations from Omi.me
omi sync all Sync all data

Usage Examples

Token Configuration

Interactive setup:

omi-token.sh set

Test connection:

omi-token.sh test

Get current token:

omi-token.sh get

CLI Examples

List memories:

omi memories list

Create a memory:

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

Create a task:

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

Mark task complete:

omi tasks complete <task-id>

Create conversation:

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

Add message:

omi conversations add-message <conv-id> user "I agree!"

Sync all data:

omi sync all

Rate Limits

Omi.me API rate limits:

  • 100 requests per minute per API key
  • 10,000 requests per day per user

The client automatically tracks rate limit headers and handles 429 responses.

Troubleshooting

"Token not configured"

# Configure interactively
omi-token.sh set

# Or check manually
cat ~/.config/omi-me/token

# If empty, add your token
echo "omi_dev_your_token" > ~/.config/omi-me/token

"Connection failed" or 401 error

# Test connection
omi-token.sh test

# Reconfigure if needed
omi-token.sh set

Permission denied for symlink

# Use full path instead
bash /home/ubuntu/.openclaw/workspace/skills/omi-me/scripts/omi-cli.sh memories list