@decentchat/decentclaw 0.1.0

package/README.md

@@ -0,0 +1,88 @@
+# decent-openclaw
+
+OpenClaw channel plugin for DecentChat.
+
+## Setup
+
+1. Add this plugin path to your OpenClaw config under `plugins.load.paths`.
+2. Configure channel settings under `channels.decentchat`:
+   - `enabled`
+   - `seedPhrase` (required; BIP39 mnemonic)
+   - `signalingServer` (optional; default `https://decentchat.app/peerjs`)
+   - `invites` (optional DecentChat invite URIs)
+3. Enable OpenClaw in the DecentChat settings panel.
+4. Use `/activation` in any channel if you want responses to all messages.
+
+
+## Status
+
+- Thread-aware routing is supported (including `replyToId` fallback).
+- Per-chat-type reply mode overrides are supported via `replyToModeByChatType`.
+- Active implementation plan: `docs/plans/2026-02-28-decent-openclaw-parity-threading.md`.
+
+
+## Config migration (threading parity)
+
+If you are upgrading from pre-parity config, migrate from global-only reply mode to explicit chat-type/thread settings.
+
+Before:
+
+```yaml
+channels:
+  decentchat:
+    enabled: true
+    replyToMode: all
+```
+
+After:
+
+```yaml
+channels:
+  decentchat:
+    enabled: true
+    replyToMode: all
+    replyToModeByChatType:
+      direct: off
+      group: all
+      channel: all
+    thread:
+      historyScope: thread
+      inheritParent: false
+      initialHistoryLimit: 10
+```
+
+## Feature flags and safe defaults
+
+Recommended safe defaults:
+
+- `replyToMode: all`
+- `replyToModeByChatType.direct: off`
+- `thread.historyScope: thread`
+- `thread.initialHistoryLimit: 10`
+
+Fast safety toggles if behavior is noisy:
+
+- Disable thread splitting entirely:
+  - `replyToMode: off`
+- Keep channel-wide session history (no per-thread split):
+  - `thread.historyScope: channel`
+- Disable bootstrap thread-context prefill:
+  - `thread.initialHistoryLimit: 0`
+
+## Rollback checklist
+
+1. Revert to previous known-good commit.
+2. Set conservative config:
+
+```yaml
+channels:
+  decentchat:
+    replyToMode: off
+    thread:
+      historyScope: channel
+      initialHistoryLimit: 0
+```
+
+3. Restart OpenClaw runtime.
+4. Validate route logs and one direct + one group reply path.
+5. Re-enable features gradually (`replyToMode`, then `historyScope`, then `initialHistoryLimit`).

package/index.ts

@@ -0,0 +1,17 @@
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
+import { decentChatPlugin } from './src/channel.js';
+import { setDecentChatRuntime } from './src/runtime.js';
+
+const plugin = {
+  id: 'decentchat',
+  name: 'DecentChat',
+  description: 'DecentChat P2P channel plugin',
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setDecentChatRuntime(api.runtime);
+    api.registerChannel({ plugin: decentChatPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,31 @@
+{
+  "id": "decentchat",
+  "name": "DecentChat",
+  "version": "0.1.0",
+  "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,48 @@
+{
+  "name": "@decentchat/decentclaw",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for DecentChat — P2P encrypted chat",
+  "type": "module",
+  "main": "index.ts",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "decentchat",
+      "label": "DecentChat",
+      "selectionLabel": "DecentChat (P2P)",
+      "docsPath": "/channels/decentchat",
+      "blurb": "P2P encrypted chat via DecentChat."
+    }
+  },
+  "files": [
+    "src",
+    "index.ts",
+    "openclaw.plugin.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Alino/DecentChat.git",
+    "directory": "decent-openclaw"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@decentchat/company-sim": "^0.1.0",
+    "decent-protocol": "^0.1.0",
+    "decent-transport-webrtc": "^0.1.0",
+    "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"
+  }
+}