@zbruceli/openclaw-dchat 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zheng "Bruce" Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# openclaw-dchat
+
+OpenClaw channel plugin for **D-Chat / nMobile** — decentralized end-to-end encrypted messaging over the [NKN](https://nkn.org) relay network.
+
+## Features
+
+- Direct messages (DM) with NKN addresses
+- Topic-based group chat (NKN pub/sub)
+- Private group messaging
+- IPFS media placeholders (image, audio, file)
+- Delivery receipts
+- AES-128-GCM encryption (nMobile wire format compatible)
+- Multi-account support
+- DM policy enforcement (pairing, allowlist, open, disabled)
+
+## Installation
+
+```bash
+openclaw plugins install @zbruceli/openclaw-dchat
+```
+
+## Configuration
+
+After installing, add the D-Chat channel:
+
+```bash
+openclaw channels add dchat
+```
+
+The onboarding wizard will prompt you for:
+
+1. **NKN wallet seed** — a 64-character hex string. Generate one with `nkn-sdk` or use an existing seed from D-Chat Desktop / nMobile.
+2. **DM policy** — controls who can send you direct messages:
+   - `pairing` (default) — new senders must be approved via pairing code
+   - `allowlist` — only explicitly allowed NKN addresses
+   - `open` — accept DMs from anyone
+   - `disabled` — no DMs
+
+You can also configure via environment variables:
+
+```bash
+export DCHAT_SEED="your-64-char-hex-wallet-seed"
+```
+
+Or set directly in your OpenClaw config:
+
+```yaml
+channels:
+  dchat:
+    enabled: true
+    seed: "your-64-char-hex-wallet-seed"
+    dm:
+      policy: pairing
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Watch mode
+npm run test:watch
+```
+
+## How it works
+
+The plugin connects to the NKN relay network as a MultiClient node, enabling peer-to-peer messaging without centralized servers. Messages use the same wire format as D-Chat Desktop and nMobile, so you can chat between OpenClaw and any D-Chat/nMobile client.
+
+## License
+
+MIT

package/index.ts

@@ -0,0 +1,17 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { dchatPlugin } from "./src/channel.js";
+import { setDchatRuntime } from "./src/runtime.js";
+
+const plugin = {
+  id: "dchat",
+  name: "D-Chat / nMobile",
+  description: "D-Chat/nMobile channel plugin (NKN relay network)",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setDchatRuntime(api.runtime);
+    api.registerChannel({ plugin: dchatPlugin });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "dchat",
+  "channels": ["dchat"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@zbruceli/openclaw-dchat",
+  "version": "0.1.0",
+  "description": "OpenClaw D-Chat/nMobile channel plugin — decentralized E2E encrypted messaging over the NKN relay network",
+  "type": "module",
+  "main": "index.ts",
+  "dependencies": {
+    "nkn-sdk": "^1.3.6",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "devDependencies": {
+    "openclaw": "*",
+    "vitest": "^3.0.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "dchat",
+      "label": "D-Chat / nMobile",
+      "selectionLabel": "D-Chat (plugin)",
+      "docsPath": "/channels/dchat",
+      "docsLabel": "dchat",
+      "blurb": "decentralized E2E encrypted messaging over the NKN relay network.",
+      "order": 80,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@zbruceli/openclaw-dchat"
+    }
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "dchat",
+    "nmobile",
+    "nkn",
+    "decentralized",
+    "e2e",
+    "encrypted",
+    "messaging"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zbruceli/openclaw-dchat.git"
+  },
+  "homepage": "https://github.com/zbruceli/openclaw-dchat"
+}