A minimal AI assistant that connects to any LLM, runs on Telegram & Feishu, searches the web, and remembers everything โ in just ~5900 lines of TypeScript.
A complete AI assistant framework without the bloat
Works with Claude, GPT-4, Gemini, Groq, and any OpenAI-compatible API. Switch models with a single config change.
Chat via Telegram or Feishu (Lark). Your AI assistant, wherever you are, on any device.
Built-in web search using DuckDuckGo โ no API key required. Just ask and get real-time information.
Long-term memory storage plus daily notes. Your assistant remembers what matters.
Extend capabilities with simple Markdown files. No code needed to teach new tricks.
Cron jobs and heartbeat checks. Schedule tasks, set reminders, automate workflows.
Simple setup, no complex configuration. Just install, add your API key, and start chatting.
Via npm or build from source
Creates config and workspace
Add your LLM API key
Start talking to your AI
# Install globally
npm install -g miniclawd
# Initialize workspace
miniclawd onboard
# Add API key to ~/.miniclawd/config.json
# "anthropic": { "api_key": "sk-ant-..." }
# Start chatting!
miniclawd agent -m "Hello!"
# Or start Telegram/Feishu gateway
miniclawd gateway
Open source, MIT licensed. Fork it, extend it, make it yours.