dvcrn 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:
- Create config directory
~/.config/omi-me/ - Guide you to configure your API token
- Create symlinks for
omiandomi-tokencommands
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