El bot aparece offline

Síntomas: el agente se instaló limpio, pero el bot aparece offline en Discord / Telegram no responde / el usuario de Slack aparece como inactivo.

Arreglo:

sento restart

Esperá 30 segundos para el handshake con el canal. Si sigue offline, sento logs -n 50 y buscá errores de autenticación.

Causas comunes:

  • Bot token expirado o revocado (el token de Discord se resetea después de 90 días de inactividad)
  • Intents / scopes requeridos sacados después de instalar (ver los docs de cada canal para permisos requeridos)
  • Corte de red — Guardian normalmente lo captura en un minuto

"Node 20+ required"

Síntomas: npx sentoagent init falla con un error de versión de Node.

Arreglo (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo bash -
sudo apt-get install -y nodejs
node -v

En macOS: brew install node@20 y después brew link --force node@20.

Errores de permiso al instalar

Síntomas: EACCES escribiendo a /usr/lib/node_modules o similar.

Arreglo: estás corriendo como root o sin un prefix de npm a nivel usuario. Creá un usuario regular y correlo como ese usuario:

adduser sento
su - sento
npx sentoagent init

El instalador de Sentō setea NPM_CONFIG_PREFIX=~/.npm-global para que las instalaciones a nivel usuario funcionen; no corre como root en Docker ni en Linux.

Playwright se cae / el agente se queda sin RAM

Síntomas: el agente se congela o se cae cuando le pedís que navegue la web.

Arreglo: tu host tiene menos de 2 GB de RAM. Redimensioná el VPS a al menos 2 GB. Chromium necesita espacio para respirar.

Error de "Message Content Intent" (Discord)

Síntomas: los logs del agente muestran Used disallowed intents o el agente ignora los mensajes en silencio.

Arreglo: abrí Discord Developer Portal → tu app → Bot → Privileged Gateway Intents → activá Message Content Intent y Server Members Intent. Reiniciá el agente.

El agente no responde a los mensajes

Síntomas: el bot está online, pero no responde.

Chequeos en orden:

  1. Permisos del canal — el rol del bot necesita View Channel + Send Messages en ese canal específico.
  2. Filtro de menciones — en grupos, requireMention: true en access.json significa que el bot sólo responde cuando lo @mencionás.
  3. Política de DM — si dmPolicy: "disabled" o "allowlist" con allowFrom vacío, nada pasa. Chequeá ~/.claude/channels/<canal>/access.json.
  4. Rate limits — si estuviste spameando al bot, el rate limiter puede estar descartando mensajes por un rato.

Guardian no reinicia un agente atascado

Síntomas: el agente está atascado, Guardian no reacciona.

Chequeos:

  • ¿Guardian está corriendo? pgrep -fa guardian.js tiene que devolver al menos un match.
  • ¿El contador de reinicios está al máximo? Chequeá /tmp/sento-guardian-<agent>.json. Si restarts.length >= 3, Guardian se rindió hasta que pase la ventana de 30 minutos.

Arreglo: borrá el archivo de estado y reiniciá los dos:

rm /tmp/sento-guardian-<agent>.json
sento restart

La memoria del agente no persiste

Síntomas: le decís al agente que se acuerde de algo, pero en la próxima sesión no lo sabe.

Chequeos:

  • ¿ClawMem está instalado? ls ~/workspace/memory/ tiene que mostrar al menos MEMORY.md.
  • ¿El agente realmente lo escribió? Mirá el archivo más reciente en ~/workspace/memory/ y hacé cat.
  • ¿Estás confiando en los embeddings de Gemini sin una API key? Si es así, la búsqueda semántica no anda pero la búsqueda por keyword sí.

iMessage: SQLITE_CANTOPEN

Síntomas: el agente de iMessage no puede leer mensajes, los logs muestran SQLITE_CANTOPEN.

Arreglo: la terminal desde la que lanzaste Sentō no tiene Acceso Total al Disco. Dáselo:

Configuración del Sistema → Privacidad y Seguridad → Acceso Total al Disco → agregá Terminal (o iTerm / Warp / Ghostty). Reiniciá la terminal.

¿Sigue roto?

Abrí un issue en GitHub con:

  • Tu OS / tipo de host (proveedor de VPS, versión de macOS, imagen de Docker)
  • Output de sento doctor
  • Últimas 40 líneas de sento logs

Humanos reales leen cada uno.