OpenClaw Infrastructure Knowledge Base Model¶

Fecha: 2026-06-01

Objetivo¶

Modelar el primer caso de uso real de O7 usando solo componentes observados en repo y VPS.

Regla¶

activo: observado hoy en VPS o repo
planificado: no observado todavia

Entidades principales¶

ID	Tipo O7	Estado	Evidencia	Observaciones
`host-srv977009`	Host	activo	`hostname`, `docs/VPS-INVENTORY.md`	host unico actual
`svc-openclaw`	Service	activo	`docker/openclaw/docker-compose.yml`, `docker ps`	servicio principal
`ctr-openclaw-gateway`	Container	activo	`openclaw-openclaw-gateway-1`	runtime OpenClaw
`svc-nginx-proxy-manager`	Service	activo	`docker ps`, governance	entrada publica
`ctr-nginx-proxy-manager`	Container	activo	`nginx-proxy-manager`	proxy y TLS
`svc-portainer`	Service	activo	`docker ps`, governance	admin Docker
`ctr-portainer`	Container	activo	`portainer`	expuesto en `8000/9443`
`svc-observability-o4`	Service	activo	`infra/observability/docker-compose.yml`, `docker ps`	observabilidad actual
`ctr-obs-prometheus`	Container	activo	`obs-prometheus`	scrape y reglas
`ctr-obs-thanos-sidecar`	Container	activo	`obs-thanos-sidecar`	puente Prometheus/Thanos
`ctr-obs-thanos-query`	Container	activo	`obs-thanos-query`	query layer
`ctr-obs-thanos-storegateway`	Container	activo	`obs-thanos-storegateway`	acceso a historico
`ctr-obs-thanos-compactor`	Container	activo	`obs-thanos-compactor`	compaction y retencion
`ctr-obs-grafana`	Container	activo	`obs-grafana`	dashboards
`ctr-obs-alertmanager`	Container	activo	`obs-alertmanager`	routing de alertas
`net-proxy-network`	Network	activo	`docker network ls`	red compartida de publicacion
`net-openclaw-internal`	Network	activo	`docker network ls`	red interna OpenClaw
`net-obs-observability-internal`	Network	activo	`docker network ls`	red observabilidad
`vol-portainer-data-new`	Volume	activo	`docker volume ls`	persistencia real Portainer
`vol-obs-prometheus-data`	Volume	activo	`docker volume ls`	TSDB caliente
`vol-obs-grafana-data`	Volume	activo	`docker volume ls`	config y dashboards runtime
`vol-obs-alertmanager-data`	Volume	activo	`docker volume ls`	estado Alertmanager
`vol-obs-thanos-storegateway-data`	Volume	activo	`docker volume ls`	cache storegateway
`vol-obs-thanos-compactor-data`	Volume	activo	`docker volume ls`	trabajo compactor
`vol-obs-thanos-objectstore-data`	Volume	activo	`docker volume ls`	historico local Thanos
`svc-knowledge-platform-o7`	Service	planificado	este documento	no desplegado
`svc-openmetadata`	Service	planificado	este documento + docs oficiales	no desplegado

Relaciones minimas obligatorias¶

Desde	Relacion	Hacia	Evidencia
`svc-openclaw`	`RUNS_ON`	`host-srv977009`	`docker ps`
`ctr-openclaw-gateway`	`USES_NETWORK`	`net-proxy-network`	compose OpenClaw
`ctr-openclaw-gateway`	`USES_NETWORK`	`net-openclaw-internal`	compose OpenClaw
`svc-openclaw`	`PUBLISHED_BY`	`svc-nginx-proxy-manager`	O6 audit
`svc-portainer`	`RUNS_ON`	`host-srv977009`	`docker ps`
`ctr-portainer`	`USES_NETWORK`	`net-proxy-network`	O6 audit
`ctr-portainer`	`MOUNTS_VOLUME`	`vol-portainer-data-new`	governance + audit
`svc-observability-o4`	`RUNS_ON`	`host-srv977009`	`docker ps`
`ctr-obs-prometheus`	`USES_NETWORK`	`net-obs-observability-internal`	observability compose
`ctr-obs-prometheus`	`MOUNTS_VOLUME`	`vol-obs-prometheus-data`	observability compose
`ctr-obs-thanos-sidecar`	`MOUNTS_VOLUME`	`vol-obs-prometheus-data`	observability compose
`ctr-obs-thanos-sidecar`	`MOUNTS_VOLUME`	`vol-obs-thanos-objectstore-data`	observability compose
`ctr-obs-thanos-storegateway`	`MOUNTS_VOLUME`	`vol-obs-thanos-storegateway-data`	observability compose
`ctr-obs-thanos-storegateway`	`MOUNTS_VOLUME`	`vol-obs-thanos-objectstore-data`	observability compose
`ctr-obs-thanos-compactor`	`MOUNTS_VOLUME`	`vol-obs-thanos-compactor-data`	observability compose
`ctr-obs-thanos-compactor`	`MOUNTS_VOLUME`	`vol-obs-thanos-objectstore-data`	observability compose
`ctr-obs-grafana`	`MOUNTS_VOLUME`	`vol-obs-grafana-data`	observability compose
`ctr-obs-alertmanager`	`MOUNTS_VOLUME`	`vol-obs-alertmanager-data`	observability compose
`ctr-obs-grafana`	`DEPENDS_ON`	`ctr-obs-thanos-query`	observability compose
`ctr-obs-thanos-query`	`DEPENDS_ON`	`ctr-obs-thanos-sidecar`	observability compose
`ctr-obs-thanos-query`	`DEPENDS_ON`	`ctr-obs-thanos-storegateway`	observability compose
`ctr-obs-alertmanager`	`DEPENDS_ON`	`ctr-obs-prometheus`	governance

Mapa de componentes pedidos¶

VPS¶

entidad candidata: Host
clave estable: host-srv977009
atributos base:
hostname srv977009
OS Ubuntu 24.04.3 LTS
recursos 2 vCPU, 7.8 GiB, 96G /

Docker¶

entidad candidata: PlatformService o Infrastructure Service
representa:
engine Docker
Compose
runtime de contenedores, redes y volumenes
no reemplaza el detalle por contenedor; lo agrupa

Redes¶

entidades candidatas: Network
redes activas registradas:
net-proxy-network
net-openclaw-internal
net-obs-observability-internal

Volumenes¶

entidades candidatas: Volume
uso esperado en O7:
persistencia
recovery mapping
ownership tecnico
dependencia de servicio

OpenClaw¶

entidad candidata principal: Service
subentidad: Container
relaciones criticas:
publicado por NPM
depende de proxy-network
observado por Prometheus indirectamente mediante blackbox

Grafana¶

entidad candidata principal: Dashboard Service
evidencia actual:
contenedor obs-grafana
puerto 127.0.0.1:3000
rol en O7 futuro:
fuente de dashboards
catalogacion de carpetas, paneles y links

Prometheus¶

entidad candidata principal: Pipeline/Monitoring Service
evidencia actual:
contenedor obs-prometheus
reglas versionadas en infra/observability/prometheus/rules/
rol en O7 futuro:
observador de servicios
fuente de metricas de plataforma

Thanos¶

entidades candidatas:
Service para la capa Thanos
Container para sidecar/query/storegateway/compactor
rol:
historico
query federada interna

Alertmanager¶

entidad candidata principal: Service
rol:
ruteo de alertas
catalogo de receivers y grupos

Portainer¶

entidad candidata principal: Service
entidad de soporte: Volume
rol:
administracion Docker
no fuente de verdad documental

Mapeo propuesto a OpenMetadata futuro¶

Componente real	Entidad futura en O7/OpenMetadata	Metodo de carga inicial
host `srv977009`	custom entity o servicio de infraestructura	carga manual desde export O6
OpenClaw	service/application	carga manual
NPM	service	carga manual
Portainer	service	carga manual
Prometheus	service	carga manual
Grafana	dashboard service	conector Grafana si se habilita
dashboards Grafana	dashboard/chart	conector Grafana
alertas Prometheus	custom entity o metadata adjunta	export documental
redes Docker	custom entity	export O6
volumenes Docker	custom entity	export O6
Thanos	service	carga manual

Lo que este modelo demuestra hoy¶

ya existe un dominio de conocimiento util sin instalar O7
el dominio tiene IDs, relaciones y fuentes de verdad suficientes
la futura plataforma deberia absorber este modelo, no reemplazarlo a ciegas