English | Русский

ClawMate

AI assistant that reads and writes messages from your personal Telegram account, with per-contact style personalization.

Quick Start

npx clawmate-oss@latest

This will:

1. Check prerequisites (Node.js, pnpm, Docker)
2. Clone the repo and install dependencies
3. Walk you through configuration (Telegram API, bot token, LLM)
4. Start all services via Docker Compose

What It Does

• Writes from your real Telegram account (not a bot) via TDLib
• Personalizes responses per contact — tone, formality, length, language
• Groups contacts (Work, Family, Friends) with inherited styles
• Three modes: auto-reply, approve before send, or muted
• Smart notifications: new contact → Add/Skip; drafts → Send/Edit/Reject — all inline
• Safety: money, meetings, promises, legal, medical — always require your approval
• Long-term memory per contact with semantic search

Prerequisites

• Docker + Docker Compose
• Telegram account + API credentials
• Telegram bot from @BotFather
• One of (for LLM): OpenClaw (recommended), OpenAI API key, or Anthropic API key

Manual Installation

1. Clone

git clone https://github.com/AbdrAbdr/ClawMate.git
cd ClawMate

2. Configure

cp compose/.env.example compose/.env
# Edit compose/.env — fill in your tokens

3. Launch

docker compose -f compose/docker-compose.yml up -d

4. Connect

Open your bot in Telegram, send /start, and use the inline buttons to set up contacts and styles.

Architecture

Control Bot  ←→  Brain  ←→  TDLib Bridge
(Telegram UI)    (API)      (Your Account)

| Service | What it does | |---------|-------------| | Brain | Core engine: LLM, styles, policies, memory, approvals | | Control Bot | Telegram bot for managing everything via inline buttons | | TDLib Bridge | Sends/receives from your personal Telegram with human simulation |

Project Structure

ClawMate/
├── shared/        # Types, schemas, constants
├── brain/         # Core engine (Fastify + SQLite)
├── control-bot/   # Telegram admin bot (grammY)
├── tdlib-bridge/  # Personal account transport
├── installer/     # npx clawmate-oss@latest
└── compose/       # Docker Compose + env template

Full architecture and API docs: DESIGN.md

License

AGPL-3.0 — see LICENSE