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
• Token Management
• CLI Commands
  • Memories
  • Action Items / Tasks
  • Conversations
  • Sync
• Usage Examples

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

---