16 tool · ~89 metodi · 13 domini

RizzoClaw
Mappa della Pipeline

Bot Telegram di controllo della VPS COSMO. Riceve testo o vocale, classifica in <1 secondo, e orchestra 16 tool per eseguire qualsiasi task: dalla pubblicazione di articoli alla generazione video.

16
Tool Registrati
~89
Metodi Disponibili
13
Domini Operativi
30
Max Tool Call / Richiesta
10m
Timeout Richiesta
<1s
Tempo Router
// architettura

Come Funziona il Routing

Due layer di elaborazione: routing veloce con Gemini Flash, processing profondo con Claude Sonnet + 16 tool.

Telegram Input
Testo o vocale (OGG → trascrizione Gemini Flash)
bot.py
Layer 1: Classificazione
Gemini 2.5 Flash — classifica CHAT o TASK in <1 secondo
CHAT
Quick Reply
Gemini Flash, no tool, 1-2 frasi. Saluti, conferme, chat leggera.
TASK
"Ci penso..." + Layer 2
CosmoMemory injection → Claude Sonnet 4.6 + 16 tool (max 30 call)
agent.py
bot.py
Media Detection + Delivery
Scansiona path immagini/video nel testo → invia automaticamente come foto/video Telegram. Testo in chunk da 4000 char.
// capacita

Cosa Puo' Fare RizzoClaw

13 domini operativi, dal content publishing alla generazione video. Ogni card elenca i comandi principali con esempi.

Pipeline & Pubblicazione

Controlla tutte le pipeline di contenuti: Facebook, Galanti, Digest. 16 metodi in PipelineTool.
  • •
    Crea post Facebook con topic e tipo (breve/medio/divulgativo)"pubblica su facebook: topic AI agents"
  • •
    Crea, leggi, modifica e pubblica articoli Galanti Digital"scrivi un articolo su LiteLLM per galanti"
  • •
    Approva/rifiuta draft con bottoni HITL"approva il draft abc123"
  • •
    Health check su 11 agenti attivi"stato pipeline" / "chi e' attivo?"
  • •
    Trigger DailyDigest on-demand"mandami il digest"

Manfria Attiva (Sito)

Modifica il frontend Next.js e deploya in staging o produzione.
  • •
    Modifica UI/codice con staging preview"cambia il colore dell'header di manfria"
  • •
    Deploy in produzione (rebuild 2-5 min)"metti in produzione manfria"

Email & Comunicazioni

Legge, analizza, cerca email Gmail. Crea bozze di risposta (MAI invia direttamente).
  • •
    Corpo completo email (non solo snippet)"email di Marco questa settimana"
  • •
    Analisi contatto: timeline + temi + azioni + tono"analizza le comunicazioni con Giulia Arzano"
  • •
    Ricerca e lettura singola email"cerca email su fattura Aboca"
  • •
    Bozza risposta in Gmail"scrivi una bozza di risposta a Marco"

Documenti & Drive

Crea Google Docs, Sheets, cartelle. Legge, scrive, cerca su Drive. 12 metodi in GwsTool.
  • •
    Google Doc formattato con header/footer"crea un documento con l'analisi delle email"
  • •
    Spreadsheet: crea, leggi, scrivi celle"crea un foglio con i dati fatturazione"
  • •
    Ricerca file su Drive con filtri"trova i PDF su Drive"

Generazione Immagini

Imagen 3 (Vertex AI) e WaveSpeed (Flux/Kling). Invio automatico come foto Telegram.
  • •
    Imagen 3 via Vertex AI (PNG locale)"genera un'immagine di un tramonto siciliano"
  • •
    WaveSpeed Flux/Kling (URL immagine)"genera un logo con WaveSpeed"

Generazione Video

Kling O3 via WaveSpeed e Veo 2 via Vertex AI. Text-to-video e image-to-video.
  • •
    Video da testo con Kling (5-10s, 1-3 min)"genera un video di onde sulla spiaggia"
  • •
    Anima immagine con Kling img2vid"anima questa immagine"
  • •
    Veo 2 via Vertex (5 o 8 secondi)"genera un video con Veo di..."

Grafici & Visualizzazioni

ChartTool genera PNG dark theme con matplotlib. Barre, linee, torte, tabelle.
  • •
    Grafico a barre, linee, torta"grafico: Italia 60M, Francia 67M, Germania 83M"
  • •
    Tabella visiva come immagine PNG"crea una tabella con i dati del Q1"

Ricerca Web & Info

DuckDuckGo, Grounded Search (Gemini + Google), Hacker News.
  • •
    Ricerca veloce DuckDuckGo"cerca info su LiteLLM"
  • •
    Grounded Search con fonti citate"cerca con fonti: ultimo aggiornamento Next.js"
  • •
    Hacker News top stories"cosa c'e' su HN oggi?"

Memoria (CosmoMemory)

Qdrant vector DB. Ricerca semantica, salvataggio, audit. Iniettata automaticamente in ogni TASK.
  • •
    Ricerca semantica nella memoria"chi e' il referente di Roadsitalia?"
  • •
    Salva informazioni"ricorda che Giulia e' la referente tecnica"
  • •
    Audit e pulizia per categoria/source"quante cose hai in memoria?"

Gestione VPS & Agenti

Shell, tmux, Docker, file, Python inline. Task complessi via sub-agent Claude.
  • •
    Sessioni tmux, log agenti, restart"mostrami i log del creativo"
  • •
    Container Docker, comandi shell"come stanno i container?"
  • •
    Sub-agent Claude per task complessi"fai un audit completo della VPS"

GitHub & Codebase

GitHubTool (10 metodi API) + CodebaseSearchTool (semantic search su 3555 chunk Qdrant).
  • •
    Repo, PR, issue, branch, commit, tree"stato del repo cosmo_agents_26"
  • •
    Semantic code search in Qdrant"dove e' definito get_model?"
  • •
    Leggi file e README da GitHub"leggi il README del repo manfria"

Calendario

Google Calendar: lista eventi e creazione. 2 metodi in GwsTool.
  • •
    Lista prossimi eventi"cosa ho in agenda?"
  • •
    Crea evento calendario"metti una call martedi' 15:00"

Data & Analytics

BigQuery, GA4, GSC via DataSquad agent :8900. Query in linguaggio naturale.
  • •
    Query analytics per cliente"quante sessioni ha avuto Pirelli?"
  • •
    Lista progetti e servizi configurati"quali clienti analytics hai?"
// esempi

Cosa Scrivere su Telegram

Esempi reali di messaggi e cosa succede dietro le quinte.

Pipeline
pubblica su facebook: come gli agenti AI cambiano il marketing
PipelineTool.facebook_submit → ResearchAgent + ContentAgent + ImageAgent → draft con preview Telegram + bottoni HITL
Email
analizza le comunicazioni con Giulia Arzano
EmailAnalystTool.analyze_contact_emails → legge tutti i thread, produce timeline, temi ricorrenti, azioni aperte, tono comunicazione
Immagini
genera un'immagine di una torre medievale al tramonto in Sicilia
VertexTool.imagen_generate → PNG in /tmp/vertex_images/ → bot.py media detection → inviata come foto Telegram
Ricerca
cerca con fonti: novita' di Agno framework 2026
VertexTool.grounded_search → Gemini + Google Search live → risposta con URL fonti verificate
Grafici
grafico a torta: Anthropic 40%, OpenAI 35%, Google 25%
ChartTool.create_pie_chart → PNG dark theme → inviato come immagine Telegram
VPS
mostrami i log del creativo
ShellTools → tmux capture-pane -t creativo -p -S -50 → ultime 50 righe di output
Memoria
ricorda che il prossimo meeting con Pirelli e' giovedi' 20 marzo
CosmoMemoryTool.memory_remember → salva in Qdrant, categoria "events" → recuperabile via ricerca semantica
Video
genera un video di onde che si infrangono sulla costa con Veo
VertexTool.veo_generate → MP4 in /tmp/vertex_videos/ → inviato come video Telegram
GitHub
dove e' definito get_model nel codebase?
CodebaseSearchTool.search_codebase → semantic search su 3555 chunk Qdrant → file, riga, contesto
// numeri

Tool Breakdown

Distribuzione dei metodi per tool — quanto e' grande ogni componente.

GwsTool
19
PipelineTool
16
GitHubTool
10
CosmoMemoryTool
6
ChartTool
4
VertexTool
4
CodebaseSrchTool
3
WavespeedTool
3
EmailAnalystTool
2
DocWriterTool
2
ClaudeCodeTool
1

Metodi registrati per tool custom/condiviso (70 totali)

89
metodi
70 metodi custom/condivisi (11 tool)
~19 metodi Agno built-in (5 tool)
Tool Opzionali (degradano silenziosamente)
GwsTool — richiede gws CLI
ClaudeCodeTool — richiede claude CLI
WavespeedTool — richiede WAVESPEED_API_KEY
VertexTool — richiede google-cloud-aiplatform
GitHubTool + CodebaseSearchTool — richiede qdrant-client
// pipeline

Flussi Principali

Come i messaggi Telegram diventano azioni concrete attraverso le pipeline.

Facebook Pipeline
Telegram
RizzoClaw
→
PipelineAgent
:8607
→
Research
:8603
→
Content
:8604
→
Image
:8605
→
Review
:8606
→
HITL Telegram
Approve / Reject
→
Facebook Page
:8602
Galanti Digital Pipeline
Telegram
RizzoClaw / GroupAgent
→
PipelineAgent
:8811
→
ContentAgent
:8812 (research + write + HTML)
→
Creativo
:8820 (voice review)
→
HITL
Approve / Fix / Reject
→
SiteAgent
:8813 (publish)
Media Generation
Telegram
"genera un video di..."
→
Claude Sonnet
sceglie tool
→
WaveSpeed / Vertex
genera MP4/PNG
→
Media Detection
bot.py auto-send
→
Telegram
foto/video
// modelli

Stack AI

Tre modelli con ruoli distinti, tutti via LiteLLM proxy :4000.

Router
Gemini 2.5 Flash
Layer 1: Classifica CHAT vs TASK in <1 secondo. Anche usato per: trascrizione vocali OGG, risposte CHAT veloci. Costo minimo, 1M context.
Executor
Claude Sonnet 4.6
Layer 2: Ragionamento complesso + 16 tool. Max 30 tool call per richiesta, timeout 10 minuti. Gestisce tutti i task operativi: pipeline, email, code, media.
Sub-agent
Claude (via ClaudeCodeTool)
On-demand: Task complessi multi-step che richiedono un agente autonomo (audit VPS, refactoring, analisi profonde). Max 10 minuti di esecuzione.
// mappa tecnica

Tool Map per Debug

Ogni tool, dove vive, quanti metodi ha, e cosa fa. Per sviluppo e troubleshooting.

Tool Custom — /root/projects/rizzoclaw/rizzoclaw/

File Classe # Metodi
pipeline_tool.py PipelineTool 16 pipelines_status, facebook_submit, facebook_approve, facebook_reject, facebook_drafts, galanti_idea, galanti_staging_list, galanti_read_article, galanti_update_article, galanti_approve, galanti_reject, trigger_digest, manfria_frontend_staging, manfria_frontend_deploy, data_query, data_projects
cosmo_memory_tool.py CosmoMemoryTool 6 memory_search, memory_list, memory_remember, memory_get_context, memory_delete_by_source, memory_audit
chart_tool.py ChartTool 4 create_bar_chart, create_line_chart, create_pie_chart, create_table_image
email_analyst_tool.py EmailAnalystTool 2 read_emails_full, analyze_contact_emails
doc_writer_tool.py DocWriterTool 2 create_report_doc, create_doc_raw

Tool Condivisi — /root/projects/agents/tools/

File Classe # Metodi
gws_tool.py GwsTool 19 list_emails, list_emails_with_details, read_email, read_email_full, search_emails, create_draft, create_draft_reply, list_drive_files, search_drive, get_drive_file, create_drive_folder, create_spreadsheet, read_spreadsheet, write_spreadsheet, create_doc, write_doc, read_doc, list_calendar_events, create_calendar_event
github_tool.py GitHubTool 10 list_repos, repo_status, list_prs, list_branches, recent_commits, read_file, search_code, get_tree, get_readme, list_issues
vertex_tool.py VertexTool 4 grounded_search, get_embedding, imagen_generate, veo_generate
codebase_search_tool.py CodebaseSearchTool 3 search_codebase, search_in_repo, list_indexed_repos
wavespeed_tool.py WavespeedTool 3 generate_image, generate_video, generate_image_to_video
claude_code_tool.py ClaudeCodeTool 1 run_claude

Tool Agno Built-in

Classe # Metodi Principali
PythonTools ~7 run_python_code, save_to_file_and_run, run_python_file, pip_install_package, uv_pip_install, read_file, list_files
FileTools ~7 save_file, read_file, read_file_chunk, replace_file_chunk, list_files, search_files, delete_file
WebSearchTools 2 web_search, search_news
HackerNewsTools 2 get_top_hackernews_stories, get_user_details
ShellTools 1 run_shell_command
agent.py:211-216
_tools = [
    WebSearchTools(), FileTools(), PythonTools(), ShellTools(), HackerNewsTools(),
    PipelineTool(), CosmoMemoryTool(),
    EmailAnalystTool(), DocWriterTool(),
    ChartTool(),
] + _gws_tools + _claude_code_tools + _wavespeed_tools + _vertex_tools + _codebase_tools