chore(i18n): refresh de translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
3f9a60befb
commit
4576abf2d2
File diff suppressed because it is too large
Load Diff
@ -1,24 +1,24 @@
|
||||
---
|
||||
read_when:
|
||||
- Sie möchten, dass die Hochstufung von Erinnerungen automatisch ausgeführt wird
|
||||
- Sie möchten verstehen, was die einzelnen Dreaming-Phasen tun
|
||||
- Sie möchten die Konsolidierung anpassen, ohne `MEMORY.md` zu verunreinigen
|
||||
summary: Hintergrund-Konsolidierung von Erinnerungen mit leichten, tiefen und REM-Phasen sowie einem Traumtagebuch
|
||||
- Sie möchten, dass die Erinnerungs-Promotion automatisch ausgeführt wird
|
||||
- Sie möchten verstehen, was jede Dreaming-Phase bewirkt
|
||||
- Sie möchten die Konsolidierung abstimmen, ohne `MEMORY.md` zu überladen
|
||||
summary: Hintergrund-Konsolidierung von Erinnerungen mit Light-, Deep- und REM-Phasen sowie einem Dream Diary
|
||||
title: Dreaming (experimentell)
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:06:19Z"
|
||||
generated_at: "2026-04-06T06:21:04Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: f27da718176bebf59fe8a80fddd4fb5b6d814ac5647f6c1e8344bcfb328db9de
|
||||
source_hash: 36c4b1e70801d662090dc8ce20608c2f141c23cd7ce53c54e3dcf332c801fd4e
|
||||
source_path: concepts/dreaming.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Dreaming (experimentell)
|
||||
|
||||
Dreaming ist das System zur Hintergrund-Konsolidierung von Erinnerungen in `memory-core`.
|
||||
Es hilft OpenClaw dabei, starke kurzfristige Signale in dauerhafte Erinnerungen zu überführen, während
|
||||
der Prozess nachvollziehbar und überprüfbar bleibt.
|
||||
Dreaming ist das Hintergrundsystem zur Konsolidierung von Erinnerungen in `memory-core`.
|
||||
Es hilft OpenClaw dabei, starke kurzfristige Signale in dauerhafte Erinnerungen zu überführen,
|
||||
während der Prozess nachvollziehbar und überprüfbar bleibt.
|
||||
|
||||
Dreaming ist **optional** und standardmäßig deaktiviert.
|
||||
|
||||
@ -26,86 +26,86 @@ Dreaming ist **optional** und standardmäßig deaktiviert.
|
||||
|
||||
Dreaming verwaltet zwei Arten von Ausgaben:
|
||||
|
||||
- **Maschinenzustand** in `memory/.dreams/` (Recall-Speicher, Phasensignale, Ingestions-Checkpoints, Sperren).
|
||||
- **Menschenlesbare Ausgabe** in `DREAMS.md` (oder vorhandener `dreams.md`) und optionale Phasenberichtdateien unter `memory/dreaming/<phase>/YYYY-MM-DD.md`.
|
||||
- **Maschinenzustand** in `memory/.dreams/` (Recall-Speicher, Phasensignale, Ingestion-Checkpoints, Sperren).
|
||||
- **Menschenlesbare Ausgabe** in `DREAMS.md` (oder vorhandenem `dreams.md`) und optionalen Phasenberichtdateien unter `memory/dreaming/<phase>/YYYY-MM-DD.md`.
|
||||
|
||||
Die langfristige Hochstufung schreibt weiterhin ausschließlich in `MEMORY.md`.
|
||||
Die langfristige Promotion schreibt weiterhin nur in `MEMORY.md`.
|
||||
|
||||
## Phasenmodell
|
||||
|
||||
Dreaming verwendet drei zusammenarbeitende Phasen:
|
||||
Dreaming verwendet drei kooperative Phasen:
|
||||
|
||||
| Phase | Zweck | Dauerhafter Schreibvorgang |
|
||||
| ----- | ----------------------------------------- | -------------------------- |
|
||||
| Light | Neues kurzfristiges Material sortieren und bereitstellen | Nein |
|
||||
| Deep | Dauerhafte Kandidaten bewerten und hochstufen | Ja (`MEMORY.md`) |
|
||||
| Phase | Zweck | Dauerhafter Schreibvorgang |
|
||||
| ----- | ------------------------------------------------ | -------------------------- |
|
||||
| Light | Aktuelles kurzfristiges Material sortieren und vorbereiten | Nein |
|
||||
| Deep | Dauerhafte Kandidaten bewerten und promovieren | Ja (`MEMORY.md`) |
|
||||
| REM | Über Themen und wiederkehrende Ideen reflektieren | Nein |
|
||||
|
||||
Diese Phasen sind interne Implementierungsdetails, keine separaten benutzerkonfigurierten
|
||||
Diese Phasen sind interne Implementierungsdetails, keine separaten, vom Benutzer konfigurierbaren
|
||||
„Modi“.
|
||||
|
||||
### Light-Phase
|
||||
|
||||
Die Light-Phase verarbeitet aktuelle tägliche Erinnerungssignale und Recall-Spuren, dedupliziert sie
|
||||
und stellt Kandidatenzeilen bereit.
|
||||
Die Light-Phase erfasst aktuelle tägliche Erinnerungssignale und Recall-Traces, entfernt Duplikate
|
||||
und bereitet Kandidatenzeilen vor.
|
||||
|
||||
- Liest aus dem kurzfristigen Recall-Zustand und aktuellen täglichen Erinnerungsdateien.
|
||||
- Schreibt einen verwalteten Block `## Light Sleep`, wenn der Speicher Inline-Ausgabe enthält.
|
||||
- Zeichnet Verstärkungssignale für das spätere Deep-Ranking auf.
|
||||
- Erfasst Verstärkungssignale für ein späteres Deep-Ranking.
|
||||
- Schreibt niemals in `MEMORY.md`.
|
||||
|
||||
### Deep-Phase
|
||||
|
||||
Die Deep-Phase entscheidet, was zu langfristiger Erinnerung wird.
|
||||
Die Deep-Phase entscheidet, was zu einer langfristigen Erinnerung wird.
|
||||
|
||||
- Ordnet Kandidaten mithilfe gewichteter Bewertungen und Schwellenwert-Gates.
|
||||
- Erfordert, dass `minScore`, `minRecallCount` und `minUniqueQueries` erfüllt sind.
|
||||
- Rehydriert Snippets aus aktiven täglichen Dateien vor dem Schreiben, sodass veraltete/gelöschte Snippets übersprungen werden.
|
||||
- Hängt hochgestufte Einträge an `MEMORY.md` an.
|
||||
- Schreibt eine Zusammenfassung `## Deep Sleep` in `DREAMS.md` und schreibt optional `memory/dreaming/deep/YYYY-MM-DD.md`.
|
||||
- Bewertet Kandidaten anhand gewichteter Scores und Schwellenwert-Gates.
|
||||
- Erfordert das Bestehen von `minScore`, `minRecallCount` und `minUniqueQueries`.
|
||||
- Hydriert Snippets vor dem Schreiben aus aktiven Tagesdateien erneut, sodass veraltete/gelöschte Snippets übersprungen werden.
|
||||
- Hängt promovierte Einträge an `MEMORY.md` an.
|
||||
- Schreibt eine Zusammenfassung `## Deep Sleep` in `DREAMS.md` und optional `memory/dreaming/deep/YYYY-MM-DD.md`.
|
||||
|
||||
### REM-Phase
|
||||
|
||||
Die REM-Phase extrahiert Muster und reflektierende Signale.
|
||||
|
||||
- Erstellt Themen- und Reflexionszusammenfassungen aus aktuellen kurzfristigen Spuren.
|
||||
- Erstellt Themen- und Reflexionszusammenfassungen aus aktuellen kurzfristigen Traces.
|
||||
- Schreibt einen verwalteten Block `## REM Sleep`, wenn der Speicher Inline-Ausgabe enthält.
|
||||
- Zeichnet REM-Verstärkungssignale auf, die beim Deep-Ranking verwendet werden.
|
||||
- Erfasst REM-Verstärkungssignale, die vom Deep-Ranking verwendet werden.
|
||||
- Schreibt niemals in `MEMORY.md`.
|
||||
|
||||
## Traumtagebuch
|
||||
## Dream Diary
|
||||
|
||||
Dreaming führt außerdem ein erzählerisches **Traumtagebuch** in `DREAMS.md`.
|
||||
Sobald nach jeder Phase genügend Material vorhanden ist, führt `memory-core` im Hintergrund nach bestem Bemühen
|
||||
einen Subagenten-Durchlauf aus (unter Verwendung des Standard-Laufzeitmodells) und hängt einen kurzen Tagebucheintrag an.
|
||||
Dreaming führt außerdem ein erzählerisches **Dream Diary** in `DREAMS.md`.
|
||||
Sobald nach jeder Phase genügend Material vorhanden ist, führt `memory-core` im Hintergrund
|
||||
best-effort einen Subagent-Durchlauf aus (mit dem Standard-Laufzeitmodell) und hängt einen kurzen Tagebucheintrag an.
|
||||
|
||||
Dieses Tagebuch ist für Menschen zum Lesen in der Dreams-Benutzeroberfläche gedacht, nicht als Quelle für Hochstufungen.
|
||||
Dieses Tagebuch ist zum Lesen durch Menschen in der Dreams-UI gedacht, nicht als Quelle für Promotion.
|
||||
|
||||
## Deep-Ranking-Signale
|
||||
|
||||
Das Deep-Ranking verwendet sechs gewichtete Basissignale plus Phasenverstärkung:
|
||||
|
||||
| Signal | Gewicht | Beschreibung |
|
||||
| ------------------- | ------ | ------------------------------------------------ |
|
||||
| Häufigkeit | 0.24 | Wie viele kurzfristige Signale der Eintrag gesammelt hat |
|
||||
| Relevanz | 0.30 | Durchschnittliche Abrufqualität für den Eintrag |
|
||||
| Anfragevielfalt | 0.15 | Unterschiedliche Anfrage-/Tageskontexte, in denen er aufgetaucht ist |
|
||||
| Aktualität | 0.15 | Zeitverfallender Frische-Score |
|
||||
| Konsolidierung | 0.10 | Stärke des Wiederauftretens über mehrere Tage |
|
||||
| Konzeptuelle Dichte | 0.06 | Dichte von Konzept-Tags aus Snippet/Pfad |
|
||||
| Signal | Gewicht | Beschreibung |
|
||||
| ------------------- | ------- | ----------------------------------------------- |
|
||||
| Häufigkeit | 0.24 | Wie viele kurzfristige Signale der Eintrag angesammelt hat |
|
||||
| Relevanz | 0.30 | Durchschnittliche Abrufqualität für den Eintrag |
|
||||
| Anfragevielfalt | 0.15 | Unterschiedliche Anfrage-/Tageskontexte, in denen er auftauchte |
|
||||
| Aktualität | 0.15 | Zeitabklingender Frische-Score |
|
||||
| Konsolidierung | 0.10 | Stärke des Wiederauftretens über mehrere Tage |
|
||||
| Konzeptuelle Dichte | 0.06 | Dichte von Konzept-Tags aus Snippet/Pfad |
|
||||
|
||||
Treffer aus der Light- und REM-Phase fügen einen kleinen, mit der Aktualität abklingenden Boost aus
|
||||
Treffer aus der Light- und REM-Phase fügen einen kleinen, zeitabklingenden Boost aus
|
||||
`memory/.dreams/phase-signals.json` hinzu.
|
||||
|
||||
## Planung
|
||||
## Zeitplanung
|
||||
|
||||
Wenn aktiviert, verwaltet `memory-core` automatisch einen Cron-Job für einen vollständigen Dreaming-Durchlauf.
|
||||
Jeder Durchlauf führt die Phasen in dieser Reihenfolge aus: light -> REM -> deep.
|
||||
|
||||
Standardmäßiges Ausführungsintervall:
|
||||
Standardverhalten für die Ausführungsfrequenz:
|
||||
|
||||
| Einstellung | Standard |
|
||||
| ------------------- | ----------- |
|
||||
| Einstellung | Standard |
|
||||
| -------------------- | ----------- |
|
||||
| `dreaming.frequency` | `0 3 * * *` |
|
||||
|
||||
## Schnellstart
|
||||
@ -128,7 +128,7 @@ Dreaming aktivieren:
|
||||
}
|
||||
```
|
||||
|
||||
Dreaming mit einem benutzerdefinierten Durchlaufintervall aktivieren:
|
||||
Dreaming mit einer benutzerdefinierten Durchlauf-Frequenz aktivieren:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -157,9 +157,9 @@ Dreaming mit einem benutzerdefinierten Durchlaufintervall aktivieren:
|
||||
/dreaming help
|
||||
```
|
||||
|
||||
## CLI-Arbeitsablauf
|
||||
## CLI-Workflow
|
||||
|
||||
Verwenden Sie die Hochstufung per CLI für Vorschau oder manuelles Anwenden:
|
||||
Verwenden Sie die CLI-Promotion für Vorschau oder manuelle Anwendung:
|
||||
|
||||
```bash
|
||||
openclaw memory promote
|
||||
@ -168,8 +168,23 @@ openclaw memory promote --limit 5
|
||||
openclaw memory status --deep
|
||||
```
|
||||
|
||||
Manuelles `memory promote` verwendet standardmäßig die Schwellenwerte der Deep-Phase, sofern diese nicht
|
||||
mit CLI-Flags überschrieben werden.
|
||||
Die manuelle Ausführung von `memory promote` verwendet standardmäßig die Schwellenwerte der Deep-Phase, sofern sie
|
||||
nicht mit CLI-Flags überschrieben werden.
|
||||
|
||||
Erklären, warum ein bestimmter Kandidat promoviert würde oder nicht:
|
||||
|
||||
```bash
|
||||
openclaw memory promote-explain "router vlan"
|
||||
openclaw memory promote-explain "router vlan" --json
|
||||
```
|
||||
|
||||
REM-Reflexionen, Kandidatenwahrheiten und Deep-Promotion-Ausgaben in der Vorschau anzeigen, ohne
|
||||
etwas zu schreiben:
|
||||
|
||||
```bash
|
||||
openclaw memory rem-harness
|
||||
openclaw memory rem-harness --json
|
||||
```
|
||||
|
||||
## Wichtige Standardwerte
|
||||
|
||||
@ -180,24 +195,24 @@ Alle Einstellungen befinden sich unter `plugins.entries.memory-core.config.dream
|
||||
| `enabled` | `false` |
|
||||
| `frequency` | `0 3 * * *` |
|
||||
|
||||
Phasenrichtlinie, Schwellenwerte und Speicherverhalten sind interne Implementierungs-
|
||||
details (keine benutzerseitige Konfiguration).
|
||||
Phasenrichtlinie, Schwellenwerte und Speicherverhalten sind interne Implementierungsdetails
|
||||
(keine benutzerseitige Konfiguration).
|
||||
|
||||
Die vollständige Liste der Schlüssel finden Sie unter [Referenz zur Erinnerungskonfiguration](/de/reference/memory-config#dreaming-experimental).
|
||||
Die vollständige Schlüsselliste finden Sie unter [Referenz zur Memory-Konfiguration](/de/reference/memory-config#dreaming-experimental).
|
||||
|
||||
## Dreams-Benutzeroberfläche
|
||||
## Dreams-UI
|
||||
|
||||
Wenn aktiviert, zeigt der **Dreams**-Tab des Gateway Folgendes an:
|
||||
Wenn aktiviert, zeigt der Gateway-Tab **Dreams** Folgendes an:
|
||||
|
||||
- aktuellen Dreaming-Aktivierungsstatus
|
||||
- Status auf Phasenebene und Vorhandensein eines verwalteten Durchlaufs
|
||||
- Anzahl kurzfristiger, langfristiger und heute hochgestufter Erinnerungen
|
||||
- aktueller Aktivierungsstatus von Dreaming
|
||||
- Status auf Phasenebene und Vorhandensein verwalteter Durchläufe
|
||||
- Anzahl kurzfristiger, langfristiger und heute promovierter Erinnerungen
|
||||
- Zeitpunkt des nächsten geplanten Durchlaufs
|
||||
- einen ausklappbaren Leser für das Traumtagebuch, gestützt durch `doctor.memory.dreamDiary`
|
||||
- einen aufklappbaren Dream-Diary-Reader, der auf `doctor.memory.dreamDiary` basiert
|
||||
|
||||
## Verwandt
|
||||
|
||||
- [Erinnerungen](/de/concepts/memory)
|
||||
- [Erinnerungssuche](/de/concepts/memory-search)
|
||||
- [Memory](/de/concepts/memory)
|
||||
- [Memory Search](/de/concepts/memory-search)
|
||||
- [memory CLI](/cli/memory)
|
||||
- [Referenz zur Erinnerungskonfiguration](/de/reference/memory-config)
|
||||
- [Referenz zur Memory-Konfiguration](/de/reference/memory-config)
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -5,100 +5,78 @@ read_when:
|
||||
- Sie aktualisieren ein Plugin auf die moderne Plugin-Architektur
|
||||
- Sie pflegen ein externes OpenClaw-Plugin
|
||||
sidebarTitle: Migrate to SDK
|
||||
summary: Von der veralteten Rückwärtskompatibilitätsschicht auf das moderne Plugin SDK migrieren
|
||||
summary: Migrieren Sie von der veralteten Abwärtskompatibilitätsschicht zum modernen Plugin SDK
|
||||
title: Migration des Plugin SDK
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:10:34Z"
|
||||
generated_at: "2026-04-06T06:22:04Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: b71ce69b30c3bb02da1b263b1d11dc3214deae5f6fc708515e23b5a1c7bb7c8f
|
||||
source_hash: 94f12d1376edd8184714cc4dbea4a88fa8ed652f65e9365ede6176f3bf441b33
|
||||
source_path: plugins/sdk-migration.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Migration des Plugin SDK
|
||||
|
||||
OpenClaw hat sich von einer breiten Rückwärtskompatibilitätsschicht zu einer modernen Plugin-Architektur
|
||||
mit fokussierten, dokumentierten Imports entwickelt. Wenn Ihr Plugin vor
|
||||
der neuen Architektur erstellt wurde, hilft Ihnen dieser Leitfaden bei der Migration.
|
||||
OpenClaw ist von einer umfassenden Abwärtskompatibilitätsschicht zu einer modernen Plugin-Architektur mit gezielten, dokumentierten Imports übergegangen. Wenn Ihr Plugin vor der neuen Architektur erstellt wurde, hilft Ihnen diese Anleitung bei der Migration.
|
||||
|
||||
## Was sich ändert
|
||||
|
||||
Das alte Plugin-System stellte zwei weit offene Oberflächen bereit, über die Plugins
|
||||
alles importieren konnten, was sie über einen einzigen Einstiegspunkt benötigten:
|
||||
Das alte Plugin-System stellte zwei weit offene Oberflächen bereit, über die Plugins alles importieren konnten, was sie über einen einzigen Einstiegspunkt benötigten:
|
||||
|
||||
- **`openclaw/plugin-sdk/compat`** — ein einzelner Import, der Dutzende von
|
||||
Hilfsfunktionen re-exportierte. Er wurde eingeführt, damit ältere hook-basierte Plugins weiter funktionieren,
|
||||
während die neue Plugin-Architektur aufgebaut wurde.
|
||||
- **`openclaw/extension-api`** — eine Brücke, die Plugins direkten Zugriff auf
|
||||
hostseitige Hilfsfunktionen wie den eingebetteten Agent-Runner gab.
|
||||
- **`openclaw/plugin-sdk/compat`** — ein einzelner Import, der Dutzende von Helfern re-exportierte. Er wurde eingeführt, damit ältere hook-basierte Plugins weiter funktionierten, während die neue Plugin-Architektur entwickelt wurde.
|
||||
- **`openclaw/extension-api`** — eine Brücke, die Plugins direkten Zugriff auf hostseitige Helfer wie den eingebetteten Agent-Runner gab.
|
||||
|
||||
Beide Oberflächen sind jetzt **veraltet**. Sie funktionieren zur Laufzeit weiterhin, aber neue
|
||||
Plugins dürfen sie nicht verwenden, und bestehende Plugins sollten vor der nächsten
|
||||
Hauptversion migrieren, in der sie entfernt werden.
|
||||
Beide Oberflächen sind jetzt **veraltet**. Sie funktionieren zur Laufzeit weiterhin, aber neue Plugins dürfen sie nicht verwenden, und bestehende Plugins sollten migrieren, bevor sie in der nächsten Hauptversion entfernt werden.
|
||||
|
||||
<Warning>
|
||||
Die Rückwärtskompatibilitätsschicht wird in einer zukünftigen Hauptversion entfernt.
|
||||
Plugins, die weiterhin aus diesen Oberflächen importieren, funktionieren dann nicht mehr.
|
||||
Die Abwärtskompatibilitätsschicht wird in einer zukünftigen Hauptversion entfernt.
|
||||
Plugins, die weiterhin aus diesen Oberflächen importieren, werden dann nicht mehr funktionieren.
|
||||
</Warning>
|
||||
|
||||
## Warum sich das geändert hat
|
||||
|
||||
Der alte Ansatz verursachte Probleme:
|
||||
|
||||
- **Langsamer Start** — der Import einer Hilfsfunktion lud Dutzende nicht zusammenhängender Module
|
||||
- **Zirkuläre Abhängigkeiten** — breite Re-Exports machten es leicht, Import-Zyklen zu erzeugen
|
||||
- **Langsamer Start** — der Import eines einzelnen Helfers lud Dutzende nicht zusammenhängender Module
|
||||
- **Zirkuläre Abhängigkeiten** — umfangreiche Re-Exports machten es leicht, Importzyklen zu erzeugen
|
||||
- **Unklare API-Oberfläche** — es gab keine Möglichkeit zu erkennen, welche Exporte stabil und welche intern waren
|
||||
|
||||
Das moderne Plugin SDK behebt dies: Jeder Importpfad (`openclaw/plugin-sdk/\<subpath\>`)
|
||||
ist ein kleines, in sich geschlossenes Modul mit klarem Zweck und dokumentiertem Vertrag.
|
||||
Das moderne Plugin SDK behebt das: Jeder Importpfad (`openclaw/plugin-sdk/\<subpath\>`) ist ein kleines, in sich geschlossenes Modul mit einem klaren Zweck und dokumentiertem Vertrag.
|
||||
|
||||
Veraltete bequeme Provider-Seams für gebündelte Kanäle sind ebenfalls verschwunden. Imports
|
||||
wie `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
|
||||
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
|
||||
kanalmarkenspezifische Helper-Seams und
|
||||
`openclaw/plugin-sdk/telegram-core` waren private Monorepo-Abkürzungen, keine
|
||||
stabilen Plugin-Verträge. Verwenden Sie stattdessen schmale generische SDK-Subpaths. Innerhalb des
|
||||
gebündelten Plugin-Workspace behalten Sie Provider-eigene Hilfsfunktionen in der eigenen
|
||||
`api.ts` oder `runtime-api.ts` dieses Plugins.
|
||||
Veraltete Convenience-Seams für Provider bei gebündelten Kanälen sind ebenfalls entfernt worden. Imports wie `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`, `openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, kanalmarkenspezifische Helper-Seams und `openclaw/plugin-sdk/telegram-core` waren private Mono-Repo-Abkürzungen, keine stabilen Plugin-Verträge. Verwenden Sie stattdessen schmale generische SDK-Subpaths. Innerhalb des gebündelten Plugin-Workspaces sollten Provider-eigene Helfer im eigenen `api.ts` oder `runtime-api.ts` dieses Plugins bleiben.
|
||||
|
||||
Aktuelle Beispiele für gebündelte Provider:
|
||||
|
||||
- Anthropic behält Claude-spezifische Stream-Hilfsfunktionen in seiner eigenen `api.ts` /
|
||||
`contract-api.ts`-Seam
|
||||
- OpenAI behält Provider-Builder, Helfer für Standardmodelle und Realtime-Provider-Builder
|
||||
in seiner eigenen `api.ts`
|
||||
- OpenRouter behält Provider-Builder sowie Hilfsfunktionen für Onboarding/Konfiguration in seiner eigenen
|
||||
`api.ts`
|
||||
- Anthropic behält Claude-spezifische Stream-Helfer in seinem eigenen `api.ts` / `contract-api.ts`-Seam
|
||||
- OpenAI behält Provider-Builder, Helfer für Standardmodelle und Realtime-Provider-Builder in seinem eigenen `api.ts`
|
||||
- OpenRouter behält Provider-Builder sowie Onboarding-/Konfigurationshelfer in seinem eigenen `api.ts`
|
||||
|
||||
## So migrieren Sie
|
||||
|
||||
<Steps>
|
||||
<Step title="Fallback-Verhalten des Windows-Wrapper prüfen">
|
||||
Wenn Ihr Plugin `openclaw/plugin-sdk/windows-spawn` verwendet, schlagen nicht aufgelöste Windows-
|
||||
`.cmd`/`.bat`-Wrapper jetzt fail-closed fehl, sofern Sie nicht explizit
|
||||
`allowShellFallback: true` übergeben.
|
||||
<Step title="Fallback-Verhalten des Windows-Wrappers prüfen">
|
||||
Wenn Ihr Plugin `openclaw/plugin-sdk/windows-spawn` verwendet, schlagen nicht aufgelöste Windows-Wrapper vom Typ `.cmd`/`.bat` jetzt standardmäßig fehl, sofern Sie nicht ausdrücklich `allowShellFallback: true` übergeben.
|
||||
|
||||
```typescript
|
||||
// Before
|
||||
// Vorher
|
||||
const program = applyWindowsSpawnProgramPolicy({ candidate });
|
||||
|
||||
// After
|
||||
// Nachher
|
||||
const program = applyWindowsSpawnProgramPolicy({
|
||||
candidate,
|
||||
// Only set this for trusted compatibility callers that intentionally
|
||||
// accept shell-mediated fallback.
|
||||
// Setzen Sie dies nur für vertrauenswürdige Kompatibilitätsaufrufer,
|
||||
// die bewusst shell-vermittelten Fallback akzeptieren.
|
||||
allowShellFallback: true,
|
||||
});
|
||||
```
|
||||
|
||||
Wenn Ihr Aufrufer nicht absichtlich auf Shell-Fallback angewiesen ist, setzen Sie
|
||||
`allowShellFallback` nicht und behandeln Sie stattdessen den ausgelösten Fehler.
|
||||
Wenn Ihr Aufrufer nicht bewusst auf Shell-Fallback angewiesen ist, setzen Sie `allowShellFallback` nicht und behandeln Sie stattdessen den ausgelösten Fehler.
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Veraltete Imports finden">
|
||||
Durchsuchen Sie Ihr Plugin nach Imports aus einer der beiden veralteten Oberflächen:
|
||||
Suchen Sie in Ihrem Plugin nach Imports aus einer der beiden veralteten Oberflächen:
|
||||
|
||||
```bash
|
||||
grep -r "plugin-sdk/compat" my-plugin/
|
||||
@ -107,36 +85,35 @@ Aktuelle Beispiele für gebündelte Provider:
|
||||
|
||||
</Step>
|
||||
|
||||
<Step title="Durch fokussierte Imports ersetzen">
|
||||
Jeder Export aus der alten Oberfläche wird auf einen spezifischen modernen Importpfad abgebildet:
|
||||
<Step title="Durch gezielte Imports ersetzen">
|
||||
Jeder Export aus der alten Oberfläche entspricht einem bestimmten modernen Importpfad:
|
||||
|
||||
```typescript
|
||||
// Before (deprecated backwards-compatibility layer)
|
||||
// Vorher (veraltete Abwärtskompatibilitätsschicht)
|
||||
import {
|
||||
createChannelReplyPipeline,
|
||||
createPluginRuntimeStore,
|
||||
resolveControlCommandGate,
|
||||
} from "openclaw/plugin-sdk/compat";
|
||||
|
||||
// After (modern focused imports)
|
||||
// Nachher (moderne gezielte Imports)
|
||||
import { createChannelReplyPipeline } from "openclaw/plugin-sdk/channel-reply-pipeline";
|
||||
import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
|
||||
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
|
||||
```
|
||||
|
||||
Für hostseitige Hilfsfunktionen verwenden Sie die injizierte Plugin-Runtime, anstatt direkt
|
||||
zu importieren:
|
||||
Verwenden Sie für hostseitige Helfer die injizierte Plugin-Laufzeitumgebung, anstatt direkt zu importieren:
|
||||
|
||||
```typescript
|
||||
// Before (deprecated extension-api bridge)
|
||||
// Vorher (veraltete extension-api-Brücke)
|
||||
import { runEmbeddedPiAgent } from "openclaw/extension-api";
|
||||
const result = await runEmbeddedPiAgent({ sessionId, prompt });
|
||||
|
||||
// After (injected runtime)
|
||||
// Nachher (injizierte Laufzeitumgebung)
|
||||
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
|
||||
```
|
||||
|
||||
Dasselbe Muster gilt für andere veraltete Bridge-Hilfsfunktionen:
|
||||
Dasselbe Muster gilt für andere veraltete Bridge-Helfer:
|
||||
|
||||
| Alter Import | Modernes Äquivalent |
|
||||
| --- | --- |
|
||||
@ -146,7 +123,7 @@ Aktuelle Beispiele für gebündelte Provider:
|
||||
| `resolveThinkingDefault` | `api.runtime.agent.resolveThinkingDefault` |
|
||||
| `resolveAgentTimeoutMs` | `api.runtime.agent.resolveAgentTimeoutMs` |
|
||||
| `ensureAgentWorkspace` | `api.runtime.agent.ensureAgentWorkspace` |
|
||||
| Sitzungsstore-Hilfsfunktionen | `api.runtime.agent.session.*` |
|
||||
| Session-Store-Helfer | `api.runtime.agent.session.*` |
|
||||
|
||||
</Step>
|
||||
|
||||
@ -160,168 +137,169 @@ Aktuelle Beispiele für gebündelte Provider:
|
||||
|
||||
## Referenz der Importpfade
|
||||
|
||||
<Accordion title="Tabelle mit häufigen Importpfaden">
|
||||
<Accordion title="Tabelle häufiger Importpfade">
|
||||
| Importpfad | Zweck | Wichtige Exporte |
|
||||
| --- | --- | --- |
|
||||
| `plugin-sdk/plugin-entry` | Kanonische Hilfsfunktion für Plugin-Einstiegspunkt | `definePluginEntry` |
|
||||
| `plugin-sdk/core` | Veralteter Sammel-Re-Export für Definitionen/Builder von Kanaleinstiegspunkten | `defineChannelPluginEntry`, `createChatChannelPlugin` |
|
||||
| `plugin-sdk/config-schema` | Export des Root-Konfigurationsschemas | `OpenClawSchema` |
|
||||
| `plugin-sdk/provider-entry` | Hilfsfunktion für Single-Provider-Einstiegspunkt | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/channel-core` | Fokussierte Definitionen und Builder für Kanaleinstiegspunkte | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/setup` | Gemeinsame Hilfsfunktionen für Setup-Assistenten | Allowlist-Prompts, Builder für Setup-Status |
|
||||
| `plugin-sdk/setup-runtime` | Runtime-Hilfsfunktionen zur Setup-Zeit | Import-sichere Setup-Patch-Adapter, Hilfsfunktionen für Lookup-Hinweise, `promptResolvedAllowFrom`, `splitSetupEntries`, delegierte Setup-Proxys |
|
||||
| `plugin-sdk/setup-adapter-runtime` | Hilfsfunktionen für Setup-Adapter | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | Hilfsfunktionen für Setup-Tooling | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Hilfsfunktionen für mehrere Konten | Hilfsfunktionen für Kontolisten/Konfiguration/Action-Gates |
|
||||
| `plugin-sdk/account-id` | Hilfsfunktionen für Account-IDs | `DEFAULT_ACCOUNT_ID`, Normalisierung von Account-IDs |
|
||||
| `plugin-sdk/account-resolution` | Hilfsfunktionen für Kontosuche | Kontosuche + Hilfsfunktionen für Standard-Fallback |
|
||||
| `plugin-sdk/account-helpers` | Schmale Hilfsfunktionen für Konten | Hilfsfunktionen für Kontolisten/Kontoaktionen |
|
||||
| `plugin-sdk/channel-setup` | Adapter für Setup-Assistenten | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, plus `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/channel-pairing` | Primitive für DM-Kopplung | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | Verdrahtung für Antwortpräfix + Eingabeanzeige | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | Factorys für Konfigurationsadapter | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Builder für Konfigurationsschemas | Typen für Kanalkonfigurationsschemas |
|
||||
| `plugin-sdk/telegram-command-config` | Hilfsfunktionen für Telegram-Befehlskonfiguration | Normalisierung von Befehlsnamen, Kürzen von Beschreibungen, Validierung von Duplikaten/Konflikten |
|
||||
| `plugin-sdk/plugin-entry` | Kanonischer Plugin-Entry-Helfer | `definePluginEntry` |
|
||||
| `plugin-sdk/core` | Veralteter umfassender Re-Export für Channel-Entry-Definitionen/-Builder | `defineChannelPluginEntry`, `createChatChannelPlugin` |
|
||||
| `plugin-sdk/config-schema` | Root-Config-Schema-Export | `OpenClawSchema` |
|
||||
| `plugin-sdk/provider-entry` | Single-Provider-Entry-Helfer | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/channel-core` | Gezielte Channel-Entry-Definitionen und -Builder | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/setup` | Gemeinsame Helfer für den Einrichtungsassistenten | Allowlist-Prompts, Builder für Einrichtungsstatus |
|
||||
| `plugin-sdk/setup-runtime` | Laufzeithelfer für die Einrichtung | Importsichere Patch-Adapter für die Einrichtung, Helfer für Lookup-Hinweise, `promptResolvedAllowFrom`, `splitSetupEntries`, delegierte Setup-Proxys |
|
||||
| `plugin-sdk/setup-adapter-runtime` | Helfer für Setup-Adapter | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | Helfer für Einrichtungswerkzeuge | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Helfer für mehrere Accounts | Helfer für Account-Liste/Config/Action-Gate |
|
||||
| `plugin-sdk/account-id` | Helfer für Account-IDs | `DEFAULT_ACCOUNT_ID`, Normalisierung von Account-IDs |
|
||||
| `plugin-sdk/account-resolution` | Helfer für die Account-Auflösung | Account-Lookup- und Standard-Fallback-Helfer |
|
||||
| `plugin-sdk/account-helpers` | Schmale Account-Helfer | Helfer für Account-Listen/Account-Aktionen |
|
||||
| `plugin-sdk/channel-setup` | Adapter für den Einrichtungsassistenten | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, plus `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/channel-pairing` | Grundbausteine für DM-Pairing | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | Verkabelung für Antwortpräfix + Tippstatus | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | Fabriken für Config-Adapter | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Builder für Config-Schemata | Typen für Channel-Config-Schemata |
|
||||
| `plugin-sdk/telegram-command-config` | Helfer für Telegram-Befehlskonfiguration | Normalisierung von Befehlsnamen, Kürzen von Beschreibungen, Validierung von Duplikaten/Konflikten |
|
||||
| `plugin-sdk/channel-policy` | Auflösung von Gruppen-/DM-Richtlinien | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/channel-lifecycle` | Verfolgung des Kontostatus | `createAccountStatusSink` |
|
||||
| `plugin-sdk/inbound-envelope` | Hilfsfunktionen für Inbound-Umschläge | Gemeinsame Hilfsfunktionen für Route- + Umschlag-Builder |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Hilfsfunktionen für eingehende Antworten | Gemeinsame Hilfsfunktionen für Aufzeichnung und Dispatch |
|
||||
| `plugin-sdk/messaging-targets` | Parsen von Messaging-Zielen | Hilfsfunktionen zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/outbound-media` | Hilfsfunktionen für ausgehende Medien | Gemeinsames Laden ausgehender Medien |
|
||||
| `plugin-sdk/outbound-runtime` | Runtime-Hilfsfunktionen für Outbound | Hilfsfunktionen für ausgehende Identität/Sende-Delegation |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Hilfsfunktionen für Thread-Bindings | Hilfsfunktionen für Lebenszyklus und Adapter von Thread-Bindings |
|
||||
| `plugin-sdk/agent-media-payload` | Veraltete Hilfsfunktionen für Medien-Payloads | Builder für Agent-Medien-Payloads für veraltete Feldlayouts |
|
||||
| `plugin-sdk/channel-runtime` | Veralteter Kompatibilitäts-Shim | Nur veraltete Kanal-Runtime-Hilfsfunktionen |
|
||||
| `plugin-sdk/channel-send-result` | Typen für Sendeergebnisse | Typen für Antwortergebnisse |
|
||||
| `plugin-sdk/channel-lifecycle` | Nachverfolgung des Account-Status | `createAccountStatusSink` |
|
||||
| `plugin-sdk/inbound-envelope` | Helfer für eingehende Envelopes | Gemeinsame Helfer für Route- und Envelope-Builder |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Helfer für eingehende Antworten | Gemeinsame Helfer zum Aufzeichnen und Dispatchen |
|
||||
| `plugin-sdk/messaging-targets` | Parsing von Messaging-Zielen | Helfer zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/outbound-media` | Helfer für ausgehende Medien | Gemeinsames Laden ausgehender Medien |
|
||||
| `plugin-sdk/outbound-runtime` | Laufzeithelfer für ausgehende Vorgänge | Helfer für ausgehende Identität/Sende-Delegation |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Helfer für Thread-Bindings | Helfer für Thread-Binding-Lebenszyklus und Adapter |
|
||||
| `plugin-sdk/agent-media-payload` | Veraltete Helfer für Medien-Payloads | Agent-Medien-Payload-Builder für veraltete Feldlayouts |
|
||||
| `plugin-sdk/channel-runtime` | Veralteter Kompatibilitäts-Shim | Nur veraltete Laufzeit-Hilfsfunktionen für Channels |
|
||||
| `plugin-sdk/channel-send-result` | Send-Result-Typen | Typen für Antwortergebnisse |
|
||||
| `plugin-sdk/runtime-store` | Persistenter Plugin-Speicher | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/runtime` | Breite Runtime-Hilfsfunktionen | Hilfsfunktionen für Runtime/Logging/Backup/Plugin-Installation |
|
||||
| `plugin-sdk/runtime-env` | Schmale Hilfsfunktionen für Runtime-Umgebung | Logger/Runtime-Umgebung, Timeout-, Retry- und Backoff-Hilfsfunktionen |
|
||||
| `plugin-sdk/plugin-runtime` | Gemeinsame Plugin-Runtime-Hilfsfunktionen | Hilfsfunktionen für Plugin-Befehle/Hooks/HTTP/interaktive Funktionen |
|
||||
| `plugin-sdk/hook-runtime` | Hilfsfunktionen für Hook-Pipelines | Gemeinsame Hilfsfunktionen für Webhook-/interne Hook-Pipelines |
|
||||
| `plugin-sdk/lazy-runtime` | Hilfsfunktionen für Lazy Runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Prozesshilfsfunktionen | Gemeinsame Exec-Hilfsfunktionen |
|
||||
| `plugin-sdk/cli-runtime` | CLI-Runtime-Hilfsfunktionen | Befehlsformatierung, Wartezeiten, Versionshilfsfunktionen |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway-Hilfsfunktionen | Gateway-Client und Hilfsfunktionen für Patches des Kanalstatus |
|
||||
| `plugin-sdk/config-runtime` | Konfigurationshilfsfunktionen | Hilfsfunktionen zum Laden/Schreiben von Konfiguration |
|
||||
| `plugin-sdk/telegram-command-config` | Hilfsfunktionen für Telegram-Befehle | Fallback-stabile Hilfsfunktionen zur Telegram-Befehlsvalidierung, wenn die Vertragsoberfläche des gebündelten Telegram-Plugins nicht verfügbar ist |
|
||||
| `plugin-sdk/approval-runtime` | Hilfsfunktionen für Genehmigungs-Prompts | Exec-/Plugin-Genehmigungs-Payload, Hilfsfunktionen für Genehmigungsfähigkeit/-profil, native Genehmigungs-Routing-/Runtime-Hilfsfunktionen |
|
||||
| `plugin-sdk/approval-auth-runtime` | Hilfsfunktionen für Genehmigungs-Authentifizierung | Auflösung von Genehmigenden, Authentifizierung für Aktionen im selben Chat |
|
||||
| `plugin-sdk/approval-client-runtime` | Hilfsfunktionen für Genehmigungs-Client | Hilfsfunktionen für Profile/Filter nativer Exec-Genehmigungen |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Hilfsfunktionen für Genehmigungszustellung | Adapter für native Genehmigungsfähigkeit/-zustellung |
|
||||
| `plugin-sdk/approval-native-runtime` | Hilfsfunktionen für Genehmigungsziele | Hilfsfunktionen für native Genehmigungsziel-/Kontobindung |
|
||||
| `plugin-sdk/approval-reply-runtime` | Hilfsfunktionen für Genehmigungsantworten | Hilfsfunktionen für Antwort-Payloads von Exec-/Plugin-Genehmigungen |
|
||||
| `plugin-sdk/security-runtime` | Sicherheitshilfsfunktionen | Gemeinsame Hilfsfunktionen für Vertrauen, DM-Gating, externe Inhalte und Secret-Erfassung |
|
||||
| `plugin-sdk/ssrf-policy` | Hilfsfunktionen für SSRF-Richtlinien | Hilfsfunktionen für Host-Allowlist und Richtlinien für private Netzwerke |
|
||||
| `plugin-sdk/ssrf-runtime` | SSRF-Runtime-Hilfsfunktionen | Pinned-Dispatcher, Guarded Fetch, SSRF-Richtlinienhilfsfunktionen |
|
||||
| `plugin-sdk/collection-runtime` | Hilfsfunktionen für begrenzten Cache | `pruneMapToMaxSize` |
|
||||
| `plugin-sdk/diagnostic-runtime` | Hilfsfunktionen für Diagnose-Gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
|
||||
| `plugin-sdk/error-runtime` | Hilfsfunktionen zur Fehlerformatierung | `formatUncaughtError`, `isApprovalNotFoundError`, Hilfsfunktionen für Fehlergraphen |
|
||||
| `plugin-sdk/fetch-runtime` | Wrapped Fetch-/Proxy-Hilfsfunktionen | `resolveFetch`, Proxy-Hilfsfunktionen |
|
||||
| `plugin-sdk/host-runtime` | Hilfsfunktionen zur Host-Normalisierung | `normalizeHostname`, `normalizeScpRemoteHost` |
|
||||
| `plugin-sdk/retry-runtime` | Retry-Hilfsfunktionen | `RetryConfig`, `retryAsync`, Policy-Runner |
|
||||
| `plugin-sdk/runtime` | Umfassende Laufzeithelfer | Laufzeit-/Logging-/Backup-/Plugin-Installationshelfer |
|
||||
| `plugin-sdk/runtime-env` | Schmale Helfer für die Laufzeitumgebung | Logger-/Laufzeitumgebungs-, Timeout-, Retry- und Backoff-Helfer |
|
||||
| `plugin-sdk/plugin-runtime` | Gemeinsame Helfer für die Plugin-Laufzeit | Plugin-Befehls-/Hook-/HTTP-/interaktive Helfer |
|
||||
| `plugin-sdk/hook-runtime` | Helfer für Hook-Pipelines | Gemeinsame Pipeline-Helfer für Webhook-/interne Hooks |
|
||||
| `plugin-sdk/lazy-runtime` | Helfer für Lazy Runtime | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Prozesshelfer | Gemeinsame Exec-Helfer |
|
||||
| `plugin-sdk/cli-runtime` | CLI-Laufzeithelfer | Helfer für Befehlsformatierung, Waits und Versionsfunktionen |
|
||||
| `plugin-sdk/gateway-runtime` | Gateway-Helfer | Gateway-Client und Patch-Helfer für Channel-Status |
|
||||
| `plugin-sdk/config-runtime` | Config-Helfer | Helfer zum Laden/Schreiben von Config |
|
||||
| `plugin-sdk/telegram-command-config` | Telegram-Befehlshelfer | Fallback-stabile Telegram-Befehlsvalidierungshelfer, wenn die gebündelte Telegram-Vertragsoberfläche nicht verfügbar ist |
|
||||
| `plugin-sdk/approval-runtime` | Helfer für Genehmigungs-Prompts | Payloads für Exec-/Plugin-Genehmigungen, Helfer für Genehmigungsfähigkeiten/-profile, natives Routing/Laufzeitverhalten für Genehmigungen |
|
||||
| `plugin-sdk/approval-auth-runtime` | Helfer für Genehmigungsautorisierung | Auflösung von Approvern, Aktionsautorisierung im selben Chat |
|
||||
| `plugin-sdk/approval-client-runtime` | Helfer für Genehmigungsclients | Helfer für native Exec-Genehmigungsprofile/-filter |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Helfer für Genehmigungszustellung | Native Adapter für Genehmigungsfähigkeiten/-zustellung |
|
||||
| `plugin-sdk/approval-native-runtime` | Helfer für Genehmigungsziele | Native Helfer für Ziel-/Account-Binding von Genehmigungen |
|
||||
| `plugin-sdk/approval-reply-runtime` | Helfer für Genehmigungsantworten | Helfer für Antwort-Payloads bei Exec-/Plugin-Genehmigungen |
|
||||
| `plugin-sdk/security-runtime` | Sicherheitshelfer | Gemeinsame Helfer für Trust, DM-Gating, externe Inhalte und Geheimnissammlung |
|
||||
| `plugin-sdk/ssrf-policy` | Helfer für SSRF-Richtlinien | Helfer für Host-Allowlists und Richtlinien für private Netzwerke |
|
||||
| `plugin-sdk/ssrf-runtime` | SSRF-Laufzeithelfer | Helfer für Pinned Dispatcher, Guarded Fetch und SSRF-Richtlinien |
|
||||
| `plugin-sdk/collection-runtime` | Helfer für begrenzte Caches | `pruneMapToMaxSize` |
|
||||
| `plugin-sdk/diagnostic-runtime` | Helfer für Diagnose-Gating | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
|
||||
| `plugin-sdk/error-runtime` | Helfer zur Fehlerformatierung | `formatUncaughtError`, `isApprovalNotFoundError`, Helfer für Fehlergraphen |
|
||||
| `plugin-sdk/fetch-runtime` | Helfer für Wrapped Fetch/Proxys | `resolveFetch`, Proxy-Helfer |
|
||||
| `plugin-sdk/host-runtime` | Helfer zur Host-Normalisierung | `normalizeHostname`, `normalizeScpRemoteHost` |
|
||||
| `plugin-sdk/retry-runtime` | Retry-Helfer | `RetryConfig`, `retryAsync`, Policy-Runner |
|
||||
| `plugin-sdk/allow-from` | Formatierung von Allowlists | `formatAllowFromLowercase` |
|
||||
| `plugin-sdk/allowlist-resolution` | Mapping von Allowlist-Eingaben | `mapAllowlistResolutionInputs` |
|
||||
| `plugin-sdk/command-auth` | Befehls-Gating- und Hilfsfunktionen für Befehlsoberflächen | `resolveControlCommandGate`, Hilfsfunktionen für Sender-Autorisierung, Hilfsfunktionen für Befehlsregistrierung |
|
||||
| `plugin-sdk/secret-input` | Parsing von Secret-Eingaben | Hilfsfunktionen für Secret-Eingaben |
|
||||
| `plugin-sdk/webhook-ingress` | Hilfsfunktionen für Webhook-Anfragen | Hilfsfunktionen für Webhook-Ziele |
|
||||
| `plugin-sdk/webhook-request-guards` | Hilfsfunktionen für Guards von Webhook-Bodys | Hilfsfunktionen zum Lesen/Begrenzen von Request-Bodys |
|
||||
| `plugin-sdk/reply-runtime` | Gemeinsame Antwort-Runtime | Inbound-Dispatch, Heartbeat, Antwortplanung, Chunking |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Schmale Hilfsfunktionen für Antwort-Dispatch | Hilfsfunktionen für Finalisierung + Provider-Dispatch |
|
||||
| `plugin-sdk/reply-history` | Hilfsfunktionen für Antwortverlauf | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/allowlist-resolution` | Zuordnung von Allowlist-Eingaben | `mapAllowlistResolutionInputs` |
|
||||
| `plugin-sdk/command-auth` | Befehls-Gating und Helfer für Befehlsoberflächen | `resolveControlCommandGate`, Helfer für Senderautorisierung, Helfer für Befehlsregistrierung |
|
||||
| `plugin-sdk/secret-input` | Parsing geheimer Eingaben | Helfer für geheime Eingaben |
|
||||
| `plugin-sdk/webhook-ingress` | Helfer für Webhook-Anfragen | Hilfsfunktionen für Webhook-Ziele |
|
||||
| `plugin-sdk/webhook-request-guards` | Guard-Helfer für Webhook-Bodys | Helfer zum Lesen/Begrenzen von Request-Bodys |
|
||||
| `plugin-sdk/reply-runtime` | Gemeinsame Antwort-Laufzeit | Inbound-Dispatch, Heartbeat, Antwortplanung, Chunking |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Schmale Helfer für Antwort-Dispatch | Helfer zum Finalisieren + Provider-Dispatch |
|
||||
| `plugin-sdk/reply-history` | Helfer für Antwortverlauf | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/reply-reference` | Planung von Antwortreferenzen | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Hilfsfunktionen für Antwort-Chunks | Hilfsfunktionen für Text-/Markdown-Chunking |
|
||||
| `plugin-sdk/session-store-runtime` | Hilfsfunktionen für Session-Store | Hilfsfunktionen für Store-Pfad + updated-at |
|
||||
| `plugin-sdk/state-paths` | Hilfsfunktionen für State-Pfade | Hilfsfunktionen für State- und OAuth-Verzeichnisse |
|
||||
| `plugin-sdk/routing` | Hilfsfunktionen für Routing/Sitzungsschlüssel | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, Hilfsfunktionen zur Normalisierung von Sitzungsschlüsseln |
|
||||
| `plugin-sdk/status-helpers` | Hilfsfunktionen für Kanalstatus | Builder für Zusammenfassungen von Kanal-/Kontostatus, Runtime-State-Standards, Hilfsfunktionen für Issue-Metadaten |
|
||||
| `plugin-sdk/target-resolver-runtime` | Hilfsfunktionen für Target Resolver | Gemeinsame Hilfsfunktionen für Target Resolver |
|
||||
| `plugin-sdk/string-normalization-runtime` | Hilfsfunktionen für String-Normalisierung | Hilfsfunktionen für Slug-/String-Normalisierung |
|
||||
| `plugin-sdk/request-url` | Hilfsfunktionen für Request-URLs | String-URLs aus request-ähnlichen Eingaben extrahieren |
|
||||
| `plugin-sdk/run-command` | Hilfsfunktionen für zeitgesteuerte Befehle | Timed Command Runner mit normalisiertem stdout/stderr |
|
||||
| `plugin-sdk/reply-chunking` | Helfer für Antwort-Chunks | Helfer für Text-/Markdown-Chunking |
|
||||
| `plugin-sdk/session-store-runtime` | Helfer für Session-Stores | Helfer für Store-Pfad + updated-at |
|
||||
| `plugin-sdk/state-paths` | Helfer für State-Pfade | Helfer für State- und OAuth-Verzeichnisse |
|
||||
| `plugin-sdk/routing` | Helfer für Routing/Session-Keys | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, Helfer zur Session-Key-Normalisierung |
|
||||
| `plugin-sdk/status-helpers` | Helfer für Channel-Status | Builder für Channel-/Account-Statuszusammenfassungen, Standardwerte für Laufzeitzustand, Issue-Metadaten-Helfer |
|
||||
| `plugin-sdk/target-resolver-runtime` | Helfer für Target Resolver | Gemeinsame Helfer für Target Resolver |
|
||||
| `plugin-sdk/string-normalization-runtime` | Helfer zur String-Normalisierung | Helfer zur Slug-/String-Normalisierung |
|
||||
| `plugin-sdk/request-url` | Helfer für Request-URLs | Extrahieren von String-URLs aus request-ähnlichen Eingaben |
|
||||
| `plugin-sdk/run-command` | Helfer für getimte Befehle | Runner für getimte Befehle mit normalisiertem stdout/stderr |
|
||||
| `plugin-sdk/param-readers` | Param-Reader | Gemeinsame Param-Reader für Tool/CLI |
|
||||
| `plugin-sdk/tool-send` | Extraktion von Tool-Send | Kanonische Send-Zielfelder aus Tool-Argumenten extrahieren |
|
||||
| `plugin-sdk/temp-path` | Hilfsfunktionen für Temp-Pfade | Gemeinsame Hilfsfunktionen für Temp-Download-Pfade |
|
||||
| `plugin-sdk/logging-core` | Logging-Hilfsfunktionen | Subsystem-Logger und Hilfsfunktionen für Schwärzung |
|
||||
| `plugin-sdk/markdown-table-runtime` | Hilfsfunktionen für Markdown-Tabellen | Hilfsfunktionen für Modus von Markdown-Tabellen |
|
||||
| `plugin-sdk/reply-payload` | Typen für Nachrichtenantworten | Typen für Antwort-Payloads |
|
||||
| `plugin-sdk/provider-setup` | Kuratierte Hilfsfunktionen für das Setup lokaler/self-hosted Provider | Hilfsfunktionen für Discovery/Konfiguration self-hosted Provider |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Fokussierte Hilfsfunktionen für das Setup self-hosted OpenAI-kompatibler Provider | Dieselben Hilfsfunktionen für Discovery/Konfiguration self-hosted Provider |
|
||||
| `plugin-sdk/provider-auth-runtime` | Runtime-Hilfsfunktionen für Provider-Authentifizierung | Hilfsfunktionen zur Auflösung von Runtime-API-Schlüsseln |
|
||||
| `plugin-sdk/provider-auth-api-key` | Hilfsfunktionen für die Einrichtung von Provider-API-Schlüsseln | Hilfsfunktionen für API-Key-Onboarding/Profilschreibvorgänge |
|
||||
| `plugin-sdk/provider-auth-result` | Hilfsfunktionen für Provider-Auth-Ergebnisse | Standard-Builder für OAuth-Auth-Ergebnisse |
|
||||
| `plugin-sdk/provider-auth-login` | Hilfsfunktionen für interaktive Provider-Anmeldung | Gemeinsame Hilfsfunktionen für interaktive Anmeldung |
|
||||
| `plugin-sdk/provider-env-vars` | Hilfsfunktionen für Provider-Env-Variablen | Hilfsfunktionen für die Suche von Env-Variablen für Provider-Authentifizierung |
|
||||
| `plugin-sdk/provider-model-shared` | Gemeinsame Hilfsfunktionen für Provider-Modell/Wiedergabe | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, gemeinsame Builder für Replay-Richtlinien, Hilfsfunktionen für Provider-Endpunkte und Normalisierung von Modell-IDs |
|
||||
| `plugin-sdk/provider-catalog-shared` | Gemeinsame Hilfsfunktionen für Provider-Kataloge | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-onboard` | Patches für Provider-Onboarding | Hilfsfunktionen für Onboarding-Konfiguration |
|
||||
| `plugin-sdk/provider-http` | Hilfsfunktionen für Provider-HTTP | Generische Hilfsfunktionen für HTTP-/Endpunktfähigkeiten von Providern |
|
||||
| `plugin-sdk/provider-web-fetch` | Hilfsfunktionen für Web-Fetch von Providern | Hilfsfunktionen für Registrierung/Cache von Web-Fetch-Providern |
|
||||
| `plugin-sdk/provider-web-search` | Hilfsfunktionen für Web-Suche von Providern | Hilfsfunktionen für Registrierung/Cache/Konfiguration von Web-Such-Providern |
|
||||
| `plugin-sdk/provider-tools` | Hilfsfunktionen für Provider-Tool-/Schema-Kompatibilität | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini-Schema-Bereinigung + Diagnostik und xAI-Kompatibilitäts-Hilfsfunktionen wie `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-usage` | Hilfsfunktionen für Provider-Nutzung | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` und andere Hilfsfunktionen für Provider-Nutzung |
|
||||
| `plugin-sdk/provider-stream` | Hilfsfunktionen für Provider-Stream-Wrapper | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, Typen für Stream-Wrapper und gemeinsame Wrapper-Hilfsfunktionen für Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/keyed-async-queue` | Geordnete Async-Warteschlange | `KeyedAsyncQueue` |
|
||||
| `plugin-sdk/media-runtime` | Gemeinsame Medienhilfsfunktionen | Hilfsfunktionen für Media Fetch/Transform/Store plus Builder für Medien-Payloads |
|
||||
| `plugin-sdk/media-understanding` | Hilfsfunktionen für Medienverständnis | Typen für Media-Understanding-Provider plus providerseitige Exporte für Bild-/Audio-Hilfsfunktionen |
|
||||
| `plugin-sdk/text-runtime` | Gemeinsame Texthilfsfunktionen | Entfernen von assistant-sichtbarem Text, Hilfsfunktionen für Rendern/Chunking/Tabellen von Markdown, Schwärzungshilfsfunktionen, Directive-Tag-Hilfsfunktionen, Safe-Text-Utilities und verwandte Hilfsfunktionen für Text/Logging |
|
||||
| `plugin-sdk/text-chunking` | Hilfsfunktionen für Text-Chunking | Hilfsfunktion für ausgehendes Text-Chunking |
|
||||
| `plugin-sdk/speech` | Hilfsfunktionen für Speech | Typen für Speech-Provider plus providerseitige Hilfsfunktionen für Direktiven, Registry und Validierung |
|
||||
| `plugin-sdk/speech-core` | Gemeinsamer Speech-Kern | Typen für Speech-Provider, Registry, Direktiven, Normalisierung |
|
||||
| `plugin-sdk/realtime-transcription` | Hilfsfunktionen für Realtime-Transkription | Hilfsfunktionen für Provider-Typen und Registry |
|
||||
| `plugin-sdk/realtime-voice` | Hilfsfunktionen für Realtime-Voice | Hilfsfunktionen für Provider-Typen und Registry |
|
||||
| `plugin-sdk/image-generation-core` | Gemeinsamer Bildgenerierungs-Kern | Hilfsfunktionen für Bildgenerierungstypen, Failover, Auth und Registry |
|
||||
| `plugin-sdk/music-generation` | Hilfsfunktionen für Musikgenerierung | Typen für Musikgenerierungs-Provider/Requests/Ergebnisse |
|
||||
| `plugin-sdk/music-generation-core` | Gemeinsamer Musikgenerierungs-Kern | Hilfsfunktionen für Musikgenerierungstypen, Failover, Providersuche und Parsen von Modellreferenzen |
|
||||
| `plugin-sdk/video-generation` | Hilfsfunktionen für Videogenerierung | Typen für Videogenerierungs-Provider/Requests/Ergebnisse |
|
||||
| `plugin-sdk/video-generation-core` | Gemeinsamer Videogenerierungs-Kern | Hilfsfunktionen für Videogenerierungstypen, Failover, Providersuche und Parsen von Modellreferenzen |
|
||||
| `plugin-sdk/interactive-runtime` | Hilfsfunktionen für interaktive Antworten | Normalisierung/Reduktion von Payloads für interaktive Antworten |
|
||||
| `plugin-sdk/channel-config-primitives` | Primitive für Kanalkonfiguration | Schmale Primitive für Kanalkonfigurationsschemas |
|
||||
| `plugin-sdk/channel-config-writes` | Hilfsfunktionen für Schreibvorgänge an Kanalkonfiguration | Hilfsfunktionen für Autorisierung von Schreibvorgängen an Kanalkonfiguration |
|
||||
| `plugin-sdk/channel-plugin-common` | Gemeinsames Kanal-Präludium | Exporte für gemeinsames Kanal-Plugin-Präludium |
|
||||
| `plugin-sdk/channel-status` | Hilfsfunktionen für Kanalstatus | Gemeinsame Hilfsfunktionen für Snapshot/Zusammenfassung des Kanalstatus |
|
||||
| `plugin-sdk/allowlist-config-edit` | Hilfsfunktionen für Allowlist-Konfiguration | Hilfsfunktionen zum Bearbeiten/Lesen von Allowlist-Konfiguration |
|
||||
| `plugin-sdk/group-access` | Hilfsfunktionen für Gruppenzugriff | Gemeinsame Hilfsfunktionen für Entscheidungen zum Gruppenzugriff |
|
||||
| `plugin-sdk/direct-dm` | Hilfsfunktionen für direkte DMs | Gemeinsame Hilfsfunktionen für Auth/Guards direkter DMs |
|
||||
| `plugin-sdk/extension-shared` | Gemeinsame Erweiterungshilfsfunktionen | Primitive Hilfsfunktionen für passive Kanäle/Status |
|
||||
| `plugin-sdk/webhook-targets` | Hilfsfunktionen für Webhook-Ziele | Registry für Webhook-Ziele und Hilfsfunktionen zur Routeninstallation |
|
||||
| `plugin-sdk/webhook-path` | Hilfsfunktionen für Webhook-Pfade | Hilfsfunktionen zur Normalisierung von Webhook-Pfaden |
|
||||
| `plugin-sdk/web-media` | Gemeinsame Hilfsfunktionen für Web-Medien | Hilfsfunktionen zum Laden entfernter/lokaler Medien |
|
||||
| `plugin-sdk/zod` | Re-Export von Zod | Re-exportiertes `zod` für Konsumenten des Plugin SDK |
|
||||
| `plugin-sdk/memory-core` | Gebündelte Hilfsfunktionen für memory-core | Oberfläche von Hilfsfunktionen für Memory-Manager/Konfiguration/Datei/CLI |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Runtime-Fassade für Memory-Engine | Runtime-Fassade für Memory-Index/-Suche |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Foundation-Engine für Memory-Host | Exporte der Foundation-Engine für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Embedding-Engine für Memory-Host | Exporte der Embedding-Engine für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | QMD-Engine für Memory-Host | Exporte der QMD-Engine für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Storage-Engine für Memory-Host | Exporte der Storage-Engine für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Multimodale Hilfsfunktionen für Memory-Host | Multimodale Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-query` | Query-Hilfsfunktionen für Memory-Host | Query-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-secret` | Secret-Hilfsfunktionen für Memory-Host | Secret-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-status` | Status-Hilfsfunktionen für Memory-Host | Status-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | CLI-Runtime für Memory-Host | CLI-Runtime-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Core-Runtime für Memory-Host | Core-Runtime-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Datei-/Runtime-Hilfsfunktionen für Memory-Host | Datei-/Runtime-Hilfsfunktionen für Memory-Host |
|
||||
| `plugin-sdk/memory-lancedb` | Gebündelte Hilfsfunktionen für memory-lancedb | Hilfsoberfläche für memory-lancedb |
|
||||
| `plugin-sdk/testing` | Test-Utilities | Test-Hilfsfunktionen und Mocks |
|
||||
| `plugin-sdk/tool-send` | Extraktion für Tool-Send | Extrahieren kanonischer Send-Zielfelder aus Tool-Argumenten |
|
||||
| `plugin-sdk/temp-path` | Helfer für temporäre Pfade | Gemeinsame Helfer für temporäre Download-Pfade |
|
||||
| `plugin-sdk/logging-core` | Logging-Helfer | Subsystem-Logger und Redaktionshelfer |
|
||||
| `plugin-sdk/markdown-table-runtime` | Helfer für Markdown-Tabellen | Helfer für Markdown-Tabellenmodi |
|
||||
| `plugin-sdk/reply-payload` | Typen für Nachrichtenantworten | Antwort-Payload-Typen |
|
||||
| `plugin-sdk/provider-setup` | Kuratierte Helfer für die Einrichtung lokaler/self-hosted Provider | Helfer für Erkennung/Config self-hosted Provider |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Gezielte Helfer für die Einrichtung OpenAI-kompatibler self-hosted Provider | Dieselben Helfer für Erkennung/Config self-hosted Provider |
|
||||
| `plugin-sdk/provider-auth-runtime` | Laufzeithelfer für Provider-Authentifizierung | Helfer zur Auflösung von API-Schlüsseln zur Laufzeit |
|
||||
| `plugin-sdk/provider-auth-api-key` | Helfer für die Einrichtung von Provider-API-Schlüsseln | Helfer für API-Key-Onboarding/Profilschreibung |
|
||||
| `plugin-sdk/provider-auth-result` | Helfer für Provider-Authentifizierungsergebnisse | Standard-Builder für OAuth-Authentifizierungsergebnisse |
|
||||
| `plugin-sdk/provider-auth-login` | Helfer für interaktive Provider-Anmeldung | Gemeinsame Helfer für interaktive Anmeldung |
|
||||
| `plugin-sdk/provider-env-vars` | Helfer für Provider-Umgebungsvariablen | Helfer für das Lookup von Auth-Umgebungsvariablen bei Providern |
|
||||
| `plugin-sdk/provider-model-shared` | Gemeinsame Helfer für Provider-Modell-/Replay | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, gemeinsame Builder für Replay-Richtlinien, Helfer für Provider-Endpunkte und Helfer zur Modell-ID-Normalisierung |
|
||||
| `plugin-sdk/provider-catalog-shared` | Gemeinsame Helfer für Provider-Kataloge | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-onboard` | Patches für Provider-Onboarding | Helfer für Onboarding-Config |
|
||||
| `plugin-sdk/provider-http` | Helfer für Provider-HTTP | Generische Helfer für Provider-HTTP/Endpoint-Fähigkeiten |
|
||||
| `plugin-sdk/provider-web-fetch` | Helfer für Provider-Web-Fetch | Helfer für Registrierung/Cache von Web-Fetch-Providern |
|
||||
| `plugin-sdk/provider-web-search` | Helfer für Provider-Web-Suche | Helfer für Registrierung/Cache/Config von Web-Such-Providern |
|
||||
| `plugin-sdk/provider-tools` | Helfer für Kompatibilität von Provider-Tools/-Schemas | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini-Schema-Bereinigung + Diagnosefunktionen sowie xAI-Kompatibilitätshelfer wie `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-usage` | Helfer für Provider-Nutzung | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` und weitere Helfer für Provider-Nutzung |
|
||||
| `plugin-sdk/provider-stream` | Helfer für Provider-Stream-Wrapper | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, Stream-Wrapper-Typen und gemeinsame Wrapper-Helfer für Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/keyed-async-queue` | Geordnete Async-Queue | `KeyedAsyncQueue` |
|
||||
| `plugin-sdk/media-runtime` | Gemeinsame Medienhelfer | Helfer zum Abrufen/Transformieren/Speichern von Medien sowie Builder für Medien-Payloads |
|
||||
| `plugin-sdk/media-generation-runtime` | Gemeinsame Helfer für Mediengenerierung | Gemeinsame Helfer für Failover, Kandidatenauswahl und Meldungen bei fehlenden Modellen für Bild-/Video-/Musikgenerierung |
|
||||
| `plugin-sdk/media-understanding` | Helfer für Medienverständnis | Provider-Typen für Medienverständnis sowie providerseitige Exporte für Bild-/Audio-Helfer |
|
||||
| `plugin-sdk/text-runtime` | Gemeinsame Texthelfer | Entfernen assistentensichtbarer Texte, Helfer für Markdown-Rendering/Chunking/Tabellen, Redaktionshelfer, Helfer für Directive-Tags, Safe-Text-Utilities und verwandte Text-/Logging-Helfer |
|
||||
| `plugin-sdk/text-chunking` | Helfer für Text-Chunking | Helfer für ausgehendes Text-Chunking |
|
||||
| `plugin-sdk/speech` | Speech-Helfer | Provider-Typen für Speech sowie providerseitige Helfer für Direktiven, Registrierung und Validierung |
|
||||
| `plugin-sdk/speech-core` | Gemeinsamer Speech-Kern | Provider-Typen für Speech, Registrierung, Direktiven, Normalisierung |
|
||||
| `plugin-sdk/realtime-transcription` | Helfer für Realtime-Transkription | Provider-Typen und Registrierungshelfer |
|
||||
| `plugin-sdk/realtime-voice` | Helfer für Realtime-Voice | Provider-Typen und Registrierungshelfer |
|
||||
| `plugin-sdk/image-generation-core` | Gemeinsamer Kern für Bildgenerierung | Helfer für Typen, Failover, Authentifizierung und Registrierung der Bildgenerierung |
|
||||
| `plugin-sdk/music-generation` | Helfer für Musikgenerierung | Provider-/Request-/Result-Typen für Musikgenerierung |
|
||||
| `plugin-sdk/music-generation-core` | Gemeinsamer Kern für Musikgenerierung | Typen für Musikgenerierung, Failover-Helfer, Provider-Lookup und Parsing von Model-Refs |
|
||||
| `plugin-sdk/video-generation` | Helfer für Videogenerierung | Provider-/Request-/Result-Typen für Videogenerierung |
|
||||
| `plugin-sdk/video-generation-core` | Gemeinsamer Kern für Videogenerierung | Typen für Videogenerierung, Failover-Helfer, Provider-Lookup und Parsing von Model-Refs |
|
||||
| `plugin-sdk/interactive-runtime` | Helfer für interaktive Antworten | Normalisierung/Reduktion interaktiver Antwort-Payloads |
|
||||
| `plugin-sdk/channel-config-primitives` | Primitive für Channel-Config | Schmale Primitive für Channel-Config-Schemata |
|
||||
| `plugin-sdk/channel-config-writes` | Helfer zum Schreiben von Channel-Config | Helfer zur Autorisierung von Channel-Config-Schreibvorgängen |
|
||||
| `plugin-sdk/channel-plugin-common` | Gemeinsames Channel-Präludium | Exporte des gemeinsamen Channel-Plugin-Präludiums |
|
||||
| `plugin-sdk/channel-status` | Helfer für Channel-Status | Gemeinsame Helfer für Snapshots/Zusammenfassungen des Channel-Status |
|
||||
| `plugin-sdk/allowlist-config-edit` | Helfer für Allowlist-Config | Helfer zum Bearbeiten/Lesen von Allowlist-Config |
|
||||
| `plugin-sdk/group-access` | Helfer für Gruppenzugriff | Gemeinsame Helfer für Entscheidungen zum Gruppenzugriff |
|
||||
| `plugin-sdk/direct-dm` | Helfer für direkte DMs | Gemeinsame Helfer für Authentifizierung/Guards bei direkten DMs |
|
||||
| `plugin-sdk/extension-shared` | Gemeinsame Helfer für Erweiterungen | Primitive Helfer für passive Channels/Status |
|
||||
| `plugin-sdk/webhook-targets` | Helfer für Webhook-Ziele | Registry für Webhook-Ziele und Helfer für Route-Installation |
|
||||
| `plugin-sdk/webhook-path` | Helfer für Webhook-Pfade | Helfer zur Normalisierung von Webhook-Pfaden |
|
||||
| `plugin-sdk/web-media` | Gemeinsame Helfer für Web-Medien | Helfer zum Laden entfernter/lokaler Medien |
|
||||
| `plugin-sdk/zod` | Zod-Re-Export | Re-exportiertes `zod` für Plugin-SDK-Konsumenten |
|
||||
| `plugin-sdk/memory-core` | Gebündelte Helfer für memory-core | Helper-Oberfläche für Memory-Manager/Config/Datei/CLI |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Laufzeit-Fassade der Memory-Engine | Laufzeit-Fassade für Memory-Index/Suche |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Host-Foundation-Engine für Memory | Exporte der Host-Foundation-Engine für Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Host-Embedding-Engine für Memory | Exporte der Host-Embedding-Engine für Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Host-QMD-Engine für Memory | Exporte der Host-QMD-Engine für Memory |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Host-Storage-Engine für Memory | Exporte der Host-Storage-Engine für Memory |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Multimodale Host-Helfer für Memory | Multimodale Host-Helfer für Memory |
|
||||
| `plugin-sdk/memory-core-host-query` | Host-Query-Helfer für Memory | Host-Query-Helfer für Memory |
|
||||
| `plugin-sdk/memory-core-host-secret` | Host-Helfer für Geheimnisse in Memory | Host-Helfer für Geheimnisse in Memory |
|
||||
| `plugin-sdk/memory-core-host-events` | Host-Helfer für Event-Journale in Memory | Host-Helfer für Event-Journale in Memory |
|
||||
| `plugin-sdk/memory-core-host-status` | Host-Helfer für Status in Memory | Host-Helfer für Status in Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | Host-CLI-Laufzeit für Memory | Host-CLI-Laufzeithelfer für Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Host-Core-Laufzeit für Memory | Host-Core-Laufzeithelfer für Memory |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Host-Datei-/Laufzeithelfer für Memory | Host-Datei-/Laufzeithelfer für Memory |
|
||||
| `plugin-sdk/memory-host-core` | Alias für Host-Core-Laufzeit von Memory | Anbieterneutraler Alias für Host-Core-Laufzeithelfer von Memory |
|
||||
| `plugin-sdk/memory-host-events` | Alias für Host-Event-Journal von Memory | Anbieterneutraler Alias für Host-Helfer des Event-Journals von Memory |
|
||||
| `plugin-sdk/memory-host-files` | Alias für Host-Datei-/Laufzeit von Memory | Anbieterneutraler Alias für Host-Datei-/Laufzeithelfer von Memory |
|
||||
| `plugin-sdk/memory-host-markdown` | Helfer für verwaltetes Markdown | Gemeinsame Helfer für verwaltetes Markdown bei Memory-nahen Plugins |
|
||||
| `plugin-sdk/memory-host-search` | Fassade für aktive Memory-Suche | Lazy Runtime-Fassade des Search-Managers für aktives Memory |
|
||||
| `plugin-sdk/memory-host-status` | Alias für Host-Status von Memory | Anbieterneutraler Alias für Host-Statushelfer von Memory |
|
||||
| `plugin-sdk/memory-lancedb` | Gebündelte Helfer für memory-lancedb | Helper-Oberfläche für memory-lancedb |
|
||||
| `plugin-sdk/testing` | Test-Utilities | Test-Helfer und Mocks |
|
||||
</Accordion>
|
||||
|
||||
Diese Tabelle ist absichtlich die häufige Migrations-Teilmenge, nicht die vollständige
|
||||
SDK-Oberfläche. Die vollständige Liste mit mehr als 200 Einstiegspunkten befindet sich in
|
||||
`scripts/lib/plugin-sdk-entrypoints.json`.
|
||||
Diese Tabelle ist bewusst die übliche Migrations-Teilmenge und nicht die vollständige SDK-Oberfläche. Die vollständige Liste mit über 200 Entry-Points befindet sich in `scripts/lib/plugin-sdk-entrypoints.json`.
|
||||
|
||||
Diese Liste enthält weiterhin einige Helper-Seams für gebündelte Plugins wie
|
||||
`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
|
||||
`plugin-sdk/zalo-setup` und `plugin-sdk/matrix*`. Diese bleiben für die Wartung
|
||||
gebündelter Plugins und aus Kompatibilitätsgründen exportiert, werden aber absichtlich
|
||||
nicht in der Tabelle häufiger Migrationen aufgeführt und sind kein empfohlenes Ziel für
|
||||
neuen Plugin-Code.
|
||||
Diese Liste enthält weiterhin einige Helper-Seams für gebündelte Plugins wie `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`, `plugin-sdk/zalo-setup` und `plugin-sdk/matrix*`. Diese bleiben für die Wartung gebündelter Plugins und zur Kompatibilität exportiert, werden jedoch bewusst aus der üblichen Migrationstabelle ausgelassen und sind nicht das empfohlene Ziel für neuen Plugin-Code.
|
||||
|
||||
Dieselbe Regel gilt für andere Familien gebündelter Hilfsfunktionen, wie:
|
||||
Dieselbe Regel gilt für andere Familien gebündelter Helfer wie:
|
||||
|
||||
- Browser-Support-Hilfsfunktionen: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
|
||||
- Browser-Support-Helfer: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
|
||||
- Matrix: `plugin-sdk/matrix*`
|
||||
- LINE: `plugin-sdk/line*`
|
||||
- IRC: `plugin-sdk/irc*`
|
||||
- gebündelte Helper-/Plugin-Oberflächen wie `plugin-sdk/googlechat`,
|
||||
- gebündelte Helfer-/Plugin-Oberflächen wie `plugin-sdk/googlechat`,
|
||||
`plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`,
|
||||
`plugin-sdk/mattermost*`, `plugin-sdk/msteams`,
|
||||
`plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`,
|
||||
@ -330,22 +308,18 @@ Dieselbe Regel gilt für andere Familien gebündelter Hilfsfunktionen, wie:
|
||||
`plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`,
|
||||
`plugin-sdk/thread-ownership` und `plugin-sdk/voice-call`
|
||||
|
||||
`plugin-sdk/github-copilot-token` stellt derzeit die schmale
|
||||
Token-Helper-Oberfläche `DEFAULT_COPILOT_API_BASE_URL`,
|
||||
`deriveCopilotApiBaseUrlFromToken` und `resolveCopilotApiToken` bereit.
|
||||
`plugin-sdk/github-copilot-token` stellt derzeit die schmale Token-Helferoberfläche `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` und `resolveCopilotApiToken` bereit.
|
||||
|
||||
Verwenden Sie den schmalsten Import, der zur Aufgabe passt. Wenn Sie keinen Export finden können,
|
||||
prüfen Sie den Quellcode unter `src/plugin-sdk/` oder fragen Sie in Discord.
|
||||
Verwenden Sie den schmalsten Import, der zur Aufgabe passt. Wenn Sie einen Export nicht finden können, prüfen Sie den Quellcode unter `src/plugin-sdk/` oder fragen Sie in Discord.
|
||||
|
||||
## Zeitplan für die Entfernung
|
||||
|
||||
| Wann | Was passiert |
|
||||
| --- | --- |
|
||||
| **Jetzt** | Veraltete Oberflächen geben Runtime-Warnungen aus |
|
||||
| **Nächste Hauptversion** | Veraltete Oberflächen werden entfernt; Plugins, die sie noch verwenden, schlagen fehl |
|
||||
| ---------------------- | ----------------------------------------------------------------------- |
|
||||
| **Jetzt** | Veraltete Oberflächen geben Laufzeitwarnungen aus |
|
||||
| **Nächste Hauptversion** | Veraltete Oberflächen werden entfernt; Plugins, die sie weiterhin verwenden, schlagen fehl |
|
||||
|
||||
Alle Core-Plugins wurden bereits migriert. Externe Plugins sollten vor
|
||||
der nächsten Hauptversion migrieren.
|
||||
Alle Kern-Plugins wurden bereits migriert. Externe Plugins sollten vor der nächsten Hauptversion migrieren.
|
||||
|
||||
## Warnungen vorübergehend unterdrücken
|
||||
|
||||
@ -356,13 +330,13 @@ OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
|
||||
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
|
||||
```
|
||||
|
||||
Dies ist eine vorübergehende Notlösung, keine dauerhafte Lösung.
|
||||
Dies ist ein vorübergehender Notausgang, keine dauerhafte Lösung.
|
||||
|
||||
## Verwandt
|
||||
## Verwandte Themen
|
||||
|
||||
- [Erste Schritte](/de/plugins/building-plugins) — Ihr erstes Plugin erstellen
|
||||
- [SDK Overview](/de/plugins/sdk-overview) — vollständige Referenz für Subpath-Imports
|
||||
- [Channel Plugins](/de/plugins/sdk-channel-plugins) — Channel-Plugins erstellen
|
||||
- [Provider Plugins](/de/plugins/sdk-provider-plugins) — Provider-Plugins erstellen
|
||||
- [Plugin Internals](/de/plugins/architecture) — tiefer Einblick in die Architektur
|
||||
- [Plugin Manifest](/de/plugins/manifest) — Referenz zum Manifest-Schema
|
||||
- [Erste Schritte](/de/plugins/building-plugins) — Erstellen Sie Ihr erstes Plugin
|
||||
- [SDK-Überblick](/de/plugins/sdk-overview) — vollständige Referenz für Subpath-Imports
|
||||
- [Channel-Plugins](/de/plugins/sdk-channel-plugins) — Erstellen von Channel-Plugins
|
||||
- [Provider-Plugins](/de/plugins/sdk-provider-plugins) — Erstellen von Provider-Plugins
|
||||
- [Plugin-Interna](/de/plugins/architecture) — detaillierter Einblick in die Architektur
|
||||
- [Plugin-Manifest](/de/plugins/manifest) — Referenz für das Manifest-Schema
|
||||
|
||||
@ -1,16 +1,16 @@
|
||||
---
|
||||
read_when:
|
||||
- Sie müssen wissen, aus welchem SDK-Subpath Sie importieren sollen
|
||||
- Sie möchten eine Referenz für alle Registrierungsmethoden auf OpenClawPluginApi
|
||||
- Sie suchen einen bestimmten SDK-Export
|
||||
- Sie müssen wissen, aus welchem SDK-Subpath importiert werden soll
|
||||
- Sie möchten eine Referenz für alle Registrierungsmethoden in OpenClawPluginApi
|
||||
- Sie schlagen einen bestimmten SDK-Export nach
|
||||
sidebarTitle: SDK Overview
|
||||
summary: Import-Map, Referenz der Registrierungs-API und SDK-Architektur
|
||||
summary: Import-Map, Referenz zur Registrierungs-API und SDK-Architektur
|
||||
title: Überblick über das Plugin SDK
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:10:48Z"
|
||||
generated_at: "2026-04-06T06:22:17Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: d801641f26f39dc21490d2a69a337ff1affb147141360916b8b58a267e9f822a
|
||||
source_hash: acd2887ef52c66b2f234858d812bb04197ecd0bfb3e4f7bf3622f8fdc765acad
|
||||
source_path: plugins/sdk-overview.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -18,42 +18,43 @@ x-i18n:
|
||||
# Überblick über das Plugin SDK
|
||||
|
||||
Das Plugin SDK ist der typisierte Vertrag zwischen Plugins und dem Core. Diese Seite ist die
|
||||
Referenz dafür, **was Sie importieren** und **was Sie registrieren können**.
|
||||
Referenz dafür, **was importiert werden soll** und **was Sie registrieren können**.
|
||||
|
||||
<Tip>
|
||||
**Suchen Sie eine Schritt-für-Schritt-Anleitung?**
|
||||
- Erstes Plugin? Beginnen Sie mit [Getting Started](/de/plugins/building-plugins)
|
||||
- Kanal-Plugin? Siehe [Channel Plugins](/de/plugins/sdk-channel-plugins)
|
||||
**Suchen Sie nach einer Schritt-für-Schritt-Anleitung?**
|
||||
- Erstes Plugin? Beginnen Sie mit [Erste Schritte](/de/plugins/building-plugins)
|
||||
- Channel-Plugin? Siehe [Channel Plugins](/de/plugins/sdk-channel-plugins)
|
||||
- Provider-Plugin? Siehe [Provider Plugins](/de/plugins/sdk-provider-plugins)
|
||||
</Tip>
|
||||
|
||||
## Import-Konvention
|
||||
## Importkonvention
|
||||
|
||||
Importieren Sie immer aus einem bestimmten Subpath:
|
||||
Importieren Sie immer aus einem spezifischen Subpath:
|
||||
|
||||
```typescript
|
||||
import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
|
||||
import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
|
||||
```
|
||||
|
||||
Jeder Subpath ist ein kleines, in sich abgeschlossenes Modul. Das hält den Start schnell und
|
||||
verhindert Probleme mit zirkulären Abhängigkeiten. Für kanalbezogene Entry-/Build-Helfer
|
||||
bevorzugen Sie `openclaw/plugin-sdk/channel-core`; verwenden Sie `openclaw/plugin-sdk/core` für
|
||||
die breitere Sammeloberfläche und gemeinsame Hilfsfunktionen wie
|
||||
Jeder Subpath ist ein kleines, in sich geschlossenes Modul. Das hält den Start schnell und
|
||||
verhindert Probleme mit zirkulären Abhängigkeiten. Für kanalbezogene Entry-/Build-Helper
|
||||
bevorzugen Sie `openclaw/plugin-sdk/channel-core`; verwenden Sie `openclaw/plugin-sdk/core`
|
||||
für die breitere Oberflächen-API und gemeinsam genutzte Helper wie
|
||||
`buildChannelConfigSchema`.
|
||||
|
||||
Fügen Sie keine providerbenannten Convenience-Schnittstellen hinzu und verlassen Sie sich nicht auf
|
||||
solche wie `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
|
||||
Fügen Sie keine nach Providern benannten Convenience-Seams hinzu und machen Sie sich nicht von ihnen abhängig, wie etwa
|
||||
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
|
||||
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp` oder
|
||||
kanalgebrandete Hilfs-Schnittstellen. Gebündelte Plugins sollten generische
|
||||
SDK-Subpaths innerhalb ihrer eigenen `api.ts`- oder `runtime-api.ts`-Barrels zusammensetzen, und der Core
|
||||
kanalmarkenspezifischen Helper-Seams. Gebündelte Plugins sollten generische
|
||||
SDK-Subpaths in ihren eigenen `api.ts`- oder `runtime-api.ts`-Barrels zusammensetzen, und der Core
|
||||
sollte entweder diese pluginlokalen Barrels verwenden oder einen schmalen generischen SDK-
|
||||
Vertrag hinzufügen, wenn der Bedarf wirklich kanalübergreifend ist.
|
||||
|
||||
Die generierte Export-Map enthält weiterhin eine kleine Menge an Hilfs-Schnittstellen für gebündelte Plugins,
|
||||
wie `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
|
||||
Die generierte Export-Map enthält weiterhin eine kleine Gruppe von Helper-
|
||||
Seams für gebündelte Plugins wie `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
|
||||
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` und `plugin-sdk/matrix*`. Diese
|
||||
Subpaths existieren nur für die Wartung und Kompatibilität gebündelter Plugins; sie werden absichtlich aus der allgemeinen Tabelle unten ausgelassen und sind nicht der empfohlene
|
||||
Subpaths existieren nur für die Wartung gebündelter Plugins und für Kompatibilität; sie werden
|
||||
in der allgemeinen Tabelle unten bewusst ausgelassen und sind nicht der empfohlene
|
||||
Importpfad für neue Drittanbieter-Plugins.
|
||||
|
||||
## Subpath-Referenz
|
||||
@ -61,11 +62,11 @@ Importpfad für neue Drittanbieter-Plugins.
|
||||
Die am häufigsten verwendeten Subpaths, nach Zweck gruppiert. Die generierte vollständige Liste von
|
||||
mehr als 200 Subpaths befindet sich in `scripts/lib/plugin-sdk-entrypoints.json`.
|
||||
|
||||
Reservierte Hilfs-Subpaths für gebündelte Plugins erscheinen weiterhin in dieser generierten Liste.
|
||||
Reservierte Helper-Subpaths für gebündelte Plugins erscheinen weiterhin in dieser generierten Liste.
|
||||
Behandeln Sie diese als Implementierungsdetail-/Kompatibilitätsoberflächen, sofern eine Dokumentationsseite
|
||||
nicht ausdrücklich eine davon als öffentlich hervorhebt.
|
||||
nicht ausdrücklich einen davon als öffentlich hervorhebt.
|
||||
|
||||
### Plugin-Entry
|
||||
### Plugin-Einstiegspunkt
|
||||
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
@ -75,208 +76,216 @@ nicht ausdrücklich eine davon als öffentlich hervorhebt.
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Kanal-Subpaths">
|
||||
<Accordion title="Channel-Subpaths">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
|
||||
| `plugin-sdk/config-schema` | Root-`openclaw.json`-Zod-Schema-Export (`OpenClawSchema`) |
|
||||
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, plus `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/setup` | Gemeinsame Hilfsfunktionen für Einrichtungsassistenten, Allowlist-Eingabeaufforderungen, Builder für Einrichtungsstatus |
|
||||
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, sowie `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
|
||||
| `plugin-sdk/setup` | Gemeinsam genutzte Setup-Wizard-Helper, Allowlist-Prompts, Builder für Setup-Status |
|
||||
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
|
||||
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
|
||||
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
|
||||
| `plugin-sdk/account-core` | Hilfsfunktionen für Multi-Account-Konfiguration/Aktions-Gates, Hilfsfunktionen für Fallbacks auf Standardkonten |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, Hilfsfunktionen zur Normalisierung von Konto-IDs |
|
||||
| `plugin-sdk/account-resolution` | Hilfsfunktionen für Konto-Lookup und Standard-Fallback |
|
||||
| `plugin-sdk/account-helpers` | Schmale Hilfsfunktionen für Kontolisten/Kontoaktionen |
|
||||
| `plugin-sdk/account-core` | Helper für Multi-Account-Konfigurations-/Action-Gates, Helper für den Fallback auf Standardkonten |
|
||||
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, Normalisierungs-Helper für Konto-IDs |
|
||||
| `plugin-sdk/account-resolution` | Konto-Lookup plus Helper für Standard-Fallback |
|
||||
| `plugin-sdk/account-helpers` | Schmale Helper für Kontolisten-/Kontoaktionen |
|
||||
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
|
||||
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
|
||||
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
|
||||
| `plugin-sdk/channel-config-schema` | Typen für Kanalkonfigurations-Schemas |
|
||||
| `plugin-sdk/telegram-command-config` | Hilfsfunktionen zur Normalisierung/Validierung benutzerdefinierter Telegram-Befehle mit Fallback auf gebündelten Vertrag |
|
||||
| `plugin-sdk/channel-config-schema` | Typen für Channel-Konfigurationsschemas |
|
||||
| `plugin-sdk/telegram-command-config` | Normalisierungs-/Validierungs-Helper für benutzerdefinierte Telegram-Befehle mit Fallback für gebündelte Verträge |
|
||||
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
|
||||
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
|
||||
| `plugin-sdk/inbound-envelope` | Gemeinsame Hilfsfunktionen für eingehende Routen und Envelope-Builder |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Gemeinsame Hilfsfunktionen zum Aufzeichnen und Verteilen eingehender Nachrichten |
|
||||
| `plugin-sdk/messaging-targets` | Hilfsfunktionen zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/outbound-media` | Gemeinsame Hilfsfunktionen zum Laden ausgehender Medien |
|
||||
| `plugin-sdk/outbound-runtime` | Hilfsfunktionen für ausgehende Identität/Sende-Delegation |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Hilfsfunktionen für Lifecycle und Adapter von Thread-Bindings |
|
||||
| `plugin-sdk/inbound-envelope` | Gemeinsam genutzte Helper für Inbound-Routen und Envelope-Builder |
|
||||
| `plugin-sdk/inbound-reply-dispatch` | Gemeinsam genutzte Helper zum Aufzeichnen und Weiterleiten eingehender Daten |
|
||||
| `plugin-sdk/messaging-targets` | Helper zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/outbound-media` | Gemeinsam genutzte Helper zum Laden ausgehender Medien |
|
||||
| `plugin-sdk/outbound-runtime` | Helper für ausgehende Identität/Sende-Delegation |
|
||||
| `plugin-sdk/thread-bindings-runtime` | Lifecycle- und Adapter-Helper für Thread-Bindings |
|
||||
| `plugin-sdk/agent-media-payload` | Legacy-Builder für Agent-Medien-Payloads |
|
||||
| `plugin-sdk/conversation-runtime` | Hilfsfunktionen für Konversations-/Thread-Binding, Pairing und konfigurierte Bindings |
|
||||
| `plugin-sdk/runtime-config-snapshot` | Hilfsfunktion für Laufzeit-Konfigurations-Snapshots |
|
||||
| `plugin-sdk/runtime-group-policy` | Hilfsfunktionen zur Auflösung von Gruppenrichtlinien zur Laufzeit |
|
||||
| `plugin-sdk/channel-status` | Gemeinsame Hilfsfunktionen für Snapshots/Zusammenfassungen des Kanalstatus |
|
||||
| `plugin-sdk/channel-config-primitives` | Schmale Primitive für Kanalkonfigurations-Schemas |
|
||||
| `plugin-sdk/channel-config-writes` | Hilfsfunktionen für die Autorisierung von Schreibvorgängen in Kanalkonfigurationen |
|
||||
| `plugin-sdk/channel-plugin-common` | Gemeinsame Prelude-Exporte für Kanal-Plugins |
|
||||
| `plugin-sdk/allowlist-config-edit` | Hilfsfunktionen zum Bearbeiten/Lesen von Allowlist-Konfigurationen |
|
||||
| `plugin-sdk/group-access` | Gemeinsame Hilfsfunktionen für Entscheidungen zum Gruppenzugriff |
|
||||
| `plugin-sdk/direct-dm` | Gemeinsame Hilfsfunktionen für Authentifizierung/Guards bei direkten DMs |
|
||||
| `plugin-sdk/interactive-runtime` | Hilfsfunktionen zur Normalisierung/Reduktion interaktiver Antwort-Payloads |
|
||||
| `plugin-sdk/channel-inbound` | Debounce-, Mention-Matching- und Envelope-Hilfsfunktionen |
|
||||
| `plugin-sdk/conversation-runtime` | Konversations-/Thread-Binding-, Pairing- und konfigurierte Binding-Helper |
|
||||
| `plugin-sdk/runtime-config-snapshot` | Helper für Runtime-Konfigurations-Snapshots |
|
||||
| `plugin-sdk/runtime-group-policy` | Helper zur Auflösung von Runtime-Gruppenrichtlinien |
|
||||
| `plugin-sdk/channel-status` | Gemeinsam genutzte Helper für Snapshots/Zusammenfassungen des Channel-Status |
|
||||
| `plugin-sdk/channel-config-primitives` | Schmale Primitive für Channel-Konfigurationsschemas |
|
||||
| `plugin-sdk/channel-config-writes` | Autorisierungs-Helper für Schreibvorgänge in Channel-Konfigurationen |
|
||||
| `plugin-sdk/channel-plugin-common` | Gemeinsam genutzte Prelude-Exporte für Channel-Plugins |
|
||||
| `plugin-sdk/allowlist-config-edit` | Helper zum Bearbeiten/Lesen von Allowlist-Konfigurationen |
|
||||
| `plugin-sdk/group-access` | Gemeinsam genutzte Entscheidungs-Helper für Gruppenzugriff |
|
||||
| `plugin-sdk/direct-dm` | Gemeinsam genutzte Auth-/Guard-Helper für direkte DMs |
|
||||
| `plugin-sdk/interactive-runtime` | Helper zur Normalisierung/Reduktion interaktiver Antwort-Payloads |
|
||||
| `plugin-sdk/channel-inbound` | Debounce-, Mention-Matching- und Envelope-Helper |
|
||||
| `plugin-sdk/channel-send-result` | Typen für Antwortergebnisse |
|
||||
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
|
||||
| `plugin-sdk/channel-targets` | Hilfsfunktionen zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/channel-contract` | Typen für Kanalverträge |
|
||||
| `plugin-sdk/channel-feedback` | Verdrahtung für Feedback/Reaktionen |
|
||||
| `plugin-sdk/channel-targets` | Helper zum Parsen/Abgleichen von Zielen |
|
||||
| `plugin-sdk/channel-contract` | Typen für Channel-Verträge |
|
||||
| `plugin-sdk/channel-feedback` | Verdrahtung von Feedback/Reaktionen |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Provider-Subpaths">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
|
||||
| `plugin-sdk/provider-setup` | Kuratierte Hilfsfunktionen für die Einrichtung lokaler/selbst gehosteter Provider |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Fokussierte Hilfsfunktionen für die Einrichtung selbst gehosteter OpenAI-kompatibler Provider |
|
||||
| `plugin-sdk/provider-auth-runtime` | Hilfsfunktionen zur Auflösung von API-Schlüsseln zur Laufzeit für Provider-Plugins |
|
||||
| `plugin-sdk/provider-auth-api-key` | Hilfsfunktionen für API-Schlüssel-Onboarding/Profilschreibvorgänge |
|
||||
| `plugin-sdk/provider-setup` | Kuratierte Setup-Helper für lokale/selbstgehostete Provider |
|
||||
| `plugin-sdk/self-hosted-provider-setup` | Fokussierte Setup-Helper für selbstgehostete OpenAI-kompatible Provider |
|
||||
| `plugin-sdk/provider-auth-runtime` | Runtime-Helper zur Auflösung von API-Schlüsseln für Provider-Plugins |
|
||||
| `plugin-sdk/provider-auth-api-key` | Helper für API-Key-Onboarding/Profilschreibvorgänge |
|
||||
| `plugin-sdk/provider-auth-result` | Standard-Builder für OAuth-Authentifizierungsergebnisse |
|
||||
| `plugin-sdk/provider-auth-login` | Gemeinsame Hilfsfunktionen für interaktive Anmeldung bei Provider-Plugins |
|
||||
| `plugin-sdk/provider-env-vars` | Hilfsfunktionen für die Suche nach Provider-Auth-Umgebungsvariablen |
|
||||
| `plugin-sdk/provider-auth-login` | Gemeinsam genutzte interaktive Login-Helper für Provider-Plugins |
|
||||
| `plugin-sdk/provider-env-vars` | Helper zum Lookup von Auth-Umgebungsvariablen für Provider |
|
||||
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile` |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, gemeinsame Builder für Replay-Richtlinien, Hilfsfunktionen für Provider-Endpoints und Model-ID-Normalisierung wie `normalizeNativeXaiModelId` |
|
||||
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, gemeinsam genutzte Replay-Policy-Builder, Helper für Provider-Endpunkte und Helper zur Normalisierung von Modell-IDs wie `normalizeNativeXaiModelId` |
|
||||
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
|
||||
| `plugin-sdk/provider-http` | Generische Hilfsfunktionen für HTTP-/Endpoint-Funktionen von Providern |
|
||||
| `plugin-sdk/provider-web-fetch` | Hilfsfunktionen zur Registrierung/Zwischenspeicherung von Web-Fetch-Providern |
|
||||
| `plugin-sdk/provider-web-search` | Hilfsfunktionen zur Registrierung/Zwischenspeicherung/Konfiguration von Websuch-Providern |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini-Schema-Bereinigung und -Diagnose sowie xAI-Kompatibilitätshelfer wie `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-http` | Generische Helper für HTTP-/Endpunkt-Fähigkeiten von Providern |
|
||||
| `plugin-sdk/provider-web-fetch` | Helper für Registrierung/Cache von Web-Fetch-Providern |
|
||||
| `plugin-sdk/provider-web-search` | Helper für Registrierung/Cache/Konfiguration von Web-Such-Providern |
|
||||
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, Gemini-Schema-Bereinigung plus Diagnostik und xAI-Kompatibilitäts-Helper wie `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
|
||||
| `plugin-sdk/provider-usage` | `fetchClaudeUsage` und Ähnliches |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, Typen für Stream-Wrapper sowie gemeinsame Wrapper-Hilfsfunktionen für Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/provider-onboard` | Hilfsfunktionen zum Patchen der Onboarding-Konfiguration |
|
||||
| `plugin-sdk/global-singleton` | Prozesslokale Hilfsfunktionen für Singletons/Maps/Caches |
|
||||
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, Stream-Wrapper-Typen und gemeinsam genutzte Wrapper-Helper für Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
|
||||
| `plugin-sdk/provider-onboard` | Helper zum Patchen der Onboarding-Konfiguration |
|
||||
| `plugin-sdk/global-singleton` | Prozesslokale Singleton-/Map-/Cache-Helper |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Auth- und Sicherheits-Subpaths">
|
||||
<Accordion title="Subpaths für Auth und Sicherheit">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, Hilfsfunktionen für Befehlsregister, Hilfsfunktionen für Sender-Autorisierung |
|
||||
| `plugin-sdk/approval-auth-runtime` | Hilfsfunktionen zur Auflösung von Genehmigern und für Same-Chat-Aktionsauthentifizierung |
|
||||
| `plugin-sdk/approval-client-runtime` | Hilfsfunktionen für native Exec-Genehmigungsprofile/-filter |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Adapter für native Genehmigungsfunktionen/Zustellung |
|
||||
| `plugin-sdk/approval-native-runtime` | Hilfsfunktionen für native Genehmigungsziele und Konto-Bindings |
|
||||
| `plugin-sdk/approval-reply-runtime` | Hilfsfunktionen für Antwort-Payloads bei Exec-/Plugin-Genehmigungen |
|
||||
| `plugin-sdk/command-auth-native` | Native Befehlsauthentifizierung und Hilfsfunktionen für native Sitzungsziele |
|
||||
| `plugin-sdk/command-detection` | Gemeinsame Hilfsfunktionen zur Befehlserkennung |
|
||||
| `plugin-sdk/command-surface` | Hilfsfunktionen zur Normalisierung von Befehlsinhalten und Befehlsoberflächen |
|
||||
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, Helper für Befehlsregister, Helper zur Sender-Autorisierung |
|
||||
| `plugin-sdk/approval-auth-runtime` | Helper zur Auflösung von Genehmigenden und zur Action-Auth im selben Chat |
|
||||
| `plugin-sdk/approval-client-runtime` | Helper für native Exec-Genehmigungsprofile/-filter |
|
||||
| `plugin-sdk/approval-delivery-runtime` | Native Adapter für Genehmigungsfähigkeiten/-zustellung |
|
||||
| `plugin-sdk/approval-native-runtime` | Native Helper für Genehmigungsziele und Kontobindung |
|
||||
| `plugin-sdk/approval-reply-runtime` | Helper für Exec-/Plugin-Genehmigungs-Antwort-Payloads |
|
||||
| `plugin-sdk/command-auth-native` | Native Befehlsauthentifizierung plus native Session-Ziel-Helper |
|
||||
| `plugin-sdk/command-detection` | Gemeinsam genutzte Helper zur Befehlserkennung |
|
||||
| `plugin-sdk/command-surface` | Helper für Befehls-Body-Normalisierung und Befehlsoberfläche |
|
||||
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
|
||||
| `plugin-sdk/security-runtime` | Gemeinsame Hilfsfunktionen für Vertrauen, DM-Gating, externe Inhalte und Secret-Erfassung |
|
||||
| `plugin-sdk/ssrf-policy` | Hilfsfunktionen für Host-Allowlists und SSRF-Richtlinien für private Netzwerke |
|
||||
| `plugin-sdk/ssrf-runtime` | Hilfsfunktionen für Pinned-Dispatcher, SSRF-geschützten Fetch und SSRF-Richtlinien |
|
||||
| `plugin-sdk/secret-input` | Hilfsfunktionen zum Parsen von Secret-Eingaben |
|
||||
| `plugin-sdk/webhook-ingress` | Hilfsfunktionen für Webhook-Anfragen/Ziele |
|
||||
| `plugin-sdk/webhook-request-guards` | Hilfsfunktionen für Größe/Timeout von Request-Bodies |
|
||||
| `plugin-sdk/security-runtime` | Gemeinsam genutzte Helper für Vertrauensmodell, DM-Gating, externe Inhalte und Secret-Erfassung |
|
||||
| `plugin-sdk/ssrf-policy` | Helper für Host-Allowlists und SSRF-Richtlinien für private Netzwerke |
|
||||
| `plugin-sdk/ssrf-runtime` | Helper für Pinned Dispatcher, SSRF-geschütztes Fetch und SSRF-Richtlinien |
|
||||
| `plugin-sdk/secret-input` | Helper zum Parsen von Secret-Eingaben |
|
||||
| `plugin-sdk/webhook-ingress` | Helper für Webhook-Anfragen/-Ziele |
|
||||
| `plugin-sdk/webhook-request-guards` | Helper für Body-Größe/Timeout von Anfragen |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Laufzeit- und Storage-Subpaths">
|
||||
<Accordion title="Subpaths für Runtime und Speicher">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/runtime` | Breite Hilfsfunktionen für Laufzeit, Logging, Backup, Plugin-Installation |
|
||||
| `plugin-sdk/runtime-env` | Schmale Hilfsfunktionen für Laufzeitumgebung, Logger, Timeout, Retry und Backoff |
|
||||
| `plugin-sdk/runtime` | Breite Runtime-/Logging-/Backup-/Plugin-Install-Helper |
|
||||
| `plugin-sdk/runtime-env` | Schmale Helper für Runtime-Umgebung, Logger, Timeout, Retry und Backoff |
|
||||
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
|
||||
| `plugin-sdk/plugin-runtime` | Gemeinsame Hilfsfunktionen für Plugin-Befehle/Hooks/HTTP/Interaktivität |
|
||||
| `plugin-sdk/hook-runtime` | Gemeinsame Hilfsfunktionen für Webhooks und interne Hook-Pipelines |
|
||||
| `plugin-sdk/lazy-runtime` | Hilfsfunktionen für verzögerte Laufzeitimporte/-Bindings wie `createLazyRuntimeModule`, `createLazyRuntimeMethod` und `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Hilfsfunktionen für Prozessausführung |
|
||||
| `plugin-sdk/cli-runtime` | Hilfsfunktionen für CLI-Formatierung, Warten und Versionen |
|
||||
| `plugin-sdk/gateway-runtime` | Hilfsfunktionen für Gateway-Client und Patches des Kanalstatus |
|
||||
| `plugin-sdk/config-runtime` | Hilfsfunktionen für Laden/Schreiben von Konfigurationen |
|
||||
| `plugin-sdk/telegram-command-config` | Normalisierung von Telegram-Befehlsnamen/-beschreibungen und Prüfungen auf Duplikate/Konflikte, auch wenn die gebündelte Telegram-Vertragsoberfläche nicht verfügbar ist |
|
||||
| `plugin-sdk/approval-runtime` | Hilfsfunktionen für Exec-/Plugin-Genehmigungen, Builder für Genehmigungsfunktionen, Auth-/Profil-Hilfsfunktionen, natives Routing/Laufzeit-Hilfsfunktionen |
|
||||
| `plugin-sdk/reply-runtime` | Gemeinsame Hilfsfunktionen für eingehende Nachrichten/Antwort-Laufzeit, Chunking, Dispatch, Heartbeat, Antwort-Planer |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Schmale Hilfsfunktionen für Antwort-Dispatch/Finalisierung |
|
||||
| `plugin-sdk/reply-history` | Gemeinsame Hilfsfunktionen für den Kurzfenster-Antwortverlauf wie `buildHistoryContext`, `recordPendingHistoryEntry` und `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/plugin-runtime` | Gemeinsam genutzte Helper für Plugin-Befehle/-Hooks/-HTTP/-Interaktivität |
|
||||
| `plugin-sdk/hook-runtime` | Gemeinsam genutzte Pipeline-Helper für Webhooks/interne Hooks |
|
||||
| `plugin-sdk/lazy-runtime` | Helper für Lazy-Runtime-Import/Binding wie `createLazyRuntimeModule`, `createLazyRuntimeMethod` und `createLazyRuntimeSurface` |
|
||||
| `plugin-sdk/process-runtime` | Prozess-Exec-Helper |
|
||||
| `plugin-sdk/cli-runtime` | Helper für CLI-Formatierung, Warten und Versionen |
|
||||
| `plugin-sdk/gateway-runtime` | Helper für Gateway-Client und Patches des Channel-Status |
|
||||
| `plugin-sdk/config-runtime` | Helper zum Laden/Schreiben von Konfigurationen |
|
||||
| `plugin-sdk/telegram-command-config` | Normalisierung von Telegram-Befehlsnamen/-beschreibungen sowie Prüfungen auf Duplikate/Konflikte, auch wenn die gebündelte Telegram-Vertragsoberfläche nicht verfügbar ist |
|
||||
| `plugin-sdk/approval-runtime` | Helper für Exec-/Plugin-Genehmigungen, Builder für Genehmigungsfähigkeiten, Auth-/Profil-Helper, native Routing-/Runtime-Helper |
|
||||
| `plugin-sdk/reply-runtime` | Gemeinsam genutzte Inbound-/Antwort-Runtime-Helper, Chunking, Dispatch, Heartbeat, Antwortplaner |
|
||||
| `plugin-sdk/reply-dispatch-runtime` | Schmale Helper für Reply-Dispatch/Finalisierung |
|
||||
| `plugin-sdk/reply-history` | Gemeinsam genutzte Helper für Antwortverlauf in kurzen Zeitfenstern wie `buildHistoryContext`, `recordPendingHistoryEntry` und `clearHistoryEntriesIfEnabled` |
|
||||
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
|
||||
| `plugin-sdk/reply-chunking` | Schmale Hilfsfunktionen für Text-/Markdown-Chunking |
|
||||
| `plugin-sdk/session-store-runtime` | Hilfsfunktionen für Sitzungsspeicherpfade und `updated-at` |
|
||||
| `plugin-sdk/state-paths` | Hilfsfunktionen für Pfade von State-/OAuth-Verzeichnissen |
|
||||
| `plugin-sdk/routing` | Hilfsfunktionen für Route-/Sitzungsschlüssel-/Konto-Bindings wie `resolveAgentRoute`, `buildAgentSessionKey` und `resolveDefaultAgentBoundAccountId` |
|
||||
| `plugin-sdk/status-helpers` | Gemeinsame Hilfsfunktionen für Statuszusammenfassungen von Kanal/Konto, Standardwerte für Laufzeitstatus und Metadaten von Problemen |
|
||||
| `plugin-sdk/target-resolver-runtime` | Gemeinsame Hilfsfunktionen zur Zielauflösung |
|
||||
| `plugin-sdk/string-normalization-runtime` | Hilfsfunktionen zur Slug-/String-Normalisierung |
|
||||
| `plugin-sdk/reply-chunking` | Schmale Helper für Text-/Markdown-Chunking |
|
||||
| `plugin-sdk/session-store-runtime` | Helper für Session-Store-Pfade und `updated-at` |
|
||||
| `plugin-sdk/state-paths` | Pfad-Helper für Status-/OAuth-Verzeichnisse |
|
||||
| `plugin-sdk/routing` | Helper für Routen-/Session-Key-/Kontobindung wie `resolveAgentRoute`, `buildAgentSessionKey` und `resolveDefaultAgentBoundAccountId` |
|
||||
| `plugin-sdk/status-helpers` | Gemeinsam genutzte Helper für Zusammenfassungen des Channel-/Kontostatus, Runtime-Status-Standards und Issue-Metadaten |
|
||||
| `plugin-sdk/target-resolver-runtime` | Gemeinsam genutzte Helper zur Zielauflösung |
|
||||
| `plugin-sdk/string-normalization-runtime` | Helper zur Slug-/String-Normalisierung |
|
||||
| `plugin-sdk/request-url` | String-URLs aus fetch-/request-ähnlichen Eingaben extrahieren |
|
||||
| `plugin-sdk/run-command` | Zeitgesteuerter Command-Runner mit normalisierten stdout-/stderr-Ergebnissen |
|
||||
| `plugin-sdk/run-command` | Zeitgesteuerter Befehlsrunner mit normalisierten stdout-/stderr-Ergebnissen |
|
||||
| `plugin-sdk/param-readers` | Allgemeine Reader für Tool-/CLI-Parameter |
|
||||
| `plugin-sdk/tool-send` | Kanonische Sendefelder für Ziele aus Tool-Argumenten extrahieren |
|
||||
| `plugin-sdk/temp-path` | Gemeinsame Hilfsfunktionen für temporäre Download-Pfade |
|
||||
| `plugin-sdk/logging-core` | Hilfsfunktionen für Subsystem-Logger und Schwärzung |
|
||||
| `plugin-sdk/markdown-table-runtime` | Hilfsfunktionen für Markdown-Tabellenmodi |
|
||||
| `plugin-sdk/json-store` | Kleine Hilfsfunktionen zum Lesen/Schreiben von JSON-Status |
|
||||
| `plugin-sdk/file-lock` | Wiederbetretbare Hilfsfunktionen für Dateisperren |
|
||||
| `plugin-sdk/persistent-dedupe` | Hilfsfunktionen für festplattenbasierte Dedupe-Caches |
|
||||
| `plugin-sdk/acp-runtime` | Hilfsfunktionen für ACP-Laufzeit/Sitzungen und Antwort-Dispatch |
|
||||
| `plugin-sdk/agent-config-primitives` | Schmale Primitive für Schemas der Agent-Laufzeitkonfiguration |
|
||||
| `plugin-sdk/boolean-param` | Loser Boolean-Parameter-Reader |
|
||||
| `plugin-sdk/dangerous-name-runtime` | Hilfsfunktionen zur Auflösung von Übereinstimmungen mit gefährlichen Namen |
|
||||
| `plugin-sdk/device-bootstrap` | Hilfsfunktionen für Device-Bootstrap und Pairing-Tokens |
|
||||
| `plugin-sdk/extension-shared` | Gemeinsame Primitive für passive Kanäle und Statushilfsfunktionen |
|
||||
| `plugin-sdk/models-provider-runtime` | Hilfsfunktionen für den `/models`-Befehl und Provider-Antworten |
|
||||
| `plugin-sdk/skill-commands-runtime` | Hilfsfunktionen zum Auflisten von Skill-Befehlen |
|
||||
| `plugin-sdk/native-command-registry` | Hilfsfunktionen zum Registrieren/Erstellen/Serialisieren nativer Befehle |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Hilfsfunktionen zur Erkennung von Z.AI-Endpoints |
|
||||
| `plugin-sdk/infra-runtime` | Hilfsfunktionen für Systemereignisse/Heartbeat |
|
||||
| `plugin-sdk/collection-runtime` | Kleine Hilfsfunktionen für begrenzte Caches |
|
||||
| `plugin-sdk/diagnostic-runtime` | Hilfsfunktionen für Diagnose-Flags und -Ereignisse |
|
||||
| `plugin-sdk/error-runtime` | Fehlergraph, Formatierung, gemeinsame Hilfsfunktionen zur Fehlerklassifikation, `isApprovalNotFoundError` |
|
||||
| `plugin-sdk/fetch-runtime` | Gewrappter Fetch sowie Hilfsfunktionen für Proxys und gepinnte Lookups |
|
||||
| `plugin-sdk/host-runtime` | Hilfsfunktionen zur Normalisierung von Hostnamen und SCP-Hosts |
|
||||
| `plugin-sdk/retry-runtime` | Hilfsfunktionen für Retry-Konfiguration und Retry-Runner |
|
||||
| `plugin-sdk/agent-runtime` | Hilfsfunktionen für Agent-Verzeichnisse, Identität und Workspaces |
|
||||
| `plugin-sdk/directory-runtime` | Konfigurationsgestützte Verzeichnisabfrage/-deduplizierung |
|
||||
| `plugin-sdk/tool-send` | Kanonische Send-Zielfelder aus Tool-Argumenten extrahieren |
|
||||
| `plugin-sdk/temp-path` | Gemeinsam genutzte Helper für temporäre Download-Pfade |
|
||||
| `plugin-sdk/logging-core` | Helper für Subsystem-Logger und Redaction |
|
||||
| `plugin-sdk/markdown-table-runtime` | Helper für Modi von Markdown-Tabellen |
|
||||
| `plugin-sdk/json-store` | Kleine Helper zum Lesen/Schreiben von JSON-Status |
|
||||
| `plugin-sdk/file-lock` | Re-entrant-Dateisperren-Helper |
|
||||
| `plugin-sdk/persistent-dedupe` | Helper für festplattenbasierte Dedupe-Caches |
|
||||
| `plugin-sdk/acp-runtime` | ACP-Runtime-/Session- und Reply-Dispatch-Helper |
|
||||
| `plugin-sdk/agent-config-primitives` | Schmale Primitive für Agent-Runtime-Konfigurationsschemas |
|
||||
| `plugin-sdk/boolean-param` | Toleranter Reader für boolesche Parameter |
|
||||
| `plugin-sdk/dangerous-name-runtime` | Helper zur Auflösung von Übereinstimmungen bei gefährlichen Namen |
|
||||
| `plugin-sdk/device-bootstrap` | Helper für Geräte-Bootstrap und Pairing-Tokens |
|
||||
| `plugin-sdk/extension-shared` | Gemeinsam genutzte Primitive für passive Channels und Status-Helper |
|
||||
| `plugin-sdk/models-provider-runtime` | Helper für `/models`-Befehle und Provider-Antworten |
|
||||
| `plugin-sdk/skill-commands-runtime` | Helper zum Auflisten von Skill-Befehlen |
|
||||
| `plugin-sdk/native-command-registry` | Native Helper für Befehlsregister/-Build/-Serialisierung |
|
||||
| `plugin-sdk/provider-zai-endpoint` | Helper zur Erkennung von Z.AI-Endpunkten |
|
||||
| `plugin-sdk/infra-runtime` | Helper für Systemereignisse/Heartbeat |
|
||||
| `plugin-sdk/collection-runtime` | Kleine Helper für begrenzte Caches |
|
||||
| `plugin-sdk/diagnostic-runtime` | Helper für Diagnose-Flags und -Ereignisse |
|
||||
| `plugin-sdk/error-runtime` | Fehlergraph, Formatierung, gemeinsam genutzte Helper zur Fehlerklassifizierung, `isApprovalNotFoundError` |
|
||||
| `plugin-sdk/fetch-runtime` | Helper für Wrapped Fetch, Proxy und Pinned Lookup |
|
||||
| `plugin-sdk/host-runtime` | Helper zur Normalisierung von Hostnamen und SCP-Hosts |
|
||||
| `plugin-sdk/retry-runtime` | Helper für Retry-Konfiguration und Retry-Runner |
|
||||
| `plugin-sdk/agent-runtime` | Helper für Agent-Verzeichnisse, -Identität und -Workspace |
|
||||
| `plugin-sdk/directory-runtime` | Konfigurationsgestützte Verzeichnisabfrage/Deduplizierung |
|
||||
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Funktions- und Test-Subpaths">
|
||||
<Accordion title="Subpaths für Fähigkeiten und Tests">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/media-runtime` | Gemeinsame Hilfsfunktionen zum Abrufen/Transformieren/Speichern von Medien sowie Builder für Medien-Payloads |
|
||||
| `plugin-sdk/media-understanding` | Typen für Media-Understanding-Provider sowie providerseitige Exporte für Bild-/Audio-Hilfsfunktionen |
|
||||
| `plugin-sdk/text-runtime` | Gemeinsame Hilfsfunktionen für Text/Markdown/Logging wie das Entfernen von für Assistants sichtbarem Text, Hilfsfunktionen für Markdown-Rendering/Chunking/Tabellen, Schwärzung, Directive-Tags und sichere Text-Utilities |
|
||||
| `plugin-sdk/text-chunking` | Hilfsfunktion für das Chunking ausgehender Texte |
|
||||
| `plugin-sdk/speech` | Typen für Sprach-Provider sowie providerseitige Hilfsfunktionen für Directives, Register und Validierung |
|
||||
| `plugin-sdk/speech-core` | Gemeinsame Typen für Sprach-Provider sowie Hilfsfunktionen für Register, Directives und Normalisierung |
|
||||
| `plugin-sdk/realtime-transcription` | Typen für Realtime-Transcription-Provider und Hilfsfunktionen für Register |
|
||||
| `plugin-sdk/realtime-voice` | Typen für Realtime-Voice-Provider und Hilfsfunktionen für Register |
|
||||
| `plugin-sdk/media-runtime` | Gemeinsam genutzte Helper zum Abrufen/Transformieren/Speichern von Medien sowie Builder für Medien-Payloads |
|
||||
| `plugin-sdk/media-generation-runtime` | Gemeinsam genutzte Failover-Helper für Mediengenerierung, Kandidatenauswahl und Meldungen für fehlende Modelle |
|
||||
| `plugin-sdk/media-understanding` | Typen für Media-Understanding-Provider sowie Provider-seitige Exporte für Bild-/Audio-Helper |
|
||||
| `plugin-sdk/text-runtime` | Gemeinsam genutzte Helper für Text/Markdown/Logging wie das Entfernen von für Assistenten sichtbarem Text, Helper für Markdown-Rendering/Chunking/Tabellen, Redaction-Helper, Directive-Tag-Helper und Safe-Text-Utilities |
|
||||
| `plugin-sdk/text-chunking` | Helper für Chunking ausgehender Texte |
|
||||
| `plugin-sdk/speech` | Typen für Speech-Provider sowie Provider-seitige Helper für Direktiven, Register und Validierung |
|
||||
| `plugin-sdk/speech-core` | Gemeinsam genutzte Typen, Register-, Direktiven- und Normalisierungs-Helper für Speech-Provider |
|
||||
| `plugin-sdk/realtime-transcription` | Typen für Realtime-Transcription-Provider und Register-Helper |
|
||||
| `plugin-sdk/realtime-voice` | Typen für Realtime-Voice-Provider und Register-Helper |
|
||||
| `plugin-sdk/image-generation` | Typen für Image-Generation-Provider |
|
||||
| `plugin-sdk/image-generation-core` | Gemeinsame Typen für Bildgenerierung, Failover, Authentifizierung und Hilfsfunktionen für Register |
|
||||
| `plugin-sdk/music-generation` | Typen für Music-Generation-Provider/Requests/Results |
|
||||
| `plugin-sdk/music-generation-core` | Gemeinsame Typen für Musikgenerierung, Failover-Hilfsfunktionen, Provider-Lookup und Parsing von Modellreferenzen |
|
||||
| `plugin-sdk/video-generation` | Typen für Video-Generation-Provider/Requests/Results |
|
||||
| `plugin-sdk/video-generation-core` | Gemeinsame Typen für Videoerzeugung, Failover-Hilfsfunktionen, Provider-Lookup und Parsing von Modellreferenzen |
|
||||
| `plugin-sdk/webhook-targets` | Hilfsfunktionen für Webhook-Zielregister und Routeninstallation |
|
||||
| `plugin-sdk/webhook-path` | Hilfsfunktionen zur Normalisierung von Webhook-Pfaden |
|
||||
| `plugin-sdk/web-media` | Gemeinsame Hilfsfunktionen zum Laden lokaler/entfernter Medien |
|
||||
| `plugin-sdk/zod` | Re-exportiertes `zod` für Nutzer des Plugin SDK |
|
||||
| `plugin-sdk/image-generation-core` | Gemeinsam genutzte Typen, Failover-, Auth- und Register-Helper für Bildgenerierung |
|
||||
| `plugin-sdk/music-generation` | Typen für Music-Generation-Provider/-Requests/-Ergebnisse |
|
||||
| `plugin-sdk/music-generation-core` | Gemeinsam genutzte Typen, Failover-Helper, Provider-Lookup und Parsing von Modellreferenzen für Musikgenerierung |
|
||||
| `plugin-sdk/video-generation` | Typen für Video-Generation-Provider/-Requests/-Ergebnisse |
|
||||
| `plugin-sdk/video-generation-core` | Gemeinsam genutzte Typen, Failover-Helper, Provider-Lookup und Parsing von Modellreferenzen für Videogenerierung |
|
||||
| `plugin-sdk/webhook-targets` | Webhook-Zielregister und Helper zur Routeninstallation |
|
||||
| `plugin-sdk/webhook-path` | Helper zur Normalisierung von Webhook-Pfaden |
|
||||
| `plugin-sdk/web-media` | Gemeinsam genutzte Helper zum Laden entfernter/lokaler Medien |
|
||||
| `plugin-sdk/zod` | Re-exportiertes `zod` für Plugin-SDK-Konsumenten |
|
||||
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Speicher-Subpaths">
|
||||
<Accordion title="Subpaths für Memory">
|
||||
| Subpath | Wichtige Exporte |
|
||||
| --- | --- |
|
||||
| `plugin-sdk/memory-core` | Gebündelte `memory-core`-Hilfsoberfläche für Manager-/Konfigurations-/Datei-/CLI-Hilfsfunktionen |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Laufzeit-Fassade für Memory-Index/Suche |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Exporte für die Foundation-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Exporte für die Embedding-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Exporte für die QMD-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Exporte für die Storage-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Hilfsfunktionen für multimodale Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-query` | Hilfsfunktionen für Memory-Host-Abfragen |
|
||||
| `plugin-sdk/memory-core-host-secret` | Hilfsfunktionen für Secrets des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-status` | Hilfsfunktionen für den Status des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | CLI-Laufzeit-Hilfsfunktionen für den Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Core-Laufzeit-Hilfsfunktionen für den Memory-Host |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Hilfsfunktionen für Dateien/Laufzeit des Memory-Hosts |
|
||||
| `plugin-sdk/memory-lancedb` | Gebündelte `memory-lancedb`-Hilfsoberfläche |
|
||||
| `plugin-sdk/memory-core` | Gebündelte Hilfsoberfläche von memory-core für Manager-/Konfigurations-/Datei-/CLI-Helper |
|
||||
| `plugin-sdk/memory-core-engine-runtime` | Runtime-Fassade für Memory-Index/Suche |
|
||||
| `plugin-sdk/memory-core-host-engine-foundation` | Exporte der Foundation-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-embeddings` | Exporte der Embedding-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-qmd` | Exporte der QMD-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-engine-storage` | Exporte der Storage-Engine des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-multimodal` | Multimodale Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-query` | Query-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-secret` | Secret-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-events` | Helper für Event-Journale des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-status` | Status-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-runtime-cli` | CLI-Runtime-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-runtime-core` | Core-Runtime-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-core-host-runtime-files` | Datei-/Runtime-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-host-core` | Herstellerneutraler Alias für Core-Runtime-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-host-events` | Herstellerneutraler Alias für Helper für Event-Journale des Memory-Hosts |
|
||||
| `plugin-sdk/memory-host-files` | Herstellerneutraler Alias für Datei-/Runtime-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-host-markdown` | Gemeinsam genutzte Managed-Markdown-Helper für memory-nahe Plugins |
|
||||
| `plugin-sdk/memory-host-search` | Aktive Memory-Runtime-Fassade für den Zugriff auf Search-Manager |
|
||||
| `plugin-sdk/memory-host-status` | Herstellerneutraler Alias für Status-Helper des Memory-Hosts |
|
||||
| `plugin-sdk/memory-lancedb` | Gebündelte Hilfsoberfläche von memory-lancedb |
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Reservierte gebündelte Hilfs-Subpaths">
|
||||
| Familie | Aktuelle Subpaths | Beabsichtigte Verwendung |
|
||||
<Accordion title="Reservierte Helper-Subpaths für gebündelte Plugins">
|
||||
| Family | Aktuelle Subpaths | Vorgesehene Verwendung |
|
||||
| --- | --- | --- |
|
||||
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Hilfsfunktionen für gebündelte Browser-Plugins (`browser-support` bleibt das Kompatibilitäts-Barrel) |
|
||||
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Hilfs-/Laufzeitoberfläche für das gebündelte Matrix-Plugin |
|
||||
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Hilfs-/Laufzeitoberfläche für das gebündelte LINE-Plugin |
|
||||
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Hilfsoberfläche für das gebündelte IRC-Plugin |
|
||||
| Kanalspezifische Hilfsfunktionen | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Gebündelte Kompatibilitäts-/Hilfs-Schnittstellen für Kanäle |
|
||||
| Auth-/pluginspezifische Hilfsfunktionen | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Gebündelte Hilfs-Schnittstellen für Funktionen/Plugins; `plugin-sdk/github-copilot-token` exportiert derzeit `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` und `resolveCopilotApiToken` |
|
||||
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Support-Helper für das gebündelte Browser-Plugin (`browser-support` bleibt das Kompatibilitäts-Barrel) |
|
||||
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Helper-/Runtime-Oberfläche des gebündelten Matrix-Plugins |
|
||||
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Helper-/Runtime-Oberfläche des gebündelten LINE-Plugins |
|
||||
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Hilfsoberfläche des gebündelten IRC-Plugins |
|
||||
| Channelspezifische Helper | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Kompatibilitäts-/Helper-Seams für gebündelte Channels |
|
||||
| Auth-/pluginspezifische Helper | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Helper-Seams für gebündelte Features/Plugins; `plugin-sdk/github-copilot-token` exportiert derzeit `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` und `resolveCopilotApiToken` |
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
@ -285,55 +294,57 @@ nicht ausdrücklich eine davon als öffentlich hervorhebt.
|
||||
Der Callback `register(api)` erhält ein `OpenClawPluginApi`-Objekt mit diesen
|
||||
Methoden:
|
||||
|
||||
### Registrierung von Funktionen
|
||||
### Registrierung von Fähigkeiten
|
||||
|
||||
| Methode | Was registriert wird |
|
||||
| ------------------------------------------------ | ------------------------------- |
|
||||
| `api.registerProvider(...)` | Text-Inferenz (LLM) |
|
||||
| `api.registerChannel(...)` | Messaging-Kanal |
|
||||
| `api.registerSpeechProvider(...)` | Text-to-Speech- / STT-Synthese |
|
||||
| `api.registerRealtimeTranscriptionProvider(...)` | Streaming-Echtzeit-Transkription |
|
||||
| `api.registerRealtimeVoiceProvider(...)` | Duplex-Echtzeit-Sprachsitzungen |
|
||||
| `api.registerMediaUnderstandingProvider(...)` | Bild-/Audio-/Videoanalyse |
|
||||
| `api.registerImageGenerationProvider(...)` | Bildgenerierung |
|
||||
| `api.registerMusicGenerationProvider(...)` | Musikgenerierung |
|
||||
| `api.registerVideoGenerationProvider(...)` | Videoerzeugung |
|
||||
| `api.registerWebFetchProvider(...)` | Web-Fetch- / Scrape-Provider |
|
||||
| `api.registerWebSearchProvider(...)` | Websuche |
|
||||
| Methode | Was registriert wird |
|
||||
| ------------------------------------------------ | -------------------------------- |
|
||||
| `api.registerProvider(...)` | Textinferenz (LLM) |
|
||||
| `api.registerChannel(...)` | Messaging-Channel |
|
||||
| `api.registerSpeechProvider(...)` | Text-to-Speech- / STT-Synthese |
|
||||
| `api.registerRealtimeTranscriptionProvider(...)` | Streamende Realtime-Transkription |
|
||||
| `api.registerRealtimeVoiceProvider(...)` | Duplex-Realtime-Voice-Sitzungen |
|
||||
| `api.registerMediaUnderstandingProvider(...)` | Bild-/Audio-/Videoanalyse |
|
||||
| `api.registerImageGenerationProvider(...)` | Bildgenerierung |
|
||||
| `api.registerMusicGenerationProvider(...)` | Musikgenerierung |
|
||||
| `api.registerVideoGenerationProvider(...)` | Videogenerierung |
|
||||
| `api.registerWebFetchProvider(...)` | Web-Fetch-/Scrape-Provider |
|
||||
| `api.registerWebSearchProvider(...)` | Websuche |
|
||||
|
||||
### Tools und Befehle
|
||||
|
||||
| Methode | Was registriert wird |
|
||||
| ------------------------------- | ----------------------------------------------- |
|
||||
| Methode | Was registriert wird |
|
||||
| ------------------------------ | --------------------------------------------- |
|
||||
| `api.registerTool(tool, opts?)` | Agent-Tool (erforderlich oder `{ optional: true }`) |
|
||||
| `api.registerCommand(def)` | Benutzerdefinierter Befehl (umgeht das LLM) |
|
||||
| `api.registerCommand(def)` | Benutzerdefinierter Befehl (umgeht das LLM) |
|
||||
|
||||
### Infrastruktur
|
||||
|
||||
| Methode | Was registriert wird |
|
||||
| --------------------------------------------- | ------------------------ |
|
||||
| `api.registerHook(events, handler, opts?)` | Event-Hook |
|
||||
| `api.registerHttpRoute(params)` | Gateway-HTTP-Endpoint |
|
||||
| `api.registerGatewayMethod(name, handler)` | Gateway-RPC-Methode |
|
||||
| `api.registerCli(registrar, opts?)` | CLI-Unterbefehl |
|
||||
| `api.registerService(service)` | Hintergrunddienst |
|
||||
| `api.registerInteractiveHandler(registration)` | Interaktiver Handler |
|
||||
| Methode | Was registriert wird |
|
||||
| --------------------------------------------- | -------------------------------------- |
|
||||
| `api.registerHook(events, handler, opts?)` | Event-Hook |
|
||||
| `api.registerHttpRoute(params)` | Gateway-HTTP-Endpunkt |
|
||||
| `api.registerGatewayMethod(name, handler)` | Gateway-RPC-Methode |
|
||||
| `api.registerCli(registrar, opts?)` | CLI-Unterbefehl |
|
||||
| `api.registerService(service)` | Hintergrunddienst |
|
||||
| `api.registerInteractiveHandler(registration)` | Interaktiver Handler |
|
||||
| `api.registerMemoryPromptSupplement(builder)` | Additiver, memory-naher Prompt-Abschnitt |
|
||||
| `api.registerMemoryCorpusSupplement(adapter)` | Additiver Such-/Lese-Korpus für Memory |
|
||||
|
||||
Reservierte Core-Admin-Namespaces (`config.*`, `exec.approvals.*`, `wizard.*`,
|
||||
`update.*`) bleiben immer `operator.admin`, selbst wenn ein Plugin versucht, einen
|
||||
engeren Geltungsbereich für Gateway-Methoden zuzuweisen. Bevorzugen Sie pluginspezifische Präfixe für
|
||||
`update.*`) bleiben immer `operator.admin`, auch wenn ein Plugin versucht, einen
|
||||
engeren Scope für Gateway-Methoden zuzuweisen. Bevorzugen Sie pluginspezifische Präfixe für
|
||||
plugin-eigene Methoden.
|
||||
|
||||
### Registrierungsmetadaten für CLI
|
||||
### CLI-Registrierungsmetadaten
|
||||
|
||||
`api.registerCli(registrar, opts?)` akzeptiert zwei Arten von Top-Level-Metadaten:
|
||||
`api.registerCli(registrar, opts?)` akzeptiert zwei Arten von Metadaten auf oberster Ebene:
|
||||
|
||||
- `commands`: explizite Befehlswurzeln, die dem Registrar gehören
|
||||
- `descriptors`: Parse-Zeit-Befehlsdeskriptoren, die für Root-CLI-Hilfe,
|
||||
Routing und verzögerte Registrierung von Plugin-CLI verwendet werden
|
||||
- `descriptors`: Parse-Zeit-Befehlsdeskriptoren für Root-CLI-Hilfe,
|
||||
Routing und verzögerte Registrierung von Plugin-CLI
|
||||
|
||||
Wenn ein Plugin-Befehl im normalen Root-CLI-Pfad verzögert geladen bleiben soll,
|
||||
geben Sie `descriptors` an, die jede Top-Level-Befehlswurzel abdecken, die von diesem
|
||||
Wenn ein Plugin-Befehl im normalen Root-CLI-Pfad lazy geladen bleiben soll,
|
||||
geben Sie `descriptors` an, die jede Befehlswurzel auf oberster Ebene abdecken, die durch diesen
|
||||
Registrar bereitgestellt wird.
|
||||
|
||||
```typescript
|
||||
@ -346,7 +357,7 @@ api.registerCli(
|
||||
descriptors: [
|
||||
{
|
||||
name: "matrix",
|
||||
description: "Manage Matrix accounts, verification, devices, and profile state",
|
||||
description: "Matrix-Konten, Verifizierung, Geräte und Profilstatus verwalten",
|
||||
hasSubcommands: true,
|
||||
},
|
||||
],
|
||||
@ -354,50 +365,50 @@ api.registerCli(
|
||||
);
|
||||
```
|
||||
|
||||
Verwenden Sie `commands` allein nur dann, wenn Sie keine verzögerte Root-CLI-Registrierung benötigen.
|
||||
Dieser eager Kompatibilitätspfad wird weiterhin unterstützt, installiert jedoch keine
|
||||
deskriptorbasierten Platzhalter für verzögertes Laden zur Parse-Zeit.
|
||||
Verwenden Sie `commands` allein nur dann, wenn Sie keine lazy Registrierung der Root-CLI benötigen.
|
||||
Dieser eager Kompatibilitätspfad wird weiterhin unterstützt, aber er installiert keine
|
||||
descriptor-gestützten Platzhalter für verzögertes Laden zur Parse-Zeit.
|
||||
|
||||
### Exklusive Slots
|
||||
|
||||
| Methode | Was registriert wird |
|
||||
| ------------------------------------------ | ------------------------------------- |
|
||||
| `api.registerContextEngine(id, factory)` | Context Engine (jeweils nur eine aktiv) |
|
||||
| `api.registerContextEngine(id, factory)` | Kontext-Engine (jeweils nur eine aktiv) |
|
||||
| `api.registerMemoryPromptSection(builder)` | Builder für Memory-Prompt-Abschnitte |
|
||||
| `api.registerMemoryFlushPlan(resolver)` | Resolver für Memory-Flush-Pläne |
|
||||
| `api.registerMemoryRuntime(runtime)` | Adapter für Memory-Laufzeit |
|
||||
| `api.registerMemoryRuntime(runtime)` | Adapter für die Memory-Runtime |
|
||||
|
||||
### Memory-Embedding-Adapter
|
||||
|
||||
| Methode | Was registriert wird |
|
||||
| --------------------------------------------- | ----------------------------------------------------- |
|
||||
| Methode | Was registriert wird |
|
||||
| --------------------------------------------- | ---------------------------------------------------- |
|
||||
| `api.registerMemoryEmbeddingProvider(adapter)` | Memory-Embedding-Adapter für das aktive Plugin |
|
||||
|
||||
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` und
|
||||
`registerMemoryRuntime` sind exklusiv für Memory-Plugins.
|
||||
- `registerMemoryEmbeddingProvider` erlaubt dem aktiven Memory-Plugin, einen
|
||||
oder mehrere Embedding-Adapter-IDs zu registrieren (zum Beispiel `openai`, `gemini` oder eine benutzerdefinierte
|
||||
plugindefinierte ID).
|
||||
- Benutzerkonfiguration wie `agents.defaults.memorySearch.provider` und
|
||||
`agents.defaults.memorySearch.fallback` wird gegen diese registrierten
|
||||
oder mehrere Embedding-Adapter-IDs zu registrieren (zum Beispiel `openai`, `gemini` oder eine
|
||||
benutzerdefinierte, vom Plugin definierte ID).
|
||||
- Benutzerkonfigurationen wie `agents.defaults.memorySearch.provider` und
|
||||
`agents.defaults.memorySearch.fallback` werden gegen diese registrierten
|
||||
Adapter-IDs aufgelöst.
|
||||
|
||||
### Ereignisse und Lifecycle
|
||||
|
||||
| Methode | Was sie tut |
|
||||
| ------------------------------------------- | ---------------------------- |
|
||||
| `api.on(hookName, handler, opts?)` | Typisierter Lifecycle-Hook |
|
||||
| `api.onConversationBindingResolved(handler)` | Callback für Konversations-Binding |
|
||||
| Methode | Was sie macht |
|
||||
| -------------------------------------------- | ----------------------------- |
|
||||
| `api.on(hookName, handler, opts?)` | Typisierter Lifecycle-Hook |
|
||||
| `api.onConversationBindingResolved(handler)` | Callback für Konversationsbindung |
|
||||
|
||||
### Hook-Entscheidungssemantik
|
||||
|
||||
- `before_tool_call`: die Rückgabe von `{ block: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `before_tool_call`: die Rückgabe von `{ block: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `block`), nicht als Überschreibung.
|
||||
- `before_install`: die Rückgabe von `{ block: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `before_install`: die Rückgabe von `{ block: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `block`), nicht als Überschreibung.
|
||||
- `reply_dispatch`: die Rückgabe von `{ handled: true, ... }` ist final. Sobald ein Handler die Zustellung beansprucht, werden Handler mit niedrigerer Priorität und der Standardpfad für Model-Dispatch übersprungen.
|
||||
- `message_sending`: die Rückgabe von `{ cancel: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `message_sending`: die Rückgabe von `{ cancel: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `cancel`), nicht als Überschreibung.
|
||||
- `before_tool_call`: Die Rückgabe von `{ block: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `before_tool_call`: Die Rückgabe von `{ block: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `block`), nicht als Überschreibung.
|
||||
- `before_install`: Die Rückgabe von `{ block: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `before_install`: Die Rückgabe von `{ block: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `block`), nicht als Überschreibung.
|
||||
- `reply_dispatch`: Die Rückgabe von `{ handled: true, ... }` ist final. Sobald ein Handler den Dispatch übernimmt, werden Handler mit niedrigerer Priorität und der Standard-Model-Dispatch-Pfad übersprungen.
|
||||
- `message_sending`: Die Rückgabe von `{ cancel: true }` ist final. Sobald ein Handler dies setzt, werden Handler mit niedrigerer Priorität übersprungen.
|
||||
- `message_sending`: Die Rückgabe von `{ cancel: false }` wird als keine Entscheidung behandelt (wie das Weglassen von `cancel`), nicht als Überschreibung.
|
||||
|
||||
### Felder des API-Objekts
|
||||
|
||||
@ -407,13 +418,13 @@ deskriptorbasierten Platzhalter für verzögertes Laden zur Parse-Zeit.
|
||||
| `api.name` | `string` | Anzeigename |
|
||||
| `api.version` | `string?` | Plugin-Version (optional) |
|
||||
| `api.description` | `string?` | Plugin-Beschreibung (optional) |
|
||||
| `api.source` | `string` | Quellpfad des Plugins |
|
||||
| `api.rootDir` | `string?` | Root-Verzeichnis des Plugins (optional) |
|
||||
| `api.config` | `OpenClawConfig` | Aktueller Konfigurations-Snapshot (aktive In-Memory-Laufzeitaufnahme, wenn verfügbar) |
|
||||
| `api.source` | `string` | Plugin-Quellpfad |
|
||||
| `api.rootDir` | `string?` | Plugin-Root-Verzeichnis (optional) |
|
||||
| `api.config` | `OpenClawConfig` | Aktueller Konfigurations-Snapshot (aktiver In-Memory-Runtime-Snapshot, falls verfügbar) |
|
||||
| `api.pluginConfig` | `Record<string, unknown>` | Pluginspezifische Konfiguration aus `plugins.entries.<id>.config` |
|
||||
| `api.runtime` | `PluginRuntime` | [Runtime Helpers](/de/plugins/sdk-runtime) |
|
||||
| `api.logger` | `PluginLogger` | Scoped Logger (`debug`, `info`, `warn`, `error`) |
|
||||
| `api.registrationMode` | `PluginRegistrationMode` | Aktueller Lademodus; `"setup-runtime"` ist das schlanke Fenster vor vollständigem Entry bei Start/Einrichtung |
|
||||
| `api.runtime` | `PluginRuntime` | [Runtime-Helper](/de/plugins/sdk-runtime) |
|
||||
| `api.logger` | `PluginLogger` | Bereichsspezifischer Logger (`debug`, `info`, `warn`, `error`) |
|
||||
| `api.registrationMode` | `PluginRegistrationMode` | Aktueller Lademodus; `"setup-runtime"` ist das leichtgewichtige Start-/Setup-Fenster vor dem vollständigen Entry |
|
||||
| `api.resolvePath(input)` | `(string) => string` | Pfad relativ zum Plugin-Root auflösen |
|
||||
|
||||
## Interne Modulkonvention
|
||||
@ -422,49 +433,49 @@ Verwenden Sie innerhalb Ihres Plugins lokale Barrel-Dateien für interne Importe
|
||||
|
||||
```
|
||||
my-plugin/
|
||||
api.ts # Öffentliche Exporte für externe Nutzer
|
||||
runtime-api.ts # Nur interne Laufzeit-Exporte
|
||||
index.ts # Plugin-Entry-Point
|
||||
setup-entry.ts # Schlanker nur-Setup-Entry (optional)
|
||||
api.ts # Öffentliche Exporte für externe Konsumenten
|
||||
runtime-api.ts # Nur interne Runtime-Exporte
|
||||
index.ts # Plugin-Einstiegspunkt
|
||||
setup-entry.ts # Leichtgewichtiger, nur für Setup gedachter Einstiegspunkt (optional)
|
||||
```
|
||||
|
||||
<Warning>
|
||||
Importieren Sie Ihr eigenes Plugin in Produktionscode niemals über `openclaw/plugin-sdk/<your-plugin>`.
|
||||
Leiten Sie interne Importe über `./api.ts` oder
|
||||
Importieren Sie Ihr eigenes Plugin niemals über `openclaw/plugin-sdk/<your-plugin>`
|
||||
aus Produktionscode. Leiten Sie interne Importe über `./api.ts` oder
|
||||
`./runtime-api.ts`. Der SDK-Pfad ist nur der externe Vertrag.
|
||||
</Warning>
|
||||
|
||||
Fassadengeladene öffentliche Oberflächen gebündelter Plugins (`api.ts`, `runtime-api.ts`,
|
||||
`index.ts`, `setup-entry.ts` und ähnliche öffentliche Entry-Dateien) bevorzugen jetzt den
|
||||
aktiven Laufzeit-Konfigurations-Snapshot, wenn OpenClaw bereits läuft. Wenn noch kein Laufzeit-
|
||||
Öffentliche Oberflächen facadengeladener gebündelter Plugins (`api.ts`, `runtime-api.ts`,
|
||||
`index.ts`, `setup-entry.ts` und ähnliche öffentliche Entry-Dateien) bevorzugen nun den
|
||||
aktiven Runtime-Konfigurations-Snapshot, wenn OpenClaw bereits läuft. Wenn noch kein Runtime-
|
||||
Snapshot existiert, greifen sie auf die auf der Festplatte aufgelöste Konfigurationsdatei zurück.
|
||||
|
||||
Provider-Plugins können außerdem ein schmales pluginlokales Vertrags-Barrel bereitstellen, wenn eine
|
||||
Hilfsfunktion absichtlich providerspezifisch ist und noch nicht in einen generischen SDK-
|
||||
Subpath gehört. Aktuelles gebündeltes Beispiel: Der Anthropic-Provider hält seine Claude-
|
||||
Stream-Hilfsfunktionen in seiner eigenen öffentlichen `api.ts`- / `contract-api.ts`-Schnittstelle, statt
|
||||
Provider-Plugins können auch ein schmales, pluginlokales Vertrags-Barrel bereitstellen, wenn ein
|
||||
Helper absichtlich providerspezifisch ist und noch nicht in einen generischen SDK-
|
||||
Subpath gehört. Aktuelles gebündeltes Beispiel: Der Anthropic-Provider behält seine Claude-
|
||||
Stream-Helper in seiner eigenen öffentlichen `api.ts`- / `contract-api.ts`-Seam, anstatt
|
||||
Anthropic-Beta-Header- und `service_tier`-Logik in einen generischen
|
||||
`plugin-sdk/*`-Vertrag hochzustufen.
|
||||
`plugin-sdk/*`-Vertrag zu übernehmen.
|
||||
|
||||
Weitere aktuelle gebündelte Beispiele:
|
||||
|
||||
- `@openclaw/openai-provider`: `api.ts` exportiert Provider-Builder,
|
||||
Hilfsfunktionen für Standardmodelle und Builder für Realtime-Provider
|
||||
- `@openclaw/openrouter-provider`: `api.ts` exportiert den Provider-Builder sowie
|
||||
Hilfsfunktionen für Onboarding/Konfiguration
|
||||
Standardmodell-Helper und Realtime-Provider-Builder
|
||||
- `@openclaw/openrouter-provider`: `api.ts` exportiert den Provider-Builder plus
|
||||
Onboarding-/Konfigurations-Helper
|
||||
|
||||
<Warning>
|
||||
Produktionscode von Erweiterungen sollte auch Importe aus `openclaw/plugin-sdk/<other-plugin>`
|
||||
vermeiden. Wenn eine Hilfsfunktion wirklich gemeinsam genutzt wird, stufen Sie sie zu einem neutralen SDK-Subpath
|
||||
wie `openclaw/plugin-sdk/speech`, `.../provider-model-shared` oder einer anderen
|
||||
funktionsorientierten Oberfläche hoch, statt zwei Plugins miteinander zu koppeln.
|
||||
Produktionscode von Extensions sollte außerdem Importe über `openclaw/plugin-sdk/<other-plugin>`
|
||||
vermeiden. Wenn ein Helper wirklich gemeinsam genutzt wird, verschieben Sie ihn in einen neutralen SDK-Subpath
|
||||
wie `openclaw/plugin-sdk/speech`, `.../provider-model-shared` oder eine andere
|
||||
fähigkeitsorientierte Oberfläche, anstatt zwei Plugins miteinander zu koppeln.
|
||||
</Warning>
|
||||
|
||||
## Verwandt
|
||||
## Verwandte Themen
|
||||
|
||||
- [Entry Points](/de/plugins/sdk-entrypoints) — Optionen für `definePluginEntry` und `defineChannelPluginEntry`
|
||||
- [Runtime Helpers](/de/plugins/sdk-runtime) — vollständige Referenz für den Namespace `api.runtime`
|
||||
- [Setup and Config](/de/plugins/sdk-setup) — Paketierung, Manifeste, Konfigurationsschemas
|
||||
- [Testing](/de/plugins/sdk-testing) — Testhilfsprogramme und Lint-Regeln
|
||||
- [SDK Migration](/de/plugins/sdk-migration) — Migration von veralteten Oberflächen
|
||||
- [Plugin Internals](/de/plugins/architecture) — ausführliche Architektur und Funktionsmodell
|
||||
- [Einstiegspunkte](/de/plugins/sdk-entrypoints) — Optionen für `definePluginEntry` und `defineChannelPluginEntry`
|
||||
- [Runtime-Helper](/de/plugins/sdk-runtime) — vollständige Referenz des `api.runtime`-Namespace
|
||||
- [Setup und Konfiguration](/de/plugins/sdk-setup) — Packaging, Manifeste, Konfigurationsschemas
|
||||
- [Tests](/de/plugins/sdk-testing) — Test-Utilities und Lint-Regeln
|
||||
- [SDK-Migration](/de/plugins/sdk-migration) — Migration von veralteten Oberflächen
|
||||
- [Plugin-Interna](/de/plugins/architecture) — tiefe Architektur und Fähigkeitsmodell
|
||||
|
||||
@ -1,30 +1,30 @@
|
||||
---
|
||||
read_when:
|
||||
- Bilder über den Agenten generieren
|
||||
- Provider und Modelle für die Bildgenerierung konfigurieren
|
||||
- Anbieter und Modelle für die Bildgenerierung konfigurieren
|
||||
- Die Parameter des Tools `image_generate` verstehen
|
||||
summary: Bilder mit konfigurierten Providern generieren und bearbeiten (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra)
|
||||
summary: Bilder mit konfigurierten Anbietern erstellen und bearbeiten (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra)
|
||||
title: Bildgenerierung
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:12:40Z"
|
||||
generated_at: "2026-04-06T06:21:07Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: dde416dd1441a06605db85b5813cf61ccfc525813d6db430b7b7dfa53d6a3134
|
||||
source_hash: 903cc522c283a8da2cbd449ae3e25f349a74d00ecfdaf0f323fd8aa3f2107aea
|
||||
source_path: tools/image-generation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Bildgenerierung
|
||||
|
||||
Das Tool `image_generate` ermöglicht es dem Agenten, Bilder mit Ihren konfigurierten Providern zu erstellen und zu bearbeiten. Generierte Bilder werden automatisch als Medienanhänge in der Antwort des Agenten zugestellt.
|
||||
Das Tool `image_generate` ermöglicht es dem Agenten, Bilder mit Ihren konfigurierten Anbietern zu erstellen und zu bearbeiten. Generierte Bilder werden automatisch als Medienanhänge in der Antwort des Agenten bereitgestellt.
|
||||
|
||||
<Note>
|
||||
Das Tool erscheint nur, wenn mindestens ein Provider für Bildgenerierung verfügbar ist. Wenn Sie `image_generate` nicht in den Tools Ihres Agenten sehen, konfigurieren Sie `agents.defaults.imageGenerationModel` oder richten Sie einen API-Schlüssel für einen Provider ein.
|
||||
Das Tool erscheint nur, wenn mindestens ein Anbieter für die Bildgenerierung verfügbar ist. Wenn `image_generate` nicht in den Tools Ihres Agenten angezeigt wird, konfigurieren Sie `agents.defaults.imageGenerationModel` oder richten Sie einen API-Schlüssel für einen Anbieter ein.
|
||||
</Note>
|
||||
|
||||
## Schnellstart
|
||||
|
||||
1. Legen Sie für mindestens einen Provider einen API-Schlüssel fest (zum Beispiel `OPENAI_API_KEY` oder `GEMINI_API_KEY`).
|
||||
1. Legen Sie für mindestens einen Anbieter einen API-Schlüssel fest (zum Beispiel `OPENAI_API_KEY` oder `GEMINI_API_KEY`).
|
||||
2. Legen Sie optional Ihr bevorzugtes Modell fest:
|
||||
|
||||
```json5
|
||||
@ -39,22 +39,22 @@ Das Tool erscheint nur, wenn mindestens ein Provider für Bildgenerierung verfü
|
||||
}
|
||||
```
|
||||
|
||||
3. Fragen Sie den Agenten: _„Erzeuge ein Bild eines freundlichen Hummer-Maskottchens.“_
|
||||
3. Fragen Sie den Agenten: _„Erstelle ein Bild eines freundlichen Hummer-Maskottchens.“_
|
||||
|
||||
Der Agent ruft `image_generate` automatisch auf. Kein Tool-Allowlisting erforderlich — es ist standardmäßig aktiviert, wenn ein Provider verfügbar ist.
|
||||
Der Agent ruft `image_generate` automatisch auf. Keine Tool-Positivliste erforderlich — es ist standardmäßig aktiviert, wenn ein Anbieter verfügbar ist.
|
||||
|
||||
## Unterstützte Provider
|
||||
## Unterstützte Anbieter
|
||||
|
||||
| Provider | Standardmodell | Unterstützung für Bearbeitung | API-Schlüssel |
|
||||
| -------- | ------------------------------ | ---------------------------------- | ------------------------------------------------------ |
|
||||
| OpenAI | `gpt-image-1` | Ja (bis zu 5 Bilder) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview` | Ja | `GEMINI_API_KEY` oder `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Ja | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Ja (Subjektreferenz) | `MINIMAX_API_KEY` oder MiniMax OAuth (`minimax-portal`) |
|
||||
| ComfyUI | `workflow` | Ja (1 Bild, workflowkonfiguriert) | `COMFY_API_KEY` oder `COMFY_CLOUD_API_KEY` für Cloud |
|
||||
| Vydra | `grok-imagine` | Nein | `VYDRA_API_KEY` |
|
||||
| Anbieter | Standardmodell | Bearbeitungsunterstützung | API-Schlüssel |
|
||||
| -------- | -------------------------------- | ---------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-1` | Ja (bis zu 5 Bilder) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview` | Ja | `GEMINI_API_KEY` oder `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Ja | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Ja (Subjektreferenz) | `MINIMAX_API_KEY` oder MiniMax OAuth (`minimax-portal`) |
|
||||
| ComfyUI | `workflow` | Ja (1 Bild, im Workflow konfiguriert) | `COMFY_API_KEY` oder `COMFY_CLOUD_API_KEY` für die Cloud |
|
||||
| Vydra | `grok-imagine` | Nein | `VYDRA_API_KEY` |
|
||||
|
||||
Verwenden Sie `action: "list"`, um verfügbare Provider und Modelle zur Laufzeit zu prüfen:
|
||||
Verwenden Sie `action: "list"`, um verfügbare Anbieter und Modelle zur Laufzeit zu prüfen:
|
||||
|
||||
```
|
||||
/tool image_generate action=list
|
||||
@ -62,20 +62,20 @@ Verwenden Sie `action: "list"`, um verfügbare Provider und Modelle zur Laufzeit
|
||||
|
||||
## Tool-Parameter
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| ------------- | -------- | ----------------------------------------------------------------------------------- |
|
||||
| `prompt` | string | Prompt für die Bildgenerierung (erforderlich für `action: "generate"`) |
|
||||
| `action` | string | `"generate"` (Standard) oder `"list"`, um Provider zu prüfen |
|
||||
| `model` | string | Override für Provider/Modell, z. B. `openai/gpt-image-1` |
|
||||
| `image` | string | Einzelner Pfad oder URL eines Referenzbilds für den Bearbeitungsmodus |
|
||||
| `images` | string[] | Mehrere Referenzbilder für den Bearbeitungsmodus (bis zu 5) |
|
||||
| `size` | string | Größenhinweis: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` |
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| ------------- | -------- | ------------------------------------------------------------------------------------ |
|
||||
| `prompt` | string | Prompt für die Bildgenerierung (erforderlich für `action: "generate"`) |
|
||||
| `action` | string | `"generate"` (Standard) oder `"list"` zum Prüfen von Anbietern |
|
||||
| `model` | string | Anbieter-/Modell-Überschreibung, z. B. `openai/gpt-image-1` |
|
||||
| `image` | string | Einzelner Referenzbildpfad oder URL für den Bearbeitungsmodus |
|
||||
| `images` | string[] | Mehrere Referenzbilder für den Bearbeitungsmodus (bis zu 5) |
|
||||
| `size` | string | Größenhinweis: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` |
|
||||
| `aspectRatio` | string | Seitenverhältnis: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
|
||||
| `resolution` | string | Auflösungshinweis: `1K`, `2K` oder `4K` |
|
||||
| `count` | number | Anzahl der zu generierenden Bilder (1–4) |
|
||||
| `filename` | string | Hinweis für den Ausgabedateinamen |
|
||||
| `resolution` | string | Auflösungshinweis: `1K`, `2K` oder `4K` |
|
||||
| `count` | number | Anzahl der zu generierenden Bilder (1–4) |
|
||||
| `filename` | string | Hinweis für den Ausgabedateinamen |
|
||||
|
||||
Nicht alle Provider unterstützen alle Parameter. Das Tool übergibt, was der jeweilige Provider unterstützt, ignoriert den Rest und meldet verworfene Overrides im Tool-Ergebnis.
|
||||
Nicht alle Anbieter unterstützen alle Parameter. Das Tool übergibt, was jeder Anbieter unterstützt, ignoriert den Rest und meldet verworfene Überschreibungen im Tool-Ergebnis.
|
||||
|
||||
## Konfiguration
|
||||
|
||||
@ -94,59 +94,59 @@ Nicht alle Provider unterstützen alle Parameter. Das Tool übergibt, was der je
|
||||
}
|
||||
```
|
||||
|
||||
### Reihenfolge der Providerauswahl
|
||||
### Reihenfolge der Anbieterauswahl
|
||||
|
||||
Beim Generieren eines Bildes versucht OpenClaw Provider in dieser Reihenfolge:
|
||||
Beim Generieren eines Bildes versucht OpenClaw Anbieter in dieser Reihenfolge:
|
||||
|
||||
1. **Parameter `model`** aus dem Tool-Aufruf (falls der Agent einen angibt)
|
||||
1. Parameter **`model`** aus dem Tool-Aufruf (wenn der Agent einen angibt)
|
||||
2. **`imageGenerationModel.primary`** aus der Konfiguration
|
||||
3. **`imageGenerationModel.fallbacks`** in Reihenfolge
|
||||
4. **Automatische Erkennung** — verwendet nur auth-gestützte Provider-Standards:
|
||||
- zuerst den aktuellen Standardprovider
|
||||
- dann die übrigen registrierten Provider für Bildgenerierung in Provider-ID-Reihenfolge
|
||||
4. **Automatische Erkennung** — verwendet nur authentifizierungsbasierte Anbieterstandards:
|
||||
- zuerst den aktuellen Standardanbieter
|
||||
- verbleibende registrierte Anbieter für Bildgenerierung in der Reihenfolge ihrer Anbieter-IDs
|
||||
|
||||
Wenn ein Provider fehlschlägt (Auth-Fehler, Rate Limit usw.), wird automatisch der nächste Kandidat versucht. Wenn alle fehlschlagen, enthält der Fehler Details aus jedem Versuch.
|
||||
Wenn ein Anbieter fehlschlägt (Authentifizierungsfehler, Ratenbegrenzung usw.), wird automatisch der nächste Kandidat versucht. Wenn alle fehlschlagen, enthält der Fehler Details aus jedem Versuch.
|
||||
|
||||
Hinweise:
|
||||
|
||||
- Die automatische Erkennung ist auth-bewusst. Ein Provider-Standard wird nur dann in die Kandidatenliste aufgenommen,
|
||||
wenn OpenClaw diesen Provider tatsächlich authentifizieren kann.
|
||||
- Verwenden Sie `action: "list"`, um die aktuell registrierten Provider, ihre
|
||||
Standardmodelle und Hinweise zu Auth-Env-Variablen zu prüfen.
|
||||
- Die automatische Erkennung ist authentifizierungsbewusst. Ein Anbieterstandard wird nur dann in die Kandidatenliste aufgenommen,
|
||||
wenn OpenClaw diesen Anbieter tatsächlich authentifizieren kann.
|
||||
- Verwenden Sie `action: "list"`, um die aktuell registrierten Anbieter, ihre
|
||||
Standardmodelle und Hinweise zu Authentifizierungs-Umgebungsvariablen zu prüfen.
|
||||
|
||||
### Bildbearbeitung
|
||||
|
||||
OpenAI, Google, fal, MiniMax und ComfyUI unterstützen die Bearbeitung von Referenzbildern. Übergeben Sie einen Pfad oder eine URL zu einem Referenzbild:
|
||||
OpenAI, Google, fal, MiniMax und ComfyUI unterstützen das Bearbeiten von Referenzbildern. Übergeben Sie einen Referenzbildpfad oder eine URL:
|
||||
|
||||
```
|
||||
"Erzeuge eine Aquarellversion dieses Fotos" + image: "/path/to/photo.jpg"
|
||||
"Erstelle eine Aquarellversion dieses Fotos" + image: "/path/to/photo.jpg"
|
||||
```
|
||||
|
||||
OpenAI und Google unterstützen bis zu 5 Referenzbilder über den Parameter `images`. fal, MiniMax und ComfyUI unterstützen 1.
|
||||
|
||||
MiniMax-Bildgenerierung ist über beide gebündelten MiniMax-Auth-Pfade verfügbar:
|
||||
Die Bildgenerierung mit MiniMax ist über beide gebündelten MiniMax-Authentifizierungspfade verfügbar:
|
||||
|
||||
- `minimax/image-01` für Setups mit API-Schlüssel
|
||||
- `minimax-portal/image-01` für Setups mit OAuth
|
||||
|
||||
## Provider-Fähigkeiten
|
||||
## Anbieterfunktionen
|
||||
|
||||
| Fähigkeit | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra |
|
||||
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ----- |
|
||||
| Funktion | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra |
|
||||
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- |
|
||||
| Generieren | Ja (bis zu 4) | Ja (bis zu 4) | Ja (bis zu 4) | Ja (bis zu 9) | Ja (workflowdefinierte Ausgaben) | Ja (1) |
|
||||
| Bearbeiten/Referenz | Ja (bis zu 5 Bilder) | Ja (bis zu 5 Bilder) | Ja (1 Bild) | Ja (1 Bild, Subjektreferenz) | Ja (1 Bild, workflowkonfiguriert) | Nein |
|
||||
| Größensteuerung | Ja | Ja | Ja | Nein | Nein | Nein |
|
||||
| Seitenverhältnis | Nein | Ja | Ja (nur Generieren) | Ja | Nein | Nein |
|
||||
| Auflösung (1K/2K/4K) | Nein | Ja | Ja | Nein | Nein | Nein |
|
||||
| Bearbeiten/Referenz | Ja (bis zu 5 Bilder) | Ja (bis zu 5 Bilder) | Ja (1 Bild) | Ja (1 Bild, Subjektreferenz) | Ja (1 Bild, im Workflow konfiguriert) | Nein |
|
||||
| Größensteuerung | Ja | Ja | Ja | Nein | Nein | Nein |
|
||||
| Seitenverhältnis | Nein | Ja | Ja (nur Generierung) | Ja | Nein | Nein |
|
||||
| Auflösung (1K/2K/4K) | Nein | Ja | Ja | Nein | Nein | Nein |
|
||||
|
||||
## Verwandt
|
||||
|
||||
- [Tools-Übersicht](/de/tools) — alle verfügbaren Agenten-Tools
|
||||
- [fal](/providers/fal) — Einrichtung des Bild- und Videoproviders fal
|
||||
- [ComfyUI](/providers/comfy) — Einrichtung von lokalem ComfyUI und Comfy Cloud Workflows
|
||||
- [Google (Gemini)](/de/providers/google) — Einrichtung des Bildproviders Gemini
|
||||
- [MiniMax](/de/providers/minimax) — Einrichtung des Bildproviders MiniMax
|
||||
- [OpenAI](/de/providers/openai) — Einrichtung des Providers OpenAI Images
|
||||
- [Vydra](/providers/vydra) — Einrichtung von Bild, Video und Sprache mit Vydra
|
||||
- [Konfigurationsreferenz](/de/gateway/configuration-reference#agent-defaults) — Konfiguration von `imageGenerationModel`
|
||||
- [Tools Overview](/de/tools) — alle verfügbaren Agenten-Tools
|
||||
- [fal](/de/providers/fal) — Einrichtung des fal-Anbieters für Bilder und Videos
|
||||
- [ComfyUI](/de/providers/comfy) — Einrichtung lokaler ComfyUI- und Comfy-Cloud-Workflows
|
||||
- [Google (Gemini)](/de/providers/google) — Einrichtung des Gemini-Bildanbieters
|
||||
- [MiniMax](/de/providers/minimax) — Einrichtung des MiniMax-Bildanbieters
|
||||
- [OpenAI](/de/providers/openai) — Einrichtung des OpenAI-Images-Anbieters
|
||||
- [Vydra](/de/providers/vydra) — Einrichtung von Vydra für Bilder, Videos und Sprache
|
||||
- [Configuration Reference](/de/gateway/configuration-reference#agent-defaults) — Konfiguration von `imageGenerationModel`
|
||||
- [Models](/de/concepts/models) — Modellkonfiguration und Failover
|
||||
|
||||
@ -1,80 +1,80 @@
|
||||
---
|
||||
read_when:
|
||||
- Videos über den Agent erzeugen
|
||||
- Provider und Modelle für die Videoerzeugung konfigurieren
|
||||
- Videos über den Agenten generieren
|
||||
- Provider und Modelle für die Videogenerierung konfigurieren
|
||||
- Die Parameter des Tools `video_generate` verstehen
|
||||
summary: Videos aus Text, Bildern oder vorhandenen Videos mit 12 Provider-Backends erzeugen
|
||||
title: Videoerzeugung
|
||||
summary: Erzeugen Sie Videos aus Text, Bildern oder vorhandenen Videos mit 12 Provider-Backends
|
||||
title: Videogenerierung
|
||||
x-i18n:
|
||||
generated_at: "2026-04-06T03:13:34Z"
|
||||
generated_at: "2026-04-06T06:21:15Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 4afec87368232221db1aa5a3980254093d6a961b17271b2dcbf724e6bd455b16
|
||||
source_hash: 90d8a392b35adbd899232b02c55c10895b9d7ffc9858d6ca448f2e4e4a57f12f
|
||||
source_path: tools/video-generation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Videoerzeugung
|
||||
# Videogenerierung
|
||||
|
||||
OpenClaw-Agents können Videos aus Text-Prompts, Referenzbildern oder vorhandenen Videos erzeugen. Zwölf Provider-Backends werden unterstützt, jedes mit unterschiedlichen Modelloptionen, Eingabemodi und Funktionssätzen. Der Agent wählt automatisch den richtigen Provider basierend auf Ihrer Konfiguration und den verfügbaren API-Schlüsseln aus.
|
||||
OpenClaw-Agenten können Videos aus Text-Prompts, Referenzbildern oder vorhandenen Videos erzeugen. Zwölf Provider-Backends werden unterstützt, jeweils mit unterschiedlichen Modelloptionen, Eingabemodi und Funktionsumfängen. Der Agent wählt automatisch den richtigen Provider basierend auf Ihrer Konfiguration und den verfügbaren API-Schlüsseln aus.
|
||||
|
||||
<Note>
|
||||
Das Tool `video_generate` erscheint nur, wenn mindestens ein Provider für Videoerzeugung verfügbar ist. Wenn Sie es nicht in Ihren Agent-Tools sehen, setzen Sie einen API-Schlüssel für einen Provider oder konfigurieren Sie `agents.defaults.videoGenerationModel`.
|
||||
Das Tool `video_generate` wird nur angezeigt, wenn mindestens ein Provider für die Videogenerierung verfügbar ist. Wenn Sie es in Ihren Agenten-Tools nicht sehen, legen Sie einen API-Schlüssel für einen Provider fest oder konfigurieren Sie `agents.defaults.videoGenerationModel`.
|
||||
</Note>
|
||||
|
||||
## Schnellstart
|
||||
|
||||
1. Setzen Sie einen API-Schlüssel für einen unterstützten Provider:
|
||||
1. Legen Sie einen API-Schlüssel für einen beliebigen unterstützten Provider fest:
|
||||
|
||||
```bash
|
||||
export GEMINI_API_KEY="your-key"
|
||||
```
|
||||
|
||||
2. Heften Sie optional ein Standardmodell fest:
|
||||
2. Optional ein Standardmodell festlegen:
|
||||
|
||||
```bash
|
||||
openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
|
||||
```
|
||||
|
||||
3. Fragen Sie den Agent:
|
||||
3. Fragen Sie den Agenten:
|
||||
|
||||
> Erzeuge ein 5-sekündiges cineastisches Video eines freundlichen Hummers, der bei Sonnenuntergang surft.
|
||||
> Erzeuge ein 5-sekündiges cineastisches Video von einem freundlichen Hummer, der bei Sonnenuntergang surft.
|
||||
|
||||
Der Agent ruft `video_generate` automatisch auf. Keine Tool-Allowlist ist erforderlich.
|
||||
Der Agent ruft `video_generate` automatisch auf. Kein Tool-Allowlisting ist erforderlich.
|
||||
|
||||
## Was passiert, wenn Sie ein Video erzeugen
|
||||
|
||||
Die Videoerzeugung ist asynchron. Wenn der Agent `video_generate` in einer Sitzung aufruft:
|
||||
Die Videogenerierung erfolgt asynchron. Wenn der Agent in einer Sitzung `video_generate` aufruft:
|
||||
|
||||
1. OpenClaw sendet die Anfrage an den Provider und gibt sofort eine Task-ID zurück.
|
||||
2. Der Provider verarbeitet den Job im Hintergrund (typischerweise 30 Sekunden bis 5 Minuten, abhängig von Provider und Auflösung).
|
||||
3. Wenn das Video bereit ist, weckt OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis.
|
||||
4. Der Agent veröffentlicht das fertige Video zurück in der ursprünglichen Konversation.
|
||||
1. OpenClaw sendet die Anfrage an den Provider und gibt sofort eine Aufgaben-ID zurück.
|
||||
2. Der Provider verarbeitet den Auftrag im Hintergrund (typischerweise 30 Sekunden bis 5 Minuten, abhängig von Provider und Auflösung).
|
||||
3. Wenn das Video bereit ist, weckt OpenClaw dieselbe Sitzung mit einem internen Abschlussereignis auf.
|
||||
4. Der Agent postet das fertige Video zurück in die ursprüngliche Unterhaltung.
|
||||
|
||||
Während ein Job läuft, geben doppelte `video_generate`-Aufrufe in derselben Sitzung den aktuellen Task-Status zurück, statt eine weitere Erzeugung zu starten. Verwenden Sie `openclaw tasks list` oder `openclaw tasks show <taskId>`, um den Fortschritt über die CLI zu prüfen.
|
||||
Während ein Auftrag läuft, geben doppelte `video_generate`-Aufrufe in derselben Sitzung den aktuellen Aufgabenstatus zurück, anstatt eine weitere Generierung zu starten. Verwenden Sie `openclaw tasks list` oder `openclaw tasks show <taskId>`, um den Fortschritt über die CLI zu prüfen.
|
||||
|
||||
Außerhalb sitzungsgebundener Agent-Ausführungen (zum Beispiel bei direkten Tool-Aufrufen) fällt das Tool auf Inline-Erzeugung zurück und gibt im selben Turn den endgültigen Medienpfad zurück.
|
||||
Außerhalb von sitzungsbasierten Agenten-Ausführungen (zum Beispiel bei direkten Tool-Aufrufen) greift das Tool auf die Inline-Generierung zurück und gibt im selben Durchlauf den endgültigen Medienpfad zurück.
|
||||
|
||||
## Unterstützte Provider
|
||||
|
||||
| Provider | Standardmodell | Text | Bildreferenz | Videoreferenz | API-Schlüssel |
|
||||
| -------- | ----------------------------- | ---- | ---------------- | ---------------- | --------------------------------------- |
|
||||
| Alibaba | `wan2.6-t2v` | Ja | Ja (Remote-URL) | Ja (Remote-URL) | `MODELSTUDIO_API_KEY` |
|
||||
| BytePlus | `seedance-1-0-lite-t2v-250428`| Ja | 1 Bild | Nein | `BYTEPLUS_API_KEY` |
|
||||
| ComfyUI | `workflow` | Ja | 1 Bild | Nein | `COMFY_API_KEY` oder `COMFY_CLOUD_API_KEY` |
|
||||
| fal | `fal-ai/minimax/video-01-live`| Ja | 1 Bild | Nein | `FAL_KEY` |
|
||||
| Google | `veo-3.1-fast-generate-preview` | Ja | 1 Bild | 1 Video | `GEMINI_API_KEY` |
|
||||
| MiniMax | `MiniMax-Hailuo-2.3` | Ja | 1 Bild | Nein | `MINIMAX_API_KEY` |
|
||||
| OpenAI | `sora-2` | Ja | 1 Bild | 1 Video | `OPENAI_API_KEY` |
|
||||
| Qwen | `wan2.6-t2v` | Ja | Ja (Remote-URL) | Ja (Remote-URL) | `QWEN_API_KEY` |
|
||||
| Runway | `gen4.5` | Ja | 1 Bild | 1 Video | `RUNWAYML_API_SECRET` |
|
||||
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Ja | 1 Bild | Nein | `TOGETHER_API_KEY` |
|
||||
| Vydra | `veo3` | Ja | 1 Bild (`kling`) | Nein | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-video` | Ja | 1 Bild | 1 Video | `XAI_API_KEY` |
|
||||
| Provider | Standardmodell | Text | Bildreferenz | Videoreferenz | API-Schlüssel |
|
||||
| -------- | ------------------------------ | ---- | ----------------- | ---------------- | ---------------------------------------- |
|
||||
| Alibaba | `wan2.6-t2v` | Ja | Ja (Remote-URL) | Ja (Remote-URL) | `MODELSTUDIO_API_KEY` |
|
||||
| BytePlus | `seedance-1-0-lite-t2v-250428` | Ja | 1 Bild | Nein | `BYTEPLUS_API_KEY` |
|
||||
| ComfyUI | `workflow` | Ja | 1 Bild | Nein | `COMFY_API_KEY` oder `COMFY_CLOUD_API_KEY` |
|
||||
| fal | `fal-ai/minimax/video-01-live` | Ja | 1 Bild | Nein | `FAL_KEY` |
|
||||
| Google | `veo-3.1-fast-generate-preview` | Ja | 1 Bild | 1 Video | `GEMINI_API_KEY` |
|
||||
| MiniMax | `MiniMax-Hailuo-2.3` | Ja | 1 Bild | Nein | `MINIMAX_API_KEY` |
|
||||
| OpenAI | `sora-2` | Ja | 1 Bild | 1 Video | `OPENAI_API_KEY` |
|
||||
| Qwen | `wan2.6-t2v` | Ja | Ja (Remote-URL) | Ja (Remote-URL) | `QWEN_API_KEY` |
|
||||
| Runway | `gen4.5` | Ja | 1 Bild | 1 Video | `RUNWAYML_API_SECRET` |
|
||||
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Ja | 1 Bild | Nein | `TOGETHER_API_KEY` |
|
||||
| Vydra | `veo3` | Ja | 1 Bild (`kling`) | Nein | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-video` | Ja | 1 Bild | 1 Video | `XAI_API_KEY` |
|
||||
|
||||
Einige Provider akzeptieren zusätzliche oder alternative API-Schlüssel-Umgebungsvariablen. Details finden Sie auf den einzelnen [Provider-Seiten](#related).
|
||||
Einige Provider akzeptieren zusätzliche oder alternative API-Schlüssel-Umgebungsvariablen. Weitere Details finden Sie auf den einzelnen [Provider-Seiten](#related).
|
||||
|
||||
Führen Sie `video_generate action=list` aus, um verfügbare Provider und Modelle zur Laufzeit zu prüfen.
|
||||
Führen Sie `video_generate action=list` aus, um verfügbare Provider und Modelle zur Laufzeit anzuzeigen.
|
||||
|
||||
## Tool-Parameter
|
||||
|
||||
@ -93,43 +93,43 @@ Führen Sie `video_generate action=list` aus, um verfügbare Provider und Modell
|
||||
| `video` | string | Einzelnes Referenzvideo (Pfad oder URL) |
|
||||
| `videos` | string[] | Mehrere Referenzvideos (bis zu 4) |
|
||||
|
||||
### Stilsteuerung
|
||||
### Stilsteuerungen
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| ----------------- | ------- | ------------------------------------------------------------------------ |
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| ----------------- | ------- | ---------------------------------------------------------------------- |
|
||||
| `aspectRatio` | string | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
|
||||
| `resolution` | string | `480P`, `720P` oder `1080P` |
|
||||
| `durationSeconds` | number | Zieldauer in Sekunden (auf den nächstgelegenen vom Provider unterstützten Wert gerundet) |
|
||||
| `size` | string | Größenhinweis, wenn der Provider ihn unterstützt |
|
||||
| `audio` | boolean | Erzeugten Ton aktivieren, wenn unterstützt |
|
||||
| `watermark` | boolean | Watermarking des Providers aktivieren/deaktivieren, wenn unterstützt |
|
||||
| `resolution` | string | `480P`, `720P` oder `1080P` |
|
||||
| `durationSeconds` | number | Zieldauer in Sekunden (auf den nächsten vom Provider unterstützten Wert gerundet) |
|
||||
| `size` | string | Größenhinweis, wenn der Provider dies unterstützt |
|
||||
| `audio` | boolean | Generierten Ton aktivieren, wenn unterstützt |
|
||||
| `watermark` | boolean | Wasserzeichen des Providers aktivieren/deaktivieren, wenn unterstützt |
|
||||
|
||||
### Erweitert
|
||||
|
||||
| Parameter | Typ | Beschreibung |
|
||||
| ---------- | ------ | ------------------------------------------------- |
|
||||
| `action` | string | `"generate"` (Standard), `"status"` oder `"list"` |
|
||||
| `model` | string | Provider-/Modell-Überschreibung (z. B. `runway/gen4.5`) |
|
||||
| `model` | string | Provider-/Modell-Override (z. B. `runway/gen4.5`) |
|
||||
| `filename` | string | Hinweis für den Ausgabedateinamen |
|
||||
|
||||
Nicht alle Provider unterstützen alle Parameter. Nicht unterstützte Überschreibungen werden best effort ignoriert und als Warnungen im Tool-Ergebnis gemeldet. Harte Funktionsgrenzen (zum Beispiel zu viele Referenzeingaben) schlagen vor dem Absenden fehl.
|
||||
Nicht alle Provider unterstützen alle Parameter. Nicht unterstützte Overrides werden nach bestem Bemühen ignoriert und als Warnungen im Tool-Ergebnis gemeldet. Harte Funktionsgrenzen (wie zu viele Referenzeingaben) schlagen vor dem Absenden fehl.
|
||||
|
||||
## Aktionen
|
||||
|
||||
- **generate** (Standard) -- ein Video aus dem angegebenen Prompt und optionalen Referenzeingaben erzeugen.
|
||||
- **status** -- den Status des laufenden Video-Tasks für die aktuelle Sitzung prüfen, ohne eine weitere Erzeugung zu starten.
|
||||
- **list** -- verfügbare Provider, Modelle und ihre Funktionen anzeigen.
|
||||
- **generate** (Standard) -- erzeugt ein Video aus dem angegebenen Prompt und optionalen Referenzeingaben.
|
||||
- **status** -- prüft den Status der laufenden Videoaufgabe für die aktuelle Sitzung, ohne eine weitere Generierung zu starten.
|
||||
- **list** -- zeigt verfügbare Provider, Modelle und ihre Fähigkeiten an.
|
||||
|
||||
## Modellauswahl
|
||||
|
||||
Beim Erzeugen eines Videos löst OpenClaw das Modell in dieser Reihenfolge auf:
|
||||
|
||||
1. **Tool-Parameter `model`** -- wenn der Agent im Aufruf eines angibt.
|
||||
1. **`model`-Tool-Parameter** -- wenn der Agent beim Aufruf einen angibt.
|
||||
2. **`videoGenerationModel.primary`** -- aus der Konfiguration.
|
||||
3. **`videoGenerationModel.fallbacks`** -- werden in Reihenfolge versucht.
|
||||
4. **Automatische Erkennung** -- verwendet Provider mit gültiger Authentifizierung, beginnend mit dem aktuellen Standard-Provider, dann die übrigen Provider in alphabetischer Reihenfolge.
|
||||
3. **`videoGenerationModel.fallbacks`** -- wird der Reihe nach versucht.
|
||||
4. **Automatische Erkennung** -- verwendet Provider mit gültiger Authentifizierung, beginnend mit dem aktuellen Standard-Provider, danach die übrigen Provider in alphabetischer Reihenfolge.
|
||||
|
||||
Wenn ein Provider fehlschlägt, wird automatisch der nächste Kandidat versucht. Wenn alle Kandidaten fehlschlagen, enthält der Fehler Details aus jedem Versuch.
|
||||
Wenn ein Provider fehlschlägt, wird automatisch der nächste Kandidat versucht. Wenn alle Kandidaten fehlschlagen, enthält der Fehler Details zu jedem Versuch.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -146,24 +146,24 @@ Wenn ein Provider fehlschlägt, wird automatisch der nächste Kandidat versucht.
|
||||
|
||||
## Hinweise zu Providern
|
||||
|
||||
| Provider | Hinweise |
|
||||
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Alibaba | Verwendet den asynchronen DashScope-/Model-Studio-Endpoint. Referenzbilder und -videos müssen Remote-`http(s)`-URLs sein. |
|
||||
| BytePlus | Nur eine einzelne Bildreferenz. |
|
||||
| ComfyUI | Workflow-gesteuerte lokale oder Cloud-Ausführung. Unterstützt Text-zu-Video und Bild-zu-Video über den konfigurierten Graphen. |
|
||||
| fal | Verwendet einen queue-gestützten Ablauf für lang laufende Jobs. Nur eine einzelne Bildreferenz. |
|
||||
| Google | Verwendet Gemini/Veo. Unterstützt ein Bild oder ein Video als Referenz. |
|
||||
| MiniMax | Nur eine einzelne Bildreferenz. |
|
||||
| OpenAI | Nur die Überschreibung `size` wird weitergegeben. Andere Stilüberschreibungen (`aspectRatio`, `resolution`, `audio`, `watermark`) werden mit einer Warnung ignoriert. |
|
||||
| Qwen | Verwendet dasselbe DashScope-Backend wie Alibaba. Referenzeingaben müssen Remote-`http(s)`-URLs sein; lokale Dateien werden direkt abgelehnt. |
|
||||
| Provider | Hinweise |
|
||||
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| Alibaba | Verwendet den asynchronen DashScope-/Model-Studio-Endpunkt. Referenzbilder und -videos müssen entfernte `http(s)`-URLs sein. |
|
||||
| BytePlus | Nur eine einzelne Bildreferenz. |
|
||||
| ComfyUI | Workflow-gesteuerte lokale oder Cloud-Ausführung. Unterstützt Text-zu-Video und Bild-zu-Video über den konfigurierten Graphen. |
|
||||
| fal | Verwendet einen warteschlangenbasierten Ablauf für lang laufende Aufträge. Nur eine einzelne Bildreferenz. |
|
||||
| Google | Verwendet Gemini/Veo. Unterstützt ein Bild oder eine Videoreferenz. |
|
||||
| MiniMax | Nur eine einzelne Bildreferenz. |
|
||||
| OpenAI | Nur der Override `size` wird weitergeleitet. Andere Stil-Overrides (`aspectRatio`, `resolution`, `audio`, `watermark`) werden mit einer Warnung ignoriert. |
|
||||
| Qwen | Dasselbe DashScope-Backend wie Alibaba. Referenzeingaben müssen entfernte `http(s)`-URLs sein; lokale Dateien werden vorab abgelehnt. |
|
||||
| Runway | Unterstützt lokale Dateien über Daten-URIs. Video-zu-Video erfordert `runway/gen4_aleph`. Reine Textläufe bieten die Seitenverhältnisse `16:9` und `9:16`. |
|
||||
| Together | Nur eine einzelne Bildreferenz. |
|
||||
| Vydra | Verwendet direkt `https://www.vydra.ai/api/v1`, um Redirects zu vermeiden, bei denen Authentifizierung verloren geht. `veo3` ist gebündelt nur als Text-zu-Video; `kling` erfordert eine Remote-Bild-URL. |
|
||||
| xAI | Unterstützt Text-zu-Video-, Bild-zu-Video- sowie Remote-Video-Bearbeitungs-/Erweiterungsabläufe. |
|
||||
| Together | Nur eine einzelne Bildreferenz. |
|
||||
| Vydra | Verwendet `https://www.vydra.ai/api/v1` direkt, um Weiterleitungen zu vermeiden, bei denen die Authentifizierung verloren geht. `veo3` ist nur als Text-zu-Video gebündelt; `kling` erfordert eine entfernte Bild-URL. |
|
||||
| xAI | Unterstützt Text-zu-Video, Bild-zu-Video und entfernte Abläufe zum Bearbeiten/Erweitern von Videos. |
|
||||
|
||||
## Konfiguration
|
||||
|
||||
Setzen Sie das Standardmodell für die Videoerzeugung in Ihrer OpenClaw-Konfiguration:
|
||||
Legen Sie das Standardmodell für die Videogenerierung in Ihrer OpenClaw-Konfiguration fest:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -186,19 +186,19 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2
|
||||
|
||||
## Verwandt
|
||||
|
||||
- [Tools Overview](/de/tools)
|
||||
- [Background Tasks](/de/automation/tasks) -- Task-Verfolgung für asynchrone Videoerzeugung
|
||||
- [Alibaba Model Studio](/providers/alibaba)
|
||||
- [BytePlus](/providers/byteplus)
|
||||
- [ComfyUI](/providers/comfy)
|
||||
- [fal](/providers/fal)
|
||||
- [Tools-Übersicht](/de/tools)
|
||||
- [Hintergrundaufgaben](/de/automation/tasks) -- Aufgabenverfolgung für die asynchrone Videogenerierung
|
||||
- [Alibaba Model Studio](/de/providers/alibaba)
|
||||
- [BytePlus](/de/concepts/model-providers#byteplus-international)
|
||||
- [ComfyUI](/de/providers/comfy)
|
||||
- [fal](/de/providers/fal)
|
||||
- [Google (Gemini)](/de/providers/google)
|
||||
- [MiniMax](/de/providers/minimax)
|
||||
- [OpenAI](/de/providers/openai)
|
||||
- [Qwen](/de/providers/qwen)
|
||||
- [Runway](/providers/runway)
|
||||
- [Runway](/de/providers/runway)
|
||||
- [Together AI](/de/providers/together)
|
||||
- [Vydra](/providers/vydra)
|
||||
- [Vydra](/de/providers/vydra)
|
||||
- [xAI](/de/providers/xai)
|
||||
- [Configuration Reference](/de/gateway/configuration-reference#agent-defaults)
|
||||
- [Models](/de/concepts/models)
|
||||
- [Konfigurationsreferenz](/de/gateway/configuration-reference#agent-defaults)
|
||||
- [Modelle](/de/concepts/models)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user