Zum Nachschlagen

Hilfe & häufige Fragen

Die bebilderten Anleitungen für die Einrichtung, die Fragen, die am häufigsten kommen — und für alle, die es genau wissen wollen: was technisch dahintersteckt.

Hilfe & Anleitungen

Die bebilderten Anleitungen kommen mit der Installation mit — hier kannst du sie auch vorher lesen oder ausdrucken, ohne irgendetwas zu installieren.

🧠

OpenRouter-Schlüssel erstellen

Registrieren, Guthaben aufladen, Schlüssel kopieren — jeder Klick als Bild, auch das Bezahlformular.

✉️

Telegram-Bot und Chat-ID

@BotFather finden, Bot anlegen, Token kopieren — und die eigene Chat-ID herausfinden. In 6 Schritten.

📅

Google-Kalender verbinden

Die Schlüsseldatei für den Kalender erstellen — der fummeligste Teil, deshalb besonders ausführlich.

Damit dein Assistent eine Stimme bekommt — drei kurze Anleitungen, eine nach der anderen:

🎙️

1 · ElevenLabs-Konto anlegen

Kostenlos registrieren — in 4 Schritten, ganz ohne Vorwissen.

🔑

2 · Den Schlüssel erstellen

Der Weg zum Schlüssel liegt hinter „Developers“ — klingt technisch, sind zwei Klicks.

🗣️

3 · Die passende Stimme finden

Stimmen probehören, aussuchen, Voice-ID kopieren. Nimm dir Zeit — sie begleitet dich täglich.

Im Alltag brauchst du nie ein Terminal: Der Telegram-Chat und das Cockpit (Doppelklick aufs Programm) erledigen 99,9 % — im Telegram-Menü liegen sechs Befehle direkt neben dem Eingabefeld: /hilfe, /modell, /verbrauch, /update, /neustart, /stopp. Sie werden lokal beantwortet und kosten nie etwas. Und für die restlichen 0,1 % fragst du einfach deinen neuen freundlichen Assistenten aus der Nachbarschaft.

Cockpit nicht mehr da? Nach der Einrichtung steht AbraxasOS in deinem Startmenü — dort findest du es nach jedem Neustart wieder. Und falls du die heruntergeladene Datei gelöscht oder verlegt hast: Lade sie einfach oben nochmal herunter. Dein Assistent läuft in der Zwischenzeit ungestört weiter und antwortet dir weiter in Telegram — er hängt nicht am Cockpit. Deine Schlüssel, Einstellungen und Erinnerungen bleiben ebenfalls, wo sie sind.

Häufige Fragen

Die Fragen, die wirklich gestellt werden — ehrlich beantwortet.

Was kostet mich das?

AbraxasOS selbst ist kostenlos und quelloffen. Geld kostet nur das Denken: Jede Antwort deines Agenten ist ein bezahlter Aufruf beim Modellanbieter — im Alltag Bruchteile von Cent. Typisch sind ein paar Cent bis wenige Dutzend Cent am Tag. Ein Tageslimit (Standard: 5 $) stoppt ihn, bevor es wehtut, und /verbrauch zeigt dir jederzeit den Stand.

Brauche ich einen Server?

Nein. Auf deinem eigenen Rechner läuft alles genauso. Ein gemieteter Server lohnt sich nur, wenn dein Agent auch dann erreichbar sein soll, wenn dein Rechner aus ist.

Sieht jemand meine Daten?

Ja — der Modellanbieter. Damit dein Agent denken kann, geht deine Nachricht (und alles, was er liest, um sie zu beantworten) an OpenRouter bzw. DeepSeek. Das ist keine Lücke, sondern die Funktionsweise. Alles andere — Gedächtnis, Dateien, Schlüssel — bleibt auf deinem Rechner. Der ganze ehrliche Abschnitt dazu →

Kann er E-Mails in meinem Namen verschicken?

Standardmäßig nicht. Er liest und fasst zusammen; Antworten schreibt er als Entwurf. Senden ist ein eigener Schritt, den du bewusst einschalten musst — eine verschickte E-Mail kann man nicht zurückholen.

Was, wenn er Unsinn macht?

Drei Netze: Er fragt vor wichtigen Schritten. Gefährliches ist im Code gesperrt, nicht per Bitte. Und /stopp im Chat hält ihn sofort an. Sein Arbeitsbereich ist im Standard („Zuhause-Modus“) auf seinen eigenen Ordner begrenzt — an den Rest deines Rechners kommt er nicht heran.

Kann ich das Modell wechseln?

Ja, im Chat: „Sparmodus“ (günstiger und schneller), „Standardmodus“ oder „Baumodus“ (sorgfältiger für längere Arbeiten). Du kannst auch DeepSeek direkt statt OpenRouter nutzen.

Was passiert, wenn das Internet weg ist?

Dann kann er nicht denken — das Modell wohnt im Netz. Er sagt dir das auch klar und versucht es von selbst wieder. Sein Gedächtnis und deine Dateien bleiben davon unberührt.

Wie werde ich AbraxasOS wieder los?

Cockpit öffnen → „Löschen und neu anfangen“ bzw. „Instanz verwalten“ → entfernen. Mit Rückfrage und auf Wunsch einer Sicherungskopie deiner Erinnerungen — vom eigenen Rechner oder vom Server. Im Terminal geht es auch mit einem Befehl.

Kann jemand Fremdes mit meinem Agenten schreiben?

Nein. Er antwortet nur in genau dem Telegram-Chat, den du bei der Einrichtung bestätigt hast. Nachrichten aus jedem anderen Chat werden verworfen — ohne Antwort und ohne Kosten.

Wie es funktioniert

Vier Bausteine. Du musst sie nicht verstehen, um ihn zu nutzen — aber wenn du wissen willst, wie er tickt, hier ist es.

Fähigkeiten

Kalender, Posteingang, Stimme — jede bringt eine geschriebene Erlaubnis mit, die genau sagt, was sie darf. Eingeschaltet wird sie erst, wenn du im Chat „Ja“ sagst.

Lernen

Sagst du „Merk dir …“, wird daraus ein Vorschlag, den du absegnest — dein Agent ändert nie heimlich sein Verhalten. „Was hast du gelernt?“ beantwortet er in Alltagssprache.

Gedächtnis

Vorlieben, eure Regeln, eure Geschichte — als Textdateien in seinem Arbeitsbereich, mit jedem Editor lesbar. Bewusst keine Datenbank, in die niemand hineinschauen kann.

Grenzen

Was nicht ausdrücklich erlaubt ist, geht nicht. Die gefährlichen Befehle sind im Code gesperrt — und vor jeder Änderung an seinen Erinnerungen legt er eine Sicherungskopie an.

Motorraum

Für Entwickler

AbraxasOS ist ein local-first Agent Operating System in purem Python — bewusst ohne Drittanbieter-Abhängigkeiten. Eigener Agent-Core mit gehärteter Tool-Schicht, Skills mit deklarierten Capabilities, dreistufiges Lernsystem, provider-agnostische Modellschicht. Apache-2.0, Quelltext auf GitHub.

runtime
Python stdlib-first (null Dependencies), systemd user service, kein sudo — alles lebt in ~/.abraxas
operator surface
Telegram (primär) + lokales Web-Cockpit (127.0.0.1, Session-Token); E-Mail-Kanal draft-first
llm layer
OpenRouter oder DeepSeek nativ — beide mit Function-Calling und identischem Tool-Loop; Fallback-Kette, Circuit-Breaker, sichtbare Degradation
cost truth
Jeder Call gezählt inkl. cached prompt & hidden reasoning tokens; anbieter-gemeldete Kosten schlagen die Preistabelle; Tagesbudget-Enforcement
skill model
SKILL.md + SKILL.json + RIGHTS.yaml, deny-by-default; pip-Pakete in den Workspace, nie ins System
file exchange
Geteilter Cloud-Ordner als einzige Brücke über die Workspace-Grenze — in reviewtem Code, nie im Modell; Symlinks und Übergrößen werden abgewiesen
guards
ExecGuard (deny-by-default, unwrappt sh -c und Substitutionen), Workspace-Boundary (realpath), Outbound-Gate, Scope-Gate, secret-gescrubbte exec-Umgebung
server ops
Geführter VPS-Umzug & Verwaltung über SSH; Ziel bleibt eingehend SSH-only, Secrets als stdin-Strom
testing
1.500+ Tests, kombinatorischer Security-Fuzz, Hygiene-Scanner gegen persönliche Daten im Baum
license
Apache-2.0; Releases als nachvollziehbare Quelltext-Snapshots mit Versions-Tag