@keyoku/bot

Your AI bot with persistent memory. Clone. Init. Run. It remembers everything.

Quick Start

Prerequisites: Docker Desktop + an LLM API key (or a ChatGPT subscription)

npx @keyoku/bot init

The setup wizard walks you through:

1. LLM provider — OpenAI, Anthropic, Gemini, or ChatGPT (no API key)
2. Memory extraction — which model handles memory extraction & embeddings
3. Channel — Telegram, Discord, or API-only
4. Launch — generates .env + docker-compose.yml and starts the bot

How It Works

  ┌──────────────┐    ┌─────────────────┐    ┌──────────────────┐
  │  Telegram    │◀──▶│    OpenClaw     │◀──▶│  Keyoku Engine   │
  │  Discord     │    │    Gateway      │    │                  │
  │  API         │    │                 │    │  Memory storage  │
  └──────────────┘    │  Sessions       │    │  Semantic search │
                      │  Tool use       │    │  Heartbeat       │
                      └─────────────────┘    └──────────────────┘

Your bot stores memories automatically. When a user says something important, Keyoku extracts entities, relationships, and facts. On the next conversation, relevant memories are injected into context — the LLM references them naturally.

Commands

npx @keyoku/bot init              # Setup wizard
npx @keyoku/bot status            # Health, memory stats, watcher, config
npx @keyoku/bot search "query"    # Test memory recall
npx @keyoku/bot memories          # List stored memories
npx @keyoku/bot watcher           # Watcher status and tick history

Supported LLMs

| Provider | Models | |----------|--------| | OpenAI | GPT-5.4, GPT-5 Mini, GPT-4.1 Mini | | OpenAI (ChatGPT) | GPT-5.4, GPT-5.3 Codex — no API key needed | | Anthropic | Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5 | | Google Gemini | Gemini 2.5 Flash, Gemini 3.1 Pro, Gemini 3.1 Flash Lite |

Customization

Edit two files to change your bot's personality:

| File | What It Controls | |------|-----------------| | workspace/IDENTITY.md | Name, vibe, style | | workspace/SOUL.md | Behavior, capabilities, boundaries |

docker compose restart   # Apply changes

Links

• GitHub — full docs, project structure, advanced config
• Keyoku Engine — memory backend
• OpenClaw — agent gateway

License

MIT