Llevo bastante tiempo trabajando con servidores, automatizaciones y, más recientemente, experimentando con agentes de inteligencia artificial como Hermes Agent. Y si hay algo que cada vez tengo más claro es que el verdadero potencial de la inteligencia artificial no está únicamente en responder preguntas, sino en aprovechar la información que vamos generando cada día.
Precisamente por eso, conectar Hermes Agent con Obsidian me parece una de las integraciones más interesantes para quienes queremos convertir la IA en una herramienta de trabajo realmente útil.
Obsidian nos permite organizar notas, documentar proyectos y construir una base de conocimiento utilizando archivos Markdown. Hermes Agent, por su parte, puede trabajar con esos archivos para buscar información, recuperar procedimientos, generar resúmenes o crear documentación nueva.
La combinación permite transformar una colección de notas en una base de conocimiento que un agente de IA puede consultar cuando lo necesitemos.
Y lo mejor es que no necesitamos obligatoriamente instalar un plugin adicional de Obsidian ni configurar un servidor MCP. Hermes dispone de una skill específica para trabajar directamente con los archivos de una bóveda.
Eso sí, hay diferencias importantes entre utilizar ambas herramientas en el mismo ordenador y ejecutar Hermes Agent en un servidor VPS.
En esta guía voy a explicar cómo funciona la integración, cómo configurarla paso a paso, qué debemos hacer para sincronizar nuestras notas con un VPS y qué precauciones conviene tomar para evitar problemas.
¿Por qué conectar Hermes Agent con Obsidian?
Antes de entrar en la configuración, merece la pena entender qué ganamos al combinar estas dos herramientas.
Obsidian es una aplicación para gestionar conocimiento personal mediante archivos Markdown. Podemos crear notas, organizarlas en carpetas, añadir etiquetas, relacionar documentos y establecer enlaces entre ideas utilizando referencias como [[Nombre de la nota]].
Una de sus principales ventajas es que la información se guarda en archivos que podemos gestionar directamente.
Hermes Agent, desarrollado por Nous Research, es un agente de inteligencia artificial que puede utilizar herramientas, ejecutar tareas y trabajar con archivos. También dispone de mecanismos para conservar información relevante entre sesiones.
Cuando conectamos ambas herramientas, Hermes puede consultar documentación que hemos creado previamente y utilizarla como referencia para realizar determinadas tareas.
Por ejemplo, imaginemos que tenemos una bóveda con información sobre configuraciones de servidores, procedimientos de seguridad, incidencias técnicas y soluciones que hemos ido documentando durante años.
En lugar de buscar manualmente entre decenas o cientos de notas, podemos pedirle al agente que localice información relacionada con un problema, compare procedimientos o prepare un resumen a partir de los documentos disponibles.
Después de tantos años administrando servidores, considero especialmente interesante esta posibilidad. No se trata simplemente de almacenar soluciones, sino de facilitar que podamos recuperarlas y reutilizarlas.
Qué aporta Obsidian como base de conocimiento
Obsidian funciona como un repositorio documental que nosotros mismos podemos organizar.
Podemos utilizarlo para guardar:
- Documentación técnica y configuraciones de sistemas.
- Procedimientos de administración y mantenimiento.
- Investigaciones y notas de proyectos.
- Manuales internos de empresa.
- Información sobre campañas y estrategias de marketing.
- Soluciones a problemas que se repiten.
- Decisiones y aprendizajes importantes.
Al utilizar archivos Markdown, la información no depende exclusivamente de la interfaz de Obsidian. Podemos abrir esos documentos con un editor de texto, procesarlos mediante scripts o permitir que un agente autorizado trabaje con ellos.
Ahí encuentro una de las principales ventajas de esta integración.
La documentación deja de ser algo que simplemente almacenamos y pasa a convertirse en un recurso mucho más accesible.
Además, podemos mantener una estructura coherente mediante carpetas, enlaces internos y convenciones para nombrar los archivos.
Esto facilita el trabajo tanto a las personas como al agente, especialmente cuando la base documental empieza a crecer.
Diferencias entre la memoria de Hermes y las notas de Obsidian
Aquí conviene aclarar una cuestión importante: conectar Hermes Agent con Obsidian no significa que el agente vaya a recordar automáticamente todo lo que hemos escrito.
Hermes dispone de sus propios mecanismos de memoria persistente, mientras que Obsidian almacena documentos y notas en archivos Markdown.
Son dos recursos diferentes.
| Memoria persistente de Hermes | Bóveda de Obsidian |
|---|---|
| Conserva información relevante entre sesiones | Almacena documentación en archivos |
| Ayuda a mantener contexto habitual | Permite consultar conocimiento específico |
| Está gestionada mediante mecanismos propios del agente | Podemos organizarla y editarla directamente |
| Es útil para preferencias y datos recurrentes | Es útil para manuales, proyectos y procedimientos |
| No sustituye una biblioteca documental completa | No se incorpora automáticamente a la memoria de Hermes |
Por ejemplo, podemos utilizar la memoria de Hermes para conservar determinadas preferencias de trabajo y Obsidian para almacenar un procedimiento de recuperación de un servidor.
Cuando necesitemos ese procedimiento, el agente deberá localizarlo y leerlo.
Personalmente, prefiero este funcionamiento. Me parece mucho más razonable decidir qué información merece conservarse como contexto habitual y qué documentación debe recuperarse únicamente cuando resulta necesaria.
De esta manera evitamos confundir una biblioteca de documentos con una memoria que recuerda absolutamente todo.
También debemos tener presente que permitir a Hermes acceder a una bóveda no implica que haya indexado automáticamente todas sus notas. Para responder utilizando información concreta, tendrá que recuperarla mediante las herramientas disponibles.
Requisitos para integrar Hermes Agent con Obsidian
La integración básica es relativamente sencilla, pero necesitamos preparar correctamente el entorno.
Lo primero es distinguir entre dos escenarios:
- Hermes Agent y Obsidian se utilizan en el mismo ordenador.
- Hermes Agent está instalado en un VPS y Obsidian se utiliza en nuestro ordenador personal.
En el primer caso, ambas herramientas pueden trabajar sobre la misma carpeta de archivos, siempre que Hermes tenga los permisos necesarios.
En el segundo, tendremos que asegurarnos de que la documentación también esté disponible en el servidor.
Esta diferencia es fundamental porque muchas incidencias aparecen cuando intentamos configurar una ruta que realmente no existe en el equipo donde se ejecuta el agente.
Hermes Agent instalado y funcionando
Antes de comenzar, debemos disponer de una instalación operativa de Hermes Agent.
Si ya lo utilizamos habitualmente, podemos comprobar su estado desde la terminal:
hermes doctorTambién podemos consultar la ruta del archivo de configuración de entorno del perfil activo:
hermes config env-pathY revisar las skills disponibles:
hermes skills listEstos comandos permiten comprobar el entorno y localizar la configuración que posteriormente necesitaremos modificar.
Si trabajamos con varios perfiles de Hermes, debemos asegurarnos de utilizar el mismo perfil que empleará la integración.
Por ejemplo:
hermes -p work config env-pathEl ejemplo utiliza un perfil denominado work, que debe existir previamente.
Es importante no modificar la configuración de un perfil pensando que los cambios afectarán automáticamente a otro.
Si utilizamos una versión distinta de Hermes, conviene contrastar los comandos con la documentación correspondiente.
Crear o localizar una bóveda de Obsidian
En Obsidian, el conjunto de notas se organiza dentro de una carpeta que recibe el nombre de vault o bóveda.
Esta carpeta contiene los archivos Markdown y, normalmente, un directorio .obsidian con determinadas configuraciones de la aplicación.
Podemos utilizar una bóveda existente, aunque para las primeras pruebas recomiendo crear una nueva o trabajar únicamente con documentación no sensible.
Por ejemplo, podríamos organizarla así:
Mi-Obsidian/
├── Proyectos/
├── Servidores/
├── Procedimientos/
├── Investigaciones/
└── Hermes-Agent/
├── Pruebas/
├── Resumenes/
└── Documentacion/No es obligatorio utilizar esta estructura. Lo importante es que resulte comprensible y facilite localizar la información.
Para comprobar la integración empezaremos trabajando dentro de la carpeta Hermes-Agent, sin permitir modificaciones sobre toda nuestra documentación.
Antes de continuar, debemos conocer la ruta absoluta de la bóveda.
En Linux, podría ser:
/home/usuario/Documentos/Mi-ObsidianEn Windows, una ubicación equivalente tendría otro formato. Si ejecutamos Hermes dentro de WSL o un contenedor, debemos utilizar la ruta visible desde ese entorno, no necesariamente la que vemos en el explorador de Windows.
Elegir entre instalación local o servidor VPS
Si estamos empezando a experimentar con agentes de IA, instalar Hermes Agent en nuestro ordenador es una opción perfectamente válida.
Podemos realizar pruebas, consultar archivos locales y familiarizarnos con el funcionamiento de las skills.
Sin embargo, cuando queremos utilizar un agente para automatizar procesos, atender peticiones remotas o mantener servicios activos, un VPS puede resultar más interesante.
En mi caso, después de años trabajando con infraestructura y servidores, valoro especialmente la posibilidad de controlar dónde se ejecutan los procesos, qué recursos tienen disponibles y a qué información pueden acceder.
Un servidor VPS nos permite configurar ese entorno y mantenerlo disponible sin depender de que nuestro ordenador personal permanezca encendido.
No obstante, debemos preparar correctamente el acceso a los documentos.
El hecho de instalar Hermes Agent en un VPS no permite acceder automáticamente a una bóveda de Obsidian que sigue estando en nuestro ordenador.
Para conseguirlo necesitaremos copiar o sincronizar los archivos, tal como veremos más adelante.
Cómo conectar Hermes Agent con Obsidian paso a paso
Vamos con la parte práctica.
El procedimiento básico consiste en indicar a Hermes dónde están los archivos Markdown y permitir que utilice su skill de Obsidian para trabajar con ellos.
La integración se basa en el sistema de archivos. No requiere que Obsidian esté abierto continuamente ni que exista una conexión permanente entre la aplicación y el agente.
Paso 1. Localizar la ruta de la bóveda de Obsidian
Lo primero es identificar la ubicación real de nuestra bóveda.
En Linux podemos abrir una terminal y acceder a la carpeta correspondiente:
cd "/home/usuario/Documentos/Mi-Obsidian"
pwdEl comando pwd mostrará la ruta absoluta del directorio.
También conviene comprobar que podemos listar su contenido:
ls -laDebemos sustituir la ruta del ejemplo por la ubicación real de nuestra bóveda.
Si Hermes se ejecuta en otro ordenador, esta comprobación debe realizarse también en el entorno donde trabaja el agente.
Una ruta válida en nuestro portátil no tiene por qué existir dentro del VPS.
Paso 2. Configurar el acceso de Hermes a los archivos
La skill de Obsidian utiliza la variable de entorno OBSIDIAN_VAULT_PATH para conocer la ubicación de la bóveda.
Primero localizamos el archivo de entorno del perfil de Hermes:
hermes config env-pathAbrimos el archivo indicado y añadimos una línea como esta:
OBSIDIAN_VAULT_PATH="/home/usuario/Documentos/Mi-Obsidian"Debemos adaptar la ruta a nuestro sistema.
En una instalación habitual, el archivo de entorno puede encontrarse dentro del directorio de configuración de Hermes, pero es preferible consultar su ubicación real con el comando anterior.
Después de guardar los cambios, reiniciamos el proceso de Hermes que utiliza ese perfil para asegurarnos de que carga la nueva configuración.
Si ejecutamos Hermes mediante un servicio, tendremos que reiniciar o recargar ese servicio según su configuración.
Hay un detalle técnico importante: la variable indica al agente dónde está la bóveda, pero no actúa como una barrera de seguridad.
Es decir, configurar una ruta no impide por sí mismo que el proceso pueda acceder a otros archivos para los que tenga permisos.
Por eso debemos limitar los permisos del sistema operativo cuando trabajemos con documentación sensible.
Paso 3. Utilizar la skill de Obsidian
Hermes Agent dispone de una skill denominada obsidian, diseñada para trabajar con archivos Markdown.
Su función es orientar al agente para realizar operaciones como:
- Leer documentos.
- Listar notas existentes.
- Buscar información en archivos.
- Crear nuevas notas Markdown.
- Añadir contenido a notas existentes.
- Modificar fragmentos concretos.
- Incorporar enlaces internos de Obsidian.
Podemos comprobar su disponibilidad mediante:
hermes skills listUna vez configurada la ruta, podemos pedir al agente que utilice esta skill.
Por ejemplo:
Utiliza la skill de Obsidian. Comprueba que puedes acceder a la bóveda configurada y enumera los archivos Markdown de la carpeta Hermes-Agent. No modifiques ningún documento.
La skill emplea las herramientas de archivos disponibles en Hermes.
Es importante tener en cuenta que estas herramientas necesitan rutas absolutas resueltas. No debemos suponer que expandirán automáticamente una expresión como $OBSIDIAN_VAULT_PATH.
La variable sirve para identificar la ubicación, pero cuando se utiliza una herramienta de archivos debe proporcionarse la ruta concreta correspondiente.
Tampoco necesitamos instalar obligatoriamente un servidor MCP para esta integración básica.
Existen otras maneras de conectar aplicaciones y agentes, pero para trabajar directamente con archivos Markdown esta solución puede ser suficiente.
Paso 4. Comprobar que Hermes puede leer y crear notas
Una vez configurada la integración, debemos comprobar que realmente funciona.
Recomiendo comenzar creando una nota desechable dentro de una carpeta de pruebas.
Podemos enviar a Hermes una instrucción como esta:
Utiliza la skill de Obsidian y trabaja únicamente en la carpeta Hermes-Agent/Pruebas. Comprueba que existe y crea un archivo llamado prueba-hermes.md si todavía no está creado. Añade el título «Prueba de conexión con Hermes Agent» y una línea que indique «Conexión de prueba correcta». Después vuelve a leer el archivo desde el disco y confirma su ubicación. No modifiques ninguna otra nota.
Cuando Hermes termine, abrimos Obsidian y buscamos el archivo.
Si todo ha funcionado correctamente, veremos la nueva nota dentro de la bóveda.
Pero no debemos conformarnos con que el agente responda que ha completado la operación.
Conviene comprobar personalmente que:
- El archivo existe en la carpeta esperada.
- El contenido coincide con lo solicitado.
- Obsidian puede abrirlo correctamente.
- Hermes puede volver a leerlo en una sesión nueva.
Esta última comprobación es especialmente interesante.
Nos permite confirmar que el agente está recuperando información del archivo y no limitándose a repetir algo que todavía conserva en el contexto de la conversación.
Una vez finalizada la prueba, podremos empezar a consultar documentos reales, preferiblemente utilizando primero permisos de solo lectura.
Cómo conectar Obsidian con Hermes Agent instalado en un VPS
Hasta ahora hemos visto cómo configurar el acceso a una bóveda que está disponible en el mismo entorno donde se ejecuta Hermes.
Sin embargo, uno de los escenarios que considero más interesantes es utilizar Hermes Agent en un servidor VPS mientras seguimos trabajando con Obsidian desde nuestro ordenador.
Es una arquitectura especialmente útil para quienes utilizamos servidores, automatizaciones o herramientas accesibles de forma remota.
En HostingTG hemos apostado por ofrecer servidores VPS con Hermes Agent preinstalado para facilitar precisamente este tipo de proyectos.
Pero antes debemos resolver una cuestión: cómo conseguir que el agente tenga acceso a nuestras notas.
Por qué la bóveda local no está disponible automáticamente
Imaginemos que utilizamos Obsidian en nuestro ordenador y que Hermes Agent se ejecuta en un VPS Linux.
Tendríamos esta situación:
ORDENADOR PERSONAL
└── Obsidian
└── Bóveda de notas
SERVIDOR VPS
└── Hermes Agent
└── Sin acceso inicial a esas notasAunque configuremos en Hermes una variable con la ruta que utilizamos en nuestro ordenador, esa carpeta no aparecerá automáticamente dentro del servidor.
Son sistemas diferentes.
Para resolverlo necesitamos un mecanismo que permita disponer de los archivos en ambos entornos.
Existen varias posibilidades: copiar los documentos periódicamente, utilizar una herramienta de sincronización, montar un almacenamiento remoto o emplear Git.
Para una base de conocimiento formada principalmente por archivos Markdown, Git puede ser una alternativa práctica porque permite sincronizar cambios y mantener un historial de versiones.
Eso sí, utilizar Git implica gestionar correctamente los conflictos y proteger el acceso al repositorio.
Sincronizar la documentación mediante Git y un repositorio privado
Una arquitectura posible sería:
ORDENADOR PERSONAL
Obsidian
│
│ Git push / pull
▼
REPOSITORIO PRIVADO
GitHub
│
│ Git pull / push
▼
SERVIDOR VPS
Carpeta de notas
│
▼
Hermes AgentEn este escenario, Obsidian y Hermes trabajan con copias sincronizadas de una misma colección de documentos.
No se trata de acceso directo en tiempo real. Los cambios estarán disponibles cuando se completen las operaciones de sincronización correspondientes.
Antes de comenzar, recomiendo utilizar una bóveda de prueba y realizar una copia de seguridad.
Preparar el repositorio
Creamos un repositorio privado en GitHub.
Después, desde el ordenador donde tenemos Obsidian, abrimos una terminal en la carpeta de una bóveda de prueba.
Si es una carpeta nueva que todavía no está gestionada por Git, podemos iniciar el repositorio:
git initAntes de añadir archivos, revisamos cuáles queremos incluir.
Es conveniente crear un archivo .gitignore para evitar subir elementos temporales, archivos de configuración sensibles o información que no deba almacenarse en el repositorio.
A continuación, configuramos el repositorio remoto utilizando la dirección SSH que proporciona GitHub:
git remote add origin git@github.com:USUARIO/REPOSITORIO.gitSustituimos USUARIO y REPOSITORIO por nuestros valores reales.
Cuando hayamos revisado los archivos, podemos realizar el primer envío:
git add .
git commit -m "Configuración inicial de notas"
git branch -M main
git push -u origin mainEstos comandos presuponen que Git ya tiene configurada la identidad del usuario y que contamos con autenticación válida para acceder a GitHub.
También debemos comprobar que el repositorio remoto está preparado para recibir la rama.
No recomiendo ejecutar git add . sobre una bóveda personal sin revisar antes qué archivos contiene, especialmente si incluye credenciales, información de clientes o documentos privados.
Preparar la copia en el VPS
Desde nuestro servidor Linux, accedemos mediante SSH y comprobamos que Git está disponible:
git --versionEn sistemas basados en Debian o Ubuntu, si no está instalado, podemos añadirlo mediante:
sudo apt update
sudo apt install gitDespués configuramos una autenticación SSH adecuada para el repositorio privado.
Lo recomendable es utilizar credenciales con los permisos mínimos necesarios y evitar compartir claves entre servicios sin una razón justificada.
Cuando tengamos acceso al repositorio, podemos clonarlo en una carpeta destinada a la documentación:
git clone git@github.com:USUARIO/REPOSITORIO.git \
/home/hermes/obsidian-vaultLa ruta es orientativa.
Debemos sustituir /home/hermes por el directorio correspondiente al usuario que utilizará los archivos, comprobar que existe y asegurarnos de que ese usuario dispone de los permisos adecuados.
Con esto tendremos una copia de la bóveda dentro del VPS.
Configurar rutas y permisos en el servidor
Una vez disponibles las notas en el servidor, indicamos a Hermes dónde encontrarlas.
Localizamos nuevamente el archivo de entorno:
hermes config env-pathY configuramos la ruta correspondiente:
OBSIDIAN_VAULT_PATH="/home/hermes/obsidian-vault"Después reiniciamos el proceso de Hermes y comprobamos que puede acceder a la carpeta.
No aconsejo ejecutar el agente como administrador del sistema si no es necesario.
Es preferible utilizar una cuenta específica, conceder únicamente los permisos necesarios y mantener las credenciales fuera de la bóveda.
También debemos evitar que los procesos de sincronización se ejecuten con privilegios superiores a los necesarios.
Un VPS con acceso root nos permite administrar toda la infraestructura, pero no significa que Hermes deba trabajar continuamente con permisos root.
De hecho, separar los privilegios facilita reducir el impacto de posibles errores o modificaciones no deseadas.
Verificar la sincronización de las notas
Una vez que Hermes puede leer y escribir archivos dentro de la copia del VPS, debemos comprobar que los cambios llegan al ordenador.
Podemos comenzar con una prueba manual.
Primero creamos una nota en Obsidian, revisamos los cambios pendientes y los enviamos al repositorio privado.
En el servidor ejecutamos, desde la carpeta del repositorio:
git pull --ff-onlyDespués comprobamos que Hermes puede leer la nota.
Para probar el camino inverso, pedimos al agente que cree un documento desechable dentro de la carpeta autorizada.
Revisamos el archivo creado y, si es correcto, realizamos un commit desde el servidor:
git add Hermes-Agent/Pruebas/prueba-hermes.md
git commit -m "Nota de prueba creada por Hermes"
git pushPor último, descargamos los cambios en el ordenador y comprobamos que la nota aparece en Obsidian.
Si queremos automatizar este proceso, podemos utilizar herramientas como Obsidian Git y una tarea programada en el VPS.
Sin embargo, conviene comprender primero el flujo manual.
Git puede encontrar conflictos cuando dos equipos modifican el mismo archivo. Tampoco debemos automatizar comandos que descarten cambios locales o sobrescriban documentos sin revisión.
Una sincronización bidireccional bien configurada debe contemplar qué sucede cuando hay cambios simultáneos, fallos de conexión o modificaciones pendientes.
En mi caso, cuando pienso en utilizar Hermes para documentación técnica, prefiero una solución donde pueda comprobar qué archivos se han modificado y recuperar versiones anteriores si algo falla.
Qué puedes hacer con Hermes Agent y Obsidian
Una vez completada la integración, llega la parte que considero realmente interesante: utilizar nuestra información para resolver tareas.
No se trata de darle a Hermes acceso a cientos de documentos simplemente porque podemos hacerlo.
Lo importante es definir qué queremos conseguir con esa información.
Buscar información en tus notas y recuperar conocimientos
Imaginemos que administramos varios servidores y llevamos tiempo documentando configuraciones, incidencias y soluciones.
Un día aparece un problema parecido a otro que resolvimos meses atrás.
En lugar de revisar manualmente toda nuestra documentación, podemos pedirle a Hermes:
Busca en mis notas de Obsidian los procedimientos relacionados con problemas de certificados SSL. Identifica los documentos relevantes y prepara un resumen con las soluciones documentadas. Indica de qué notas has obtenido la información.
Este tipo de consulta puede ayudarnos a recuperar conocimientos que ya teníamos, pero cuya ubicación no recordábamos.
El resultado dependerá de que el agente tenga acceso a los archivos, de las herramientas de búsqueda disponibles y de la calidad de la documentación.
También debemos comprobar las respuestas cuando las utilicemos para tomar decisiones técnicas.
Resumir documentación y generar nuevas notas
Otro uso interesante es transformar documentos extensos en información más fácil de consultar.
Por ejemplo, podemos pedir a Hermes que lea varios documentos de un proyecto y prepare una nota con:
- Objetivos y decisiones importantes.
- Configuraciones relevantes.
- Tareas pendientes.
- Problemas detectados.
- Referencias a los archivos originales.
Podemos utilizar enlaces internos de Obsidian para relacionar el resumen con las notas de origen.
Esto resulta especialmente útil cuando trabajamos con proyectos que acumulan documentación durante meses.
También podemos solicitar resúmenes periódicos, siempre que configuremos el mecanismo necesario para ejecutar esas tareas y acceder a los documentos.
Organizar procedimientos técnicos y documentación empresarial
La integración también tiene aplicaciones interesantes para empresas.
En una agencia de marketing, por ejemplo, podemos utilizar Obsidian para organizar investigaciones, campañas, procedimientos y documentación de clientes.
Un agente autorizado podría consultar esas notas para preparar resúmenes internos o recuperar información sobre un proyecto.
En una empresa tecnológica, podríamos trabajar con procedimientos de despliegue, configuraciones de sistemas y documentación operativa.
Y en una organización con muchos procesos internos, Obsidian puede convertirse en una referencia documental que los agentes consulten para determinadas automatizaciones.
Después de años administrando servidores, una de las posibilidades que más me interesan es mantener una base de conocimiento técnico que no se limite a almacenar soluciones, sino que nos ayude a reutilizarlas.
Eso sí, no debemos confundir recuperar una instrucción con garantizar que sea correcta.
Si Hermes encuentra un procedimiento antiguo, tendremos que comprobar si continúa siendo válido antes de aplicarlo a un sistema de producción.
Consultar tu base de conocimiento desde Telegram
Otra posibilidad interesante consiste en utilizar Hermes Agent a través de herramientas de mensajería como Telegram.
Si configuramos correctamente ese canal y Hermes tiene acceso a la bóveda, podemos realizar consultas sobre nuestra documentación sin necesidad de abrir Obsidian en ese momento.
Por ejemplo, podríamos solicitar desde el teléfono:
Busca en la documentación del proyecto los pasos previstos para realizar una actualización y prepara un resumen. No ejecutes ninguna modificación.
Hermes podría consultar los archivos disponibles y responder por el canal configurado.
Esto resulta especialmente útil cuando el agente se ejecuta en un VPS y permanece disponible de forma continua.
No obstante, debemos proteger el acceso al bot y evitar que conversaciones o solicitudes no autorizadas puedan provocar la exposición de documentación sensible.
Problemas frecuentes al conectar Hermes Agent con Obsidian
Aunque la configuración básica no es especialmente compleja, pueden aparecer errores relacionados con las rutas, los permisos o la sincronización.
Estos son los que conviene revisar primero.
Hermes no encuentra la bóveda de Obsidian
Uno de los problemas más habituales aparece cuando configuramos una ruta incorrecta.
Debemos comprobar que OBSIDIAN_VAULT_PATH contiene una ruta absoluta válida dentro del entorno donde se ejecuta Hermes.
También conviene revisar:
- Que la carpeta existe realmente.
- Que el proceso utiliza el perfil correcto.
- Que hemos reiniciado Hermes después de cambiar la configuración.
- Que el usuario del proceso puede acceder al directorio.
- Que no estamos mezclando rutas de Windows, WSL, contenedores o Linux.
Si Hermes funciona en un VPS, una ruta correspondiente a nuestro ordenador personal no servirá salvo que el almacenamiento esté disponible en el servidor mediante un mecanismo adecuado.
La skill no puede leer o modificar archivos
Si Hermes encuentra la carpeta pero no consigue abrir o crear notas, debemos comprobar los permisos.
En Linux podemos examinar la información del directorio:
ls -ld "/home/hermes/obsidian-vault"Y consultar los permisos de los archivos:
ls -la "/home/hermes/obsidian-vault"Después debemos comprobar qué usuario ejecuta Hermes.
No recomiendo solucionar todos los problemas de permisos utilizando chmod 777 o ejecutando el agente como root.
Es preferible determinar qué acceso necesita realmente y concederlo únicamente sobre las carpetas autorizadas.
También debemos verificar que la skill se encuentra disponible y que Hermes está utilizando las herramientas apropiadas.
Los cambios no se sincronizan con el VPS
Si Hermes consigue modificar archivos en el servidor pero los cambios no aparecen en Obsidian, probablemente el problema esté en la sincronización.
Conviene comprobar el estado del repositorio:
git statusTambién podemos revisar si existen cambios pendientes o errores relacionados con la autenticación.
Si los archivos aparecen correctamente en el VPS pero no en el ordenador, debemos comprobar si los cambios se han enviado al repositorio remoto y descargado en la bóveda local.
En cambio, si el agente está escribiendo en otra carpeta, el problema probablemente sea la ruta configurada.
La siguiente tabla puede servirnos como referencia rápida:
| Problema | Posible causa | Qué comprobar |
|---|---|---|
| Hermes no encuentra las notas | Ruta incorrecta | OBSIDIAN_VAULT_PATH |
| No puede crear archivos | Permisos insuficientes | Usuario y permisos del directorio |
| La skill no aparece | Instalación o perfil diferente | hermes skills list |
| Las notas no llegan al VPS | Sincronización pendiente | Estado de Git y autenticación |
| Los cambios no aparecen en Obsidian | Falta de descarga o carpeta incorrecta | Repositorio local y ruta de la bóveda |
| Aparecen conflictos | Modificaciones simultáneas | Historial y conflictos de Git |
Mi recomendación es realizar las comprobaciones por separado: primero acceso a archivos, después lectura y escritura y, finalmente, sincronización entre equipos.
Así resulta mucho más sencillo identificar dónde está el fallo.
Seguridad y buenas prácticas al utilizar Hermes con Obsidian
La seguridad es una cuestión que considero especialmente importante cuando combinamos agentes de IA con documentación privada.
Permitir que un agente consulte archivos puede ayudarnos a trabajar de forma más eficiente, pero también implica conceder acceso a información que debemos proteger.
Por eso no recomiendo comenzar dando permisos de escritura sobre toda nuestra base documental.
Es preferible realizar las primeras pruebas con una carpeta específica y ampliar el acceso únicamente cuando sea necesario.
Limitar permisos y proteger documentos sensibles
Una buena práctica consiste en crear un usuario específico para ejecutar Hermes y limitar los directorios a los que puede acceder.
También podemos utilizar contenedores o mecanismos de aislamiento que expongan únicamente las carpetas necesarias.
Debemos recordar que indicar al agente que trabaje solamente en una carpeta no equivale a establecer una restricción de seguridad.
Las instrucciones que enviamos al agente orientan su comportamiento, pero el control efectivo del acceso debe aplicarse mediante permisos y aislamiento del sistema.
Tampoco deberíamos incluir claves privadas, contraseñas, tokens o credenciales dentro de una bóveda accesible al agente salvo que exista una necesidad justificada y controles adecuados.
Si utilizamos GitHub, mantener el repositorio como privado es imprescindible para la confidencialidad básica, pero no sustituye una política de seguridad.
También debemos controlar las credenciales utilizadas por el VPS, los dispositivos autorizados y los documentos que realmente necesitamos sincronizar.
Mantener copias de seguridad y revisar los cambios
Otra precaución importante es disponer de copias de seguridad.
Git permite conservar un historial de versiones, pero un repositorio Git no sustituye por sí solo una estrategia completa de copias de seguridad.
Debemos disponer de respaldos independientes y comprobar que podemos recuperarlos.
También recomiendo revisar los documentos generados por Hermes antes de incorporarlos a una base de conocimiento importante.
Por ejemplo, podemos crear una carpeta donde el agente deposite propuestas de documentación y revisarlas antes de trasladarlas a los procedimientos definitivos.
Esto resulta especialmente interesante cuando trabajamos con manuales técnicos, configuraciones de seguridad o instrucciones de producción.
En mi caso, prefiero un sistema donde el agente me ayude a preparar y organizar información, pero donde mantenga el control sobre los cambios importantes.
La automatización debe facilitarnos el trabajo, no introducir modificaciones difíciles de detectar o recuperar.
Ventajas de utilizar un VPS con Hermes Agent preinstalado
Hasta aquí hemos visto que podemos conectar Hermes Agent con Obsidian tanto en nuestro ordenador como en un servidor.
Pero ¿cuándo merece la pena utilizar un VPS?
Desde mi punto de vista, especialmente cuando queremos pasar de realizar pruebas ocasionales a disponer de un agente que forme parte de nuestro entorno habitual de trabajo.
Funcionamiento continuo y control de la infraestructura
Un VPS permite mantener Hermes Agent ejecutándose en un entorno remoto sin depender de que nuestro ordenador personal esté encendido.
Esto abre posibilidades interesantes cuando queremos utilizar canales de mensajería, automatizaciones programadas o herramientas que necesitan estar disponibles durante buena parte del día.
También podemos decidir cómo organizar el almacenamiento, qué servicios adicionales instalar y qué permisos tendrá el agente.
Por ejemplo, podríamos utilizar un VPS para mantener una copia sincronizada de nuestra bóveda de Obsidian, recibir peticiones mediante Telegram y ejecutar tareas autorizadas sobre la documentación.
Eso no significa que todo deba funcionar automáticamente sin supervisión.
Necesitaremos configurar correctamente los servicios, las credenciales, la sincronización y los controles de seguridad.
Sin embargo, disponer de una infraestructura propia ofrece flexibilidad para adaptar el entorno a las necesidades de cada proyecto.
Servidores VPS de HostingTG preparados para Hermes Agent
En HostingTG hemos apostado por ofrecer servidores VPS con Hermes Agent preinstalado para facilitar que profesionales y empresas puedan empezar a trabajar con este tipo de agentes sin tener que preparar toda la infraestructura desde cero.
Nuestros servidores VPS están orientados a proyectos que necesitan recursos dedicados, almacenamiento NVMe, acceso root completo y protección Anti-DDoS, además de un entorno preparado para ejecutar Hermes Agent.
Para mí, una de las ventajas más interesantes es que podemos utilizar estos recursos para construir soluciones que vayan más allá de mantener una conversación con una inteligencia artificial.
Podemos integrar herramientas, organizar documentación, preparar automatizaciones y trabajar con una base de conocimiento propia.
La combinación con Obsidian encaja especialmente bien en ese planteamiento.
Imaginemos una empresa que mantiene documentación sobre sus procedimientos internos o un administrador de sistemas que guarda configuraciones y soluciones a incidencias.
Con una integración adecuada, Hermes puede ayudar a recuperar esa información, preparar resúmenes y facilitar determinadas tareas mientras se ejecuta en un servidor disponible de forma continuada.
Naturalmente, necesitaremos configurar el acceso a las notas y los mecanismos de sincronización que correspondan.
Un VPS con Hermes preinstalado no significa que Obsidian esté conectado automáticamente, pero sí nos proporciona un entorno sobre el que podemos construir la integración.
Y esto es precisamente lo que buscamos facilitar desde HostingTG: que las empresas y profesionales puedan experimentar con agentes de inteligencia artificial y desarrollar sus propios flujos de trabajo sin tener que comenzar toda la instalación del agente desde cero.
Dudas de la comunidad
¿Se puede conectar Hermes Agent con Obsidian sin instalar plugins?
Sí. Hermes dispone de una skill específica que permite trabajar directamente con los archivos Markdown de una bóveda de Obsidian.
Para esta integración básica no es obligatorio instalar un complemento adicional dentro de Obsidian.
¿Necesito un servidor MCP para integrar Hermes con Obsidian?
No necesariamente. Si Hermes tiene acceso a los archivos de la bóveda, puede utilizar su skill de Obsidian para leer, buscar y crear notas.
Un servidor MCP puede formar parte de otras arquitecturas, pero no es un requisito de la integración mediante archivos.
¿Puede Hermes Agent modificar mis notas de Obsidian?
Sí, siempre que disponga de las herramientas y los permisos necesarios.
Por seguridad, recomiendo comenzar con documentos de prueba y restringir los permisos antes de permitir modificaciones sobre documentación importante.
¿Cómo conecto una bóveda local con Hermes instalado en un VPS?
Necesitamos conseguir que los archivos estén disponibles en el servidor.
Una posibilidad consiste en utilizar un repositorio Git privado para sincronizar la documentación entre nuestro ordenador y el VPS.
Después configuramos OBSIDIAN_VAULT_PATH para indicar a Hermes la ubicación de la copia del servidor.
¿Obsidian sustituye la memoria persistente de Hermes Agent?
No. La memoria persistente de Hermes y los archivos Markdown de Obsidian cumplen funciones diferentes.
La memoria del agente puede conservar información relevante entre sesiones, mientras que Obsidian actúa como repositorio documental que Hermes puede consultar cuando corresponda.
¿Por qué Hermes Agent no encuentra mi bóveda?
Las causas habituales incluyen una ruta incorrecta, permisos insuficientes, el uso de un perfil diferente o una carpeta que no existe dentro del entorno donde se ejecuta Hermes.
Debemos comprobar la ruta absoluta, el usuario del proceso y la configuración activa.
Convierte tus notas en una base de conocimiento para IA
Después de trabajar durante años con servidores, automatizaciones y herramientas tecnológicas, cada vez tengo más claro que una de las aplicaciones más interesantes de los agentes de inteligencia artificial consiste en permitirnos aprovechar mejor nuestro propio conocimiento.
Y conectar Hermes Agent con Obsidian representa un paso interesante en esa dirección.
Obsidian nos proporciona una forma de organizar documentación mediante archivos que podemos gestionar directamente. Hermes Agent añade la capacidad de trabajar con esa información utilizando sus herramientas.
La combinación puede ayudarnos a recuperar procedimientos, relacionar contenidos, crear resúmenes y mantener nuestra documentación más accesible.
Pero también debemos ser conscientes de sus límites.
No estamos creando una memoria mágica que recordará automáticamente todo lo que guardemos. Necesitamos estructurar bien la información, configurar el acceso a los archivos, revisar los resultados y proteger nuestra documentación.
Si además ejecutamos Hermes Agent en un VPS, podemos construir un entorno preparado para mantener servicios activos, integrar herramientas adicionales y desarrollar automatizaciones de forma continuada.
Precisamente por eso, en HostingTG seguimos apostando por nuestros servidores VPS con Hermes Agent preinstalado.
Creo que los agentes de IA van a tener un papel cada vez más importante en la forma de trabajar de profesionales y empresas. Y disponer de una infraestructura adecuada será fundamental para aprovechar sus posibilidades.
Al final, lo que más me interesa de conectar Hermes Agent con Obsidian es algo bastante sencillo: dejar de tener una colección de notas que apenas consultamos y empezar a disponer de una base de conocimiento que podamos utilizar de manera mucho más inteligente.
Si quieres desarrollar este tipo de integración en un entorno remoto, puedes conocer los servidores VPS de HostingTG preparados para trabajar con Hermes Agent y construir sobre ellos tu propio sistema de automatización y gestión del conocimiento.
Opinión Personal
Después de años trabajando con servidores, automatizaciones y, más recientemente, experimentando con agentes de inteligencia artificial, cada vez tengo más claro que el verdadero potencial de la IA no está únicamente en generar respuestas, sino en aprovechar todo el conocimiento que vamos acumulando con el tiempo.
Por eso, la posibilidad de conectar Hermes Agent con Obsidian me parece especialmente interesante. No hablamos simplemente de utilizar dos herramientas que funcionan bien por separado, sino de combinar un agente de IA capaz de trabajar con archivos y ejecutar tareas con una base de conocimiento que podemos organizar y controlar nosotros mismos.
En mi caso, una de las cosas que más valoro es poder recuperar información que he documentado anteriormente. Quienes llevamos años administrando servidores sabemos perfectamente lo que significa encontrarnos con un problema que ya resolvimos hace meses, pero no recordar dónde guardamos la solución. Poder pedirle a Hermes que consulte nuestras notas, localice un procedimiento o prepare un resumen me parece una forma muy inteligente de aprovechar esa experiencia acumulada.
Eso sí, tampoco creo que debamos presentar esta integración como una solución mágica. Conectar Hermes Agent con Obsidian no significa que el agente vaya a recordar absolutamente todo ni que debamos darle acceso sin restricciones a nuestra documentación. La seguridad, los permisos y las copias de seguridad siguen siendo fundamentales, especialmente cuando trabajamos con información profesional o empresarial.
También considero que ejecutar Hermes Agent en un VPS puede marcar una diferencia importante. Disponer de un agente funcionando de manera continua, sin depender de mantener nuestro ordenador encendido, abre posibilidades muy interesantes para automatizar tareas, consultar documentación desde Telegram o construir nuestra propia base de conocimiento asistida por IA.
Precisamente por eso, en HostingTG hemos apostado por ofrecer servidores VPS con Hermes Agent preinstalado. Creo que facilitar el acceso a estas tecnologías es una buena forma de ayudar a profesionales y empresas a descubrir lo que pueden conseguir con los agentes de inteligencia artificial.
Personalmente, pienso que estamos empezando a dejar atrás la etapa en la que utilizábamos la IA únicamente para hacer preguntas. El siguiente paso será conseguir que estos agentes trabajen con nuestras herramientas, nuestros documentos y nuestros propios conocimientos.
Y la combinación de Hermes Agent con Obsidian me parece un buen ejemplo de hacia dónde nos dirigimos.
¿Y tú qué opinas?
Me gustaría conocer tu experiencia. ¿Has conseguido conectar Hermes Agent con Obsidian? ¿Lo utilizas en tu ordenador o prefieres ejecutarlo en un VPS? ¿Qué ventajas le encuentras y qué problemas has tenido durante la configuración?
Y si todavía no has probado esta integración, también me interesa saber qué automatizaciones te gustaría conseguir con ella.
Te animo a dejar tu opinión, tus dudas o tu experiencia en los comentarios. Seguro que entre todos podemos descubrir nuevas formas de aprovechar Hermes Agent y Obsidian, compartir soluciones y ayudar a quienes están empezando con estas herramientas.
¡Te leo en los comentarios!
