Keyboard shortcuts

Press or to navigate between chapters

Press ? to show this help

Press Esc to hide this help

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 bool · default false

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 integer · default 500

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 string[] · default ["created","modified","deleted","renamed"]

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 string[] · default []

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 string[] · default []

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 bool · default false

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 string[] · default []

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 integer? · default 65536

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 string[] · default []

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 bool · default false

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 bool · default true

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 integer · default 250

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íntomaCausa probableCorregir
El listener no se iniciase rechazó una raíz amplia en la validaciónEstrecha paths para alejarlos de las raíces amplias, o establece allow_broad_roots
Cambiar ignoradoexcluido por glob, o fuera de los tipos eventsComprueba include, exclude y events contra el archivo modificado
SOP no se iniciael glob path del activador no coincideVerifica que la trigger path coincida y que el archivo esté dentro del alcance de observación

Ver también