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

The setup script will:

Create config directory ~/.config/omi-me/
Guide you to configure your API token
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

Visit https://docs.omi.me/doc/developer/api/overview
Generate a developer API key
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

omi-me

Omi.me Integration for OpenClaw

Table of Contents

Setup

Automated Setup