AstrBot: AI Chatbot-Zugangsplattform mit WebUI

Allgemeine Einführung

AstrBot ist ein Open-Source-Chatbot-Entwicklungsframework, das QQ, Telegram, WeChat und andere Messaging-Plattformen unterstützt und leicht auf OpenAI, DeepSeek, Google Zwillinge AstrBot ist ein Framework für die Entwicklung intelligenter Chatbots, wie z.B. das Large Language Model (LLM). Das Framework bietet ein Plugin-System, ein visuelles Management-Panel und multimodale Funktionen wie Bildverstehen und Sprache-zu-Text.AstrBot wurde entwickelt, um Nutzern die schnelle Entwicklung intelligenter Chatbots zu ermöglichen und ist für Entwickler und Technikbegeisterte geeignet. Es verwendet die AGPL-v3-Lizenz, hat offenen Code und eine aktive Community.

Funktionsliste

• Unterstützt plattformübergreifenden Messaging-Zugang, einschließlich QQ, QQ Channel, Telegram, WeChat (persönliches und Unternehmens-WeChat), Flybook, Nail und mehr.
• Integration mehrerer großer Sprachmodelle, wie OpenAI, Google Gemini, DeepSeek, Claude, Ollama usw., und Unterstützung lokaler Modelle.
• Bietet mehrere Dialogrunden mit einstellbaren Persönlichkeiten, Unterstützung für Bildverstehen und Sprache-zu-Text (basierend auf Whisper).
• Eingebautes visuelles Administrationspanel zur Konfiguration von Bots, Anzeige von Protokollen und Verwaltung von Plugins.
• Plugin-Erweiterungen werden unterstützt, und Benutzer können benutzerdefinierte Funktionen wie Check-in oder Code-Ausführung entwickeln.
• Bietet Agentenfunktionen, einschließlich Websuche, Aufgabenliste in natürlicher Sprache und Andocken Dify Plattform.
• Umfasst die Verwaltung der Sicherheit von Inhalten, z. B. die Filterung von Schlüsselwörtern und die Prüfung von Baidu-Inhalten.
• Die WebUI ermöglicht es dem Benutzer, direkt über die Webseite mit dem Roboter zu kommunizieren.

Hilfe verwenden

Der Installations- und Nutzungsprozess von AstrBot ist klar, die offizielle Dokumentation bietet eine Vielzahl von Einsatzmethoden. Nachfolgend finden Sie eine detaillierte Beschreibung der Installationsschritte und der Hauptmerkmale des Vorgangs.

Einbauverfahren

AstrBot unterstützt Quellcode-Bereitstellung, Docker-Bereitstellung, Windows-Ein-Klick-Installation, Pagoda-Panel-Bereitstellung und so weiter. Hier ist ein Beispiel für Quellcode-Bereitstellung und Docker-Bereitstellung.

Bereitstellung des Quellcodes

1. Vorbereiten der Umgebung
   Stellen Sie sicher, dass Git und Python 3.11+ installiert sind; Windows-Benutzer können Python von der offiziellen Python-Website herunterladen, Linux-Benutzer können Python von der offiziellen Python-Website herunterladen. sudo apt install python3 Einbau.
2. Code herunterladen
   Läuft im Terminal:

git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot

Oder laden Sie die ZIP-Datei von GitHub herunter und entpacken Sie sie.

3. Installation von Abhängigkeiten
   Empfohlen uv Werkzeuge:

pip install uv
uv run main.py

Oder auf die traditionelle Art und Weise:

pip install -r requirements.txt
python main.py

4. Auslöseverfahren
   Nach der Ausführung zeigt das Terminal die Adresse des Verwaltungspanels an, z. B. http://localhost:6185. Verwenden Sie das Standardkonto astrbot und Passwörter astrbot Einloggen.

Docker-Bereitstellung

1. Installation von Docker
   Stellen Sie sicher, dass Docker installiert und verfügbar ist docker --version Prüfen.
2. Ziehen Sie das Image und führen Sie
   Geben Sie ihn in das Terminal ein:

docker run -d -p 6185:6185 -v astrbot-data:/app/data soulter/astrbot:latest

-p 6185:6185 Mapping-Port.-v Erstellen Sie ein Datenvolumen, um die Konfiguration zu speichern.

3. Zugangspaneel
   Öffnen Sie Ihren Browser und geben Sie http://localhost:6185melden Sie sich mit dem Standard-Kontopasswort an.

Hauptfunktionen

Konfigurieren des großen Sprachmodells

1. Melden Sie sich in der Verwaltungskonsole an und klicken Sie auf Provider-Einstellungen.
2. Wählen Sie den Modelltyp, z. B. openai_chat_completion.
3. Geben Sie den API-Schlüssel (den Sie von einer Plattform wie OpenAI erhalten) und die Adresse (Standard) ein. https://api.openai.com/v1).
4. Wählen Sie das spezifische Modell (z. B. gpt-3.5-turbo), speichern Sie sie und sie wird wirksam.

Zugang über mehrere Plattformen

1. Wählen Sie eine Plattform, wie z. B. Telegram, aus der Option Messaging-Plattformen im Verwaltungsbereich aus.
2. Geben Sie die erforderlichen Informationen ein (z. B. das Bot-Token von Telegram, das Sie von BotFather erhalten haben).
3. Speichern Sie die Konfiguration und der Bot kann auf Nachrichten auf der entsprechenden Plattform antworten. Geben Sie zum Beispiel in Telegram Folgendes ein /startantwortet der Roboter.

Plug-Ins verwenden

1. Laden Sie das Plugin (z.B. Telegram Adaptor) herunter und fügen Sie es in das Verzeichnis <AstrBot目录>/data/plugins.
2. Starten Sie AstrBot neu und das Plugin wird automatisch geladen.
3. Aktivieren Sie das Plugin in der Verwaltungskonsole und konfigurieren Sie die Parameter, z. B. die Begrenzung der Nachrichtenrate.

multimodale Fähigkeit

• BildverstehenSenden Sie dem Bot ein Bild mit einer Aufforderung (z.B. "Erklären Sie dieses Bild") und der Bot wird es analysieren und antworten.
• Sprache-zu-TextUm eine Sprachdatei zu senden, aktivieren Sie Whisper in den Provider-Einstellungen, und der Bot wird sie in Text umwandeln und antworten.

Agent Funktion

• Suche im InternetSenden Sie "Suche Wettervorhersage" und der Bot wird Ergebnisse liefern.
• Code-AusführungUm einen Codeschnipsel (z. B. Python) zu senden, müssen Sie den Sandboxed Code Executor aktivieren, den der Bot dann ausführt und das Ergebnis zurückgibt.

caveat

• Die Serverbereitstellung erfordert, dass die localhost auf die Server-IP.
• WeChat persönlichen Nummer Zugang mit Gewechat, wird empfohlen, ein alternatives Konto zu verwenden, um eine Sperrung zu vermeiden.
• Die Docker-Bereitstellung erfordert ein Mapping /var/run/docker.sock, andernfalls ist der Code-Executor nicht verfügbar.
• Der erste Lauf erzeugt eine Konfigurationsdatei <AstrBot目录>/data/config.jsondie manuell bearbeitet werden können.

Mit diesen Schritten können die Benutzer AstrBot problemlos einsetzen und verwenden.

Anwendungsszenario

1. Persönlicher Assistent
   Legen Sie Erinnerungen fest, überprüfen Sie Nachrichten und seien Sie bereit, auf Telegram mit AstrBot zu helfen.
2. Gruppenchat-Management
   In QQ-Gruppen oder Flybook können Bots automatisch Fragen beantworten, Check-ins verwalten und die Effizienz verbessern.
3. Lernwerkzeuge
   Die Schüler können AstrBot verwenden, um Bildformeln zu analysieren oder Sprachnotizen zu transkribieren, um das Lernen zu erleichtern.
4. Entwicklungstests
   Entwickler können die Auswirkungen von LLM-Dialogen testen oder neue Plug-in-Erweiterungen entwickeln.

QA

1. Welche Plattformen werden bereits unterstützt?
   QQ (offiziell und OneBot), QQ Channel, Telegram, WeChat (persönliches und Unternehmens-WeChat), Flybook und Nail werden bereits unterstützt, während Discord und andere in der Entwicklung sind.
2. Wie kann ich ein neues Modell hinzufügen?
   Fügen Sie es in der Verwaltungskonsole "Provider" hinzu, z. B. durch Eingabe von Ollama Die lokale Adresse und der Modellname des Modells sind ausreichend.
3. Was ist, wenn der Start fehlschlägt?
   Überprüfen Sie die Terminalprotokolle, möglicherweise fehlen Abhängigkeiten oder sind Ports belegt. Vergewissern Sie sich requirements.txt Die Installation ist abgeschlossen.
4. Wie werden Plugins entwickelt?
   Siehe offizielle Dokumentation <https://astrbot.app/dev/plugin.html>um den Code in die data/plugins Danach neu starten.