Ein umfassender Entwickler-Leitfaden zum Erstellen von AstrBot-Plugins, die den Prüfanforderungen entsprechen, einschließlich Befehlen, LLM-Tools und Multi-Agenten-Integrationen.
Installieren & Herunterladen
1. ClawHub CLI
Der schnellste Weg, einen Skill direkt aus der Registry zu installieren.
npx clawhub@latest install astrbot-plugin-dev-skill
2. Manuelle Installation
Kopiere den Skill-Ordner an einen dieser Orte
~/.openclaw/skills/ <project>/skills/ Priorität: Workspace > Lokal > Integriert (Bundled)
3. Prompt-Installation
Kopiere diesen Prompt in OpenClaw, um ihn automatisch zu installieren.
Hilf mir, astrbot-plugin-dev-skill über Clawhub zu installieren. Falls Clawhub nicht installiert ist, installiere es bitte zuerst (npm i -g clawhub).
Lieber herunterladen?
Hole dir die rohen Skill-Dateien in einem ZIP-Archiv.
Was ist AstrBot Plugin-Entwicklung?
Diese Openclaw Skills-Ressource bietet ein technisches Framework für den Aufbau robuster, leistungsstarker Plugins für das AstrBot-Ökosystem. Der Fokus liegt auf einem „Prüfer-zuerst“-Entwicklungsfluss, der sicherstellt, dass alle Plugins die strengen Anforderungen des astr-plugin-reviewer erfüllen, während die neueste Star-Klassenarchitektur genutzt wird. Die Fähigkeit deckt den gesamten Lebenszyklus ab, von der anfänglichen metadata-Konfiguration bis hin zu fortschrittlichen KI-gesteuerten Funktionen.
Durch das Befolgen dieser Muster können Entwickler Plugins erstellen, die nicht nur funktional sind, sondern auch für den offiziellen Plugin-Marktplatz bereitstehen. Der Inhalt betont asynchrones I/O, einheitliches Logging und eine saubere Behandlung von Nachrichtenketten, was die Erstellung anspruchsvoller Bot-Interaktionen ermöglicht, die von einfachen automatisierten Antworten bis hin zu komplexen, auf Large Language Models basierenden Multi-Agenten-Workflows reichen.
AstrBot Plugin-Entwicklung Anwendungsfälle
- Erstellung neuer AstrBot-Plugins, die den Standards für die Einreichung im offiziellen Marktplatz entsprechen.
- Integration benutzerdefinierter LLM-Tools und Agenten in bestehende Chatbot-Workflows.
- Umstellung veralteter Bot-Erweiterungen auf die moderne asynchrone Star-Architektur.
- Implementierung von persistenter Datenspeicherung und Konfigurationsmanagement für Bot-Funktionen.
- Aufbau plattformübergreifender Bot-Befehle mit automatischer Parameter-Analyse und Type-Hinting.
So funktioniert AstrBot Plugin-Entwicklung
- Initialisiere die Plugin-Struktur durch Definieren einer metadata.yaml-Datei als Quelle der Wahrheit für die Identität.
- Erstelle eine main.py-Datei und implementiere eine Klasse, die von der Star-Basisklasse erbt, für die automatische Erkennung.
- Registriere Befehle und Filter mit optimierten Decorators wie @filter.command, um Benutzereingaben zu verarbeiten.
- Nutze den AstrBot-Kontext, um auf Kern-APIs zuzugreifen, einschließlich Logging, Sitzungsverwaltung und plattformspezifischer Treiber.
- Implementiere asynchrone Netzwerkaufrufe mit httpx oder aiohttp, um eine blockierungsfreie Bot-Leistung sicherzustellen.
- Überprüfe die Implementierung anhand der Prüfer-Checkliste, um Kompatibilität und Stabilität vor der Bereitstellung zu gewährleisten.
AstrBot Plugin-Entwicklung Einrichtung
Um mit der Entwicklung mit diesem Openclaw Skills-Leitfaden zu beginnen, stelle sicher, dass deine Umgebung für die AstrBot-Entwicklung bereit ist. Erstelle ein Verzeichnis, das der Namenskonvention astrbot_plugin_[name] folgt, und initialisiere die erforderlichen Dateien.
# Create plugin directory
mkdir astrbot_plugin_myskill && cd astrbot_plugin_myskill
# Initialize core files
touch main.py metadata.yaml requirements.txt
Installiere die notwendigen Entwicklungsabhängigkeiten mit pip, um sicherzustellen, dass deine Umgebung den AstrBot-Kernanforderungen entspricht.
AstrBot Plugin-Entwicklung Datenschema & Taxonomie
Die Plugin-Struktur ist streng definiert, um die Kompatibilität mit Openclaw Skills und dem AstrBot-Prüfer zu gewährleisten:
| Datei | Typ | Beschreibung |
|---|---|---|
metadata.yaml |
YAML | Enthält Plugin-Name, Version, Autor und Repository-Link. |
main.py |
Python | Die Hauptlogik-Datei, die von der Star-Klasse erbt. |
_conf_schema.json |
JSON | Definiert die Konfigurations-UI und das Einstellungs-Schema für Benutzer. |
requirements.txt |
Text | Listet alle für das Plugin erforderlichen externen Python-Bibliotheken auf. |
data/ |
Directory | Lokales Persistenzverzeichnis, auf das über StarTools.get_data_dir() zugegriffen wird. |
AstrBot Plugin-Entwicklung Erweiterte Funktionen
- LLM-Tool-Integration: Registriere Funktionen als Tools für Agenten mit @filter.llm_tool.
- Tool-Loop-Agenten: Erstelle autonome mehrstufige Agenten mit der API self.context.tool_loop_agent().
- Zustandsbehaftete Sitzungen: Verwalte komplexe Benutzerinteraktionen mit session_waiter für Multi-Turn-Prompts.
- T2I-Rendering: Konvertiere Text, HTML oder Jinja2-Vorlagen in Bilder für reichhaltige Plattformantworten.
- Direkte LLM-Aufrufe: Umgehe Standard-Workflows, um LLM-Anbieter direkt für die benutzerdefinierte Textgenerierung aufzurufen.
SKILL.md
Laden
Verwandte Openclaw-Skills
Fossil
Fossil ist ein semantisches Fehlergedächtnis-Protokoll, das es KI-Agenten ermöglicht, nach vergangenen Fehlern zu suchen und Lösungen aufzuzeichnen, um Fehlerwiederholungen zu vermeiden.
BLE-Gerätesteuerung
Eine leistungsstarke Befehlszeilen-Integration zur Verwaltung von Bluetooth Low Energy (BLE)-Geräten, die automatisiertes Scannen, GATT-Operationen und dauerhafte Verbindungsverwaltung ermöglicht.
Voice Chat Mode
Ein spezialisierter Skill zur Umwandlung von AI-Agenten-Antworten in natürliches, emotional bewusstes gesprochenes Chinesisch, optimiert für Text-to-Speech-Engines.
Goldpreis-Abfrage
Ein Echtzeit-Spot-Goldpreis-Abfrage-Tool zur Verfolgung von Marktwerten in CNY (RMB/Gramm) und USD (USD/Unze).
Sitzung umbenennen
Ein spezialisiertes Dienstprogramm zum Umbenennen und Organisieren von OpenClaw-Chat-Sitzungen durch Aktualisierung des Sitzungsverlaufsspeichers oder Backend-Pfade.
Architektur-Fitness-Funktions-Designer
Diese Fähigkeit ermöglicht die Erstellung automatisierter, objektiver Fitnessfunktionen, um Softwarearchitektur-Eigenschaften während des gesamten Entwicklungslebenszyklus zu messen und durchzusetzen.
Hervorgehoben*
