Troubleshooting
Plugin not listed
- Run
openclaw plugins list - Verify package installed in the same runtime environment as OpenClaw
- Restart OpenClaw
Channel fails to start
- Check
channels.simplex.enabled - Validate
connectionvalues (mode,cliPath,wsUrl,wsHost/wsPort) - In managed mode, verify
simplex-chatis executable from PATH
Inbound messages dropped
- Review
dmPolicy,allowFrom,groupPolicy,groupAllowFrom - In pairing mode, approve pending senders
Invite methods failing
- Ensure channel account is configured and enabled
- Verify WS connectivity to SimpleX endpoint
- Check runtime status for last error
Media issues
- Ensure media URLs are reachable by OpenClaw host
- Check configured max media size (
mediaMaxMb) - Confirm MIME/file handling on source side
Useful diagnostic commands
bash
openclaw plugins list
openclaw plugins info simplex