OpenClaw és la plataforma que fem servir per orquestrar agents IA locals. S'integra amb Ollama (models locals 100%), Telegram i Discord, i es pot controlar tant des de la seva interfície de terminal (TUI) com enviant comandes per Telegram. Aquesta pàgina és una referència ràpida per tenir-ho tot a mà.

Accedir a la TUI

Un cop instal·lat OpenClaw, arranques la interfície de terminal des de qualsevol directori:

openclaw

Si tens múltiples perfils o entorns configurats, pots especificar-ne un directament:

openclaw --profile nom-del-perfil

Comandes generals de la TUI

Dins la TUI, les comandes s'escriuen precedides de /. Aquí les més útils del dia a dia:

Comanda Descripció
/help Mostra totes les comandes disponibles amb una breu descripció.
/clear Neteja la conversa actual. L'historial es perd però el model i la configuració es mantenen.
/reset Reinicia l'agent completament: esborra conversa, context i torna als paràmetres per defecte.
/exit o /quit Tanca la TUI i surt del programa.
/status Mostra l'estat actual: model actiu, tokens usats, temps de resposta i connexió a Ollama.
/history Visualitza el log de la conversa actual amb tots els missatges i respostes.

Gestió de models (Ollama)

OpenClaw s'integra directament amb Ollama. Per canviar de model en qualsevol moment sense sortir de la TUI:

Comanda Descripció
/model Mostra el model actiu en aquest moment.
/model llista Llista tots els models disponibles a l'Ollama local.
/model kimi-k2.5:cloud Canvia al model especificat. Substitueix el nom pel que vulguis usar.
/model qwen3.5 Exemple: canvi ràpid a Qwen 3.5.
/model deepseek Exemple: canvi a DeepSeek.
💡 Consell El model per defecte es configura a config.yaml (clau default_model). Si sempre arranques amb el mateix, val la pena fixar-lo allà per no haver-lo d'especificar cada vegada.

Gestió d'agents

OpenClaw permet tenir múltiples agents configurats amb personalitats, eines i models diferents. Des de la TUI:

Comanda Descripció
/agents Llista tots els agents definits al sistema amb el seu nom i model associat.
/agent nom-agent Commuta a l'agent especificat. Es carrega el seu system prompt i eines.
/agent info Mostra els detalls de l'agent actiu: model, eines habilitades i system prompt.
/agent reload Torna a carregar la configuració de l'agent des del fitxer, sense reiniciar la TUI.

Comandes des de Telegram

Si tens OpenClaw integrat amb Telegram (via bot), pots controlar els agents directament des del mòbil o l'escriptori. Les comandes funcionen de la mateixa manera que a la TUI, però s'envien com a missatges al bot:

Comanda Telegram Equivalent TUI Descripció
/start — Inicia la sessió amb el bot i mostra el missatge de benvinguda.
/help /help Llista les comandes disponibles al bot de Telegram.
/clear /clear Esborra la conversa actual i comença de nou.
/model qwen3.5 /model qwen3.5 Canvia el model actiu directament des de Telegram.
/agent nom /agent nom Commuta a un agent diferent sense necessitat d'obrir la TUI.
/status /status Retorna l'estat del servidor, model actiu i latència d'Ollama.
/reset /reset Reinicia la conversa i l'agent completament.
📱 Telegram vs TUI Des de Telegram pots fer gairebé tot el que fas a la TUI. La diferència principal és que la TUI ofereix una visualització més rica (markdown renderitzat, stats en temps real), mentre que Telegram és ideal quan ets fora o vols enviar una tasca ràpida des del mòbil.

Ús de eines (tools)

Si l'agent té eines habilitades (cerca web, accés a fitxers, execució de codi...), pots consultar-les i activar-les o desactivar-les en calent:

# Llistar les eines actives de l'agent actual
/tools

# Activar una eina concreta
/tool enable web_search

# Desactivar-la
/tool disable web_search

Depurar i veure logs

Quan alguna cosa no va com esperaves, les comandes de depuració t'ajuden a entendre què passa:

# Veure el log de l'execució actual
/log

# Activar mode verbose (mostra el raonament intern de l'agent)
/debug on

# Desactivar el mode verbose
/debug off

Flux habitual de treball

Un exemple típic de sessió: arrancas la TUI, selecciones el model adequat per a la tasca, fas la feina, i si cal continuar-la des del mòbil, simplement obre el bot de Telegram i continua:

# 1. Arranca OpenClaw
openclaw

# 2. Comprova quin model tens actiu
/status

# 3. Canvia a un model lleuger si la tasca és senzilla
/model gemma4

# 4. Commuta a l'agent de codi si cal
/agent dev

# 5. Quan acabes, neteja la conversa
/clear

Més informació

La documentació oficial d'OpenClaw és a openclaw.ai. Per als models locals, consulta el catàleg d'Ollama a ollama.com/library.