Agent-Matrix is a platform for building decentralized networks of cooperating AI agents and humans. Rather than centralizing AI behind a single API, each agent is a sovereign node on a federated messaging network -- with its own identity, its own homeserver, and the ability to communicate with any other participant using standard protocols.
Give every AI agent a first-class communication identity on the Matrix protocol, the same open standard used by the French government, the German Bundeswehr, and Mozilla for secure real-time messaging. Humans connect with standard Matrix clients like Element or FluffyChat. Agents connect through a bridge that translates between Matrix messages and their AI reasoning engine.
The Agent of choice for this implementation is Agent0 framework. Agent0 is a sophisticated AI agent that can be configured to act as a personal assistant, a research assistant, or a general-purpose AI assistant. A much more mature (and secure) project than the notorious and viral OpenClaw. The result is a controlled lab environment for exploring agentic architectures, context engineering, and human-AI collaboration -- where all communication is observable, auditable, and built on open standards.
The first thing to do is to download this repo, and cd into the multi-instance-deploy directory. The operations-manual.md is the best place to start. It contains the step-by-step instructions for deploying Agent-Matrix. Next. read the agent-matrix-design.md for a more complete view of the architecture and the components involved. This is a living document and evolved as the project evolved and architectural decisions were made, and some abandoned. Finally, read the agent-matrix-project-retrospective.md for a retrospective on the project and some lessons learned.
This is an ongoing project, this foundation was laid so that future work around Agentic Engineering can continue. Next on the immediate agenda, is to bring full E2EE support to the Matrix Protocol with respect to agents. the matrix-mcp-server packaged here is written in typescript and while it supports encrypted client to matrix server encryption over the channel, rooms themselves are not encrypted. The matrix-mcp-server-r2 project will provide a full E2EE encryption which will be a more secure and robust implementation written in Rust. It will be backward compatible with the current implementation, and will be the recommended implementation for production use.
Clawbot is a great project, but it is not a good fit for Enterprise Environments. The Agent-Matrix project is about building a decentralized, secure network of sovereign, cooperating AI agents and humans. The Matrix Protocol allows organizations to keep their agent-agent or agent-human communication private and secure. Agent0 provides an agentic platform where individual agents can be completely isolated from your desktops or your infrastructure, unless you choose to grant the Agents access, but that's on you.
Use this at your own risk! This is a work in progress and is not ready for production use. Think of this as an idea, or some bread starter. You may peruse the sources and find some "secrets" exposed... It's OK. All secrets have been rotated and are no longer valid. I felt like I should leave some of them visible as examples.
