Come utilizzare Felo Slides con Claude Code e agenti AI

June 25, 2026 · 13 minuti di lettura

Committed to answers at your fingertips

Crea presentazioni potenziate dall’intelligenza artificiale direttamente dal terminale utilizzando Felo Slides con Claude Code, OpenClaw e il pacchetto npm felo-slides. Una guida per sviluppatori alla generazione programmata di slide.

$ npx felo-slides "Spiega la pianificazione dei pod Kubernetes in 8 slide"
✓ Analisi dell’argomento...
✓ Generazione dell’indice (8 slide)...
✓ Creazione dei contenuti delle slide...
✓ Costruzione della presentazione...
✔ Fatto → kubernetes-pod-scheduling.felo

Ecco fatto. Niente browser. Niente drag-and-drop. Niente selezione di template. Hai digitato un solo comando e sono comparse otto slide.

Se hai mai partecipato a una riunione di 40 minuti che sarebbe dovuta essere solo un set di slide, sai già perché abbiamo creato Felo Slides. Ma questo post non parla dell’app web — riguarda cosa succede quando metti nelle mani degli sviluppatori un’API e dici loro di automatizzare tutto.

Ecco come usare Felo Slides con Claude Code, gli agenti OpenClaw e i tuoi script per generare slide AI senza mai uscire dal terminale.

[IMG: Screenshot del terminale che mostra la CLI felo-slides mentre genera una presentazione da un prompt singolo, con l’output evidenziato]

Cos’è Felo Slides (per sviluppatori)?

Felo Slides è un motore di presentazioni basato su AI. La maggior parte delle persone lo conosce come un’app web su slides.felo.ai. Dietro le quinte, è anche:

Pacchetto npm felo-slides — una CLI e libreria per generare slide in modo programmatico
Claude Code Skill — una skill nativa che permette a Claude Code di creare presentazioni in linea
OpenClaw Skill — stessa idea, integrata nel framework di agenti OpenClaw
REST API — endpoint HTTP per generare slide, analizzare argomenti e renderizzare template

L’app web è il front-end rifinito. Gli strumenti per sviluppatori sono il motore. Puoi combinarli: usa la CLI per generazioni rapide in locale, l’API per automazione server-side o la skill di Claude Code per creare slide in conversazione.

Quando usare cosa:

Caso d’uso	Strumento
Slide rapide dal terminale	`felo-slides` CLI
Generazione conversazionale nell’editor	Claude Code Skill
Workflow basati su agenti	OpenClaw Skill
Backend / CI / processi batch	Felo Slides API

Installazione e configurazione

Prerequisiti

Node.js 18+ (consigliato 20+)
Un account Felo con accesso API (va bene anche il piano gratuito)
Una chiave API da slides.felo.ai/settings/api

Installa il pacchetto npm

npm install -g felo-slides

Oppure usalo senza installazione:

npx felo-slides "Il tuo argomento di presentazione qui"

Autenticazione

Imposta la tua chiave API come variabile d’ambiente:

export FELO_SLIDES_API_KEY=fsk_la_tua_api_key_qui

Oppure crea un file .felo-slides.json nella root del progetto:

{
  "apiKey": "fsk_la_tua_api_key_qui",
  "defaultOutput": "./presentations",
  "template": "developer-dark"
}

Verifica del funzionamento

$ felo-slides --version
felo-slides 2.4.0

$ felo-slides --check
✓ Chiave API valida
✓ Limite richieste: 47/50 rimanenti
✓ Template caricati: 12

[IMG: Confronto affiancato tra output del terminale che mostra una configurazione riuscita e comuni errori di autenticazione]

Utilizzare Felo Slides con Claude Code

Qui le cose si fanno interessanti. La skill di Claude Code trasforma l’editor di Claude in una fabbrica di presentazioni. Invece di scrivere prompt e copiare output, Claude genera, modifica ed esporta le presentazioni direttamente.

Installa la Claude Code Skill

# Nella directory del progetto Claude Code
claude skill add felo-slides

Questo registra la skill Felo Slides con Claude Code. Ora Claude sa che può creare presentazioni e ha accesso all’intera API di felo-slides.

Uso di base in Claude Code

Una volta installato, chiedi semplicemente a Claude:

> Crea una presentazione di 10 slide sul piano ingegneristico del Q3.
  Includi sezioni su: migrazione della piattaforma, piano assunzioni
  e budget infrastrutturale.

Claude eseguirà:

Bozza un indice e ti conferma la struttura
Genera i contenuti delle slide usando l’API di Felo Slides
Salva il file .felo nella directory del progetto
Ti propone modifiche su slide specifiche

Niente cambio di contesto. Niente copia e incolla. Le slide vivono nel tuo repository assieme al codice.

Avanzato: template personalizzati in Claude Code

Puoi definire template di slide specifici per progetto che Claude userà automaticamente:

mkdir -p .felo/templates

Crea .felo/templates/engineering.json:

{
  "name": "Aggiornamento Ingegneria",
  "theme": "dark",
  "accent": "#6366f1",
  "fonts": {
    "heading": "JetBrains Mono",
    "body": "Inter"
  },
  "layout": {
    "titleSlide": "code-hero",
    "contentSlide": "split-left",
    "closingSlide": "cta-minimal"
  }
}

Poi in Claude Code:

> Crea una presentazione sulla migrazione del servizio auth.
  Usa il template di ingegneria.

Claude rileva automaticamente il template e lo applica a ogni slide generata.

[IMG: Editor di Claude Code che mostra una conversazione dove l’utente chiede una presentazione, Claude genera un indice e il file .felo appare nel file tree]

Modifica conversazionale delle slide

Il vero potere dell’integrazione con Claude Code è la modifica iterativa:

> La slide 3 è troppo densa. Dividila in due slide.
  Sposta il diagramma dell’architettura nella slide 4.

> Aggiungi note del presentatore alle slide 5-7. Mantienile
  sotto le 50 parole ciascuna.

> Cambia il colore di accento con il verde del nostro brand (#10b981)
  e aggiungi il logo alla slide del titolo.

Ogni modifica è una chiamata API sotto il cofano, ma non vedrai mai la richiesta HTTP. Claude gestisce tutto.

Utilizzare Felo Slides con OpenClaw

OpenClaw porta l’approccio ad agenti ancora oltre. La skill Felo Slides per OpenClaw consente agli agenti AI di generare presentazioni come parte di workflow più ampi — non solo in risposta a comandi diretti.

Configurazione

openclaw skill install felo-slides

Configura nel tuo workspace OpenClaw:

# openclaw.yaml
skills:
  felo-slides:
    apiKey: "${FELO_SLIDES_API_KEY}"
    defaultTemplate: "professional"
    outputDir: "./output/slides"

Generazione di slide guidata da agenti

Con OpenClaw puoi attivare la generazione di slide all’interno dei flussi di lavoro degli agenti:

Utente: Abbiamo appena chiuso l’accordo Acme. Prepara una
        presentazione di kickoff per il team di ingegneria.
        Usa il brief del progetto da Notion e la timeline da Linear.

Agente: [legge il brief da Notion]
         [recupera la timeline da Linear]
         [genera 12 slide di kickoff tramite felo-slides]
         [salva su output/slides/acme-kickoff.felo]
         "Fatto. Creata una presentazione di 12 slide su ambito,
          tempistiche, assegnazioni e tappe principali.
          Vuoi che la invii a #eng-general?"

L’agente ha recuperato il contesto da due strumenti esterni, l’ha strutturato in una presentazione e ha generato le slide — tutto in un unico passaggio.

[IMG: Diagramma che mostra il workflow dell’agente OpenClaw: richiesta utente → raccolta contesto (Notion, Linear) → API felo-slides → file di output → consegna]

Esempi da riga di comando

Vediamo la CLI più in dettaglio. Questi esempi coprono i flussi di lavoro più comuni per gli sviluppatori.

Genera da un argomento

felo-slides "Microservizi vs monoliti: una guida pragmatica" --slides 12

Genera da un file Markdown

felo-slides --from ./meeting-notes.md --template "standup"

La CLI analizza il Markdown, rileva titoli e punti elenco e li mappa automaticamente alle slide.

Genera da un URL

felo-slides --from-url https://github.com/org/repo/blob/main/README.md

Utile per trasformare documentazione, post o RFC in presentazioni.

Generazione batch

# Genera slide per più argomenti
felo-slides batch --file topics.txt --output ./deck-batch/

Dove topics.txt contiene un argomento per riga:

Revisione OKR Q4
Onboarding nuovi assunti: Backend
Postmortem incidente: guasto del 12-05-2026
Record decisione architetturale: Event Sourcing

Formati di esportazione

# Esporta in PDF
felo-slides export ./output.felo --format pdf

# Esporta in PPTX
felo-slides export ./output.felo --format pptx

# Esporta in immagini (una PNG per slide)
felo-slides export ./output.felo --format png --dpi 300

Integrazione CI/CD

# .github/workflows/weekly-deck.yml
name: Genera presentazione di aggiornamento settimanale
on:
  schedule:
    - cron: '0 9 * * 1'  # Ogni lunedì alle 9

jobs:
  generate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npx felo-slides "Aggiornamento ingegneristico settimanale per ${{ github.run_id }}" --template weekly --output ./decks/
      - uses: actions/upload-artifact@v4
        with:
          name: weekly-deck
          path: ./decks/

[IMG: Log di esecuzione di GitHub Actions che mostra il passaggio felo-slides completato con successo, con la presentazione generata elencata sotto Artifacts]

Esempi di workflow di automazione

Ecco tre workflow reali in cui Felo Slides fa risparmiare molto tempo.

1. Bot di preparazione pre-riunione

Un bot Slack che genera automaticamente una presentazione iniziale prima di ogni riunione ricorrente:

import { FeloSlides } from 'felo-slides';
import { getMeetingContext } from './calendar-integration';

const slides = new FeloSlides({ apiKey: process.env.FELO_SLIDES_API_KEY });

export async function prepareMeetingDeck(meetingId: string) {
  const context = await getMeetingContext(meetingId);

  const deck = await slides.generate({
    topic: context.title,
    slides: 8,
    context: [
      `Partecipanti: ${context.attendees.join(', ')}`,
      `Azioni precedenti: ${context.lastActions.join('; ')}`,
      `Agenda: ${context.agenda.join(', ')}`,
    ],
    template: 'standup',
  });

  await slides.export(deck.id, { format: 'pdf' });
  await postToSlack(context.channel, {
    text: `📊 Presentazione iniziale per ${context.title}`,
    files: [{ file: deck.exportPath, filename: `${context.title}.pdf` }],
  });
}

2. Pipeline Documentazione → Presentazione

Conversione automatica di nuovi RFC o documenti di progettazione in bozze di presentazioni:

#!/bin/bash
# hooks/post-commit-slides.sh

# Rileva nuovi file .md in /docs/rfcs
CHANGED_FILES=$(git diff --name-only HEAD~1 HEAD -- 'docs/rfcs/*.md')

for file in $CHANGED_FILES; do
  TITLE=$(head -1 "$file" | sed 's/^# //')
  OUTPUT="./presentations/$(basename "$file" .md).felo"

  npx felo-slides --from "$file" --template "rfc" --output "$OUTPUT"

  echo "Generate slide per: $TITLE → $OUTPUT"
done

Collega questo script come hook di git o step CI, e ogni nuovo RFC avrà automaticamente la sua presentazione gemella.

3. Riproporre contenuti in più formati

Trasforma un singolo contenuto in un post sul blog, una presentazione e un thread sui social:

import { FeloSlides } from 'felo-slides';
import { generateBlog } from './blog-generator';
import { generateSocialThread } from './social-generator';

async function repurposeContent(sourceUrl: string) {
  // Recupera e analizza i contenuti sorgente
  const content = await fetchAndParse(sourceUrl);

  // Genera tutti e tre i formati in parallelo
  const [blog, deck, thread] = await Promise.all([
    generateBlog(content, { words: 2000 }),
    new FeloSlides().generate({
      topic: content.title,
      slides: 10,
      context: content.summary,
    }),
    generateSocialThread(content, { posts: 8 }),
  ]);

  return { blog, deck, thread };
}

Una sola fonte, tre output. La presentazione non è un ripensamento — è generata con la stessa intelligenza contenutistica del post sul blog.

[IMG: Diagramma di flusso che mostra un contenuto sorgente che si dirama in tre output: post sul blog, presentazione e thread sui social]

Riferimento API

Per i team che costruiscono integrazioni personalizzate, l’API di Felo Slides espone tre endpoint principali.

Autenticazione

Tutte le richieste richiedono una chiave API nell’header:

Authorization: Bearer fsk_la_tua_api_key_qui

POST /v1/slides/generate

Genera una nuova presentazione.

curl -X POST https://api.slides.felo.ai/v1/slides/generate \
  -H "Authorization: Bearer fsk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Introduzione a WebAssembly",
    "slideCount": 10,
    "template": "developer-dark",
    "context": [
      "Pubblico: ingegneri backend senior",
      "Concentrarsi su casi d’uso pratici, non teoria",
      "Includere confronto prestazioni con Docker"
    ],
    "language": "en"
  }'

Risposta:

{
  "id": "deck_abc123",
  "status": "processing",
  "estimatedSeconds": 15,
  "slides": 10,
  "pollUrl": "/v1/slides/deck_abc123"
}

GET /v1/slides/{id}

Controlla lo stato e recupera una presentazione completata.

curl https://api.slides.felo.ai/v1/slides/deck_abc123 \
  -H "Authorization: Bearer fsk_your_api_key_here"

Risposta (quando completa):

{
  "id": "deck_abc123",
  "status": "complete",
  "slides": [
    {
      "number": 1,
      "title": "Cos’è WebAssembly?",
      "content": "...",
      "notes": "..."
    }
  ],
  "downloadUrls": {
    "felo": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?felo",
    "pdf": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?pdf",
    "pptx": "https://api.slides.felo.ai/v1/slides/deck_abc123/download?pptx"
  }
}

POST /v1/slides/{id}/edit

Modifica una presentazione esistente in modo programmatico.

curl -X POST https://api.slides.felo.ai/v1/slides/deck_abc123/edit \
  -H "Authorization: Bearer fsk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "actions": [
      { "type": "update", "slide": 3, "title": "WASM vs Container: Benchmark" },
      { "type": "insert", "after": 5, "title": "Demo live", "content": "..." },
      { "type": "delete", "slide": 8 }
    ]
  }'

Limiti di utilizzo

Piano gratuito: 50 richieste/giorno, 5 richieste/min
Piano Pro: 500 richieste/giorno, 30 richieste/min
Enterprise: limiti personalizzati

La CLI felo-slides e tutti gli SDK gestiscono automaticamente i limiti con backoff esponenziale.

[IMG: Screenshot della documentazione API che mostra i tre endpoint con esempi di richieste e risposte]

Domande frequenti (FAQ)

Posso usare Felo Slides offline?

La fase di generazione richiede una chiamata API (il modello AI gira lato server). Ma puoi esportare le presentazioni in PDF o PPTX e lavorarci localmente in seguito. La CLI memorizza nella cache le ultime 10 presentazioni generate per la visualizzazione offline.

Come gestisco contenuti sensibili?

Tutte le richieste API sono criptate in transito (TLS 1.3) e a riposo. I contenuti delle slide non vengono usati per l’addestramento del modello. Per le aziende con esigenze di residenza dei dati, contattaci per soluzioni on-premise.

Posso usare i miei template?

Sì. Il pacchetto npm e l’API supportano template personalizzati. Definisci il tuo template in un file JSON (vedi la sezione su Claude Code), poi riferiscilo per nome o percorso:

felo-slides "Argomento qui" --template ./my-template.json

Qual è il formato di output?

Le presentazioni generate sono archiviate come file .felo (un formato JSON strutturato). Puoi esportarle in PDF, PPTX, PNG o HTML. Il formato .felo è modificabile — puoi cambiarlo via codice o reimportarlo per ulteriori modifiche AI.

La skill di Claude Code funziona con Claude CLI o solo con l’app desktop?

Entrambe. La skill funziona sia con claude nel terminale sia nell’app desktop di Claude. L’installazione è identica in entrambi i casi.

Posso generare slide in lingue diverse dall’inglese?

Sì. Passa il parametro language (codice ISO 639-1) all’API o il flag --lang alla CLI:

felo-slides "Kubernetes 入门指南" --lang zh
felo-slides "Introducción a WebAssembly" --lang es

L’AI genera contenuti nella lingua specificata mantenendo i termini tecnici nella forma standard.

In cosa differisce la skill OpenClaw da quella Claude Code?

La skill di Claude Code è ottimizzata per un uso interattivo, dentro l’editor — ti pone domande e itera con te. La skill OpenClaw è pensata per workflow autonomi di agenti — riceve input strutturato e restituisce output senza dialogo. Stesso motore, differente modello d’interazione.

Inizia a costruire

Ecco la checklist per iniziare subito:

Ottieni una chiave API → slides.felo.ai/settings/api
Installa la CLI → npm install -g felo-slides
Imposta la chiave → export FELO_SLIDES_API_KEY=fsk_...
Genera la tua prima presentazione → felo-slides "Il tuo argomento qui"
Aggiungila a Claude Code → claude skill add felo-slides
Automatizza → integra l’API nei tuoi workflow

Felo Slides non vuole sostituire il tuo strumento di design. Vuole eliminare il problema del “mi serve una presentazione al volo” — soprattutto se già lavori nel terminale, nell’editor o in un workflow con agenti.

Le slide generate in questo modo non sono bozze perfette. Sono prime bozze utili. Quelle che davvero apri, modifichi in dieci minuti e spedisci. È questo lo standard.

Provalo:

npx felo-slides "La presentazione che volevo fare da tempo"

→ Felo Slides · pacchetto npm · Documentazione API · GitHub

Questo articolo è disponibile anche in English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Tiếng Việt, Türkçe, ไทย, Español, বাংলা and Português.

Cos’è Felo Slides (per sviluppatori)?​

Installazione e configurazione​

Prerequisiti​

Installa il pacchetto npm​

Autenticazione​

Verifica del funzionamento​

Utilizzare Felo Slides con Claude Code​

Installa la Claude Code Skill​

Uso di base in Claude Code​

Avanzato: template personalizzati in Claude Code​

Modifica conversazionale delle slide​

Utilizzare Felo Slides con OpenClaw​

Configurazione​

Generazione di slide guidata da agenti​

Esempi da riga di comando​

Genera da un argomento​

Genera da un file Markdown​

Genera da un URL​

Generazione batch​

Formati di esportazione​

Integrazione CI/CD​

Esempi di workflow di automazione​

1. Bot di preparazione pre-riunione​

2. Pipeline Documentazione → Presentazione​

3. Riproporre contenuti in più formati​

Riferimento API​

Autenticazione​

POST /v1/slides/generate​

GET /v1/slides/{id}​

POST /v1/slides/{id}/edit​

Limiti di utilizzo​

Domande frequenti (FAQ)​

Posso usare Felo Slides offline?​

Come gestisco contenuti sensibili?​

Posso usare i miei template?​

Qual è il formato di output?​

La skill di Claude Code funziona con Claude CLI o solo con l’app desktop?​

Posso generare slide in lingue diverse dall’inglese?​

In cosa differisce la skill OpenClaw da quella Claude Code?​

Inizia a costruire​

Cos’è Felo Slides (per sviluppatori)?

Installazione e configurazione

Prerequisiti

Installa il pacchetto npm

Autenticazione

Verifica del funzionamento

Utilizzare Felo Slides con Claude Code

Installa la Claude Code Skill

Uso di base in Claude Code

Avanzato: template personalizzati in Claude Code

Modifica conversazionale delle slide

Utilizzare Felo Slides con OpenClaw

Configurazione

Generazione di slide guidata da agenti

Esempi da riga di comando

Genera da un argomento

Genera da un file Markdown

Genera da un URL

Generazione batch

Formati di esportazione

Integrazione CI/CD

Esempi di workflow di automazione

1. Bot di preparazione pre-riunione

2. Pipeline Documentazione → Presentazione

3. Riproporre contenuti in più formati

Riferimento API

Autenticazione

POST /v1/slides/generate

GET /v1/slides/{id}

POST /v1/slides/{id}/edit

Limiti di utilizzo

Domande frequenti (FAQ)

Posso usare Felo Slides offline?

Come gestisco contenuti sensibili?

Posso usare i miei template?

Qual è il formato di output?

La skill di Claude Code funziona con Claude CLI o solo con l’app desktop?

Posso generare slide in lingue diverse dall’inglese?

In cosa differisce la skill OpenClaw da quella Claude Code?

Inizia a costruire