port42-openclaw 0.3.2 → 0.4.0

package/IMPLEMENTATION_PLAN.md

@@ -0,0 +1,265 @@
+# port42-openclaw v0.4.0 Implementation Plan
+
+## Problem
+
+The current plugin doesn't conform to OpenClaw's channel adapter API. It uses a custom `PluginAPI` interface with `registerChannel(name, handler)` when OpenClaw expects `api.registerChannel({ plugin: channelObject })` with a structured channel descriptor. This causes:
+
+- `unknown channel id: port42` — OpenClaw doesn't know port42 is a valid channel
+- `plugin not found: port42-openclaw` — manifest missing `configSchema`, plugin can't load
+
+## Key Findings from OpenClaw Docs
+
+1. **Inbound messages** are handled via `gateway.registerHandlers` and `gateway.handleIncomingMessage` on the `ChannelGatewayAdapter`. The gateway context provides runtime helpers for routing messages to agents.
+2. **Lifecycle** is managed by the gateway adapter. OpenClaw calls `registerHandlers` on startup, which is where we open the WebSocket connection.
+3. **CLI**: Plugins register top-level commands via `api.registerCli()` using commander.js. We can't add flags to `channels add`, but we can register our own `port42` command (e.g. `openclaw port42 join --invite "..."`).
+4. **Package.json** should use `"openclaw": { "plugin": "./openclaw.plugin.json" }` (not `"extensions"`). The extensions array format is for bundled multi-extension packs.
+
+## Files Changed
+
+### 1. `src/index.ts` — Complete rewrite
+
+Replace the current named `register()` export with a `default` export function that registers a proper `ChannelPlugin` object.
+
+**Channel descriptor shape:**
+
+```ts
+const port42Channel = {
+  id: "port42",
+  meta: {
+    id: "port42",
+    label: "Port42",
+    selectionLabel: "Port42 (Companion Computing)",
+    docsPath: "/channels/port42",
+    blurb: "Bring agents into Port42 companion computing channels.",
+    aliases: ["p42"],
+  },
+  capabilities: { chatTypes: ["direct", "group"] },
+  config: { listAccountIds, resolveAccount, isConfigured, describeAccount },
+  outbound: { deliveryMode: "direct", textChunkLimit: 4096, sendText },
+  gateway: { registerHandlers, handleIncomingMessage },
+};
+```
+
+**Config adapter** reads from `cfg.channels.port42.accounts.*`:
+
+```ts
+config: {
+  listAccountIds: (cfg) => Object.keys(cfg.channels?.port42?.accounts ?? {}),
+  resolveAccount: (cfg, accountId) => {
+    const section = cfg.channels?.port42?.accounts?.[accountId ?? "default"];
+    return {
+      accountId: accountId ?? "default",
+      invite: section?.invite,
+      gateway: section?.gateway,
+      channelId: section?.channelId,
+      encryptionKey: section?.encryptionKey,
+      token: section?.token,
+      displayName: section?.displayName ?? "Port42 Agent",
+      trigger: section?.trigger ?? "mention",
+      enabled: section?.enabled ?? true,
+    };
+  },
+  isConfigured: (account) => Boolean(account.invite || (account.gateway && account.channelId)),
+  describeAccount: (account) => ({
+    accountId: account.accountId,
+    name: account.displayName,
+    enabled: account.enabled ?? true,
+    configured: Boolean(account.invite || (account.gateway && account.channelId)),
+  }),
+},
+```
+
+**Outbound adapter** sends messages through cached `Port42Connection` instances:
+
+```ts
+outbound: {
+  deliveryMode: "direct",
+  textChunkLimit: 4096,
+  sendText: async (ctx) => {
+    const account = port42Channel.config.resolveAccount(ctx.cfg, ctx.accountId);
+    const conn = connections.get(account.accountId);
+    if (!conn) return { ok: false, error: new Error("Not connected") };
+    conn.sendResponse(ctx.text);
+    return { ok: true, timestamp: Date.now() };
+  },
+},
+```
+
+**Gateway adapter** connects all configured accounts on startup and routes inbound messages:
+
+```ts
+gateway: {
+  registerHandlers: (ctx) => {
+    const accountIds = port42Channel.config.listAccountIds(ctx.cfg);
+    for (const id of accountIds) {
+      const account = port42Channel.config.resolveAccount(ctx.cfg, id);
+      if (!account.enabled || !port42Channel.config.isConfigured(account)) continue;
+
+      const conn = connectAccount(account, (senderName, content, messageId) => {
+        ctx.handleIncomingMessage?.({
+          channelId: "port42",
+          accountId: id,
+          senderId: `port42:${senderName}`,
+          senderName,
+          content,
+          messageId,
+          chatType: "group",
+        });
+      });
+      connections.set(id, conn);
+    }
+  },
+  handleIncomingMessage: async () => {
+    // Handled via registerHandlers callback
+  },
+},
+```
+
+**CLI command** for joining channels from the command line:
+
+```ts
+api.registerCli(
+  ({ program }) => {
+    const p42 = program.command("port42").description("Port42 companion computing");
+    p42.command("join")
+      .description("Join a Port42 channel with an invite link")
+      .requiredOption("--invite <url>", "Port42 invite link")
+      .option("--name <name>", "Display name for your agent", "OpenClaw Agent")
+      .option("--account <id>", "Account identifier", "default")
+      .option("--trigger <mode>", "Respond to 'mention' or 'all'", "mention")
+      .action(async (opts) => {
+        console.log(`Adding Port42 channel account "${opts.account}"...`);
+        console.log(`\nAdd this to your openclaw.json under channels.port42.accounts.${opts.account}:`);
+        console.log(JSON.stringify({
+          invite: opts.invite,
+          displayName: opts.name,
+          trigger: opts.trigger,
+        }, null, 2));
+      });
+  },
+  { commands: ["port42"] },
+);
+```
+
+### 2. `openclaw.plugin.json` — Rewrite
+
+Add required `configSchema` (JSON Schema) and `channels` declaration:
+
+```json
+{
+  "id": "port42-openclaw",
+  "name": "Port42",
+  "description": "Bring your OpenClaw agents into Port42 companion computing channels.",
+  "channels": ["port42"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "accounts": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "invite": { "type": "string", "description": "Port42 HTTPS invite link" },
+            "gateway": { "type": "string", "description": "WebSocket URL" },
+            "channelId": { "type": "string", "description": "Channel UUID" },
+            "encryptionKey": { "type": "string", "description": "Base64 AES-256 key" },
+            "token": { "type": "string", "description": "Gateway auth token" },
+            "displayName": { "type": "string", "description": "Agent display name in Port42" },
+            "trigger": { "type": "string", "enum": ["mention", "all"], "default": "mention" },
+            "enabled": { "type": "boolean", "default": true }
+          },
+          "required": ["displayName"]
+        }
+      }
+    }
+  },
+  "uiHints": {
+    "accounts.*.invite": { "label": "Invite Link", "help": "Paste a Port42 channel invite link" },
+    "accounts.*.encryptionKey": { "sensitive": true },
+    "accounts.*.token": { "sensitive": true }
+  }
+}
+```
+
+### 3. `package.json` — Two changes
+
+```diff
+- "version": "0.3.2"
++ "version": "0.4.0"
+
+- "openclaw": { "extensions": ["./dist/index.js"] }
++ "openclaw": { "plugin": "./openclaw.plugin.json" }
+```
+
+### 4. `.npmignore` — New file
+
+```
+src/
+tsconfig.json
+.github/
+```
+
+Prevents shipping `.ts` source files that trigger OpenClaw's validator warnings.
+
+## Unchanged Files
+
+| File | Why |
+|------|-----|
+| `src/connection.ts` | WebSocket lifecycle, reconnection, encryption all work correctly |
+| `src/protocol.ts` | Envelope types and builders match Port42 gateway protocol |
+| `src/crypto.ts` | AES-256-GCM matches Port42's wire format |
+| `src/invite.ts` | Invite link parsing works correctly |
+
+## User Experience After v0.4.0
+
+### Install
+
+```bash
+openclaw plugins install port42-openclaw
+```
+
+### Join a channel (CLI)
+
+```bash
+openclaw port42 join \
+  --invite "https://host.ngrok-free.dev/invite?id=UUID&name=ch&key=KEY&token=TOKEN" \
+  --name "Researcher"
+```
+
+### Or edit openclaw.json directly
+
+```json
+{
+  "channels": {
+    "port42": {
+      "accounts": {
+        "default": {
+          "invite": "https://host.ngrok-free.dev/invite?id=UUID&name=ch&key=KEY&token=TOKEN",
+          "displayName": "Researcher",
+          "trigger": "mention"
+        }
+      }
+    }
+  }
+}
+```
+
+### Then restart the gateway
+
+```bash
+openclaw gateway restart
+```
+
+## Open Risk
+
+The `gateway.registerHandlers` context object (`ctx.handleIncomingMessage`) is based on patterns from the docs but not confirmed with an exact example for custom plugins. If the context API differs, the inbound routing may need adjustment. The outbound, CLI, and manifest parts are well documented and solid.
+
+## Sources
+
+- [Channel Plugin Development Guide](https://zread.ai/openclaw/openclaw/16-channel-plugin-development)
+- [Plugins - OpenClaw](https://docs.openclaw.ai/tools/plugin)
+- [Plugin Manifest](https://docs.openclaw.ai/plugins/manifest)
+- [Channel Message Flow](https://deepwiki.com/openclaw/openclaw/8.3-telegram-integration)
+- [Channels CLI](https://docs.openclaw.ai/cli/channels)

package/README.md

@@ -6,38 +6,76 @@ Port42 channel adapter for OpenClaw. Bring your OpenClaw agents into [Port42](ht
 
 ```bash
 openclaw plugins install port42-openclaw
+openclaw gateway restart
 ```
 
-## Usage
+To explicitly trust the plugin (silences the auto-load warning), add to your `openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "allow": ["port42-openclaw"]
+  }
+}
+```
+
+### Install from source
+
+```bash
+git clone https://github.com/gordonmattey/port42-openclaw.git
+cd port42-openclaw
+npm install
+npm run build
+openclaw plugins install .
+openclaw gateway restart
+```
 
-Someone shares a Port42 channel invite link with you. Add it to OpenClaw:
+### Uninstall
 
 ```bash
-openclaw channel add port42 \
-  --invite "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY&token=GATEWAY_TOKEN" \
-  --agent my-researcher \
-  --name "Researcher"
+openclaw plugins uninstall port42-openclaw
+openclaw gateway restart
 ```
 
-Your agent appears in the Port42 channel. People can @mention it and it responds alongside other companions in the room.
+## Usage
 
-### Manual config
+Someone shares a Port42 channel invite link with you. Join from the CLI:
+
+```bash
+openclaw port42 join --invite "INVITE_LINK" --agent my-researcher
+openclaw agents bind --agent my-researcher --bind port42:my-researcher
+openclaw gateway restart
+```
+
+The agent ID is used as the display name in Port42.
 
 Or edit `openclaw.json` directly:
 
 ```json
 {
   "channels": {
-    "port42-project": {
-      "type": "port42",
-      "invite": "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY&token=GATEWAY_TOKEN",
-      "displayName": "Researcher",
-      "trigger": "mention"
+    "port42": {
+      "accounts": {
+        "my-researcher": {
+          "invite": "https://your-host.ngrok-free.dev/invite?id=CHANNEL-UUID&name=my-channel&key=BASE64KEY&token=GATEWAY_TOKEN&host=gordon",
+          "displayName": "my-researcher",
+          "trigger": "mention"
+        }
+      }
     }
   }
 }
 ```
 
+Then bind and restart:
+
+```bash
+openclaw agents bind --agent my-researcher --bind port42:my-researcher
+openclaw gateway restart
+```
+
+Your agent appears in the Port42 channel. People can @mention it and it responds alongside other companions in the room.
+
 ### Config options
 
 | Option | Required | Default | Description |
@@ -49,6 +87,7 @@ Or edit `openclaw.json` directly:
 | `token` | no | — | Gateway auth token (parsed from invite if provided) |
 | `displayName` | yes | — | How the agent appears in Port42 |
 | `trigger` | no | `mention` | `mention` (respond to @name) or `all` (respond to everything) |
+| `enabled` | no | `true` | Enable or disable this account |
 
 *Provide either `invite` or both `gateway` + `channelId`.
 
@@ -61,15 +100,6 @@ The adapter connects to a Port42 gateway as a regular peer over WebSocket. From
 - Typing indicators show when the agent is generating a response
 - Auto-reconnects if the connection drops
 
-## Building from source
-
-```bash
-git clone https://github.com/gordonmattey/port42-openclaw.git
-cd port42-openclaw
-npm install
-npm run build
-```
-
 ## License
 
 MIT. See [LICENSE](LICENSE).

package/dev.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# Build, deploy to local OpenClaw, and restart gateway
+set -e
+
+echo "Building..."
+npm run build
+
+echo "Copying to extensions..."
+cp dist/* ~/.openclaw/extensions/port42-openclaw/dist/
+
+echo "Restarting gateway..."
+npx openclaw gateway restart
+
+echo "Done. Checking logs in 3s..."
+sleep 3
+tail -20 ~/.openclaw/logs/gateway.log | grep -E '\[port42\]|error|Error' || echo "No port42 log lines found"

package/dist/connection.js

@@ -40,6 +40,7 @@ class Port42Connection {
             const payload = {
                 content,
                 senderName: this.config.displayName,
+                senderType: "agent",
                 senderOwner: null,
                 replyToId: null,
             };

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/dist/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../src/crypto.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AASH,0BAYC;AAED,0BAqBC;AA1CD,6CAA4E;AAG5E,MAAM,SAAS,GAAG,aAAa,CAAC;AAChC,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,SAAgB,OAAO,CAAC,OAAgB,EAAE,SAAiB;IACzD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAA,yBAAW,EAAC,YAAY,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAA,4BAAc,EAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEhC,2BAA2B;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,OAAO,CAAC,IAAY,EAAE,SAAiB;IACrD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAEzC,IAAI,IAAI,CAAC,MAAM,GAAG,YAAY,GAAG,UAAU,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAG,IAAA,8BAAgB,EAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;QACzD,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAEzB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -3,36 +3,9 @@
  *
  * Bridges OpenClaw agents into Port42 companion computing channels.
  * Users install with: openclaw plugins install port42-openclaw
- * Then add a channel with a Port42 invite link.
+ * Then join with: openclaw port42 join --invite "..."
  */
-export interface Port42ChannelConfig {
-    invite?: string;
-    gateway?: string;
-    channelId?: string;
-    encryptionKey?: string;
-    token?: string;
-    displayName: string;
-    trigger?: 'mention' | 'all';
-}
-interface PluginAPI {
-    registerChannel(name: string, handler: ChannelHandler): void;
-    log: {
-        info(msg: string): void;
-        error(msg: string): void;
-        debug(msg: string): void;
-    };
-}
-interface ChannelHandler {
-    connect(config: Port42ChannelConfig): Promise<ChannelInstance>;
-}
-interface ChannelInstance {
-    send(content: string): Promise<void>;
-    disconnect(): Promise<void>;
-}
-/**
- * OpenClaw plugin entry point.
- */
-export declare function register(api: PluginAPI): void;
+export default function (api: any): void;
 export { parseInviteLink } from './invite';
 export { Port42Connection } from './connection';
 export type { ConnectionConfig } from './connection';