Fehlerbehebung

clawhub login öffnet einen Browser, wird aber nie abgeschlossen

Die CLI startet während der Browseranmeldung kurzzeitig einen lokalen Callback-Server.

• Stellen Sie sicher, dass Ihr Browser http://127.0.0.1:<port>/callback erreichen kann.
• Prüfen Sie die Regeln der lokalen Firewall, des VPN und des Proxys, wenn der Callback nie eintrifft.
• Erstellen Sie in Umgebungen ohne grafische Oberfläche ein API-Token in der ClawHub-Weboberfläche und führen Sie Folgendes aus:

clawhub login --token clh_...

whoami oder publish gibt Unauthorized (401) zurück

• Melden Sie sich mit clawhub login erneut an.
• Wenn Sie einen benutzerdefinierten Konfigurationspfad verwenden, vergewissern Sie sich, dass CLAWHUB_CONFIG_PATH auf die Datei verweist, die Ihr aktuelles Token enthält.
• Wenn Sie ein API-Token verwenden, vergewissern Sie sich, dass es nicht in der Weboberfläche widerrufen wurde.

Suche oder Installation gibt Rate limit exceeded (429) zurück

Lesen Sie die Wiederholungsinformationen in der Antwort:

• Retry-After: Sekunden, die vor einem erneuten Versuch gewartet werden müssen.
• RateLimit-Limit: das für diese Anfrage geltende Limit.
• RateLimit-Remaining: Ihr exakt verbleibendes Kontingent, wenn der Header vorhanden ist. Bei 429 beträgt es 0.
• RateLimit-Reset oder X-RateLimit-Reset: Zeitpunkt der Zurücksetzung.

Wenn viele Benutzer dieselbe ausgehende IP-Adresse verwenden, können anonyme IP-Limits erreicht werden, selbst wenn jede Person nur wenige Anfragen sendet. Melden Sie sich nach Möglichkeit an und versuchen Sie es nach der angegebenen Wartezeit erneut.

Suche oder Installation schlägt hinter einem Proxy fehl

Die CLI berücksichtigt die standardmäßigen Proxy-Variablen:

export HTTPS_PROXY=http://proxy.example.com:3128clawhub search "my query"

Zu den unterstützten Namen gehören HTTPS_PROXY, HTTP_PROXY, https_proxy und http_proxy.

Ein Skill erscheint nicht in der Suche

• Prüfen Sie den exakten Slug oder die Eigentümerseite, falls bekannt.
• Vergewissern Sie sich, dass die Version öffentlich ist und nicht durch eine Prüfung oder Moderation zurückgehalten wird.
• Wenn der Skill Ihnen gehört, melden Sie sich an und prüfen Sie ihn:

clawhub inspect @openclaw/demo

Für Eigentümer sichtbare Diagnosen können den Status der Prüfung, der Upload-Sperre oder der Moderation erläutern.

Die Veröffentlichung schlägt wegen fehlender erforderlicher Metadaten fehl

Prüfen Sie für Skills das Frontmatter in SKILL.md. Erforderliche Umgebungsvariablen und Tools sollten deklariert werden, damit Benutzer und Scanner das Paket nachvollziehen können.

Prüfen Sie für Plugins die Kompatibilitätsmetadaten in package.json. Veröffentlichungen von Code-Plugins benötigen OpenClaw-Kompatibilitätsfelder wie openclaw.compat.pluginApi und openclaw.build.openclawVersion.

Zeigen Sie zunächst eine Vorschau der Veröffentlichungsnutzlast an:

clawhub package publish <source> --family code-plugin --dry-run

Die Veröffentlichung schlägt wegen eines GitHub-Eigentümer- oder Quellfehlers fehl

ClawHub verwendet die GitHub-Identität und Quellenzuordnung, um Pakete mit ihren Herausgebern zu verknüpfen.

• Stellen Sie sicher, dass Sie mit dem GitHub-Konto angemeldet sind, dem das Paket gehört oder das es veröffentlichen kann.
• Prüfen Sie, ob die Quell-URL öffentlich oder für ClawHub zugänglich ist.
• Verwenden Sie für GitHub-Quellen owner/repo, owner/repo@ref oder eine vollständige GitHub-URL.

Die Veröffentlichung schlägt fehl, weil ein Namespace beansprucht oder reserviert ist

Wenn eine Veröffentlichung fehlschlägt, weil das Eigentümer-Handle, der Organisations-Namespace, der Paketbereich, der Skill- Slug oder der Paketname bereits beansprucht oder reserviert ist, vergewissern Sie sich zunächst, dass Sie mit dem zum Namespace passenden Eigentümer veröffentlichen. Bei Plugin-Paketen müssen bereichsbezogene Namen wie @example-org/example-plugin unter dem entsprechenden Eigentümer example-org veröffentlicht werden.

Wenn Sie der Ansicht sind, dass Ihre Organisation, Ihr Projekt oder Ihre Marke der rechtmäßige Eigentümer des Namespace ist, Sie den aktuellen ClawHub-Eigentümer jedoch nicht verwalten können, erstellen Sie ein Problem zur Beanspruchung einer Organisation/eines Namespace mit öffentlichen, nicht vertraulichen Nachweisen. Unter Beanspruchung von Organisationen und Namespaces finden Sie Hinweise zu Nachweisen und dazu, welche Informationen nicht in öffentliche Issues gehören.

sync meldet, dass keine Skills gefunden wurden

sync sucht nach Ordnern, die SKILL.md oder skill.md enthalten.

Verweisen Sie auf die Stammverzeichnisse, die durchsucht werden sollen:

clawhub sync --root /path/to/skills

Zeigen Sie zunächst eine Vorschau an, wenn Sie nicht sicher sind, was veröffentlicht wird:

clawhub sync --all --dry-run --no-input

update verweigert den Vorgang wegen lokaler Änderungen

Die lokalen Dateien entsprechen keiner ClawHub bekannten Version. Wählen Sie eine Option:

• Behalten Sie die lokalen Änderungen bei und überspringen Sie die Aktualisierung.
• Überschreiben Sie sie mit der veröffentlichten Version:

clawhub update @openclaw/demo --force

• Veröffentlichen Sie Ihre bearbeitete Kopie unter einem neuen Slug oder als Fork.

Die Installation eines Plugins in OpenClaw schlägt fehl

• Verwenden Sie eine explizite ClawHub-Quelle:

openclaw plugins install clawhub:<package>

• Prüfen Sie auf der Paketdetailseite den Prüfstatus und die Kompatibilitätsmetadaten.
• Vergewissern Sie sich, dass Ihre OpenClaw-Version den angegebenen Kompatibilitätsbereich des Pakets erfüllt.
• Wenn das Paket ausgeblendet, zurückgehalten oder gesperrt ist, kann es möglicherweise erst installiert werden, nachdem der Eigentümer das Problem behoben hat.

Anfragen an die öffentliche API schlagen fehl

• Beachten Sie die Retry-Header 429 und speichern Sie öffentliche Listen-/Suchantworten zwischen.
• Verweisen Sie Benutzer zurück auf den kanonischen ClawHub-Eintrag.
• Spiegeln Sie keine ausgeblendeten, privaten, zurückgehaltenen oder durch Moderation gesperrten Inhalte außerhalb der öffentlichen API-Oberfläche.

Weitere Einzelheiten zu den Endpunkten finden Sie unter HTTP-API.