OpenProse

OpenProse è un formato di workflow portabile e markdown-first per orchestrare sessioni AI. In OpenClaw viene distribuito come Plugin che installa un pacchetto di Skills OpenProse più un comando slash /prose. I programmi vivono in file .prose e possono generare più sotto-agenti con controllo di flusso esplicito.

Sito ufficiale: https://www.prose.md

# Cosa può fare

• Ricerca + sintesi multi-agente con parallelismo esplicito.
• Flussi di lavoro ripetibili e sicuri rispetto alle approvazioni (code review, triage degli incidenti, pipeline di contenuti).
• Programmi .prose riutilizzabili che puoi eseguire su runtime di agenti supportati.

# Installazione + abilitazione

I Plugin inclusi sono disabilitati per impostazione predefinita. Abilita OpenProse:

openclaw plugins enable open-prose

Riavvia il Gateway dopo aver abilitato il Plugin.

Checkout dev/locale: openclaw plugins install ./path/to/local/open-prose-plugin

Documentazione correlata: Plugins, Plugin manifest, Skills.

# Comando slash

OpenProse registra /prose come comando skill invocabile dall'utente. Instrada verso le istruzioni della VM OpenProse e usa sotto il cofano gli strumenti OpenClaw.

Comandi comuni:

/prose help
/prose run <file.prose>
/prose run <handle/slug>
/prose run <https://example.com/file.prose>
/prose compile <file.prose>
/prose examples
/prose update

# Esempio: un semplice file .prose

# Research + synthesis with two agents running in parallel.

input topic: "What should we research?"

agent researcher:
  model: sonnet
  prompt: "You research thoroughly and cite sources."

agent writer:
  model: opus
  prompt: "You write a concise summary."

parallel:
  findings = session: researcher
    prompt: "Research {topic}."
  draft = session: writer
    prompt: "Summarize {topic}."

session "Merge the findings + draft into a final answer."
context: { findings, draft }

# Posizioni dei file

OpenProse mantiene lo stato sotto .prose/ nel tuo spazio di lavoro:

.prose/
├── .env
├── runs/
│   └── {YYYYMMDD}-{HHMMSS}-{random}/
│       ├── program.prose
│       ├── state.md
│       ├── bindings/
│       └── agents/
└── agents/

Gli agenti persistenti a livello utente vivono in:

~/.prose/agents/

# Modalità di stato

OpenProse supporta più backend di stato:

• filesystem (predefinito): .prose/runs/...
• in-context: transitorio, per piccoli programmi
• sqlite (sperimentale): richiede il binario sqlite3
• postgres (sperimentale): richiede psql e una stringa di connessione

Note:

• sqlite/postgres sono opt-in e sperimentali.
• Le credenziali postgres fluiscono nei log dei sotto-agenti; usa un DB dedicato con privilegi minimi.

# Programmi remoti

/prose run <handle/slug> viene risolto in https://p.prose.md/<handle>/<slug>. Gli URL diretti vengono recuperati così come sono. Questo usa lo strumento web_fetch (oppure exec per POST).

# Mappatura del runtime OpenClaw

I programmi OpenProse vengono mappati su primitive OpenClaw:

Concetto OpenProse	Strumento OpenClaw
Genera sessione / strumento Task	sessions_spawn
Lettura/scrittura file	read / write
Web fetch	web_fetch

Se la tua allowlist degli strumenti blocca questi strumenti, i programmi OpenProse falliranno. Vedi Skills config.

# Sicurezza + approvazioni

Tratta i file .prose come codice. Esaminali prima di eseguirli. Usa le allowlist degli strumenti OpenClaw e i punti di approvazione per controllare gli effetti collaterali.

Per flussi di lavoro deterministici e controllati da approvazione, confronta con Lobster.

# Correlati

• Text-to-speech
• Markdown formatting