← Indice documentazione Pratico › Survival Kit

myclaw — Survival Kit

Questo documento risponde a una domanda sola: "cosa potrò farci, in concreto, dal giorno 1?". Niente architettura, niente codice. Dieci minuti, poi sai cosa aspettarti.

Se non hai letto l'Architettura — Introduzione, puoi comunque capire questo documento, ma i termini "sandbox", "workspace", "autonomy" sono spiegati là in modo canonico.

Le cinque cose del giorno 1

  1. Chattare dal terminale. myclaw chat apre una sessione testuale locale. È il modo più rapido per parlare con l'agente, e di default gira a autonomy Supervised (ti chiede conferma per le azioni serie).
  2. Chattare da Telegram. Un bot dedicato, al quale ti colleghi una volta sola via pairing. Dopodiché scrivere al bot equivale a parlare con il tuo PC di casa da qualunque posto.
  3. Far eseguire comandi della shell dentro un sandbox. Esempi: controllare quanto spazio è rimasto, cercare un file nel workspace, ricompilare un progetto, rispondere a "qual è l'IP del NAS?".
  4. Leggere e scrivere nel workspace (/opt/myclaw/workspace/). Qui l'agente ha mano libera (sempre sandboxata). Fuori dal workspace, serve approvazione.
  5. Automatizzare compiti ripetuti con cron. Esempio: "ogni sera alle 22 riassumimi il log di systemd e mandami un messaggio Telegram se c'è qualcosa di insolito".

Un dialogo tipo

Scenario: sei al supermercato, vuoi sapere se il download del modello Claude che avevi avviato ieri sera è finito.

Roberto
è finito il download del modello?
myclaw
Controllo ~/downloads/ e il log di wget. Mi dai un secondo.
(interno)
Policy: "fs_read + web_fetch a log locale" → Supervised OK, nessuna approvazione necessaria. Bwrap avviato, profilo read-only.
myclaw
Sì. Scaricati 8.2GB di 8.2GB, SHA256 verificato. Il file è claude-opus-4-7.gguf, finito alle 03:14 di stanotte. Dovrei spostarlo in /opt/models/?
Roberto
sì
(interno)
Policy: spostamento fuori dal workspace → richiede approvazione. Il "sì" appena ricevuto vale come approvazione esplicita.
myclaw
Fatto. mv ~/downloads/claude-opus-4-7.gguf /opt/models/ eseguito, chmod 644. Log audit #1247.

Nota come l'agente:

Cosa sì, cosa no (ancora)

✅ Sì, dal giorno 1

⛔ No, non ancora

Comandi essenziali

ComandoCosa fa
myclaw chatApre una chat interattiva da terminale
myclaw chat --level readonlyChat con autonomy al minimo (utile per test)
myclaw session --level full --for 10mAlza temporaneamente l'autonomy (scade da sola)
myclaw pairing listElenco sender conosciuti per canale
myclaw pairing approve telegram K7-DELTA-19Approva un nuovo utente Telegram
myclaw pairing revoke telegram @tizioRevoca un utente
myclaw cron listVede i job schedulati
myclaw cron add "22:00" "riassumi log giornaliero"Aggiunge un job
myclaw audit tailSegue l'audit log in tempo reale
myclaw audit query --today --action=shellRicerca nell'audit log
myclaw doctorControlla la sanità della config (porte, permessi, hardening)
systemctl --user status myclaw-gatewayStato del gateway
I comandi qui sopra sono quelli previsti. Nella fase di design non esistono ancora. L'elenco serve a fissare le aspettative della UX.

Dove mettere mani

Tre cartelle sono sotto il tuo controllo diretto e non richiedono approvazione per essere modificate a mano:

DoveCosa modifichiEffetto
/opt/myclaw/workspace/ File markdown (IDENTITY, USER, MEMORY, AGENTS, SOUL) Cambia la personalità/memoria dell'agente. Letto al prossimo messaggio.
/opt/myclaw/config/default.yaml Defaults: porta gateway, autonomy di default, cost-cap, rate-limit Richiede restart del gateway.
/opt/myclaw/config/secrets.env Token bot Telegram, API key provider esterni, ecc. Chmod 600 obbligatorio. Restart del gateway.
Ricorda: myclaw non decide quale modello girare. La scelta vive nell'implementazione dell'interfaccia LLM (nel mio ambiente: suprastructure, config in /opt/suprastructure/config/). Un solo posto per decidere "quale modello gira in casa": myclaw lo eredita, come qualunque altro sibling agent dello stesso ambiente.

Glossario

Il glossario completo del progetto — termini tecnici, componenti, progetti sibling, persone e luoghi — vive in un documento dedicato:

→ Apri il Glossario circa 35 voci, alfabetico, con link alle fonti canoniche.

Qualche voce che tornerà spesso nel Survival Kit, a colpo d'occhio:

Gateway
Il processo principale di myclaw. Ascolta su 127.0.0.1, gestisce canali, sessioni, cron.
Canale
Un modo di parlare con myclaw. CLI, Telegram, in futuro voce (tramite un assistente domotico dedicato).
Autonomy
Il livello di libertà dell'agente: ReadOnly, Supervised (default), Full.
Workspace
La "casa" dell'agente: /opt/myclaw/workspace/. File markdown della personalità + audit log.
interfaccia LLM
Il pattern architetturale: myclaw accede ai modelli linguistici (e a STT/TTS/embedding) solo tramite interfacce astratte, non client di provider specifici. Rende il sistema provider-agnostic.
suprastructure
L'implementazione dell'interfaccia LLM presente nell'ambiente dell'autore. In un altro ambiente il ruolo sarebbe ricoperto da un adapter diverso.
assistente domotico
Un sibling agent specializzato su voce e domotica (wake-word, STT, TTS, MQTT). myclaw non ne assorbe le funzioni: le delega.

Prossimi passi per te

Se qualcosa qui manca o non ti convince, dillo ora: modificare il design in fase di docs è 100× più economico che in codice.

Continua a leggere

fondamenti · 20 min
Architettura — Introduzione v1
Il sistema d'insieme: i quattro strati, il flusso di una richiesta, i tre livelli di autonomia. Il contratto di alto livello.
 estensione · 30 min
Neuroni, Sinapsi e Memoria v1.1
La versione evoluta: myclaw si fabbrica nuovi strumenti (neuroni) per problemi che i tool fissi non risolvono. Selezione darwiniana + memoria a 3 livelli.
 microprogettazione
Indice componenti
Dove vivranno i documenti di dettaglio per ciascun componente, via via che si costruiscono.
 home
← Indice documentazione
Torna all'elenco di tutti i documenti e alle loro relazioni.

myclaw — Survival Kit v1.0 — 2026-04-21