@openclaw/simplex (scaffold)

SimpleX channel extension scaffold for OpenClaw.

Current status

This is a repository scaffold, not a finished channel implementation.

Implemented now:

• package metadata for OpenClaw extension discovery
• channel registration (id: simplex)
• channels.simplex.accounts config schema
• channels.simplex.voiceCalls config schema
• outbound text sending via simplex-chat -e "@<target> <text>"
• inbound call keyword detection with [SimpleX CALL:<author>] prefix
• outbound CALL: prefix support for voice call signaling
• no-op gateway start/stop lifecycle hooks

Not implemented yet:

• inbound polling + event mapping to OpenClaw inbound pipeline
• pairing/allow-from policy wiring
• delivery/read receipts, retries, reconnection
• media and voice support

Configuration

Example channels.simplex.voiceCalls config:

channels:
  simplex:
    accounts:
      default:
        enabled: true
        displayName: "SimpleX"
        dbPrefix: "/home/user/.local/share/simplex"
    voiceCalls:
      enabled: false
      keywords: ["call", "voice", "audio", "video", "ringing"]
      startPrefix: "CALL:"

Voice Calls

Text intent only - this does not relay RTP/audio. Outbound CALL: prefix and inbound call keyword detection are for signaling/text intents only.

Local development

# from repo root
openclaw plugins enable simplex
openclaw plugins list

If plugin loading from workspace path is used in your environment, point OpenClaw to extensions/simplex/index.ts.

Roadmap to publishable plugin

1. Runtime service layer (spawn and supervise simplex-chat)
2. Inbound adapter (parse messages -> normalized OpenClaw message events)
3. Outbound adapter (sendText, then media)
4. Config + secrets UX (channels.simplex.accounts.*)
5. Tests: unit + integration smoke tests with local SimpleX profile
6. Docs page /channels/simplex and ClawHub metadata
7. Versioning and npm publish (@openclaw/simplex)