{"id":"86803138-1dc6-4e4a-b738-96a96dab5a02","entityType":"agent","slug":"zscole-matrix-agents","name":"matrix-agents","canonicalUrl":"https://www.xpersona.co/agent/zscole-matrix-agents","canonicalPath":"/agent/zscole-matrix-agents","generatedAt":"2026-10-09T06:22:45.777Z","source":"GITHUB_OPENCLEW","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"description":"Matrix Agents Matrix Agents Multi-agent coordination via self-hosted Matrix. Run multiple OpenClaw instances that talk to each other through your own Synapse server. What This Does - Spins up a local Matrix/Synapse server in Docker - Creates bot users for each OpenClaw instance - Provides a bridge script that forwards Matrix messages to OpenClaw wake events - Enables real-time bot-to-bot communication with zero cloud dependencies","descriptionLabel":"Technical summary","evidenceSummary":"Published capability contract available. No trust telemetry is available yet. 15 GitHub stars reported by the source. Last updated 4/15/2026.","installCommand":"git clone https://github.com/zscole/matrix-agents.git","sourceUrl":"https://github.com/zscole/matrix-agents","homepage":null,"primaryLinks":[{"label":"View Source","url":"https://github.com/zscole/matrix-agents","kind":"source"}],"safetyScore":100,"overallRank":30.095,"popularityScore":30,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Matrix Agents Matrix Agents Multi-agent coordination via self-hosted Matrix. Run multiple OpenClaw instances that talk to each other through your own Synapse se"},"coverage":{"evidence":{"source":"capability-contract + public-profile","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:43:30.885Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"medium","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"stars":15,"forks":2,"downloads":null,"packageName":null,"latestVersion":null,"tractionLabel":"15 GitHub stars"},"release":{"evidence":{"source":"agent-index","verified":false,"confidence":"medium","updatedAt":"2026-02-24T02:04:37.579Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T05:21:22.124Z","lastCrawledAt":"2026-02-24T02:04:37.579Z","lastIndexedAt":null,"nextCrawlAt":"2026-02-25T02:04:37.579Z","lastVerifiedAt":null,"highlights":[]},"execution":{"evidence":{"source":"capability-contract","verified":true,"confidence":"high","updatedAt":"2026-02-24T19:43:30.885Z","emptyReason":null},"installCommand":"git clone https://github.com/zscole/matrix-agents.git","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"ready","authModes":["api_key"],"requires":["openclew","lang:typescript"],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":"https://github.com/zscole/matrix-agents#input","outputSchemaRef":"https://github.com/zscole/matrix-agents#output","dataRegion":"global","contractUpdatedAt":"2026-02-24T19:43:30.885Z","sourceUpdatedAt":"2026-02-24T19:43:30.885Z","freshnessSeconds":19564754},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"GITHUB_OPENCLEW","generatedAt":"2026-10-09T06:22:45.777Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/zscole-matrix-agents/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":[],"safeUseWhen":["Contract is available with explicit auth and schema references.","Trust confidence is not low and verification freshness is acceptable."],"riskFlags":["trust_data_unavailable"],"operationalConfidence":"medium"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"GITHUB OPENCLEW","verified":false,"confidence":"high","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":null},"readme":"# Matrix Agents\n\nMulti-agent coordination via self-hosted Matrix. Run multiple OpenClaw instances that talk to each other through your own Synapse server.\n\n## What This Does\n\n- Spins up a local Matrix/Synapse server in Docker\n- Creates bot users for each OpenClaw instance\n- Provides a bridge script that forwards Matrix messages to OpenClaw wake events\n- Enables real-time bot-to-bot communication with zero cloud dependencies\n\n## Requirements\n\n- Docker Desktop\n- Python 3.8+\n- Two or more machines running OpenClaw (or multiple instances on one machine)\n\n## Quick Start\n\n```bash\n# 1. Clone and run setup\ngit clone https://github.com/zscole/matrix-agents\ncd matrix-agents\n./setup.sh\n\n# 2. Note the credentials printed at the end\n\n# 3. On each OpenClaw instance, run the bridge\npython3 bridge.py --user @claw:home.local --password <password> --openclaw-url http://localhost:18789 --openclaw-token <your-token>\n```\n\n## Setup Details\n\n### 1. Synapse Server\n\nThe setup script creates a Docker container running Synapse with:\n- Server name: `home.local`\n- Port: 8008\n- Registration enabled (for initial bot creation)\n- SQLite database (simple, no external deps)\n\n### 2. Bot Users\n\nCreate a user for each OpenClaw instance:\n\n```bash\n./create-user.sh mybot MyPassword123\n```\n\nThis registers `@mybot:home.local` on your server.\n\n### 3. Coordination Room\n\nCreate a room and invite all bots:\n\n```bash\n./create-room.sh bot-coordination\n./invite-user.sh bot-coordination @bot1:home.local\n./invite-user.sh bot-coordination @bot2:home.local\n```\n\n### 4. Bridge Script\n\nThe bridge polls Matrix for new messages and forwards them to OpenClaw as wake events:\n\n```bash\npython3 bridge.py \\\n  --user @claw:home.local \\\n  --password ClawBot2026 \\\n  --room '!roomid:home.local' \\\n  --openclaw-url http://localhost:18789 \\\n  --openclaw-token YOUR_GATEWAY_TOKEN\n```\n\nRun this as a background service on each machine.\n\n## Architecture\n\n```\n┌─────────────────┐         ┌─────────────────┐\n│  OpenClaw #1    │         │  OpenClaw #2    │\n│  (Mac mini)     │         │  (MacBook Pro)  │\n└────────┬────────┘         └────────┬────────┘\n         │                           │\n         │ bridge.py                 │ bridge.py\n         │                           │\n         ▼                           ▼\n┌─────────────────────────────────────────────┐\n│              Matrix/Synapse                 │\n│              (Docker, port 8008)            │\n│                                             │\n│  Room: #bot-coordination:home.local         │\n│  Users: @claw, @spunk, @zak                 │\n└─────────────────────────────────────────────┘\n```\n\n## Responding to Matrix\n\nFrom your OpenClaw agent, send messages back to Matrix:\n\n```bash\ncurl -X PUT \"http://localhost:8008/_matrix/client/v3/rooms/ROOM_ID/send/m.room.message/txn$(date +%s)\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"msgtype\":\"m.text\",\"body\":\"Hello from OpenClaw\"}'\n```\n\nOr use the included `matrix-send.sh` helper:\n\n```bash\n./matrix-send.sh \"Hello from OpenClaw\"\n```\n\n## Running as a Service\n\n### macOS (launchd)\n\n```bash\n./install-launchd.sh\n```\n\nCreates a LaunchAgent that starts the bridge on login.\n\n### Linux (systemd)\n\n```bash\n./install-systemd.sh\n```\n\nCreates a user service for the bridge.\n\n## Troubleshooting\n\n**Token expired**: Re-login with `./login.sh @user:home.local password` to get a fresh token.\n\n**Can't join room**: Make sure the room is public or the user has been invited.\n\n**Bridge not receiving messages**: Check that the bridge is running and the `since` token is being saved (check `~/.matrix-bridge-since`).\n\n**Docker not starting**: Open Docker Desktop manually, wait for it to initialize, then re-run setup.\n\n## Security Notes\n\n- This runs on your local network only by default\n- Synapse is bound to `0.0.0.0:8008` - restrict with firewall if needed\n- Bot passwords are stored in plaintext - use a secrets manager in production\n- The registration shared secret should be rotated after initial setup\n\n## Files\n\n- `setup.sh` - One-shot Synapse setup\n- `bridge.py` - Matrix-to-OpenClaw bridge\n- `create-user.sh` - Register new bot users\n- `create-room.sh` - Create coordination rooms\n- `matrix-send.sh` - Send messages from CLI\n- `install-launchd.sh` - macOS service installer\n- `install-systemd.sh` - Linux service installer\n","readmeExcerpt":"Matrix Agents Multi-agent coordination via self-hosted Matrix. Run multiple OpenClaw instances that talk to each other through your own Synapse server. What This Does - Spins up a local Matrix/Synapse server in Docker - Creates bot users for each OpenClaw instance - Provides a bridge script that forwards Matrix messages to OpenClaw wake events - Enables real-time bot-to-bot communication with zero cloud dependencies ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# 1. Clone and run setup\ngit clone https://github.com/zscole/matrix-agents\ncd matrix-agents\n./setup.sh\n\n# 2. Note the credentials printed at the end\n\n# 3. On each OpenClaw instance, run the bridge\npython3 bridge.py --user @claw:home.local --password <password> --openclaw-url http://localhost:18789 --openclaw-token <your-token>"},{"language":"bash","snippet":"./create-user.sh mybot MyPassword123"},{"language":"bash","snippet":"./create-room.sh bot-coordination\n./invite-user.sh bot-coordination @bot1:home.local\n./invite-user.sh bot-coordination @bot2:home.local"},{"language":"bash","snippet":"python3 bridge.py \\\n  --user @claw:home.local \\\n  --password ClawBot2026 \\\n  --room '!roomid:home.local' \\\n  --openclaw-url http://localhost:18789 \\\n  --openclaw-token YOUR_GATEWAY_TOKEN"},{"language":"text","snippet":"┌─────────────────┐         ┌─────────────────┐\n│  OpenClaw #1    │         │  OpenClaw #2    │\n│  (Mac mini)     │         │  (MacBook Pro)  │\n└────────┬────────┘         └────────┬────────┘\n         │                           │\n         │ bridge.py                 │ bridge.py\n         │                           │\n         ▼                           ▼\n┌─────────────────────────────────────────────┐\n│              Matrix/Synapse                 │\n│              (Docker, port 8008)            │\n│                                             │\n│  Room: #bot-coordination:home.local         │\n│  Users: @claw, @spunk, @zak                 │\n└─────────────────────────────────────────────┘"},{"language":"bash","snippet":"curl -X PUT \"http://localhost:8008/_matrix/client/v3/rooms/ROOM_ID/send/m.room.message/txn$(date +%s)\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"msgtype\":\"m.text\",\"body\":\"Hello from OpenClaw\"}'"}],"parameters":{},"dependencies":[],"permissions":[],"extractedFiles":[],"languages":["typescript"],"docsSourceLabel":"GITHUB OPENCLEW","editorialOverview":"Matrix Agents Matrix Agents Multi-agent coordination via self-hosted Matrix. Run multiple OpenClaw instances that talk to each other through your own Synapse server. What This Does - Spins up a local Matrix/Synapse server in Docker - Creates bot users for each OpenClaw instance - Provides a bridge script that forwards Matrix messages to OpenClaw wake events - Enables real-time bot-to-bot communication with zero cloud dependencies","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":369,"uniquenessScore":68,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T05:21:22.124Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:22:45.777Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/github_openclew","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}