@decentchat/decentchat-plugin 0.1.9

package/README.md

@@ -0,0 +1,170 @@
+# @decentchat/decentchat-plugin
+
+OpenClaw channel plugin for [DecentChat](https://github.com/DecentChat/DecentChat) -- peer-to-peer encrypted chat over WebRTC.
+
+Connects your OpenClaw agent to DecentChat workspaces so it can read and reply to messages in channels, groups, DMs, and threads.
+
+## Install
+
+```
+openclaw plugins install @decentchat/decentchat-plugin
+```
+
+## Configure
+
+The quickest way to set up is with the interactive wizard:
+
+```
+openclaw configure
+```
+
+Select **DecentChat** when prompted. The wizard will:
+
+1. Offer to generate a new 12-word seed phrase (or let you paste an existing one)
+2. Ask for a display name
+3. Ask for an invite URL to join a workspace
+
+You can also set the seed phrase via the `DECENTCHAT_SEED_PHRASE` environment variable instead of storing it in the config file.
+
+### Manual configuration
+
+If you prefer to edit the config directly, add a `channels.decentchat` block to your OpenClaw config (`~/.openclaw/openclaw.json` or per-project):
+
+```yaml
+channels:
+  decentchat:
+    enabled: true
+    seedPhrase: "your twelve word BIP39 mnemonic goes here ..."
+```
+
+That's the minimum. The bot will join the DecentChat network using the default signaling server (`https://decentchat.app/peerjs`), respond to all messages, and call itself "DecentChat Bot".
+
+### Optional settings
+
+| Key | Default | What it does |
+|-----|---------|-------------|
+| `signalingServer` | `https://decentchat.app/peerjs` | PeerJS signaling endpoint |
+| `invites` | `[]` | DecentChat invite URIs to auto-join |
+| `alias` | `"DecentChat Bot"` | Display name for the bot |
+| `dataDir` | auto | Override the data directory |
+| `dmPolicy` | `"open"` | DM access: `open`, `pairing`, `allowlist`, or `disabled` |
+| `streamEnabled` | `true` | Stream responses token-by-token |
+| `replyToMode` | `"all"` | Reply behavior: `off`, `first`, or `all` |
+
+### Reply mode per chat type
+
+You can override `replyToMode` for specific chat types:
+
+```yaml
+channels:
+  decentchat:
+    enabled: true
+    seedPhrase: "..."
+    replyToMode: all
+    replyToModeByChatType:
+      direct: "off"
+      group: "all"
+      channel: "all"
+```
+
+### Thread settings
+
+```yaml
+channels:
+  decentchat:
+    thread:
+      historyScope: "thread"     # "thread" or "channel"
+      inheritParent: false
+      initialHistoryLimit: 20
+```
+
+- `historyScope: thread` -- the bot only sees messages in the current thread (not the full channel history)
+- `inheritParent: false` -- don't prepend the parent message to thread context
+- `initialHistoryLimit` -- how many prior thread messages to load for context
+
+### Huddle (voice) settings
+
+```yaml
+channels:
+  decentchat:
+    huddle:
+      enabled: true
+      autoJoin: false
+      sttEngine: "whisper-cpp"    # whisper-cpp | whisper-python | openai | groq
+      whisperModel: "base.en"
+      sttLanguage: "en"
+      ttsVoice: "alloy"
+      vadSilenceMs: 800
+      vadThreshold: 0.5
+```
+
+### Company simulation
+
+The plugin includes a company simulation subsystem (`@decentchat/company-sim`) that lets you run multi-agent teams inside DecentChat workspaces. Configure it per-account:
+
+```yaml
+channels:
+  decentchat:
+    companySim:
+      enabled: true
+      manifestPath: "./company-manifest.yaml"
+      companyId: "acme"
+      employeeId: "bot-1"
+    companySimBootstrap:
+      enabled: true
+      mode: "runtime"
+```
+
+### Multiple accounts
+
+Run multiple bot identities from one OpenClaw instance:
+
+```yaml
+channels:
+  decentchat:
+    defaultAccount: "main"
+    accounts:
+      main:
+        seedPhrase: "first mnemonic ..."
+        alias: "Bot A"
+      secondary:
+        seedPhrase: "second mnemonic ..."
+        alias: "Bot B"
+        dmPolicy: "disabled"
+```
+
+Each account gets its own peer connection and data directory.
+
+## Quick safety toggles
+
+If the bot is too chatty:
+
+```yaml
+# Shut off all replies
+replyToMode: "off"
+
+# Keep replies but use full channel history (no per-thread split)
+thread:
+  historyScope: "channel"
+
+# Disable thread context prefill
+thread:
+  initialHistoryLimit: 0
+```
+
+## How it works
+
+The plugin creates a DecentChat peer (using `@decentchat/protocol` and `@decentchat/transport-webrtc`) that joins the P2P mesh. Incoming messages are routed through OpenClaw's agent pipeline. Responses are sent back to the originating chat, with thread-aware routing so replies land in the right thread.
+
+All traffic is end-to-end encrypted (ECDH + AES-GCM-256). The bot's identity is derived from the seed phrase, same as any other DecentChat client.
+
+## Dependencies
+
+- [@decentchat/protocol](https://npmjs.com/package/@decentchat/protocol) -- DecentChat SDK
+- [@decentchat/transport-webrtc](https://npmjs.com/package/@decentchat/transport-webrtc) -- WebRTC transport layer
+- [@decentchat/company-sim](https://npmjs.com/package/@decentchat/company-sim) -- company simulation subsystem
+- [openclaw](https://openclaw.ai) -- peer dependency (the host runtime)
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,11 @@
+import { defineChannelPluginEntry } from 'openclaw/plugin-sdk/core';
+import { decentChatPlugin } from './src/channel.js';
+import { setDecentChatRuntime } from './src/runtime.js';
+
+export default defineChannelPluginEntry({
+  id: 'decentchat',
+  name: 'DecentChat',
+  description: 'DecentChat P2P channel plugin',
+  plugin: decentChatPlugin,
+  setRuntime: setDecentChatRuntime,
+});

package/openclaw.plugin.json

@@ -0,0 +1,32 @@
+{
+  "id": "decentchat",
+  "kind": "channel",
+  "name": "DecentChat",
+  "version": "0.1.9",
+  "channels": ["decentchat"],
+  "description": "DecentChat P2P channel plugin for OpenClaw — P2P encrypted chat",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": { "type": "boolean", "default": true },
+      "seedPhrase": { "type": "string" },
+      "signalingServer": { "type": "string", "default": "https://decentchat.app/peerjs" },
+      "invites": { "type": "array", "items": { "type": "string" } },
+      "alias": { "type": "string", "default": "DecentChat Bot" },
+      "dataDir": { "type": "string" },
+      "dmPolicy": { "type": "string", "enum": ["open", "pairing", "allowlist", "disabled"], "default": "open" },
+      "channels": { "type": "object" }
+    }
+  },
+  "uiHints": {
+    "enabled": { "label": "Enabled" },
+    "seedPhrase": { "label": "Seed Phrase (12 words)", "sensitive": true },
+    "signalingServer": { "label": "Signaling Server", "placeholder": "https://decentchat.app/peerjs" },
+    "invites": { "label": "Invite URLs" },
+    "alias": { "label": "Bot Display Name", "placeholder": "DecentChat Bot" },
+    "dataDir": { "label": "Data Directory" },
+    "dmPolicy": { "label": "DM Policy" },
+    "channels": { "label": "Channel Rules" }
+  }
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@decentchat/decentchat-plugin",
+  "version": "0.1.9",
+  "description": "OpenClaw channel plugin for DecentChat — P2P encrypted chat",
+  "type": "module",
+  "main": "index.ts",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "channel": {
+      "id": "decentchat",
+      "label": "DecentChat",
+      "selectionLabel": "DecentChat (P2P)",
+      "docsPath": "/channels/decentchat",
+      "blurb": "P2P encrypted chat via DecentChat."
+    },
+    "install": {
+      "npmSpec": "@decentchat/decentchat-plugin"
+    }
+  },
+  "files": [
+    "src",
+    "index.ts",
+    "setup-entry.ts",
+    "openclaw.plugin.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DecentChat/DecentChat.git",
+    "directory": "decent-openclaw"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@decentchat/company-sim": "^0.1.3",
+    "@decentchat/protocol": "^0.1.2",
+    "@decentchat/transport-webrtc": "^0.1.2",
+    "node-datachannel": "^0.32.1",
+    "opusscript": "^0.1.1",
+    "yaml": "^2.8.2",
+    "zod": "^3.24.1"
+  },
+  "peerDependencies": {
+    "openclaw": ">=0.1.0"
+  },
+  "devDependencies": {
+    "playwright": "^1.58.2"
+  }
+}

package/setup-entry.ts

@@ -0,0 +1,4 @@
+import { defineSetupPluginEntry } from 'openclaw/plugin-sdk/core';
+import { decentChatPlugin } from './src/channel.js';
+
+export default defineSetupPluginEntry(decentChatPlugin);