Guía de instalación e inicialización de OpenFang: De cero a tu primer agente en funcionamiento

Slug: openfang-install-setup-guide Categoría: usage-guides (Guías de uso) Palabras clave objetivo: Instalación de OpenFang, tutorial de configuración de OpenFang, guía de inicio de OpenFang Intención de búsqueda: Informativa (el usuario desea implementar OpenFang) Longitud objetivo: ~1800 palabras Idioma: es

¿Qué es OpenFang?

OpenFang es un sistema operativo para agentes de nivel de producción construido sobre Rust. A diferencia de los marcos de trabajo de chat de IA tradicionales, OpenFang ofrece un entorno de ejecución de agentes completo: arranque en frío de 180 ms, consumo de memoria de 40 MB, 16 capas de seguridad y 40 adaptadores de canales. Ya sea que desees ejecutar una tarea de automatización simple localmente o construir un clúster de agentes autónomos 24/7 multiplataforma, OpenFang es capaz de hacerlo.

Este artículo te llevará desde cero a completar la instalación, inicialización y ejecución de tu primer agente en OpenFang.

Requisitos del sistema

Antes de comenzar la instalación, asegúrate de que tu sistema cumpla con los siguientes requisitos mínimos:

La filosofía de diseño de OpenFang es "la ligereza primero": incluso una Raspberry Pi 4 (versión de 4GB) puede ejecutarlo sin problemas.

Paso 1: Instalar la cadena de herramientas Rust

OpenFang está escrito en Rust, por lo que primero debes instalar la cadena de herramientas de Rust:

# Instalar Rustup (gestor de la cadena de herramientas Rust)curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# Recargar variables de entornosource "$HOME/.cargo/env"# Verificar la instalaciónrustc --versioncargo --version

Si ya tienes instalado Rust, se recomienda actualizar a la última versión estable:

rustup update stable

Paso 2: Instalar OpenFang

OpenFang ofrece varios métodos de instalación; se recomienda usar Cargo para una instalación directa:

# Instalar la última versión desde crates.iocargo install openfang# Verificar la instalaciónopenfang --version

Si prefieres compilar desde el código fuente (adecuado para usuarios avanzados que necesitan configuraciones personalizadas):

git clone https://github.com/openfang/openfang.gitcd openfangcargo build --release./target/release/openfang --version

Los usuarios de Docker también pueden usar la imagen oficial:

docker pull openfang/openfang:latestdocker run -d --name openfang -v ./config:/app/config openfang/openfang

Paso 3: Inicializar la configuración

Una vez completada la instalación, ejecuta el comando de inicialización para crear el archivo de configuración:

# Crear directorio de configuración predeterminadoopenfang init# Ubicación del archivo de configuración# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

Tras la inicialización, se generará un archivo config.toml. Las opciones de configuración principales son:

[core]name = "my-first-agent"          # Nombre del agenteworkspace = "./workspace"         # Directorio de trabajolog_level = "info"                # Nivel de registro: trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # Leer desde variables de entornomodel = "claude-sonnet-5"         # Modelo predeterminadomax_tokens = 4096[security]sandbox_mode = "strict"           # Modo sandbox: off, basic, strictnetwork_policy = "allowlist"      # Política de redallowed_domains = ["api.anthropic.com"][channels]# Configura al menos un adaptador de canal

Notas sobre la configuración clave:

• api_key: Admite referencias a variables de entorno (formato ${VAR_NAME}); no escribas la API key directamente en el archivo de configuración.
• sandbox_mode: Se recomienda el modo strict para entornos de producción.
• network_policy: El modo allowlist solo permite el acceso a dominios en la lista blanca; el modo blocklist bloquea los dominios en la lista negra.
• channels: Se requiere al menos un adaptador de canal, de lo contrario el agente no podrá interactuar con el exterior.

Paso 4: Configurar la API Key de Anthropic

OpenFang depende de la API de Claude (a través de Anthropic), por lo que necesitas configurar tu API key:

# Establecer variable de entornoexport ANTHROPIC_API_KEY="sk-ant-..."# Se recomienda añadirla al archivo de configuración de tu shellecho 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

Puedes obtener tu API key desde la Consola de Anthropic.

Paso 5: Seleccionar y configurar adaptadores de canales

OpenFang admite más de 40 adaptadores de canales, lo que permite que el agente interactúe con los usuarios a través de diferentes plataformas. Estos son algunos de los más utilizados:

Ejemplo de configuración de canal para Telegram:

[channels.telegram]enabled = truebot_token = "${TELEGRAM_BOT_TOKEN}"allowed_users = ["@your_username"]

Paso 6: Iniciar tu primer agente

Una vez configurado, inicia el agente:

# Inicio básicoopenfang start# Especificar archivo de configuraciónopenfang start --config ./my-config.toml# Ejecutar en segundo planoopenfang start --daemon# Ver registros de ejecuciónopenfang logs --follow

Tras un inicio exitoso, verás:

⚡ OpenFang v1.0.0├─ Agent: my-first-agent├─ Model: claude-sonnet-5├─ Sandbox: strict├─ Channels: cli└─ Ready. Type /help for commands.

En el canal CLI, puedes hablar directamente con el agente:

> /help> Ayúdame a consultar el clima de hoy> Analiza la estructura de código de este repositorio de GitHub

Paso 7: Verificar la instalación

Ejecuta el comando de diagnóstico integrado para confirmar que todo funciona correctamente:

# Comprobación de saludopenfang doctor# Debería mostrar algo como:# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

Preguntas frecuentes

Siguientes pasos

¡Felicidades por completar la instalación e inicialización de OpenFang! A continuación, te recomendamos leer:

• Guía de configuración de OpenFang Hands: Aprende a configurar módulos de capacidades para diferentes usos del agente.
• Configuración de adaptadores multicanal de OpenFang: Configura múltiples canales simultáneamente para que tu agente esté en todas partes.
• Mejores prácticas de seguridad en OpenFang: Protege a tus agentes contra ataques.