RAGClaw: Uma Plataforma de Agentes Compartilhados para Implantação Privada

A maioria das histórias de "IA para minha equipe" termina em um de dois lugares:

• Um produto SaaS. Funciona muito bem, até que alguém cole os dados financeiros do Q3 em um prompt e você perceba que os dados agora estão nos servidores de outra pessoa.
• Um hack de fim de semana. langchain + um banco de dados vetorial no seu laptop. Demonstração legal, zero autenticação, sem sandbox, e boa sorte para integrar as outras nove pessoas da sua equipe.

RAGClaw é o caminho do meio que geralmente está faltando: uma plataforma de agente compartilhada que você implementa privadamente, em uma máquina, por trás da sua própria autenticação, com as barreiras (isolamento de sandbox, gerenciamento de chaves, controles administrativos) que uma organização real precisa, não aquelas que um protótipo consegue escapar.

Uma plataforma de agente compartilhada para implantação privada em pequenas e médias organizações.

Neste post, vou mostrar o que é, as cinco características que a tornam interessante, como a arquitetura se sustenta sob escrutínio e como fazê-la funcionar em cerca de cinco minutos.

Por que o RAGClaw existe

Três características o definem:

• Facilidade de uso. Com o Docker instalado, um único script menu implementa toda a plataforma em uma máquina. Sem Kubernetes, sem conta na nuvem.
• Segurança. Dados e chaves permanecem totalmente privados. As chaves da API são gerenciadas centralmente e criptografadas em repouso; elas nunca ficam em disco em texto simples e nunca vazam para o frontend.
• Controlabilidade. O acesso ao LLM, SKILLs, servidores MCP e a política de rede do sandbox são todos governados por um superadministrador. A fronteira de capacidade é definida pela sua organização, não pelos padrões de um fornecedor.

Esse último ponto é importante. Em uma equipe real, você não quer que cada usuário faça chamadas de rede de saída arbitrárias ou instale qualquer habilidade que encontraram. O RAGClaw coloca um administrador no controle do raio de explosão.

As cinco características que merecem sua atenção

1. Gerenciamento de contexto detalhado

Conversas longas são onde a maioria dos chatbots RAG falha. O contexto transborda, o modelo "esquece" o que você disse 20 mensagens atrás, e a latência do primeiro token (TTFT) aumenta.

O RAGClaw ataca isso de três ângulos:

• Compactação em múltiplos níveis. Um resumo contínuo alimenta uma cadeia de arquivo RAG, para que mais de uma conversa longa permaneça recuperável em vez de ser descartada.
• Compactação assíncrona. A sumarização acontece fora do caminho crítico, então nunca bloqueia a geração de respostas. Menor TTFT, sem pausas estranhas.
• Recuperação de memória híbrida. O contexto lembrado é recuperado via recuperação híbrida vetorial + BM25, e você ainda pode editar ou excluir manualmente qualquer memória. Você permanece no controle.

2. Um sandbox de execução endurecido ("a Garra")

Esta é a parte que eu gostaria de ver em uma revisão de segurança. A execução do código do agente não roda no seu processo de aplicativo ou no host. Ela roda em um contêiner mcp-repl em uma rede interna exclusiva:

• Isolamento de UID por usuário. Cada execução reduz privilégios para um user_u<uid> não privilegiado via setuid, com diretórios de trabalho chown.
• Egress de rede mediado. O sandbox não tem rota direta para a internet. Cada conexão de saída é forçada através do ragclaw-egress, que aplica a política que você escolher: deny (padrão: tudo bloqueado), allowlist (apenas domínios configurados) ou allow (apenas para depuração). O sandbox nunca está silenciosamente online.
• Dureza do contêiner. read_only rootfs, tmpfs /tmp, no-new-privileges, um seccomp.json personalizado bloqueando syscalls perigosos, cap_drop: ALL (apenas SETUID/SETGID/CHOWN re-adicionados para isolamento), além de limites de memória e PID. Nenhuma porta do host é publicada. O servidor MCP é exclusivo para uso interno.

Em resumo, você pode finalmente deixar o agente "agir" sem segurar a respiração.

3. Um espaço de trabalho compartilhado e co-gerenciado

A maioria dos agentes lhe entrega um link para download e chama isso de dia. O RAGClaw lhe dá um espaço de trabalho real, um navegador de arquivos que parece o seu gerenciador de arquivos do sistema operacional, e é o mesmo espaço de trabalho que o agente escreve.

• Navegação em breadcrumbs, visualizações em lista e grade (cartão), filtros de tipo e oito opções de classificação.
• Pesquisa de nome de arquivo recursiva que alcança subpastas.
• Criar pastas, upload por arrastar e soltar com um pool concorrente (progresso por arquivo, pausar/retomar/cancelar), baixar como um único ZIP, renomear, mover, excluir em lote.

Como é respaldado pelo mesmo volume que o sandbox usa, o que você coloca lá está instantaneamente disponível para o agente, e o que o agente gera aparece na sua pasta, pronto para ser pego, ajustado ou enviado. Sem dança de exportação e importação.

4. Um sistema de SKILL compartilhado que é eficiente e seguro

As habilidades (pacotes de capacidade de terceiros) são carregadas como pastas inteiras ou zips a partir da página de administração, para que tudo chegue de uma vez.

Dois detalhes tornam isso amigável para produção:

• Um adaptador configurável .ragclaw/ aumenta a eficiência da invocação de scripts enquanto deixa a fonte de terceiros intacta. Você não precisa bifurcar a habilidade para fazê-la funcionar, você se adapta a ela.
• Habilidades que precisam de uma chave da API passam por