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

