Matrix Agents
Multi-agent coordination via self-hosted Matrix/Synapse. Run multiple OpenClaw instances that communicate in real-time with zero cloud dependencies.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add matrix-agents npx -- -y @trustedskills/matrix-agents
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"matrix-agents": {
"command": "npx",
"args": [
"-y",
"@trustedskills/matrix-agents"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
Matrix Agents enables the coordination of multiple AI agents across different machines using a self-hosted Matrix server. This setup avoids reliance on external services and API limits, allowing for scalable agent communication within your own infrastructure. The system utilizes a bridge script to translate Matrix messages into events that trigger agent actions via OpenClaw.
When to use it
- Scalable Agent Coordination: When you need multiple AI agents working together beyond the limitations of cloud-based platforms.
- Privacy and Control: If you require full control over your agent communication data and want to avoid sending it through third-party services.
- Federated Environments: For scenarios where agents need to communicate across different, self-managed networks.
- High Volume Communication: When dealing with a large volume of messages between agents that would exceed API rate limits on external platforms.
Key capabilities
- Self-hosted Matrix server (Synapse) via Docker.
- End-to-end encryption support.
- No imposed message rate limits.
- Bridge script for translating Matrix messages to OpenClaw wake events.
- Easy setup with provided scripts (
setup.sh,create-user.sh, etc.).
Example prompts
- "Run
./create-user.sh agent3 MySecretPasswordto create a new agent user." - "Start the Matrix bridge on machine A using:
python3 bridge.py --user @agent1:home.local --password SecurePass123 --room '!<room_id>:home.local'. "
Tips & gotchas
- Requires Docker to be installed for running Synapse.
- Ensure OpenClaw is accessible at the specified URL in the bridge configuration (
--openclaw-url).
Requirements
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Installing this skill downloads the exact code at commit 7c2ba65f, not the current state of the repository. This prevents supply-chain attacks from unauthorized updates.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.
Install command fetches the verified snapshot, not the live repository.