Repolode
Submit
thatsme

thatsme/AlexClaw

A single-user personal AI agent built on Elixir/OTP that monitors sources, runs scheduled workflows and chats over Telegram or Discord, self-hosted.

View on GitHub
Stars
118
Forks
9
Open issues
0
Last commit
13 days ago

What is it?

AlexClaw is a personal AI agent for one operator, built on Elixir and OTP and meant to run on the operator's own infrastructure. It watches RSS feeds, web pages, GitHub repositories and APIs, reads PostgreSQL databases through fixed read-only queries, stores what it collects in a knowledge base, and runs multi-step workflows on a schedule. The owner interacts with it over Telegram or Discord.

Each task is routed through an LLM router that picks the cheapest configured provider meeting the task's reasoning tier, with local models such as Ollama and LM Studio supported. Semantic memory uses PostgreSQL with pgvector and hybrid vector plus keyword search. Credentials are stored in a bundled OpenBao instance rather than the database, and privileged actions require a TOTP two-factor code in the admin UI.

The project includes a workflow engine with branching and export/import, a plan-execute-evaluate reasoning loop, per-skill circuit breakers, dynamic skill loading with permission declarations, and an MCP server at /mcp for read access and workflow runs. Docker Compose is provided for deployment.

Key features

  • 01Routes each LLM task to the cheapest configured provider that meets its reasoning tier, including local models.
  • 02Multi-step workflows with conditional branching, run history, and JSON export/import.
  • 03Monitors RSS feeds, web pages, GitHub repositories, APIs and read-only PostgreSQL queries.
  • 04Semantic memory and knowledge base using PostgreSQL with pgvector and hybrid search.
  • 05Telegram and Discord gateways that answer only the configured owner.
  • 06Credentials stored in a bundled OpenBao, with TOTP 2FA guarding admin changes.

Use cases

  • Running a daily scheduled workflow that collects feeds, scores relevance and sends a digest to Telegram.
  • Asking a personal assistant questions over chat with memory of past conversations and documents.
  • Keeping an LLM agent fully local with Ollama while avoiding third-party API calls.
  • Automating scheduled PostgreSQL backups with rotation to a host-mounted directory.

Things to know

  • Single-user only: it has one operator and no multi-user access control.
  • The license is not clearly identified (metadata reports NOASSERTION), so check the repository's license before use.
  • It depends on PostgreSQL with pgvector and a bundled OpenBao, so self-hosting takes setup effort.

Topics

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

FAQ

What is AlexClaw?
A single-user personal AI agent built on Elixir/OTP that monitors sources, runs scheduled workflows and chats over Telegram or Discord, self-hosted. AlexClaw is a personal AI agent for one operator, built on Elixir and OTP and meant to run on the operator's own infrastructure. It watches RSS feeds, web pages, GitHub repositories and APIs, reads PostgreSQL databases through fixed read-only queries, stores what it collects in a knowledge base, and runs multi-step workflows on a schedule. The owner interacts with it over Telegram or Discord.
Is AlexClaw free to use? What license does it have?
AlexClaw is open source under the Other license. Check the license terms before using it in commercial products.
Is AlexClaw still maintained?
Actively maintained. The last commit to AlexClaw was on Oct 9, 2026.
What can I use AlexClaw for?
Running a daily scheduled workflow that collects feeds, scores relevance and sends a digest to Telegram. Asking a personal assistant questions over chat with memory of past conversations and documents. Keeping an LLM agent fully local with Ollama while avoiding third-party API calls. Automating scheduled PostgreSQL backups with rotation to a host-mounted directory.
Where can I get AlexClaw?
The source code and installation instructions are on GitHub: https://github.com/thatsme/AlexClaw

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects