matrix-fix

What This Skill Does

The matrix-fix skill is an essential diagnostic and maintenance utility designed for OpenClaw users running Matrix channels. It acts as a comprehensive toolkit to resolve common communication failures, environment misconfigurations, and authentication errors that frequently plague Matrix integrations. By centralizing repair procedures, this skill automates the remediation of missing encryption modules, handles token expiry issues, assists in DNS troubleshooting, and guides users through complete channel resets. It serves as a bridge between the OpenClaw gateway and the Matrix homeserver, ensuring that your bot remains consistently reachable and fully functional.

Installation

To install this skill, use the following command in your terminal:

clawhub install openclaw/skills/skills/boms/matrix-fix

Ensure that you have the appropriate permissions to modify the OpenClaw installation directory, as some repair operations require elevated system access to perform node module re-builds or configuration updates.

Use Cases

This skill is designed for scenarios where the Matrix integration fails to synchronize or initialize correctly. Common use cases include:

• Resolving 'E2EE disabled' errors caused by missing Node.js crypto binaries.
• Recovering from 'M_UNKNOWN_TOKEN' errors after a long period of inactivity or server-side password changes.
• Troubleshooting connection timeouts caused by DNS resolution failures between the OpenClaw gateway and your specific homeserver.
• Resetting the configuration entirely when moving to a new homeserver or changing bot credentials.
• Batch-leaving noisy or problematic rooms when the bot has joined too many chats.

Example Prompts

1. "OpenClaw, my Matrix channel is throwing an E2EE initialization error, please help me fix the crypto modules."
2. "I'm getting M_UNKNOWN_TOKEN errors, can you help me reset my authentication token and restart the gateway?"
3. "My Matrix bot is acting up; please run a full diagnostic probe and show me the recent logs related to the channel."

Tips & Limitations

• Permissions: Always verify that you are running the matrix-fix commands from the correct root directory (/usr/local/lib/node_modules/openclaw) for operations involving module reinstallation.
• Diagnostics: Always utilize the openclaw channels status --probe command before attempting a reset; it provides granular data about connectivity that can save you time.
• Security: When resetting tokens or reconfiguring passwords, ensure you are working within a secure environment. Avoid logging your cleartext password in shell history.
• Scope: This skill is focused specifically on the Matrix protocol. If you are experiencing network-wide outages across all channels, this may be an OpenClaw system-level issue rather than a specific Matrix channel error.