Filesystem
El canal filesystem supervisa una o más rutas y envía cada cambio al ciclo del agente o al motor SOP. Está controlado por la característica de compilación channel-filesystem (activada por defecto).
Este es una fuente de eventos SOP. Para la sintaxis de activadores y la coincidencia de rutas, consulta SOP Fan-In: Filesystem. Esta página cubre qué se supervisa y el ámbito de seguridad.
Configuración
La lista completa de campos, derivada del esquema en vivo. Para un watcher básico, estableces paths.
allow_broad_roots
Vigila las raíces amplias del sistema (/, /home, /etc, /var, /proc, /sys, /dev, /tmp) a pesar del valor predeterminado de denegar raíces amplias. Los pseudoarchivos del sistema /proc y /sys mostrarían rutas de objetos del kernel en los payloads de SOP y inundarían al observador con eventos. Desactivado, salvo que se habilite explícitamente.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.allow_broad_roots.
zerocode
En el panel Config, establezca el campo channels.filesystem.<alias>.allow_broad_roots.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.allow_broad_roots <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__allow_broad_roots=
debounce_ms
Colapsa eventos repetidos rápidamente por ruta/tipo dentro de esta ventana.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.debounce_ms.
zerocode
En el panel de Config, establece el campo channels.filesystem.<alias>.debounce_ms.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.debounce_ms <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__debounce_ms=
events
Tipos de eventos a emitir (created, modified, deleted, renamed).
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abre /config/channels/filesystem y establece el campo channels.filesystem.<alias>.events.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.events.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.events <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__events=
exclude
Patrones glob para excluir. Se aplican después de include.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Open /config/channels/filesystem y establece el campo channels.filesystem.<alias>.exclude.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.exclude.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.exclude <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__exclude=
excluded_tools
Herramientas excluidas de la especificación de herramientas de este canal.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abre /config/channels/filesystem y establece el campo channels.filesystem.<alias>.excluded_tools.
zerocode
En el panel de Config, establece el campo channels.filesystem.<alias>.excluded_tools.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.excluded_tools <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__excluded_tools=
follow_symlinks
Sigue los enlaces simbólicos al leer metadatos de event-path, hash y contenido. Desactivado por defecto: un enlace simbólico bajo una raíz vigilada se rechaza antes de cualquier manejo de metadatos/hash/contenido, por lo que su destino no puede salir de la raíz. Cuando está activado, el destino canónico debe seguir resolviendo dentro de una raíz configurada.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.follow_symlinks.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.follow_symlinks.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.follow_symlinks <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__follow_symlinks=
include
Patrones glob para incluir. Vacío coincide con todas las rutas bajo las raíces.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.include.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.include.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.include <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__include=
max_content_bytes
Bytes máximos de contenido de archivo admitidos en una carga útil cuando read_content, y el límite de tamaño para el hash. Some(n) limita las lecturas y el hash a n bytes; los archivos demasiado grandes se omiten en lugar de truncarse. None elimina por completo el límite (lecturas sin límite). El valor predeterminado es Some(65536) (64 KiB), por lo que el límite se aplica de forma predeterminada siempre que se ejecute read_content o el hash.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.max_content_bytes.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.max_content_bytes.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.max_content_bytes <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__max_content_bytes=
paths
Rutas raíz para vigilar. Se requiere al menos una.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abre /config/channels/filesystem y establece el campo channels.filesystem.<alias>.paths.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.paths.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.paths <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__paths=
read_content
Leer el contenido del archivo en la carga útil del evento. Optativo.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abre /config/channels/filesystem y establece el campo channels.filesystem.<alias>.read_content.
zerocode
En el panel Config, establece el campo channels.filesystem.<alias>.read_content.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.read_content <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__read_content=
recursive
Vigila las rutas anidadas debajo de cada raíz.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abra /config/channels/filesystem y establezca el campo channels.filesystem.<alias>.recursive.
zerocode
En el panel de Config, establece el campo channels.filesystem.<alias>.recursive.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.recursive <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__recursive=
settle_ms
Espere este tiempo después del último evento antes de leer metadatos o contenido, para dar tiempo a que finalicen las escrituras atómicas y las copias lentas.
Colócalo sobre cualquier superficie:
Panel de control del gateway
Abre /config/channels/filesystem y establece el campo channels.filesystem.<alias>.settle_ms.
zerocode
En el panel de Config, establezca el campo channels.filesystem.<alias>.settle_ms.
zeroclaw config
zeroclaw config set channels.filesystem.<alias>.settle_ms <value>
Variable de entorno
Exporte la anulación (shells POSIX; colóquelo en ~/.bashrc, ~/.zshrc, .env o un Dockerfile). Reemplace <alias> con el alias literal:
export ZEROCLAW_channels__filesystem__<alias>__settle_ms=
Referencia completa de campos: referencia de configuración.
Delimitación de lo que se vigila
paths enumera las raíces a vigilar; recursive controla si se incluyen los subdirectorios. include y exclude reducen los globos de rutas que emiten eventos, y events filtra por tipo de cambio. debounce_ms y settle_ms colapsan ráfagas de cambios rápidos en un único evento estabilizado.
Seguridad
Las raíces amplias del sistema /, /home, /etc, /var, /proc, /sys, /dev y /tmp se rechazan en la validación de la configuración a menos que se establezca allow_broad_roots. Las rutas de eventos de enlaces simbólicos se rechazan antes de leer cualquier metadato, hash o contenido de forma predeterminada; follow_symlinks habilita ese comportamiento, pero aun así requiere que el destino canónico se resuelva dentro de una raíz supervisada.
Solución de problemas
| Síntoma | Causa probable | Corregir |
|---|---|---|
| El listener no se inicia | se rechazó una raíz amplia en la validación | Estrecha paths para alejarlos de las raíces amplias, o establece allow_broad_roots |
| Cambiar ignorado | excluido por glob, o fuera de los tipos events | Comprueba include, exclude y events contra el archivo modificado |
| SOP no se inicia | el glob path del activador no coincide | Verifica que la trigger path coincida y que el archivo esté dentro del alcance de observación |
Ver también
- SOP Fan-In: Filesystem: sintaxis de activación y coincidencia de rutas
- Visión general de los canales