OpenKitten 😼

Telegram-first 💬 AI agent with 75+ AI providers 🤖, extensible plugins 🧩, multiple (sub)agents 🤝, composable skills 🧱, and controlled permissions 🔒.

Motivation

OpenClaw is the dominant open-source AI agent, but it has become buggy and almost unusable. With ~500k lines of code, it's overwhelming — hard to tell what's causing issues, what might break next, and what security risks are lurking underneath.

NanoClaw took the right approach by going minimal at ~500 lines of code, but it's Claude-only and more of a starting point than a product. You'll need to add a lot yourself before it becomes actually useful.

How is OpenKitten different?

• Built for Telegram — the best chatbot experience on the best messaging platform
• Powered by OpenCode — 75+ AI providers with rich plugin & skill ecosystem
• Opinionated by design — fewer choices, more capability, zero bloat

Warning

OpenKitten is in early development. Things may break between releases.

Setup

Prepare

• Install Bun runtime (Bun installation)
• Create a bot with @BotFather
• Get your user ID from @userinfobot

Install

# Clone OpenKitten
git clone https://github.com/phuctm97/openkitten.git
cd openkitten/packages/bot/cli

# Install dependencies
bun install

To update and install as a system service:

bun . up

To stop and remove the system service:

bun . down

To run directly in the foreground:

bun . serve

Use -y / --yes with up or serve to skip the optional config action menus when you just want to continue with the current setup.

Note

The system service may appear as "Jarred Sumner" — this is the name of the Bun creator used to sign the runtime, not malware.

Configuration

Log level

Set via OPENKITTEN_LOG_LEVEL (defaults to silly):

OPENKITTEN_LOG_LEVEL=info bun . serve

Levels: silly, trace, debug, info, warn, error, fatal.

Profile

Set via OPENKITTEN_PROFILE (defaults to default):

OPENKITTEN_PROFILE=work bun . serve

Each profile isolates its config & data at ~/.openkitten/profiles/<profile>.

Telegram

OpenKitten prompts for your Telegram bot token and user ID if not already configured, then saves them to ~/.openkitten/profiles/<profile>/system/config/openkitten/telegram.json. To reconfigure, delete the file and restart the server.

OpenCode

OpenKitten bootstraps an OpenCode config directory per profile at ~/.openkitten/profiles/<profile>/.opencode:

opencode.json       # OpenCode configuration
agents/             # OpenCode agents
├── assist.md       # General purpose agent (default)
├── build.md        # Software engineering agent
└── plan.md         # Read-only research & planning agent

Edit opencode.json to configure providers, models, agents, commands, permissions, MCP servers, and more. See OpenCode config docs for all available options.