Eine SKILL.md-Bearbeitung ist eine Produktionsänderung – auch wenn sich kein Code geändert hat.

OpenClaw-Skills sind keine passive Dokumentation. Sie ändern, wann Werkzeuge aufgerufen werden und wie Arbeit ausgeführt wird. Ein lokaler Skill in Ihrem Arbeitsbereich hat die höchste Lade-Priorität, sodass er eine gebündelte oder verwaltete Version stillschweigend ersetzen kann – ohne Anwendungscode zu berühren. Das macht jede Änderung an einer SKILL.md zu einer Produktionsänderung, auch wenn sich kein Code geändert hat.

Warum das wichtig ist

Die Skills-Dokumentation von OpenClaw weist darauf hin, dass der Skills-Watcher standardmäßig aktiviert ist. Eine geänderte SKILL.md kann die Sitzungs-Snapshot beim nächsten Agenten-Zug aktualisieren. Die Sicherheitsrichtlinien empfehlen ausdrücklich, Skill-Ordner als vertrauenswürdigen Code zu behandeln – weil sie Dateisystemzugriff, Netzwerkaufrufe, Anmeldedatenverarbeitung oder Genehmigungsworkflows anfordern können.

Prüfen Sie, bevor Sie ändern

Bevor Sie einen Skill ändern, erfassen Sie, was der Agent tatsächlich laden kann. Führen Sie diese Befehle aus und speichern Sie die Ausgabe:

openclaw skills list --json
openclaw skills check --agent main --json
openclaw skills info SKILL_NAME --agent main --json

Diese liefern die effektiven Quellen und Hashes – nützlich als Release-Nachweis. Halten Sie Skill-Wurzeln unter Versionskontrolle und überprüfen Sie im Diff alle neuen Anweisungen zu Dateisystem, Netzwerk, Anmeldedaten oder Genehmigungen.

Mid-Session-Änderungen deaktivieren

Wenn Sie nicht möchten, dass Skills mitten in der Sitzung gewechselt werden, unterstützt die dokumentierte Konfiguration das Deaktivieren der automatischen Überwachung:

{
  "skills": {
    "load": {
      "watch": false
    }
  }
}

Testen wie in Produktion

Wenn Sie geprüfte Änderungen aktivieren, starten Sie eine kontrollierte neue Sitzung und führen Sie eine begrenzte Aufgabe aus. Bestätigen Sie die erwartete Werkzeugsequenz, Berechtigungen und das Endergebnis. Ein erfolgreiches Laden beweist nur, dass der Skill geeignet ist – nicht, dass sein Verhalten sicher ist.

Das Fazit

Welche Dateien in Ihrer OpenClaw-Einrichtung können derzeit das Agentenverhalten ändern, ohne Ihren normalen Code-Review-Prozess zu durchlaufen? Behandeln Sie jede SKILL.md wie eine Produktionsbereitstellung: Prüfen, versionieren, testen und dokumentieren Sie, was Sie geändert haben.