agent-access-control

Tiered stranger access control for AI agents. Use when setting up contact permissions, handling unknown senders, managing approved contacts, or configuring stranger deflection on messaging platforms (WhatsApp, Telegram, Discord, Signal). Provides diplomatic deflection, owner approval flow, and multi-tier access (owner/trusted/chat-only/blocked).

1. Utwórz plik memory/access-control.json w katalogu workspace swojego agenta. Skopiuj do niego strukturę JSON zawierającą puste tablice ownerIds, approvedContacts, pendingApprovals, blockedIds oraz domyślną wiadomość dla nieznajomych.

2. Uzupełnij pole ownerIds, wpisując identyfikatory właściciela agenta — numery telefonu, identyfikatory Telegram lub Discord w formacie tekstowym (string). To są osoby z pełnym dostępem do wszystkich funkcji agenta.

3. Dostosuj wiadomość strangerMessage, zastępując {{AGENT_NAME}} rzeczywistą nazwą swojego agenta. Ta wiadomość będzie wysyłana do osób, które nie są na liście zatwierdzonych kontaktów.

4. Skonfiguruj powiadomienia dla właściciela, wybierając kanał notifyChannel (telegram, whatsapp, discord lub signal) i wpisując identyfikator właściciela na tym kanale w polu notifyTarget. Agent będzie informować właściciela o nowych próbach kontaktu.

5. Skill automatycznie będzie sprawdzać każdą wiadomość przychodzącą — jeśli nadawca jest właścicielem, uzyska pełny dostęp; jeśli jest na liście zaufanych, będzie mógł rozmawiać i otrzymywać informacje publiczne; jeśli jest na liście tylko-czat, będzie mógł tylko rozmawiać; jeśli jest zablokowany, wiadomość zostanie zignorowana.

6. Zarządzaj dostępem poprzez edycję pliku access-control.json — dodawaj kontakty do approvedContacts, przenoś je między poziomami dostępu lub dodawaj do blockedIds w zależności od potrzeb bezpieczeństwa.