@datanovallc/openclaw-slack-router 0.1.0

package/dist/plugin.js

@@ -0,0 +1,98 @@
+import path from "node:path";
+import { startSlackBot, stopSlackBot } from "./bot.js";
+import { runInit } from "./commands/init.js";
+const plugin = {
+    id: "@datanovallc/openclaw-slack-router",
+    name: "Slack Router",
+    description: "Connect openclaw to Slack with per-channel context isolation. Each Slack channel is an isolated project context — managed via chat.",
+    configSchema: {
+        jsonSchema: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                botToken: {
+                    type: "string",
+                    description: "Slack bot OAuth token (xoxb-...)",
+                },
+                appToken: {
+                    type: "string",
+                    description: "Slack app-level token for Socket Mode (xapp-...)",
+                },
+                mainChannelId: {
+                    type: "string",
+                    description: "Channel ID of the admin channel where you manage project channels via chat",
+                },
+                gatewayUrl: {
+                    type: "string",
+                    description: "openclaw gateway WebSocket URL",
+                    default: "ws://127.0.0.1:18789",
+                },
+                gatewayToken: {
+                    type: "string",
+                    description: "Gateway auth token (if your gateway requires one)",
+                },
+            },
+            required: ["botToken", "appToken"],
+        },
+        uiHints: {
+            botToken: { label: "Bot Token", sensitive: true, placeholder: "xoxb-..." },
+            appToken: {
+                label: "App Token (Socket Mode)",
+                sensitive: true,
+                placeholder: "xapp-...",
+            },
+            mainChannelId: {
+                label: "Main Channel ID",
+                help: "The admin channel where you create and manage project channels by chatting with the bot",
+                placeholder: "C...",
+            },
+            gatewayUrl: {
+                label: "Gateway URL",
+                placeholder: "ws://127.0.0.1:18789",
+            },
+            gatewayToken: {
+                label: "Gateway Token",
+                sensitive: true,
+            },
+        },
+    },
+    register(api) {
+        const pluginCfg = (api.pluginConfig ?? {});
+        api.registerService({
+            id: "openclaw-slack-router",
+            async start(ctx) {
+                const botToken = pluginCfg.botToken;
+                const appToken = pluginCfg.appToken;
+                if (!botToken || !appToken) {
+                    ctx.logger.error("openclaw-slack-router: botToken and appToken are required. " +
+                        "Run `openclaw slack setup` to configure them.");
+                    return;
+                }
+                // Config file lives in the openclaw state directory so it persists across installs
+                const configPath = path.join(ctx.stateDir, "openclaw-slack-router.config.json");
+                await startSlackBot({
+                    botToken,
+                    appToken,
+                    gatewayUrl: pluginCfg.gatewayUrl ??
+                        process.env.OPENCLAW_GATEWAY_URL ??
+                        "ws://127.0.0.1:18789",
+                    gatewayToken: pluginCfg.gatewayToken,
+                    configPath,
+                    logger: ctx.logger,
+                });
+            },
+            stop: stopSlackBot,
+        });
+        api.registerCli((ctx) => {
+            const cmd = ctx.program
+                .command("slack")
+                .description("Slack router plugin commands");
+            cmd
+                .command("setup")
+                .description("Interactive setup wizard — configure tokens and main channel")
+                .action(runInit);
+        }, { commands: ["slack"] });
+    },
+};
+export default plugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,11 @@
+import type { SubagentConfig } from "./types.js";
+export interface RouteResult {
+    agentName: string;
+    text: string;
+}
+export declare class UnknownAgentError extends Error {
+    readonly requestedAgent: string;
+    readonly availableAgents: string[];
+    constructor(requestedAgent: string, availableAgents: string[]);
+}
+export declare function resolveRoute(rawText: string, _botUserId: string, config: SubagentConfig): RouteResult;

package/dist/router.js

@@ -0,0 +1,40 @@
+export class UnknownAgentError extends Error {
+    requestedAgent;
+    availableAgents;
+    constructor(requestedAgent, availableAgents) {
+        super(`Unknown agent "${requestedAgent}". Available agents: ${availableAgents.join(", ")}`);
+        this.requestedAgent = requestedAgent;
+        this.availableAgents = availableAgents;
+        this.name = "UnknownAgentError";
+    }
+}
+// Slack encodes mentions as <@UXXXXXX> — strip any leading mention
+const MENTION_RE = /^<@[A-Z0-9]+>\s*/;
+// /agentname message body
+const SLASH_PREFIX_RE = /^\/(\w+)\s+([\s\S]*)$/;
+// agentname: message body
+const COLON_PREFIX_RE = /^(\w+):\s+([\s\S]*)$/;
+export function resolveRoute(rawText, _botUserId, config) {
+    // Strip bot mention (present in app_mention, absent in DMs — regex is tolerant)
+    const text = rawText.replace(MENTION_RE, "").trim();
+    let agentName = null;
+    let message = text;
+    const slashMatch = text.match(SLASH_PREFIX_RE);
+    if (slashMatch) {
+        agentName = slashMatch[1].toLowerCase();
+        message = slashMatch[2].trim();
+    }
+    else {
+        const colonMatch = text.match(COLON_PREFIX_RE);
+        if (colonMatch) {
+            agentName = colonMatch[1].toLowerCase();
+            message = colonMatch[2].trim();
+        }
+    }
+    const resolvedName = agentName ?? config.defaultAgent;
+    if (!config.agents[resolvedName]) {
+        throw new UnknownAgentError(resolvedName, Object.keys(config.agents));
+    }
+    return { agentName: resolvedName, text: message };
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IACA;IAFlB,YACkB,cAAsB,EACtB,eAAyB;QAEzC,KAAK,CACH,kBAAkB,cAAc,wBAAwB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;QALc,mBAAc,GAAd,cAAc,CAAQ;QACtB,oBAAe,GAAf,eAAe,CAAU;QAKzC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,GAAG,kBAAkB,CAAC;AACtC,0BAA0B;AAC1B,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,0BAA0B;AAC1B,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,UAAkB,EAClB,MAAsB;IAEtB,gFAAgF;IAChF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpD,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,OAAO,GAAG,IAAI,CAAC;IAEnB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC/C,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACxC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,IAAI,MAAM,CAAC,YAAY,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/dist/subagents/index.d.ts

@@ -0,0 +1,7 @@
+import type { SubagentDefinition } from "./types.js";
+export type SubagentRegistry = Record<string, SubagentDefinition>;
+export interface RegistryOptions {
+    gatewayUrl: string;
+    gatewayToken?: string;
+}
+export declare function buildSubagentRegistry(options: RegistryOptions): SubagentRegistry;

package/dist/subagents/index.js

@@ -0,0 +1,10 @@
+import { createOpenclawGatewaySubagent } from "./openclaw-gateway.js";
+export function buildSubagentRegistry(options) {
+    return {
+        default: createOpenclawGatewaySubagent({
+            gatewayUrl: options.gatewayUrl,
+            gatewayToken: options.gatewayToken,
+        }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/subagents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subagents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAStE,MAAM,UAAU,qBAAqB,CAAC,OAAwB;IAC5D,OAAO;QACL,OAAO,EAAE,6BAA6B,CAAC;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/subagents/openclaw-gateway.d.ts

@@ -0,0 +1,7 @@
+import type { SubagentDefinition } from "./types.js";
+export interface OpenclawGatewaySubagentOptions {
+    gatewayUrl: string;
+    gatewayToken?: string;
+    timeoutMs?: number;
+}
+export declare function createOpenclawGatewaySubagent(options: OpenclawGatewaySubagentOptions): SubagentDefinition;

package/dist/subagents/openclaw-gateway.js

@@ -0,0 +1,30 @@
+import { gatewayChatSend } from "../gateway/chat-client.js";
+import { randomUUID } from "node:crypto";
+export function createOpenclawGatewaySubagent(options) {
+    const { gatewayUrl, gatewayToken, timeoutMs } = options;
+    return {
+        name: "openclaw-gateway",
+        description: "Routes messages through the local openclaw gateway",
+        async handle(ctx) {
+            const chatOptions = {
+                url: gatewayUrl,
+                token: gatewayToken,
+                timeoutMs,
+            };
+            const idempotencyKey = randomUUID();
+            try {
+                const result = await gatewayChatSend(chatOptions, {
+                    sessionKey: ctx.channelId,
+                    message: ctx.currentMessage,
+                    idempotencyKey,
+                });
+                return result.text;
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                return `[openclaw-gateway error] ${errorMsg}`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=openclaw-gateway.js.map

package/dist/subagents/openclaw-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-gateway.js","sourceRoot":"","sources":["../../src/subagents/openclaw-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,MAAM,UAAU,6BAA6B,CAC3C,OAAuC;IAEvC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAExD,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oDAAoD;QACjE,KAAK,CAAC,MAAM,CAAC,GAAoB;YAC/B,MAAM,WAAW,GAAuB;gBACtC,GAAG,EAAE,UAAU;gBACf,KAAK,EAAE,YAAY;gBACnB,SAAS;aACV,CAAC;YAEF,MAAM,cAAc,GAAG,UAAU,EAAE,CAAC;YAEpC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE;oBAChD,UAAU,EAAE,GAAG,CAAC,SAAS;oBACzB,OAAO,EAAE,GAAG,CAAC,cAAc;oBAC3B,cAAc;iBACf,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClE,OAAO,4BAA4B,QAAQ,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/subagents/types.d.ts

@@ -0,0 +1,6 @@
+import type { SubagentContext } from "../types.js";
+export interface SubagentDefinition {
+    name: string;
+    description: string;
+    handle(ctx: SubagentContext): Promise<string>;
+}

package/dist/subagents/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/subagents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/subagents/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export interface SubagentEntry {
+    name: string;
+    description: string;
+}
+export interface ChannelEntry {
+    name: string;
+    historyLimit?: number;
+}
+export interface HistoryMessage {
+    role: "user" | "assistant";
+    content: string;
+}
+export interface SubagentContext {
+    channelId: string;
+    userId: string;
+    threadTs: string;
+    currentMessage: string;
+    threadHistory: HistoryMessage[];
+    agentName: string;
+}
+export interface SubagentConfig {
+    botName: string;
+    mainChannelId: string | null;
+    introPosted: boolean;
+    defaultAgent: string;
+    agents: Record<string, SubagentEntry>;
+    channels: Record<string, ChannelEntry>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/openclaw.plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "@datanovallc/openclaw-slack-router",
+  "name": "Slack Router",
+  "description": "Connect openclaw to Slack with per-channel context isolation. Each Slack channel is an isolated project context — managed via chat.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "botToken": { "type": "string" },
+      "appToken": { "type": "string" },
+      "mainChannelId": { "type": "string" },
+      "gatewayUrl": { "type": "string", "default": "ws://127.0.0.1:18789" },
+      "gatewayToken": { "type": "string" }
+    },
+    "required": ["botToken", "appToken"]
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@datanovallc/openclaw-slack-router",
+  "version": "0.1.0",
+  "description": "Slack router plugin for openclaw — connect your agent to Slack with per-channel context isolation",
+  "keywords": [
+    "openclaw",
+    "slack",
+    "agent",
+    "router",
+    "bot"
+  ],
+  "homepage": "https://github.com/andrewtcrooks/openclaw-slack-router#readme",
+  "bugs": {
+    "url": "https://github.com/andrewtcrooks/openclaw-slack-router/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andrewtcrooks/openclaw-slack-router.git"
+  },
+  "license": "MIT",
+  "author": "Andrew T. Crooks",
+  "type": "module",
+  "exports": {
+    ".": "./dist/plugin.js"
+  },
+  "main": "./dist/plugin.js",
+  "bin": {
+    "openclaw-slack-router": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --reporter=verbose",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.2",
+    "@slack/bolt": "^4.6.0",
+    "commander": "^14.0.3",
+    "dotenv": "^16.5.0",
+    "ws": "^8.20.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  }
+}