Artykuł 4

Ten artykuł obejmuje kompletną implementację techniczną SafeClaw — od interfejsu Telegram po warstwę API Binance.



━━━ PRZEGLĄD SYSTEMU ━━━

SafeClaw to system wielowarstwowy:

WARSTWA 1 — Interfejs użytkownika
Telegram Bot API (tryb długiego oczekiwania)
Nie wymaga webhooka. Działa za NAT.
Automatyczne ponowne połączenie po przerwaniu połączenia.

WARSTWA 2 — Brama AI
OpenClaw 2026.3.13
Działa na AWS EC2 t3.small (Ubuntu 24.04 LTS)
Usługa systemd — automatycznie uruchamia się przy starcie, automatycznie restartuje się po awarii
Port 18789 (tylko loopback, niepublicznie eksponowany)

WARSTWA 3 — Warstwa Modelu AI
Podstawowy: claude-haiku-4.5 przez openrouter/anthropic/claude-haiku-4.5
Zapas 1: claude-sonnet-4-5 (wyższa dokładność, wyższy koszt)
Zapas 2: meta-llama/llama-3.3-70b-instruct:free (zapas darmowy)
Automatyczne przełączanie w przypadku limitów lub błędów

WARSTWA 4 — Warstwa Umiejętności (10 umiejętności)
Każda umiejętność to plik SKILL.md z instrukcjami w języku naturalnym.
Brak skompilowanego kodu. Brak pipeline'u wdrożeniowego.
Dodaj lub zaktualizuj umiejętność = edytuj plik + uruchom ponownie bramkę.

WARSTWA 5 — Warstwa Integracji API
6 środowisk Binance + 3 zewnętrzne źródła danych



━━━ WARSTWA UMIEJĘTNOŚCI W SZCZEGÓŁACH ━━━

System umiejętności OpenClaw działa poprzez wstrzykiwanie treści SKILL.md do kontekstu agenta, gdy jest wywoływany przez odpowiednie słowa kluczowe lub komendy.

10 umiejętności SafeClaw:

1. api-router
Wewnętrzna warstwa routingu. Odczytuje typ konta użytkownika z sesji i zwraca poprawny adres URL i dane uwierzytelniające. Wywoływana przez wszystkie umiejętności, które potrzebują dostępu do API Binance.

2. p2p-safefinder
Wywołuje API wyszukiwania P2P Binance z skompresowanymi nagłówkami żądań. Stosuje model oceniania. Zwraca listę ocenionych sprzedawców.

3. guardianclaw
Pobiera dane tickerów na żywo z ostatnich 24 godzin, głębokość książki zamówień, niedawne transakcje. Przeprowadza ankietę psychologiczną. Oblicza złożony wynik bezpieczeństwa.

4. smartdca
Pobiera Indeks Strachu i Chciwości. Oblicza adaptacyjny mnożnik. Wywołuje api-router dla poprawnego punktu końcowego. Wykonuje zlecenie rynkowe. Rejestruje w historii sesji.

5. briefing
Partiowo pobiera 5 głównych tickerów aktywów. Pobiera najlepiej poruszające się. Pobiera lokalną stawkę P2P. Pobiera Strach i Chciwość. Formatuje zorganizowane podsumowanie rynku.

6. safeclaw-academy
Routuje do dema lub testnetu w zależności od typu konta użytkownika. Wykonuje rzeczywiste zlecenia na Binance Demo API. Oblicza ceny likwidacji. Oceny decyzji handlowych. Linki do zasobów Binance Academy.

7. yield-monitor
Wywołuje punkty końcowe API Binance Earn. Porównuje bieżące stawki z dostępnymi stawkami. Oblicza możliwości optymalizacji zysku.

8. square-content-engine
Pobiera wiele kanałów RSS i dane rynkowe jednocześnie. Generuje 3 wersje robocze z różnymi profilami optymalizacji. Publikuje za pośrednictwem Binance Square OpenAPI.

9. user-onboarding
5-krokowy kreator. Weryfikuje klucze API względem poprawnych punktów końcowych. Przechowuje typ konta i preferencje w sesji. Obsługuje rzeczywiste, demo i konta testowe.

10. profile
Odczytuje ustawienia z sesji. Pobiera aktualny bilans z poprawnego punktu końcowego Binance. Wyświetla zjednoczony widok profilu.



━━━ UŻYTKOWANIE API BINANCE ━━━

SafeClaw używa więcej API Binance niż jakikolwiek inny projekt OpenClaw, o którym wiemy:

Publiczne API (bez uwierzytelniania):
• GET /api/v3/ticker/24hr — dane o cenie i wolumenie
• GET /api/v3/ticker/price — aktualna cena
• GET /api/v3/depth — książka zamówień
• GET /api/v3/trades — niedawne transakcje
• POST p2p.binance.com/.../adv/search — lista sprzedawców P2P

Uwierzytelnione API (własny klucz użytkownika):
• GET /api/v3/account — weryfikacja salda i uprawnień
• POST /api/v3/order — wykonanie zlecenia na rynku spot
• POST /fapi/v1/leverage — ustawienie dźwigni futures
• POST /fapi/v1/order — zlecenie na rynku futures
• GET /fapi/v2/account — saldo futures
• GET /fapi/v2/positionRisk — otwarte pozycje futures
• GET /sapi/v1/lending/union/account — przegląd Earn
• GET /sapi/v1/lending/daily/product/list — stawki Earn
• GET /sapi/v1/staking/position — pozycje stakingowe

Binance Demo API:
• demo-api.binance.com — identyczne z żywym API spot
• demo-fapi.binance.com — identyczne z żywym API futures

Binance Square API:
• POST /bapi/composite/v1/public/pgc/openApi/content/add

Podpisywanie żądań: HMAC SHA256 z znakiem czasowym + ciąg parametrów.
Wszystkie podpisane żądania używają własnego klucza API użytkownika — nigdy wspólnego klucza serwera.



━━━ INFRASTRUKTURA ━━━

Serwer: AWS EC2 t3.small
• vCPUs: 2
• RAM: 2GB + 2GB swap
• Pamięć: 30GB gp3 EBS
• OS: Ubuntu 24.04 LTS
• Koszt: ~$15/miesiąc (darmowy poziom przez 12 miesięcy)

Czas wykonywania: Node.js 22.22.1 (pakiet systemowy, nie nvm)
Pakiet: OpenClaw zainstalowany przez npm global
Usługa: systemd usługa użytkownika z włączonym lingering
Monitorowanie: status bramki openclaw + logi openclaw

GitHub: https://github.com/bnbnepalbinanceangel/SafeClaw
Szablon konfiguracji: config.template.json (bez sekretów)
Umiejętności: katalog skills/ (10 plików SKILL.md)
Workspace: workspace/ (SOUL.md, AGENTS.md, IDENTITY.md)



━━━ ARCHITEKTURA WDROŻENIA ━━━

Lokalny rozwój:
WSL2 Ubuntu na Windows 11
Natywna instalacja OpenClaw (nie Docker)
Lokalny bot testowy z oddzielnym tokenem
Binance Testnet do testowania bezpiecznych transakcji

Produkcja:
AWS EC2 t3.small zawsze włączony
Token bota produkcyjnego
Binance Demo API dla funkcji Academy
Prawdziwe Binance API dla żywych użytkowników

Pipeline wdrożeniowy:
git push → SSH na serwer → git pull → cp skills → uruchom ponownie bramkę
(Automatyczny skrypt aktualizacji: ~/update-safeclaw.sh)



━━━ EFEKTYWNOŚĆ KOSZTÓW ━━━

Wnioskowanie AI: Claude Haiku 4.5 ≈ $0.001 za wiadomość
Serwer: ~$15/miesiąc AWS EC2 t3.small
OpenRouter: płatność za użycie, brak minimalnego
Całkowity koszt dla 1 000 użytkowników/dzień: ~$16/miesiąc

To sprawia, że SafeClaw jest jednym z najbardziej efektywnych kosztowo produkcyjnych botów AI w infrastrukturze Binance.



━━━ ŚCIEŻKA SKALOWALNOŚCI ━━━

Bieżąca architektura obsługuje setki równoczesnych użytkowników na t3.small.

Ścieżka skalowania poziomego:
→ t3.small → t3.medium → t3.large (wertykalne, proste)
→ Wiele instancji OpenClaw za load balancerem (poziome)
→ Redis session store dla współdzielonego stanu (wiele instancji)
→ Oddzielne węzły robocze dla ciężkich subagentów (SmartDCA, Academy)

Natywne uruchamianie wielu agentów OpenClaw (sessions_spawn) jest już skonfigurowane dla współbieżności subagentów do 8 równoległych agentów na głównym orkiestratorze.

Szybkie linki:

Artykuł 1 Artykuł 2 Artykuł 3 Artykuł 5 Artykuł 6 Artykuł 7 Artykuł 8

Źródło: https://github.com/bnbnepalbinanceangel/SafeClaw

#AIBinance #SafeClaw #TechStack #OpenClaw #Binance