Guia de Instalação e Inicialização do OpenFang: Do Zero ao Primeiro Agente

Slug: openfang-install-setup-guide Categoria: usage-guides (Guias de Uso) Palavras-chave: Instalação OpenFang, Tutorial de configuração OpenFang, Guia de introdução ao OpenFang Intenção de busca: Informativa (usuário deseja implantar o OpenFang) Contagem de palavras alvo: ~1800 palavras Idioma: pt

O que é o OpenFang?

O OpenFang é um sistema operacional de agentes de nível de produção construído em Rust. Diferente das estruturas de chat de IA tradicionais, o OpenFang oferece um ambiente de tempo de execução de agente completo — inicialização a frio de 180ms, consumo de memória de 40MB, 16 camadas de proteção de segurança e 40 adaptadores de canal. Seja para executar uma tarefa de automação simples localmente ou construir um cluster de agentes autônomos 24/7 multiplataforma, o OpenFang dá conta do recado.

Este artigo levará você do zero à instalação, inicialização e execução do seu primeiro agente OpenFang.

Requisitos do Sistema

Antes de começar a instalação, confirme se o seu sistema atende aos seguintes requisitos mínimos:

A filosofia de design do OpenFang é "leve em primeiro lugar" — até mesmo um Raspberry Pi 4 (versão de 4GB) pode executá-lo sem problemas.

Passo 1: Instalar a cadeia de ferramentas Rust

O OpenFang é escrito em Rust, então primeiro você precisa instalar a cadeia de ferramentas Rust:

# Instalar o Rustup (gerenciador da cadeia de ferramentas Rust)curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh# Recarregar variáveis de ambientesource "$HOME/.cargo/env"# Verificar a instalaçãorustc --versioncargo --version

Se você já tem o Rust instalado, recomendamos atualizar para a versão estável mais recente:

rustup update stable

Passo 2: Instalar o OpenFang

O OpenFang oferece vários métodos de instalação; recomendamos usar o Cargo para uma instalação direta:

# Instalar a versão mais recente via crates.iocargo install openfang# Verificar a instalaçãoopenfang --version

Se você prefere compilar a partir do código-fonte (ideal para usuários avançados que precisam de configurações personalizadas):

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

Usuários de Docker também podem usar a imagem oficial:

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

Passo 3: Inicializar a configuração

Após a instalação, execute o comando de inicialização para criar o arquivo de configuração:

# Criar diretório de configuração padrãoopenfang init# Localização do arquivo de configuração# Linux/macOS: ~/.config/openfang/config.toml# Windows:     %APPDATA%\openfang\config.toml

Após a inicialização, um arquivo config.toml será gerado. Os itens de configuração principais são:

[core]name = "my-first-agent"          # Nome do Agenteworkspace = "./workspace"         # Diretório de trabalholog_level = "info"                # Nível de log: trace, debug, info, warn, error[claude]api_key = "${ANTHROPIC_API_KEY}"  # Lida a partir de variáveis de ambientemodel = "claude-sonnet-5"         # Modelo padrãomax_tokens = 4096[security]sandbox_mode = "strict"           # Modo sandbox: off, basic, strictnetwork_policy = "allowlist"      # Política de redeallowed_domains = ["api.anthropic.com"][channels]# Configure pelo menos um adaptador de canal

Notas sobre configurações importantes:

• api_key: Suporta referência a variáveis de ambiente (formato ${VAR_NAME}); não escreva a chave de API diretamente no arquivo de configuração.
• sandbox_mode: Recomendamos o modo strict para ambientes de produção.
• network_policy: O modo allowlist permite apenas domínios na lista de permissões; o modo blocklist bloqueia domínios na lista negra.
• channels: É necessário pelo menos um adaptador de canal, caso contrário, o Agente não poderá interagir com o mundo exterior.

Passo 4: Configurar a chave de API da Anthropic

O OpenFang depende da API do Claude (via Anthropic), sendo necessária a configuração da chave de API:

# Definir variável de ambienteexport ANTHROPIC_API_KEY="sk-ant-..."# Recomendado adicionar ao seu arquivo de configuração do shellecho 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrcsource ~/.bashrc

Você pode obter sua chave de API no Console da Anthropic.

Passo 5: Selecionar e configurar adaptadores de canal

O OpenFang suporta mais de 40 adaptadores de canal, permitindo que o Agente interaja com usuários através de diferentes plataformas. Abaixo estão alguns dos mais comuns:

Exemplo de configuração de canal para Telegram:

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

Passo 6: Iniciar seu primeiro Agente

Após concluir a configuração, inicie o Agente:

# Inicialização básicaopenfang start# Especificar arquivo de configuraçãoopenfang start --config ./my-config.toml# Executar em segundo planoopenfang start --daemon# Visualizar logs de execuçãoopenfang logs --follow

Após a inicialização bem-sucedida, será exibido:

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

No canal CLI, você pode conversar diretamente com o Agente:

> /help> Verifique a previsão do tempo para hoje> Analise a estrutura de código deste repositório do GitHub

Passo 7: Verificar a instalação

Execute o comando de diagnóstico integrado para confirmar que tudo está funcionando corretamente:

# Verificação de saúdeopenfang doctor# Deve exibir algo como:# ✅ Rust toolchain: 1.80.0# ✅ Config file: valid# ✅ API key: configured# ✅ Network: ok (latency 45ms)# ✅ Workspace: writable# All checks passed.

Perguntas Frequentes

Próximos Passos

Parabéns por concluir a instalação e inicialização do OpenFang! Recomendamos a leitura dos seguintes artigos:

• Guia de Configuração do OpenFang Hands: Aprenda a configurar módulos de capacidade de agente para diferentes propósitos.
• Configuração de Adaptadores Multicanais do OpenFang: Configure vários canais simultaneamente para que seu Agente esteja em todos os lugares.
• Melhores Práticas de Segurança do OpenFang: Proteja seu Agente contra ataques.