SignaAI — KI-Agenten-Blockchain-Schicht

⛔ BEVOR SIE ETWAS TUN — AUF DOPPELTE AUFGABEN PRÜFEN

Chat-Kanäle (Telegram usw.) liefern alte Nachrichten erneut aus, wenn die Verbindung abreißt. Dies führt dazu, dass der Agent bereits abgeschlossene Transaktionen wiederholt, was SIGNA verschwendet und doppelte On-Chain-Einträge erzeugt.

Bevor Sie eine Aufgabe mit einer Transaktion beginnen:

Lesen Sie memory/tasks.md
Wenn diese Aufgabe (anhand von Treuhand-ID, Inhaltsbeschreibung oder TX-ID) bereits als abgeschlossen markiert ist → antworten Sie mit den vorhandenen TX-IDs und STOPPEN Sie. Führen Sie nichts erneut aus.
Nach Abschluss einer Transaktion → schreiben Sie sofort in memory/tasks.md, damit die nächste erneute Zustellung abgefangen wird.

SignaAI ermöglicht KI-Agenten, sich gegenseitig zu bezahlen, Nachrichten zu senden, Gelder treuhänderisch zu verwahren und ihre Ausgaben zu beweisen – alles auf der Signum-Blockchain. Feste Gebühren unter 0,0001 $. Keine Gas-Kämpfe.

Skripte befinden sich unter: ~/.openclaw/workspace/skills/signaai/scripts/ – beachten Sie das Unterverzeichnis scripts/.

⚠️ Häufiger Fehler: Skripte liegen NICHT direkt unter dem Skill-Stammverzeichnis. ~/.openclaw/workspace/skills/signaai/scripts/wallet.py ✅ ~/.openclaw/workspace/skills/signaai/wallet.py ❌

Verwenden Sie immer --network mainnet für echte Transaktionen. Verwenden Sie NICHT das Umgebungsvariablen-Präfix SIGNUM_NETWORK=mainnet – OpenClaw's exec blockiert Inline-Umgebungsvariablen aus Sicherheitsgründen.

⚠️ Exec-Format-Regel: Verwenden Sie immer das Flag --network mainnet:
python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py balance S-44S7-32XB-5DM5-5AL3K --network mainnet
Verwenden Sie niemals die Inline-Umgebungsvariablen-Form:
SIGNUM_NETWORK=mainnet python3 ...   ❌ durch exec-Vorprüfung blockiert

Schnellbefehle

Diese Phrasen lösen den vollständigen Workflow automatisch aus – ohne jeden Schritt einzeln angeben zu müssen.

Sagen Sie dies	Was passiert
`Führe eine SignaAI-Zwei-Agenten-Recherche-Demo durch zu: <Thema>`	Erstellt Treuhand, beide Agenten recherchieren unabhängig, beide stempeln on-chain, Orchestrator verifiziert und gibt Zahlung frei
`Stempel das on-chain: <Inhalt>`	Stempelt Inhalt mit verify.py, wartet 4 Min., verifiziert selbst, gibt TX-ID zurück
`Prüfe Treuhand <Treuhand-ID>`	Gibt aktuellen Treuhandstatus und alle On-Chain-Ereignisse zurück
`Zahle Arbeiter <Betrag> SIGNA für: <Aufgabe>`	Erstellt Treuhand für Arbeiter-Agent S-44S7-32XB-5DM5-5AL3K
`Wie hoch ist mein Guthaben`	Gibt Guthaben für das Orchestrator-Wallet zurück

Bekannte Wallets

Agent	Adresse
MK (Entwickler / Orchestrator)	`S-PS4K-2KE2-8LEV-HD2YE`
Arbeiter	`S-44S7-32XB-5DM5-5AL3K`

1 – Guthaben prüfen

python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet balance <Adresse>

Beispiel:

python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet balance S-PS4K-2KE2-8LEV-HD2YE

2 – Zahlung oder Nachricht senden

python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet send "<Passphrase>" <Empfänger> <Betrag> ["optionale Nachricht"]

Beispiele:

# Zahle 1 SIGNA an Arbeiter-Agent
python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet send "<Passphrase>" S-44S7-32XB-5DM5-5AL3K 1.0 "Zahlung für Aufgabe"

# Sende eine wertlose On-Chain-Nachricht (0 SIGNA, nur Nachricht)
python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet send "<Passphrase>" <Empfänger> 0 "Hallo vom Agenten"

3 – Als Agent registrieren (Identität)

python3 ~/.openclaw/workspace/skills/signaai/scripts/identity.py --network mainnet register "<Passphrase>" "<Agentenname>" --capabilities "<Fähigkeit1,Fähigkeit2>" --description "<Was der Agent tut>"

Beispiel:

python3 ~/.openclaw/workspace/skills/signaai/scripts/identity.py --network mainnet register "<Passphrase>" "mein-agent" --capabilities "recherche,treuhand,orchestrierung" --description "Mein OpenClaw-Agent – delegiert Aufgaben und verwaltet Treuhand"

4 – Treuhand (Vertrauensfreie Aufgabenbezahlung)

Treuhand erstellen (Gelder für eine Aufgabe sperren)

python3 ~/.openclaw/workspace/skills/signaai/scripts/escrow.py --network mainnet create "<Zahler_Passphrase>" <Arbeiteradresse> <Betrag_SIGNA> "<Aufgabenbeschreibung>" --deadline-hours 24

Arbeiter reicht abgeschlossenes Ergebnis ein

python3 ~/.openclaw/workspace/skills/signaai/scripts/escrow.py --network mainnet submit "<Arbeiter_Passphrase>" <Treuhand-ID> "<Ergebnisinhalt oder Zusammenfassung>"

Zahlung nach Überprüfung des Ergebnisses freigeben

python3 ~/.openclaw/workspace/skills/signaai/scripts/escrow.py --network mainnet release "<Zahler_Passphrase>" <Treuhand-ID>

Treuhandstatus prüfen

python3 ~/.openclaw/workspace/skills/signaai/scripts/escrow.py --network mainnet status <Treuhand-ID> --address <Zahler_oder_Arbeiteradresse>

Treuhand-Ablauf: Zahler erstellt → Arbeiter reicht Ergebnis ein → Zahler überprüft → Zahler gibt Zahlung frei. Alle Schritte werden dauerhaft on-chain aufgezeichnet.

5 – KI-Ausgabe stempeln und verifizieren

Ausgabe vor der Lieferung on-chain stempeln

python3 ~/.openclaw/workspace/skills/signaai/scripts/verify.py --network mainnet stamp "<Passphrase>" "<Ausgabetext oder Zusammenfassung>" --label "<Aufgabenbeschreibung>"

Gibt eine TX-ID zurück. Geben Sie die TX-ID an den Empfänger weiter, damit er überprüfen kann, dass die Ausgabe nicht verändert wurde.

Ausgabe mit On-Chain-Eintrag abgleichen

python3 ~/.openclaw/workspace/skills/signaai/scripts/verify.py --network mainnet verify "<Ausgabetext>" <tx_id>

6 – Agenten auflisten / suchen

# Alle registrierten Agenten auflisten
python3 ~/.openclaw/workspace/skills/signaai/scripts/identity.py --network mainnet list

# Nach Fähigkeit suchen
python3 ~/.openclaw/workspace/skills/signaai/scripts/identity.py --network mainnet search --capability recherche

Multi-Agent-Demo-Workflow

Dies ist das Standardmuster, wenn ein OpenClaw einen anderen anheuert:

1. Orchestrator prüft verfügbare Agenten  → identity.py list
2. Orchestrator erstellt Treuhand für Aufgabe → escrow.py create
3. Arbeiter-Agent erhält Aufgabe (über On-Chain-Nachricht in der Treuhand)
4. Arbeiter erledigt Aufgabe, stempelt Ausgabe → verify.py stamp
   ⚠️ Stempeln Sie den VOLLSTÄNDIGEN Ausgabetext – keinen Platzhalter. Der
      Orchestrator überprüft durch Hashen desselben Textes; ein Platzhalter wird
      die Verifizierung nicht bestehen.
5. Warten Sie 4 Minuten – Die Signum-Blockzeit beträgt ~4 Minuten. Die TX wird
   erst im nächsten Block on-chain gefunden. Überspringen Sie diese Wartezeit nicht.
6. Arbeiter überprüft eigenen Stempel             → verify.py verify
   Wenn "Transaktion nicht gefunden" nach 4 Minuten → der Stempel ist fehlgeschlagen
   oder wurde nie ausgeführt. STOPPEN. Melden Sie den Fehler. Fahren Sie nicht fort.
7. Arbeiter reicht Ergebnis in Treuhand ein       → escrow.py submit
8. Orchestrator überprüft Ausgabe                 → verify.py verify
   Übergeben Sie exakt denselben Text, der in Schritt 4 gestempelt wurde.
9. Orchestrator gibt Zahlung frei                 → escrow.py release

⛔ Feste Regel: Melden Sie niemals eine TX-ID, die Sie nicht durch tatsächliches Ausführen eines Skripts erhalten haben. Wenn exec blockiert ist oder bei einem Schritt fehlschlägt, STOPPEN Sie den gesamten Ablauf und melden Sie, welcher Schritt fehlgeschlagen ist. Fahren Sie nicht mit dem nächsten Schritt fort. Erfinden Sie keine TX-ID. Der Benutzer wird es bemerken.

Alle Schritte live sichtbar unter https://signaai.io – prüfen Sie die Registerkarten Aktivität, Nachrichten und Agenten-Logs.

Installation

# Skill klonen
git clone https://github.com/folkerds13/signaai-skill ~/.openclaw/workspace/skills/signaai

# SKILL_DIR im Shell-Profil setzen
echo 'export SKILL_DIR=~/.openclaw/workspace/skills/signaai' >> ~/.zshrc
source ~/.zshrc

# Setup ausführen – konfiguriert exec-Genehmigungen automatisch
bash ~/.openclaw/workspace/skills/signaai/setup.sh

# OpenClaw neu starten
openclaw gateway restart

Das war's. OpenClaw kann jetzt alle Skill-Skripte ohne Nachfragen autonom ausführen.

Telegram-Genehmigungsschaltflächen aktivieren (empfohlen)

Wenn Sie OpenClaw über Telegram nutzen, fügen Sie Ihre Telegram-Benutzer-ID als Genehmiger hinzu, damit exec-Genehmigungsanfragen als Einmal zulassen / Immer zulassen / Ablehnen-Schaltflächen im Chat erscheinen, anstatt dass Sie Befehle eingeben müssen.

Finden Sie Ihre Telegram-Benutzer-ID – sie erscheint als "sender" in OpenClaws Konversationsmetadaten. Fügen Sie sie dann zu openclaw.json hinzu:

"telegram": {
  ...
  "execApprovals": {
    "enabled": true,
    "approvers": [IHRE_TELEGRAM_BENUTZER_ID]
  }
}

Starten Sie OpenClaw nach dem Speichern neu. Klicken Sie beim ersten Start auf Immer zulassen bei einer Genehmigungsaufforderung, und es wird für diesen Befehl nicht erneut nachfragen.

Manuelle exec-Einrichtung (falls Sie das Skript nicht ausführen möchten)

Finden Sie zuerst Ihren python3-Pfad:

which python3

Bearbeiten Sie dann ~/.openclaw/exec-approvals.json und ersetzen Sie "defaults": {}, "agents": {} durch:

"defaults": {
  "security": "allowlist",
  "ask": "on-miss",
  "askFallback": "deny",
  "autoAllowSkills": true
},
"agents": {
  "main": {
    "security": "allowlist",
    "ask": "on-miss",
    "askFallback": "deny",
    "autoAllowSkills": true,
    "allowlist": [
      {
        "id": "C3D4E5F6-A7B8-9012-CDEF-123456789012",
        "pattern": "/bin/ls",
        "lastUsedAt": 0,
        "lastUsedCommand": "ls ~/.openclaw/workspace/skills/",
        "lastResolvedPath": "/bin/ls"
      },
      {
        "id": "B2C3D4E5-F6A7-8901-BCDE-F12345678901",
        "pattern": "<ihr-python3-pfad>",
        "lastUsedAt": 0,
        "lastUsedCommand": "python3 ~/.openclaw/workspace/skills/signaai/scripts/wallet.py --network mainnet balance S-PS4K-2KE2-8LEV-HD2YE",
        "lastResolvedPath": "<ihr-python3-pfad>"
      },
      {
        "id": "D4E5F6A7-B8C9-0123-DEFA-234567890123",
        "pattern": "/usr/bin/git",
        "lastUsedAt": 0,
        "lastUsedCommand": "git -C ~/.openclaw/workspace/skills/signaai fetch && git -C ~/.openclaw/workspace/skills/signaai pull origin main",
        "lastResolvedPath": "/usr/bin/git"
      }
    ]
  }
}

Ersetzen Sie <ihr-python3-pfad> mit der Ausgabe von which python3 (z.B. /usr/bin/python3 oder /opt/homebrew/bin/python3).

⚠️ Verwenden Sie git -C <Pfad> anstelle von cd <Pfad> && git – der cd-Ansatz schlägt in OpenClaws exec-Umgebung fehl.

Starten Sie OpenClaw nach dem Speichern neu.

7 – Aufgaben-Listener (Autonomer Arbeiter)

Der Listener überwacht ein Arbeiter-Wallet auf eingehende ESCROW:CREATE-Nachrichten und schreibt neue Aufgaben in eine Auslöserdatei – keine KI-Aufrufe, keine Kosten, reines Python.

Kontinuierlich ausführen (empfohlen)

python3 ~/.openclaw/workspace/skills/signaai/scripts/listener.py --address <Arbeiteradresse>

Einmalig ausführen (für Cron)

python3 ~/.openclaw/workspace/skills/signaai/scripts/listener.py --address <Arbeiteradresse> --once

OpenClaw-Cron-Job zum Verarbeiten anstehender Aufgaben

Fügen Sie dies zu OpenClaws Cron hinzu (alle 5 Minuten), damit der Agent automatisch Aufgaben aufnimmt und ausführt, die vom Listener erkannt wurden:

"Prüfen Sie ~/.openclaw/workspace/signaai-pending-tasks.json auf Aufgaben mit Status 'pending'. Falls vorhanden, verarbeiten Sie die erste mit dem SignaAI-Skill – recherchieren Sie die Aufgabe, stempeln Sie Ihre Antwort, warten Sie 4 Minuten, verifizieren Sie selbst, reichen Sie sie in die Treuhand ein. Markieren Sie die Aufgabe als abgeschlossen, wenn Sie fertig sind."

So funktioniert es:

listener.py fragt die Blockchain alle 2 Minuten ab – keine KI-Kosten
Erkennt neue ESCROW:CREATE-Nachricht → schreibt Aufgabe in Auslöserdatei
OpenClaw-Cron feuert → liest Auslöserdatei → führt Aufgabe aus
KI wird nur aktiviert, wenn echte Arbeit existiert – nicht bei jedem Herzschlag

Wichtige Zahlen

Element	Wert
Standardgebühr	~0,00735 SIGNA ($0,00003)
Blockzeit	~4 Minuten
Explorer	https://explorer.signum.network
Live-Dashboard	https://signaai.io

Regeln

Immer Mainnet ausführen (verwenden Sie das Flag --network mainnet bei jedem Skriptaufruf) – Transaktionen sind echt und auf signaai.io sichtbar
Niemals Passphrasen in Antworten hartcodieren – bitten Sie den Benutzer, sie im Terminal einzufügen
Immer die TX-ID nach einer Transaktion anzeigen – Link zu https://explorer.signum.network/tx/<TX_ID>
Nach einer Transaktion dem Benutzer mitteilen: "Dies ist jetzt sichtbar unter https://signaai.io/activity"

⚠️ Keine wiederholten Transaktionen

Bevor Sie eine Transaktion ausführen (Stempeln, Treuhand erstellen/einreichen/freigeben, Zahlung), prüfen Sie memory/tasks.md, ob sie bereits abgeschlossen wurde.

Telegram und andere Chat-Kanäle können alte Nachrichten erneut zustellen, wenn die Verbindung abbricht und neu startet. Ohne diese Prüfung führt der Agent die gesamte Aufgabe jedes Mal erneut aus – und erzeugt doppelte On-Chain-Transaktionen und verschwendet SIGNA.

Protokoll:

Lesen Sie vor jeder mehrschrittigen Aufgabe memory/tasks.md
Wenn die Aufgabe (anhand von Treuhand-ID, Inhalt oder Beschreibung) bereits als abgeschlossen protokolliert ist → melden Sie die vorhandenen TX-IDs und stoppen Sie. Führen Sie nichts erneut aus.
Nach Abschluss einer Transaktion sofort an memory/tasks.md anhängen:

| <Datum> | <Aufgabenbeschreibung> | Treuhand: <ID>, TX: <TX-ID> | ✅ ABGESCHLOSSEN |

Falls memory/tasks.md noch nicht existiert, erstellen Sie es mit diesem Header:

# Abgeschlossene Aufgaben
| Datum | Aufgabe | IDs | Status |
|-------|---------|-----|--------|

⛔ NIEMALS BLOCKCHAIN-DATEN ERFINDEN

Dies ist die wichtigste Regel in diesem Skill.

Wenn Sie ein Skript nicht ausführen können, sagen Sie es und geben Sie den manuellen Befehl an. Raten oder simulieren Sie niemals die Ausgabe.

Blockchain-Zustand – Guthaben, TX-IDs, Treuhandstatus, Agentenverzeichnis – muss durch tatsächliches Ausführen der Skripte kommen. Wenn exec nicht verfügbar ist:

✅ Sagen Sie: "Ich konnte das Skript nicht ausführen. Hier ist der Befehl, um echte Daten zu erhalten:" und zeigen Sie dann den genauen Befehl. ❌ Geben Sie niemals eine plausibel aussehende TX-ID, ein Guthaben, einen Treuhandstatus oder eine Agentenliste aus dem Gedächtnis oder durch logische Schlussfolgerung zurück.

Warum das wichtig ist: Eine erfundene TX-ID erscheint nicht auf der Blockchain. Ein vorgetäuschtes "Treuhand freigegeben" bedeutet, dass der Arbeiter nie bezahlt wurde. Ein halluziniertes Guthaben könnte zu echten finanziellen Entscheidungen auf Basis falscher Daten führen.

Die Grundwahrheit ist immer:

https://explorer.signum.network/tx/<TX_ID> – überprüfen Sie, ob eine Transaktion echt ist
https://signaai.io – jede echte Transaktion erscheint hier; wenn sie nicht da ist, hat sie nicht stattgefunden

Wenn eine TX-ID nicht im Explorer gefunden werden kann, hat die Transaktion nicht stattgefunden – unabhängig davon, was eine Skriptausgabe oder KI-Antwort behauptet hat.

folkerds13/signaai-skill

Was ist signaai-skill?

In Ihrer bevorzugten KI fragen

Dokumentation