# OpenClaw SimpleX

> SimpleX channel plugin for OpenClaw.

## Docs

- [Architecture](https://openclaw-simplex.mintlify.app/guide/architecture.md): Understand the runtime boundaries between OpenClaw, the SimpleX channel plugin, and the external simplex-chat process including their responsibilities.
- [Getting Started](https://openclaw-simplex.mintlify.app/guide/getting-started.md): Install simplex-chat, configure the OpenClaw SimpleX plugin, generate your first invite link, and pair your first contact with the agent step by step.
- [How It Works](https://openclaw-simplex.mintlify.app/guide/how-it-works.md): Trace the full message lifecycle from an incoming SimpleX contact through the plugin WebSocket bridge, OpenClaw policy checks, and agent response delivery.
- [Migration to openclaw-simplex](https://openclaw-simplex.mintlify.app/guide/migration.md): Migrate from the legacy simplex plugin and channel identifiers to the renamed openclaw-simplex format introduced in version 1.0.0 with step-by-step commands.
- [Runtime Setup](https://openclaw-simplex.mintlify.app/guide/runtime-setup.md): Configure simplex-chat as a persistent systemd or launchd service, set the WebSocket endpoint, and connect multiple SimpleX accounts to OpenClaw.
- [Security Model](https://openclaw-simplex.mintlify.app/guide/security-model.md): Learn how invite-link access control, OpenClaw pairing and allowlist policies, and simplex-chat runtime trust boundaries work together to secure the channel.
- [Troubleshooting](https://openclaw-simplex.mintlify.app/guide/troubleshooting.md): Diagnose and fix common OpenClaw SimpleX problems including WebSocket connection failures, plugin trust errors, policy rejections, and pairing issues.
- [Why SimpleX](https://openclaw-simplex.mintlify.app/guide/why-simplex.md): Discover why SimpleX gives OpenClaw a private, invitation-first messaging channel that needs no phone number, bot username, or hosted platform account.
- [Configuration](https://openclaw-simplex.mintlify.app/reference/config.md): Complete reference for every OpenClaw SimpleX channel configuration field including connection settings, DM and group policies, and multi-account setup.
- [Example Commands](https://openclaw-simplex.mintlify.app/reference/example-commands.md): Copy-paste CLI commands for common OpenClaw SimpleX tasks like generating invite links, approving contacts, listing paired users, and managing addresses.
- [Gateway Methods](https://openclaw-simplex.mintlify.app/reference/gateway-methods.md): API reference for the OpenClaw SimpleX gateway RPC methods used to create invite links, generate address QR codes, and automate onboarding programmatically.
- [Screenshots](https://openclaw-simplex.mintlify.app/reference/screenshots.md): Step-by-step screenshots showing the full SimpleX pairing flow from generating an invite link through contact approval and the first agent conversation.

## OpenAPI Specs

- [openapi](https://openclaw-simplex.mintlify.app/api-reference/openapi.json)