Skip to content
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

100 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tu agente en OCI con OpenClaw o Hermes

Crea un agente propio que se ejecute dentro de tu OCI, con una URL para conversar desde el navegador. La idea es simple: la infraestructura queda en tu tenancy, la VM ejecuta OpenClaw o Hermes, y las llamadas al modelo pasan por OCI Generative AI usando la autenticación de la propia instancia.

No necesitas pegar una API key del modelo, un token de Telegram ni un chat id. La stack levanta todo, prueba todo y solo termina con Succeeded cuando el agente está realmente listo.

En una frase

Levantas una stack, eliges openclaw o hermes, esperas unos minutos y recibes una URL lista para abrir tu agente.

Archivo

Usa este paquete:

openclaw-hermes-oci.zip

Crea una VM con 2 OCPU y 16 GB de RAM. La stack intenta usar VM.Standard.E5.Flex primero y, si hace falta, intenta VM.Standard.E6.Flex.

La app es liviana. Para una versión más económica, también puede ejecutarse en A1 Always Free, pero este paquete prioriza E5/E6 porque suele ofrecer una experiencia de despliegue más predecible.

Qué queda en OCI

Casi todo lo importante queda dentro de tu OCI:

  • la VM donde se ejecuta el agente;
  • la red de la VM;
  • las reglas de acceso;
  • la app elegida, OpenClaw o Hermes;
  • el acceso al modelo enterprise vía OCI Generative AI.

La persona conversa desde fuera, usando la interfaz web. Si quieres, después también puedes conectar canales como Telegram en la app. El agente y el modelo quedan del lado de OCI.

flowchart LR
    Web["Interfaz Web"]
    Telegram["Telegram"]

    subgraph OCI["OCI - tu tenancy"]
        subgraph VM["Instancia VM E5"]
            App["Hermes u OpenClaw"]
        end
        Model["Modelo de IA empresarial compatible con OpenAI"]

        VM --> Model
    end

    Web --> VM
    Telegram -.-> VM

    class Web,Telegram purpleBox
    classDef purpleBox fill:#e1d5e7,stroke:#9673a6,stroke-width:2px,color:#4527a0

    style Telegram stroke-dasharray: 5 5,color:#4527a0

    style OCI fill:#f3f4f6,stroke:#111111,stroke-width:2px,stroke-dasharray: 5 5,color:#000000
    style VM fill:#f3f4f6,stroke:#111111,stroke-width:2px,color:#000000
    style App fill:#f3f4f6,stroke:#111111,stroke-width:1px,color:#000000
    style Model fill:#f3f4f6,stroke:#111111,stroke-width:2px,color:#000000
Loading

En términos prácticos:

  • Fuera de OCI queda la forma de interacción: navegador y, si se configura después, Telegram.
  • Dentro de OCI queda la VM con Hermes u OpenClaw.
  • La VM conversa con OCI Generative AI en formato compatible con OpenAI.
  • El modelo es empresarial, se consume bajo demanda y tiene una propuesta de cero retención para inferencia.

Para explicarlo de forma simple: la infraestructura queda en tu OCI y el modelo se consume mediante OCI Generative AI con una propuesta de cero retención para inferencia. Según la documentación de tratamiento de datos del servicio, los prompts y las respuestas usados en inferencia no se almacenan dentro de OCI Generative AI y tampoco se comparten con proveedores externos. Referencia oficial: https://docs.oracle.com/pt-br/iaas/Content/generative-ai/data-handling.htm

Costo, sin complicarlo

Piensa en el costo en tres partes:

Parte Cómo pensarlo
Red La VCN, subnet, route table y security list no cobran por existir. Para esta prueba, piensa en la red base como gratuita; el tráfico de salida puede seguir las reglas de cobro de OCI.
VM La VM se paga por hora mientras esté encendida. Si la apagas, deja de consumir computación. El boot volume puede seguir existiendo.
LLM El modelo se paga por consumo, normalmente por tokens de entrada y salida. Si usas más, pagas más; si usas menos, pagas menos.

Resumen bien directo:

  • para probar poco, el mayor cuidado es la VM encendida;
  • para conversar bastante, el costo del LLM empieza a importar;
  • para máxima economía, se puede usar una variación con A1 Always Free;
  • para un despliegue más tranquilo, E5/E6 suele ser más cómodo.

Instalación paso a paso.

Las siguientes variables serán necesarias durante el proceso de instalación.

Tenancy id

Es el id de la cuenta en donde será desplegado nuestro agente. Tiene el siguiente formato.

tenancy_ocid   = ocid1.tenancy.oc1....

Podemos encontrar el id de nuestro tenancy haciendo clic en el nombre de nuestra cuenta.

image

Region

Es la región en donde se encontrarán los recursos, cada tenancy o cuenta está asociada con una o más regiones, podemos encontrar el id de nuestra región en este link. A continuación verás algunos ejemplos de regiones.

sa-saopaulo-1
us-chicago-1

Create IAM policy

Indica si la stack debe crear el grupo dinámico y la política IAM necesarios para acceder a OCI Generative AI. Déjalo en true para que la stack cree los permisos necesarios. Tiene el siguiente formato.

true

Compartment id (Opcional pero recomendado)

Es el id del compartment, es decir, la agrupación lógica de nuestros recursos, podemos encontrar el id del compartment en este link. Tiene el siguiente formato.

ocid1.compartment.oc1....

Podemos crear un comaprtment nuevo siguiendo este tutorial

SSH public key (Opcional)

Es la clave pública que se usará para acceder a la VM por SSH. Puedes dejarla vacía para que la stack genere una clave. Tiene el siguiente formato.

ssh-rsa AAAAB3NzaC1yc2E...

System prompt (Opcional)

Es el comportamiento inicial del agente y define cómo debe responder. Tiene el siguiente formato.

Eres un asistente útil que responde de forma sencilla y directa.

Boot volume size in GBs (Opcional)

Es el tamaño en GB del disco de arranque de la VM. El valor predeterminado es 80. Tiene el siguiente formato.

80

Crear el stack

Para la creación del stack, vamos a seguir estos pasos.

1. Navega a Stacks

Desde la consola de Oracle, haz click en el menú en la esquina superior izquierda y navega hasta el panel de stacks.

image

2. Crea un stack

Haz clic en Create Stack.

image

Allí verás tres bloques que completaremos con la siguiente información.

image

(1) Stack information

Elige subir un .zip y adjunta openclaw-hermes-oci-principal-v14.zip. Elige un compartment. Dale un nombre al stack.

Crear stack en Resource Manager

(2) Configure variables

Completa el valor compartment_id con el id del compartment o el id del tenancy.

(3) Review

Marca Run apply al crear la stack o ejecuta un Apply después.

Ejecutar apply en la stack

Y listo!

Ahora solo queda esperar. Normalmente tarda alrededor de 4 a 5 minutos.

Ese tiempo no es solo la VM arrancando. La stack también espera a que:

  • la app termine de instalarse;
  • la URL local responda;
  • el modelo responda OK;
  • la página temporal desaparezca;
  • el servicio final quede activo.
Apply en progreso

El stack debería estar en estado Succeeded.

Apply concluido

Cuando aparezca Succeeded, la experiencia esperada es: abrir el output y usarlo.

Abrir el agente

En la stack, ve a outputs y busca chat_url.

Outputs de la stack con URL final

Si elegiste OpenClaw, la URL viene así:

http://IP_PUBLICO:18789/#token=TOKEN_GENERADO

El token al final es solo para abrir el gateway de OpenClaw. No es una clave de OCI.

Si elegiste Hermes, la URL viene así:

http://IP_PUBLICO:9119

Ábrela en el navegador y empieza a conversar.

¿Y ahora que el agente está listo?

Empieza simple. Trata al agente como alguien que acaba de llegar a tu entorno y puede ayudarte a organizar, investigar y construir cosas.

image

Algunas ideas para los primeros pedidos:

  • "Investiga competidores de mi empresa..."
  • "Mándame todos los días a las 8 h las noticias de IA del día."
  • "Lee los archivos de este proyecto y dime cómo mejorar la documentación."
  • "Ayúdame a conectar este agente a Telegram usando un token."
  • "Activa la conversación por voz, quiero mandarte audio."
  • "Crea una página pública con las métricas de la VM, que tenga consumo de CPU y RAM."

También puedes pedir cosas más abiertas, como:

Quiero transformar este agente en un asistente personal de operaciones.
Respóndeme siempre de esta forma.

O:

Quiero que trabajes conmigo por WhatsApp.
¿Puedes configurarlo tú solo?

Opcional: conectar con Telegram

Telegram no es obligatorio para levantar la stack. La interfaz web ya funciona justo después de Succeeded.

Pero, si quieres conversar desde el celular, un buen siguiente paso es crear un bot en Telegram y pedirle al propio agente que te ayude a conectar ese canal.

Para generar el token:

  1. Abre Telegram.
  2. Busca @BotFather.
  3. Envía /start.
  4. Envía /newbot.
  5. Elige el nombre del bot.
  6. Elige el username del bot.
  7. Copia el token devuelto.
  8. Vuelve al agente y pídele que configure Telegram con ese token.
Crear bot en Telegram con BotFather

Un ejemplo de pedido para hacerle al agente:

Configura un canal de Telegram para este agente.
Mi bot token es: PEGA_AQUI_EL_TOKEN
Dime también cómo probar si está respondiendo correctamente.

Guarda ese token con cuidado. Da acceso a tu bot.

About

Despliega un agente web en OCI con OpenClaw o Hermes, usando OCI Generative AI y una VM dentro de la tenancy.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors