OpenClaw API REST: come controllare il tuo agente AI da qualsiasi programma

# OpenClaw API e interfaccia REST: come controllare il tuo agente AI da qualsiasi programma

Hai mai voluto far parlare il tuo agente AI con un altro programma? Con OpenClaw, questo è possibile attraverso la sua interfaccia REST. In questo articolo spiegheremo cos'è un'API, come funziona l'interfaccia REST di OpenClaw e come puoi usarla per creare automazioni personalizzate.

## COS'È UN'API?

Prima di tutto, cos'è un'API? Immagina di essere in un ristorante. Tu sei il cliente, il cuoco è il sistema che prepara il cibo, e il cameriere è l'API. Tu non vai in cucina a cucinare da solo. Ordini al cameriere, lui porta l'ordine al cuoco, e poi ti porta il piatto pronto.

Un'API fa esattamente questo: è un intermediario che permette a due programmi di parlare tra loro. Tu fai una richiesta ("dammi la risposta del mio agente"), e l'API ti dà la risposta.

## COS'È REST?

REST è un modo standard di fare richieste API. Le richieste REST usano protocolli web come HTTP. Invece di programmi complessi, usi URL semplici. È come inviare un messaggio di testo invece di una chiamata telefonica.

## L'API DI OPENCLAW

OpenClaw ha un'interfaccia REST che gira sul tuo Gateway. Di default, il Gateway ascolta sulla porta 18789. Puoi parlare con lui da qualsiasi programma che sappia fare richieste HTTP.

### COME FUNZIONA?

Il Gateway OpenClaw espone endpoint come:
- `/v1/messages` per inviare messaggi all'agente
- `/v1/sessions` per gestire le sessioni
- `/v1/cron` per gestire i cron job
- `/v1/status` per lo stato del sistema

Ogni endpoint ha metodi specifici (GET per leggere, POST per scrivere, ecc.).

## PRIMO ESEMPIO: MANDARE UN MESSAGGIO

Vediamo un esempio pratico. Immagina di voler inviare un messaggio al tuo agente OpenClaw da uno script Python.

```python
import requests

response = requests.post(
"http://localhost:18789/v1/messages",
json={
"sessionKey": "current",
"message": "Ciao OpenClaw!"
}
)
print(response.json())
```

Questo codice fa una richiesta POST (invia dati) all'endpoint `/v1/messages`. Il Gateway risponde con il messaggio dell'agente.

### SPIEGAZIONE DEL CODICE

- `import requests`: importi una libreria che sa fare richieste HTTP
- `requests.post()`: fai una richiesta di tipo POST
- `"http://localhost:18789/v1/messages"`: l'URL del Gateway OpenClaw
- `json={...}`: i dati che invii (il messaggio)
- `response.json()`: leggi la risposta in formato JSON

## LEGGERE LO STATO

Vuoi sapere se il tuo agente è online? Usa un GET invece di un POST:

```python
import requests

response = requests.get("http://localhost:18789/v1/status")
print(response.json())
```

Questo ti dà informazioni sul modello usato, i token consumati, e altro.

## AUTOMAZIONI REALI

Con l'API REST di OpenClaw puoi creare cose come:
- Un bot Telegram che manda messaggi a OpenClaw
- Un cron job che chiede all'agente di fare un report ogni mattina
- Un'app web che usa l'agente come backend
- Un sistema di notifiche che usa l'agente per inviare messaggi

## SICUREZZA

L'API REST di OpenClaw è esposta solo sul tuo computer locale di default. Per questo è importante:
- Non esporre la porta 18789 su internet
- Usare firewall per bloccare accessi non autorizzati
- Usare autenticazione se necessario

## IN CONCLUSIONE

L'interfaccia REST di OpenClaw ti dà il potere di integrare il tuo agente AI in qualsiasi sistema. Non serve essere un programmatore esperto: bastano poche righe di codice per iniziare.

La prossima volta che vuoi automatizzare qualcosa, pensa: "Posso farlo parlare con OpenClaw via API?" La risposta è quasi sempre sì.

---
⚠️ SICUREZZA PRIMA DI TUTTO

Non installare mai OpenClaw direttamente sul computer che usi tutti i giorni. Usa sempre una macchina virtuale o un container per isolare l'ambiente.

Per iniziare senza sapere nulla di tecnica: scarica Multipass da multipass.run. Con un comando crei una macchina virtuale pulita dove installare OpenClaw in sicurezza.

Se gia' sai usare Docker: crea un container e lavora li'. Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.

La regola e' una: OpenClaw su un computer isolato. Mai in chiaro sul PC di tutti i giorni. La sicurezza informatica non e' paranoia, e' buon senso.
---

Sent via AgentMail