JohanYP/Opencode-Assistent

Was macht Opencode-Assistent?

Selbstgehosteter persönlicher KI-Assistent auf Telegram. Angetrieben von OpenCode + Claude Sonnet (kostenloses big-pickle). Kompatibel mit OpenClaw-Fähigkeiten. SQLite + MCP Live-Speicher mit optionaler Ollama-Vektorsuche.

Der Assistent verwendet OpenCode als Laufzeitumgebung und Claude Sonnet als primäres Sprachmodell. Die Kommunikation erfolgt über den Telegram-Messenger, wobei der Bot jede eingehende Nachricht auswertet und kontextbewusst antwortet. Dank der MCP-Integration (Model Context Protocol) kann der Assistent auf einen persistierenden Kontext in einer SQLite-Datenbank zugreifen, sodass er sich an vorherige Dialoge und Benutzerpräferenzen erinnert. Für fortgeschrittene semantische Suchen kann optional Ollama mit lokalen Embedding-Modellen verwendet werden.

Voraussetzungen

• Ein Telegram Bot-Token (von @BotFather erhalten)
• Zugang zu einem OpenCode-Server (selbst gehostet oder in einer Cloud-Umgebung)
• Python 3.10+ und die Pakete opencode, ollama (optional), telebot oder python-telegram-bot
• Optional: Ollama lokal installiert für Vektorsuche

Installation

1. Klone das Repository:

   git clone https://github.com/JohanYP/Opencode-Assistant.git
   cd Opencode-Assistant
   

2. Installiere Abhängigkeiten:

   pip install -r requirements.txt
   

3. Konfiguriere Umgebungsvariablen (z.B. in .env):

   TELEGRAM_BOT_TOKEN=dein_token_hier
   OPENCODE_API_KEY=dein_api_key
   OPENCODE_MODEL=claude-sonnet-4-20250506
   DATABASE_PATH=./data/assistant.db
   OLLAMA_BASE_URL=http://localhost:11434 (optional)
   

4. Starte den Bot:

   python bot.py
   

Nutzung

Nach dem Start ist der Bot über Telegram erreichbar. Sende ihm eine Nachricht, und er antwortet mit dem Claude-Modell. Um das Langzeitgedächtnis zu nutzen, kann der Benutzer den Kontext explizit abfragen (z.B. "Erinnere dich an ...") oder der Assistent speichert automatisch Schlüsselinformationen.

Kompatibilität mit OpenClaw-Skills

Der Assistent erkennt und lädt OpenClaw-kompatible Skills aus dem Ordner ./skills/. Jeder Skill muss eine manifest.yaml oder SKILL.md enthalten, die die Fähigkeiten beschreibt. So können Entwickler eigene Telegram-Befehle, Datenquellen oder Aktionsschritte hinzufügen.

Beispiel: Einen neuen Skill hinzufügen

1. Erstelle einen Ordner ./skills/mein_skill/.

2. Lege eine SKILL.md an, z.B.:

   # Mein Skill
   
   Hilft bei der Verwaltung von Notizen in einer SQLite-Datenbank.
   

3. Starte den Bot neu. Der Skill wird automatisch registriert.

Lizenz

MIT