Agente AI per la gestione dei contratti con OpenClaw
Un agente per la gestione dei contratti basato sull'intelligenza artificiale (AI) con OpenClaw risiede sulla sua macchina e comunica con lei su Telegram, WhatsApp o Slack. Gli chieda se può ancora disdire l'abbonamento a Pipewell, un software di gestione delle relazioni con i clienti (CRM). Risponderà che la disdetta deve arrivare entro il 15 gennaio, che dopo quella data il contratto si rinnova per un anno con canoni fino al 6% più alti e che è impostato un promemoria per il 5 gennaio. Contracko svolge il lavoro specialistico: analisi AI dei contratti per ogni documento, date, promemoria e revisione dei rischi. L'agente si occupa del lavoro operativo.
OpenClaw è un agente personale open source, mantenuto dalla OpenClaw Foundation e rilasciato con la licenza del Massachusetts Institute of Technology (MIT) [1]. Lei gestisce il suo gateway e sceglie il modello che lo alimenta, per esempio di Anthropic, OpenAI, Google o un modello locale [1].
Perché i contratti meritano un agente dedicato
OpenClaw può eseguire più agenti in parallelo. Ognuno ha il proprio spazio di lavoro, il proprio SOUL.md che descrive chi è e le proprie sessioni, e un collegamento al canale stabilisce quali chat lo raggiungono [3]. È adatto al lavoro sui contratti, con le sue fonti, la sua memoria e il suo calendario.
Per un privato, l'agente tiene sotto controllo l'affitto, le assicurazioni e gli abbonamenti che si rinnovano senza che nessuno se ne accorga. Per una piccola impresa, lavora come un contract manager part-time.
È la divisione dei compiti a rendere affidabile la gestione dei contratti con l'AI tramite un agente. Contracko si occupa dell'estrazione e dell'analisi con l'AI: parti, date, condizioni di rinnovo, termini di preavviso, importi, responsabilità, obblighi e rischi. Veda l'analisi AI dei contratti di Contracko. L'agente legge quell'analisi, e il testo del contratto quando gli serve la formulazione esatta, e fa il resto:
- trova i documenti sulla macchina su cui gira o in una cartella cloud sincronizzata
- li carica su Contracko e controlla quando ogni importazione è terminata
- verifica il tipo di ogni nuovo contratto, corregge gli errori e rilancia l'analisi
- archivia i contratti in cartelle e aggiunge i contatti mancanti delle controparti
- imposta promemoria, crea report e segnala ciò che richiede la sua attenzione
I due sono collegati tramite il Model Context Protocol (MCP), uno standard aperto per collegare gli agenti AI alle app, spiegato in che cos'è un MCP server per la gestione dei contratti. Questa guida collega il MCP server per la gestione dei contratti di Contracko.
Un agente dei contratti nella sua chat
Un esempio di conversazione su Telegram. Aziende e dati sono fittizi.
What needs notice in the next 60 days? Include anything that renews on its own.
| Contratto | Controparte | Preavviso entro | Si rinnova |
|---|---|---|---|
| Locazione ufficio, unità 4B | Marlow Estates | 28 dicembre | Sì, per 3 anni |
| Assicurazione flotta | Calder Mutual | 2 gennaio | Sì, annualmente |
| Abbonamento CRM | Pipewell | 15 gennaio | Sì, annualmente, canoni fino al 6% più alti |
L'agente aggiunge che il preavviso per la locazione va inviato con raccomandata, come Contracko ha rilevato nella clausola di recesso. Chiede se vuole un promemoria 10 giorni prima di ogni data.
Configurare l'agente dei contratti
Le serve un gateway OpenClaw in esecuzione. OpenClaw è gratuito e non ha piani a pagamento [1]. Un modello ospitato o un server in affitto possono costare denaro in base al fornitore e al piano; un modello locale usa invece il suo hardware.
Collegare il MCP server di Contracko
OpenClaw supporta MCP server remoti con accesso tramite Open Authorization (OAuth) [2]. Esegua prima openclaw mcp status --verbose: se è già salvata una voce contracko, la riutilizzi invece di aggiungerne una seconda [6]. Altrimenti, la documentazione di configurazione di Contracko indica tre comandi per la macchina che esegue il gateway [6]:
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko
Salvano il server, lo impostano su OAuth e avviano l'accesso a Contracko, che lei completa nel browser. Se quel browser gira su un'altra macchina o non raggiunge l'indirizzo mostrato, passi il codice restituito con openclaw mcp login contracko --code <returned-code> [2]. Può anche aggiungere il server nella Control User Interface (UI) (interfaccia di controllo) del gateway, nelle impostazioni MCP [2], oppure chiedere all'agente di farlo con questo prompt:
Fetch and follow the setup instructions for Contracko MCP at https://contracko.com/mcp/install/prompt.md
Poi openclaw mcp status --verbose mostra se l'accesso è stato completato, e openclaw mcp doctor contracko --probe apre una connessione in tempo reale con Contracko [2]. Infine chieda all'agente di aggiornare i suoi strumenti e di eseguire il controllo di accesso in sola lettura di Contracko, che indica lo spazio di lavoro a cui è collegato [6]. L'endpoint per gli altri metodi è:
https://app.contracko.com/mcp
Quando Contracko chiede quale accesso concedere, conceda fin dall'inizio read and write access to your contracts (accesso in lettura e scrittura ai suoi contratti). Con la sola lettura l'agente può rispondere alle domande, ma non importare, archiviare o impostare un promemoria.
La schermata di accesso mostra i due prodotti di Contracko:
- Contract management è la sua repository contrattuale: contratti, date, promemoria, cartelle, analisi e report. È ciò che usa il suo agente, e non consuma mai crediti Parser.
- Contracko Parser è uno strumento separato per documenti in blocco. Lo lasci disattivato.
Non ha ancora un account? La schermata di accesso offre una prova gratuita senza carta di credito. Può anche iniziare dalla pagina dei prezzi.
Creare l'agente dei contratti
Aggiunga a OpenClaw un nuovo bot BotFather come account Telegram chiamato contracts [3]. Arresti il gateway, operazione necessaria per aggiungere un agente collegato, poi crei l'agente con il suo spazio di lavoro, collegato a quell'account [3]:
openclaw agents add contracts --workspace ~/.openclaw/workspace-contracts --bind telegram:contracts
Il collegamento indirizza ogni chat di quell'account bot all'agente dei contratti; un collegamento per una chat specifica ha la precedenza [3]. Riavvii il gateway e controlli l'instradamento con openclaw agents list --bindings. Se quel collegamento appartiene già a un altro agente, OpenClaw segnala il conflitto. Lo risolva con openclaw agents bind e openclaw agents unbind invece di creare di nuovo l'agente [3].
Poi scriva il suo compito nel file AGENTS.md dello spazio di lavoro dell'agente, dove OpenClaw conserva le regole di lavoro. SOUL.md serve per il tono e lo stile.
You run my contracts in Contracko. Keep the contract repository complete, correctly typed and filed, and tell me what needs a decision before it is due. Quote the clause behind each finding.
Qui non ci sono regole di approvazione, perché l'agente lavora in autonomia. Contracko controlla due cose a ogni scrittura: l'accesso che lei ha approvato al momento dell'accesso e i suoi permessi nello spazio di lavoro [6]. Eliminare un report o rimuoverne una parte richiede inoltre la sua approvazione esplicita. In OpenClaw i MCP server vengono salvati per l'intero gateway con un solo accesso, quindi anche altri agenti su quel gateway possono raggiungere Contracko, in base al loro ambiente di esecuzione e alla loro policy degli strumenti [2].
Installare lo skill di Contracko
Uno skill insegna a un agente a usare bene uno strumento. Lo skill di Contracko, contracko, copre importazione, archiviazione, verifica dei tipi e revisione delle date. La documentazione di configurazione di Contracko lo installa su un host OpenClaw con un solo comando [6]:
npx skills@latest add contracko/contracko-skills
Poi chieda all'agente dei contratti quali skill può usare. OpenClaw carica gli skill dallo spazio di lavoro dell'agente e da cartelle condivise, entro l'elenco di skill consentiti di ogni agente, e openclaw skills check mostra perché uno skill manca a un agente [1].
Costruire una repository contrattuale con monitoraggio
Questo è il compito principale dell'agente: un'unica repository contrattuale le cui date e i cui promemoria continuano a funzionare quando il gateway è spento. Se il concetto le è nuovo, legga prima che cos'è una repository contrattuale.
Importare l'archivio
L'agente può lavorare con i file sulla sua macchina, compresa una cartella sincronizzata di Google Drive, Dropbox o OneDrive.
Go through ~/Documents/Contracts and the synced folder ~/Google Drive/Agreements. Import every signed contract into Contracko, wait until each import is done, and list anything that failed.
Contracko legge ogni documento, crea il contratto e lo collega a una controparte esistente o nuova. La guida completa si trova in importare e organizzare i contratti con MCP.
Cosa estrae Contracko per lei
Contracko estrae le parti, le date di inizio, fine e rinnovo, i termini di preavviso, le condizioni di pagamento e gli importi, e l'analisi segnala responsabilità, obblighi e condizioni insolite. Un tipo di contratto può avere campi propri, come il deposito cauzionale di una locazione. Anche questi vengono compilati durante l'estrazione.
Contracko registra il rinnovo automatico e il periodo di rinnovo separatamente dalla data di fine e memorizza il preavviso come un periodo fisso che la precede. Veda date dei contratti e rinnovi automatici.
Correggere tipi e cartelle
For every contract imported today, check the contract type. Correct any that are wrong and re-run the analysis, then file each contract under Clients, Suppliers, Property or Insurance.
Dopo un cambio di tipo, l'agente chiede a Contracko di rileggere il documento. Contracko mostra i nuovi valori come proposte, che lei approva nell'app.
Promemoria e date del calendario
Add a reminder 21 days before the notice deadline of every contract that renews automatically.
I promemoria sono salvati in Contracko e arrivano via email, anche quando il gateway è spento. Altri prompt si trovano in promemoria per il rinnovo dei contratti con MCP.
Il feed del calendario di Contracko porta queste date in Google Calendar, Apple Calendar o Outlook; veda la guida all'integrazione del calendario.
Analisi AI dei contratti per ogni accordo
Contracko ha già analizzato ogni accordo. L'agente parte quindi da quell'analisi, legge il testo del contratto per la formulazione esatta e cita la frase alla base di ogni punto. Quando analisi e testo non chiariscono un punto, deve dirlo.
Explain the Marlow Estates lease in plain language: rent reviews, who repairs what, and how I get out of it.
Un esempio di risposta, con dati fittizi:
| Punto | Cosa ha trovato Contracko | Clausola |
|---|---|---|
| Revisione del canone | Ogni 2 anni, legata all'inflazione | "The Rent shall be reviewed in line with inflation on each second anniversary of the Term Commencement Date." |
| Riparazioni | Il conduttore ripara gli interni | "The Tenant shall keep the interior of the Premises in good repair." |
| Uscita | Facoltà di recesso al terzo anniversario, con almeno 6 mesi di preavviso | "The Tenant may terminate this Lease on the third anniversary by giving not less than six months' notice." |
La versione in chat di questo compito si trova in revisione AI dei contratti con MCP.
Revisione AI di rischi e obblighi
Per una revisione AI dei contratti sull'intero portafoglio, pone la stessa domanda a ogni accordo.
Which of my supplier contracts have uncapped liability or let the supplier change prices on its own? Sort by renewal date.
What do I owe under my client contracts in the next 90 days? Payments, deliverables, reports and notices.
Risultati di esempio per il secondo prompt, con dati fittizi:
| Obbligo | Verso | Scadenza |
|---|---|---|
| Report mensile sul servizio | Heron Logistics | Il 5 di ogni mese |
| Prova dell'assicurazione di responsabilità civile | Marlow Estates | 31 gennaio |
| Preavviso di 30 giorni per cambi di personale | Fenwick Dental Group | Prima di ogni cambio |
Ogni risultato parte dall'analisi dei rischi e degli obblighi di Contracko [5]. L'agente cita la clausola, così lei può verificare la formulazione. Per l'approccio complessivo, veda la gestione dei rischi contrattuali.
Report sempre aggiornati
Contracko crea report a partire dai dati del suo account e li aggiorna quando i contratti cambiano. L'agente crea i report dai modelli di report e dai campi di Contracko, per esempio contratti in scadenza a breve, valore annuo per controparte o contratti per tipo. Mostra prima un'anteprima di ogni parte e salva il report in modo privato nel suo account.
Create a Contracko report of the contracts ending in the next 6 months, with counterparty, end date and annual value. Show me the preview, then save it and tell me its name.
Chi lo apre il mese prossimo vede i numeri del mese prossimo.
Cinque workflow ricorrenti
OpenClaw pianifica il lavoro come automazioni, note anche con il vecchio nome cron. Un'attività può essere eseguita a un orario fisso, a intervalli o secondo una pianificazione cron, in una propria sessione isolata, e pubblicare il risultato in una chat [4]. Le attività vengono eseguite solo mentre il gateway è in funzione, nel fuso orario dell'host del gateway salvo che ne indichi un altro [4]. Se lo strumento delle automazioni è disponibile, può chiedere in chat di impostare un'attività. Un'attività creata da una chat riferisce a quella chat, a meno che lei non indichi un'altra destinazione o abbia impostato una destinazione predefinita [4]. Chieda all'agente di mostrarle la pianificazione salvata e la destinazione prima di fare affidamento su un'attività.
Il vecchio heartbeat di OpenClaw ora è un'automazione chiamata Proactive check per l'agente che gestisce le sue conversazioni quotidiane; openclaw doctor --fix converte le impostazioni di heartbeat supportate e segnala ciò che non riesce a convertire [4]. Dia al lavoro sui contratti automazioni proprie, ognuna con un orario e un risultato chiari.
Acquisire tutto in una volta
Find every signed contract in ~/Documents and my synced cloud storage folders. Import each into Contracko and wait for every import. Fix any wrong contract type and re-run the analysis. File each contract by client, supplier or household category, then tell me how many you imported, where they went and what failed.
Monitorare una cartella per i nuovi contratti
Create an automation that runs every weekday at 07:00 in an isolated session. Check the synced folder ~/Google Drive/Agreements for files that are not yet in Contracko. Import each one, wait for the import, check the contract type and file it. Post one line in this chat with what you imported, or nothing if there was nothing new.
Contracko avvisa l'agente quando un documento è già collegato a un contratto e aggiunge una seconda copia solo se lei insiste. Un file la cui importazione non è riuscita non è ancora in Contracko, quindi l'esecuzione successiva ci riprova.
Raccogliere i contratti firmati dalla posta
Il plugin email di OpenClaw avvia una sessione separata per ogni nuovo messaggio dai mittenti che lei consente, come @docusign.net. Per impostazione predefinita un messaggio deve anche superare la verifica del mittente, con un token legato al mittente come eccezione documentata, e al primo avvio viene saltata la posta già presente nella casella [4]. Inizi quindi con un recupero una tantum: esporti i documenti completati da DocuSign, Adobe Sign o PandaDoc in una cartella ed esegua su di essa il prompt di acquisizione.
Per i nuovi messaggi, la documentazione di OpenClaw le fa configurare prima un agente lettore separato: in sandbox, quasi senza strumenti, il che richiede un backend di sandbox e un modello funzionante [4]. Può riassumere un messaggio ma non importare nulla, ed è voluto: un'email può contenere istruzioni che lei non ha scritto. Nell'esempio documentato i riassunti non vengono recapitati. Per sapere quando un contratto viene firmato, attivi il recapito per quella casella, si invii un messaggio di prova e controlli nei log che l'esecuzione sia terminata e il riassunto recapitato [4]. Salvi la copia firmata nella cartella monitorata per l'automazione dei giorni feriali, poi dia i dettagli all'agente dei contratti:
Pipewell signed the CRM renewal. Their contact is Dana Reyes, account manager, [email protected]. Check that the contract is in Contracko, add her as the counterparty contact and confirm in one line.
Ricevere un riepilogo settimanale delle scadenze
Create an automation for every Monday at 08:00 in an isolated session. List every contract with a notice deadline or end date in the next 60 days, with the date and the decision I need to make. Add any contract imported last week that has no end date or no contract type. Post it in this chat.
Condividere i report con il team
Colleghi prima Slack come canale di OpenClaw. Le automazioni pubblicano in un canale Slack tramite il suo identificativo (ID), nel formato channel:C0123456 [4].
Create a Contracko report with two parts: the contracts ending in the next 6 months, sorted by annual value, and their total annual value. Show me the preview before you save it. Then create an automation for 09:00 Amsterdam time on the 1st of each month that previews both parts again and posts to Slack channel:C0123456 how many contracts end, their total annual value and the three largest. Show me the saved schedule.
Un report di Contracko resta privato finché non lo condivide. Prima di condividerlo, verifichi chi lo vedrà: un report condiviso può mostrare dati contrattuali a persone che non possono aprire quei contratti. La pagina dei report spiega i link di condivisione.
Elenchi le attività con openclaw automations list --all, che mostra anche quelle disattivate, e controlli la cronologia di un'attività con openclaw automations runs e il suo ID, che indica se ogni esecuzione è terminata ed è stata recapitata [4]. Per impostazione predefinita OpenClaw avvisa dopo due esecuzioni fallite consecutive, in base alle impostazioni di instradamento, e un'attività pianificata ricorrente che fallisce dieci volte di fila viene disattivata [4]. Un recapito non riuscito non è un'esecuzione fallita, e nemmeno lo è un'esecuzione in cui il modello si limita a segnalare un problema. Controlli quindi la cronologia delle esecuzioni e legga di persona i riepiloghi.
Cosa può fare l'agente e cosa no
L'agente agisce per suo conto, nello spazio di lavoro scelto al momento dell'accesso, e non può aprire alcun contratto che lei non possa aprire. Ogni scrittura richiede l'accesso in scrittura che ha approvato e i suoi permessi nello spazio di lavoro [6]. Tutto ciò che crea o modifica viene contrassegnato come proveniente da MCP nella cronologia delle attività di Contracko [5].
Non può eliminare alcun contratto, documento, cartella, controparte o tipo di contratto; questo si fa solo nell'app di Contracko. Può eliminare solo date personalizzate, promemoria, report e parti di report, e i report o le loro parti solo dopo la sua approvazione.
Lo scolleghi in qualsiasi momento in Contracko da Settings, poi Integrations e infine MCP Connections [6]. La documentazione del MCP server copre il resto.
C'è un'avvertenza specifica di OpenClaw. I MCP server vengono salvati per l'intero gateway, non per agente, quindi anche altri agenti sullo stesso gateway possono usare Contracko, in base al loro ambiente di esecuzione e alla loro policy degli strumenti [2]. Inoltre gli spazi di lavoro degli agenti non sono sandbox e, per impostazione predefinita, gli agenti possono vedere le sessioni degli altri. OpenClaw stesso consiglia un gateway separato per una separazione rigorosa [3], quindi dia agli agenti di altre persone un gateway proprio.
Contracko non addestra modelli sui suoi contratti [6]. Con OpenClaw, il contenuto delle conversazioni va al fornitore del modello che ha scelto. Controlli le sue impostazioni di addestramento prima di collegare contratti reali.
Perché collegare è meglio che incollare
Un agente non collegato conosce solo i file che gli ha mostrato l'ultima volta. Collegato a Contracko lavora su dati aggiornati, e il riepilogo del lunedì descrive il portafoglio di questa settimana.
Domande frequenti
Come collego OpenClaw a un MCP server per la gestione dei contratti?
Se non è ancora salvata una voce Contracko, esegua openclaw mcp set con l'endpoint di Contracko, openclaw mcp configure per attivare OAuth e poi openclaw mcp login per accedere dal browser. Dopodiché parla con l'agente in linguaggio naturale. La configurazione di OpenClaw richiede una certa dimestichezza con il terminale.
Come tengono traccia le aziende dei rinnovi dei contratti in automatico?
Conservano ogni contratto in una repository che conosce ogni data di rinnovo e di preavviso. Qui l'agente importa i contratti, Contracko estrae le date e invia i promemoria, e un'automazione settimanale elenca ciò che si avvicina.
Posso provare gratis la revisione AI dei contratti prima di configurare l'agente?
Sì. Lo strumento di revisione AI dei contratti gratuita di Contracko controlla un singolo documento. È separato dall'agente, che lavora nel suo account Contracko.
L'agente consuma crediti Parser, e di quale piano ho bisogno?
No. Il suo agente dei contratti usa gli strumenti di gestione dei contratti di Contracko, che non consumano mai crediti Parser. Per i piani attuali, veda i prezzi. OpenClaw non ha piani a pagamento [1]. La disponibilità nel suo paese dipende dal fornitore del modello e dai canali di chat che sceglie.
Chi sviluppa OpenClaw, e invia i miei contratti da qualche parte?
Lo mantiene la OpenClaw Foundation [1]. Con un modello locale l'elaborazione del modello resta sulla sua macchina; un modello ospitato riceve le sue conversazioni. In ogni caso, i canali e i MCP server che collega, come Telegram o Contracko, ricevono ciò che invia loro. I controlli degli aggiornamenti di OpenClaw non includono il contenuto dei messaggi, ma il servizio degli aggiornamenti registra una posizione approssimativa, e dopo un controllo può seguire una richiesta di conteggio senza identificativo. Imposti update.checkOnStart: false o OPENCLAW_NO_AUTO_UPDATE=1 per interrompere le richieste automatiche di aggiornamento [1].
Fonti
[1] OpenClaw Foundation. Panoramica di OpenClaw, licenza, fornitori di modelli, skill e telemetria degli aggiornamenti. docs.openclaw.ai
[2] OpenClaw Foundation. Comandi MCP, accesso OAuth, la Control UI e impostazioni MCP per l'intero gateway. docs.openclaw.ai/cli/mcp
[3] OpenClaw Foundation. Instradamento multi-agente, spazi di lavoro, account Telegram e il comando agents. docs.openclaw.ai/concepts/multi-agent
[4] OpenClaw Foundation. Automazioni: pianificazioni, recapito, avvisi di errore, la migrazione dell'heartbeat e il trigger email IMAP. docs.openclaw.ai/automation
[5] Contracko. MCP server per la gestione dei contratti: analisi leggibile dall'agente, controlli sulle scritture ed etichette MCP nella cronologia delle attività. contracko.com/mcp/contract-management
[6] Contracko. Documentazione e prompt di configurazione del MCP server: configurazione per OpenClaw, riutilizzo di una connessione, controllo di accesso, accesso in lettura e scrittura, gestione delle connessioni e addestramento dei modelli. contracko.com/docs/mcp-server
Inizia con Contracko
Elimini le complicazioni della gestione dei contratti. Contracko Le permette di restare organizzato, puntuale e in controllo. Inizi a semplificare oggi stesso.