omi-me

# 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](#setup)
- [Token Management](#token-management)
- [CLI Commands](#cli-commands)
  - [Memories](#memories)
  - [Action Items / Tasks](#action-items--tasks)
  - [Conversations](#conversations)
  - [Sync](#sync)
- [Usage Examples](#usage-examples)

## Setup

### Automated Setup

```bash
# 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

```bash
# 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:

```bash
# Interactive (recommended)
omi-token.sh set

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

## Token Management

```bash
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:
```bash
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 creat...