Repolode
Enviar
thatsme

thatsme/AlexClaw

Agente pessoal de IA para um único usuário, desenvolvido com Elixir/OTP, que monitora fontes, executa fluxos agendados e conversa pelo Telegram ou Discord, em hospedagem própria.

Ver no GitHub
Estrelas
118
Forks
9
Issues abertas
0
Último commit
há 13 dias

O que é?

AlexClaw é um agente pessoal de IA para um único operador, desenvolvido com Elixir e OTP e pensado para rodar na infraestrutura do próprio operador. Ele monitora feeds RSS, páginas da web, repositórios do GitHub e APIs, consulta bancos de dados PostgreSQL por meio de consultas fixas somente para leitura, armazena o que coleta em uma base de conhecimento e executa fluxos de várias etapas em horários programados. O proprietário interage com ele pelo Telegram ou Discord.

Cada tarefa é encaminhada a um roteador de LLM que escolhe o provedor configurado mais barato que atenda ao nível de raciocínio exigido pela tarefa; também há suporte a modelos locais, como Ollama e LM Studio. A memória semântica usa PostgreSQL com pgvector e busca híbrida vetorial e por palavras-chave. As credenciais ficam armazenadas em uma instância integrada do OpenBao, não no banco de dados, e ações privilegiadas exigem um código de autenticação de dois fatores TOTP na interface de administração.

O projeto inclui um mecanismo de fluxos de trabalho com ramificações e exportação/importação, um ciclo de raciocínio de planejar-executar-avaliar, disjuntores por skill, carregamento dinâmico de skills com declarações de permissões e um servidor MCP em /mcp para acesso de leitura e execução de fluxos. Há um Docker Compose disponível para implantação.

Recursos principais

  • 01Encaminha cada tarefa de LLM ao provedor configurado mais barato que atenda ao nível de raciocínio exigido, incluindo modelos locais.
  • 02Fluxos de trabalho com várias etapas, ramificações condicionais, histórico de execução e exportação/importação em JSON.
  • 03Monitora feeds RSS, páginas da web, repositórios do GitHub, APIs e consultas somente para leitura no PostgreSQL.
  • 04Memória semântica e base de conhecimento com PostgreSQL, pgvector e busca híbrida.
  • 05Gateways do Telegram e Discord que respondem apenas ao proprietário configurado.
  • 06Credenciais armazenadas em uma instância integrada do OpenBao, com alterações administrativas protegidas por 2FA TOTP.

Casos de uso

  • Executar um fluxo diário agendado que coleta feeds, avalia a relevância e envia um resumo pelo Telegram.
  • Fazer perguntas a um assistente pessoal pelo chat, com memória de conversas e documentos anteriores.
  • Manter um agente de LLM totalmente local com Ollama, evitando chamadas a APIs de terceiros.
  • Automatizar backups agendados do PostgreSQL, com rotação em um diretório montado no host.

Antes de usar

  • É exclusivo para um único usuário: tem um operador e não oferece controle de acesso para vários usuários.
  • A licença não está claramente identificada (os metadados informam NOASSERTION), então verifique a licença do repositório antes de usar.
  • Depende do PostgreSQL com pgvector e do OpenBao incluído, portanto a hospedagem própria exige algum trabalho de configuração.

Tópicos

#personal-agent#elixir#otp#llm#telegram-bot-ai-assistant#self-hosted#pgvector#workflow-automation#2fa#ai-agent

Perguntas frequentes

O que é AlexClaw?
Agente pessoal de IA para um único usuário, desenvolvido com Elixir/OTP, que monitora fontes, executa fluxos agendados e conversa pelo Telegram ou Discord, em hospedagem própria. AlexClaw é um agente pessoal de IA para um único operador, desenvolvido com Elixir e OTP e pensado para rodar na infraestrutura do próprio operador. Ele monitora feeds RSS, páginas da web, repositórios do GitHub e APIs, consulta bancos de dados PostgreSQL por meio de consultas fixas somente para leitura, armazena o que coleta em uma base de conhecimento e executa fluxos de várias etapas em horários programados. O proprietário interage com ele pelo Telegram ou Discord.
AlexClaw é gratuito? Qual é a licença?
AlexClaw é open source sob a licença Other. Confira os termos da licença antes de usá-lo em produtos comerciais.
AlexClaw ainda é mantido?
Manutenção ativa. O último commit de AlexClaw foi em 9 de out. de 2026.
Para que posso usar AlexClaw?
Executar um fluxo diário agendado que coleta feeds, avalia a relevância e envia um resumo pelo Telegram. Fazer perguntas a um assistente pessoal pelo chat, com memória de conversas e documentos anteriores. Manter um agente de LLM totalmente local com Ollama, evitando chamadas a APIs de terceiros. Automatizar backups agendados do PostgreSQL, com rotação em um diretório montado no host.
Onde consigo AlexClaw?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/thatsme/AlexClaw

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados