@clawhouse/openclaw-plugin 0.1.0

package/dist/channel.d.ts

@@ -0,0 +1,3 @@
+import type { ChannelPlugin } from './types';
+export declare const clawHousePlugin: ChannelPlugin;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,SAAS,CAAC;AAOjB,eAAO,MAAM,eAAe,EAAE,aA8J7B,CAAC"}

package/dist/channel.js

@@ -0,0 +1,148 @@
+import { ClawHouseClient } from './client';
+import { startClawHouseConnection } from './gateway';
+import { getClawHouseRuntime } from './runtime';
+function getChannelConfig(cfg) {
+    const c = cfg;
+    return c?.channels?.clawhouse ?? null;
+}
+export const clawHousePlugin = {
+    id: 'clawhouse',
+    meta: {
+        name: 'ClawHouse',
+        description: '1:1 messaging channel for ClawHouse bots',
+    },
+    capabilities: {
+        text: true,
+        media: false,
+        reactions: false,
+        threads: true,
+        editing: false,
+    },
+    config: {
+        listAccountIds(cfg) {
+            const ch = getChannelConfig(cfg);
+            if (!ch)
+                return [];
+            if (ch.accounts && Object.keys(ch.accounts).length > 0) {
+                return Object.keys(ch.accounts);
+            }
+            return ['default'];
+        },
+        resolveAccount(cfg, accountId) {
+            const ch = getChannelConfig(cfg);
+            if (!ch) {
+                return {
+                    accountId: accountId ?? 'default',
+                    botToken: '',
+                    apiUrl: '',
+                    wsUrl: '',
+                    enabled: false,
+                };
+            }
+            const id = accountId ?? 'default';
+            const acct = id !== 'default' && ch.accounts?.[id] ? ch.accounts[id] : ch;
+            return {
+                accountId: id,
+                botToken: acct.botToken ?? '',
+                apiUrl: acct.apiUrl ?? '',
+                wsUrl: acct.wsUrl ?? '',
+                enabled: acct.enabled !== false,
+            };
+        },
+        isConfigured(account) {
+            return Boolean(account.botToken && account.apiUrl);
+        },
+        isEnabled(account) {
+            return account.enabled;
+        },
+        describeAccount(account) {
+            return {
+                running: false,
+                lastStartAt: undefined,
+                lastStopAt: undefined,
+                lastError: undefined,
+            };
+        },
+    },
+    outbound: {
+        deliveryMode: 'direct',
+        chunkerMode: 'markdown',
+        textChunkLimit: 2000,
+        async sendText(ctx) {
+            const runtime = getClawHouseRuntime();
+            const cfg = runtime.config.loadConfig();
+            const ch = getChannelConfig(cfg);
+            if (!ch) {
+                return { channel: 'clawhouse', success: false };
+            }
+            const acct = clawHousePlugin.config.resolveAccount(cfg, ctx.accountId);
+            const client = new ClawHouseClient(acct.botToken, acct.apiUrl);
+            try {
+                await client.sendMessage({
+                    userId: ctx.to,
+                    content: ctx.text,
+                    taskId: ctx.threadId ? String(ctx.threadId) : undefined,
+                });
+                return {
+                    channel: 'clawhouse',
+                    success: true,
+                    threadId: ctx.threadId ? String(ctx.threadId) : undefined,
+                };
+            }
+            catch {
+                return { channel: 'clawhouse', success: false };
+            }
+        },
+    },
+    gateway: {
+        async startAccount(ctx) {
+            return startClawHouseConnection(ctx);
+        },
+    },
+    setup: {
+        applyAccountConfig(params) {
+            const { cfg, accountId, input } = params;
+            const config = cfg;
+            const channels = (config.channels ?? {});
+            const clawhouse = (channels.clawhouse ?? {});
+            if (accountId === 'default') {
+                clawhouse.botToken = input.botToken;
+                clawhouse.apiUrl = input.apiUrl;
+                clawhouse.wsUrl = input.wsUrl;
+                clawhouse.enabled = true;
+            }
+            else {
+                const accounts = (clawhouse.accounts ?? {});
+                accounts[accountId] = {
+                    botToken: input.botToken,
+                    apiUrl: input.apiUrl,
+                    wsUrl: input.wsUrl,
+                    enabled: true,
+                };
+                clawhouse.accounts = accounts;
+            }
+            channels.clawhouse = clawhouse;
+            config.channels = channels;
+            return config;
+        },
+        validateInput(params) {
+            const { input } = params;
+            if (!input.botToken?.startsWith('bot_')) {
+                return 'Bot token must start with "bot_"';
+            }
+            if (!input.apiUrl) {
+                return 'API URL is required';
+            }
+            if (!input.wsUrl) {
+                return 'WebSocket URL is required';
+            }
+            return null;
+        },
+    },
+    security: {
+        resolveDmPolicy() {
+            return { policy: 'open' };
+        },
+    },
+};
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+import type { MessagesResponse, WsTicketResponse } from './types';
+/**
+ * HTTP client for the ClawHouse bot API.
+ * All endpoints use tRPC via HTTP POST/GET.
+ */
+export declare class ClawHouseClient {
+    private botToken;
+    private apiUrl;
+    constructor(botToken: string, apiUrl: string);
+    private request;
+    sendMessage(input: {
+        userId: string;
+        content: string;
+        taskId?: string;
+    }): Promise<unknown>;
+    listMessages(input: {
+        userId?: string;
+        cursor?: string | null;
+        limit?: number;
+    }): Promise<MessagesResponse>;
+    getWsTicket(): Promise<WsTicketResponse>;
+    comment(input: {
+        taskId: string;
+        content: string;
+    }): Promise<unknown>;
+    createTask(input: {
+        projectId: string;
+        title: string;
+        instructions?: string;
+    }): Promise<unknown>;
+    listTasks(input: {
+        projectId: string;
+        status?: string;
+    }): Promise<unknown[]>;
+    done(input: {
+        taskId: string;
+        reason: string;
+        deliverable?: string;
+    }): Promise<unknown>;
+    giveup(input: {
+        taskId: string;
+        reason: string;
+        deliverable?: string;
+    }): Promise<unknown>;
+    getNextTask(input?: {
+        projectId?: string;
+    }): Promise<unknown>;
+    listProjects(): Promise<unknown[]>;
+    createProject(input: {
+        name: string;
+        key: string;
+        description?: string;
+        color?: string;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAElE;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;YAK9B,OAAO;IA+Bf,WAAW,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,CAAC;IAId,YAAY,CAAC,KAAK,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKvB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAKxC,OAAO,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,UAAU,CAAC,KAAK,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,OAAO,CAAC;IAId,SAAS,CAAC,KAAK,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIhB,IAAI,CAAC,KAAK,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC;IAId,MAAM,CAAC,KAAK,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,OAAO,CAAC;IAId,WAAW,CAAC,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIlC,aAAa,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrB"}

package/dist/client.js

@@ -0,0 +1,68 @@
+/**
+ * HTTP client for the ClawHouse bot API.
+ * All endpoints use tRPC via HTTP POST/GET.
+ */
+export class ClawHouseClient {
+    botToken;
+    apiUrl;
+    constructor(botToken, apiUrl) {
+        this.botToken = botToken;
+        this.apiUrl = apiUrl.replace(/\/$/, '');
+    }
+    async request(method, procedure, input) {
+        const url = method === 'GET' && input
+            ? `${this.apiUrl}/${procedure}?input=${encodeURIComponent(JSON.stringify(input))}`
+            : `${this.apiUrl}/${procedure}`;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                Authorization: `Bot ${this.botToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: method === 'POST' ? JSON.stringify(input) : undefined,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => 'unknown error');
+            throw new Error(`ClawHouse API error: ${response.status} ${response.statusText} — ${text}`);
+        }
+        const json = (await response.json());
+        return json.result?.data;
+    }
+    // Messages
+    async sendMessage(input) {
+        return this.request('POST', 'messages.send', input);
+    }
+    async listMessages(input) {
+        return this.request('GET', 'messages.list', input);
+    }
+    // WebSocket ticket
+    async getWsTicket() {
+        return this.request('POST', 'messages.wsTicket', {});
+    }
+    // Tasks
+    async comment(input) {
+        return this.request('POST', 'tasks.comment', input);
+    }
+    async createTask(input) {
+        return this.request('POST', 'tasks.create', input);
+    }
+    async listTasks(input) {
+        return this.request('GET', 'tasks.list', input);
+    }
+    async done(input) {
+        return this.request('POST', 'tasks.done', input);
+    }
+    async giveup(input) {
+        return this.request('POST', 'tasks.giveup', input);
+    }
+    async getNextTask(input) {
+        return this.request('GET', 'tasks.getNextTask', input ?? {});
+    }
+    async listProjects() {
+        return this.request('GET', 'projects.list', {});
+    }
+    async createProject(input) {
+        return this.request('POST', 'projects.create', input);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/deliver.d.ts

@@ -0,0 +1,9 @@
+import type { ChannelGatewayContext, ChatMessage } from './types';
+/**
+ * Delivers a ClawHouse chat message to the OpenClaw agent pipeline.
+ *
+ * Each message produces a single inbound message.
+ * If the message has a taskId, it's set as ThreadId for conversation threading.
+ */
+export declare function deliverMessageToAgent(ctx: ChannelGatewayContext, message: ChatMessage): Promise<void>;
+//# sourceMappingURL=deliver.d.ts.map

package/dist/deliver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.d.ts","sourceRoot":"","sources":["../src/deliver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/deliver.js

@@ -0,0 +1,40 @@
+import { getClawHouseRuntime } from './runtime';
+/**
+ * Delivers a ClawHouse chat message to the OpenClaw agent pipeline.
+ *
+ * Each message produces a single inbound message.
+ * If the message has a taskId, it's set as ThreadId for conversation threading.
+ */
+export async function deliverMessageToAgent(ctx, message) {
+    const runtime = getClawHouseRuntime();
+    const msgCtx = runtime.channel.reply.finalizeInboundContext({
+        Body: message.content,
+        RawBody: message.content,
+        ChatType: 'dm',
+        Provider: 'clawhouse',
+        Surface: 'clawhouse',
+        From: message.userId,
+        To: message.botId,
+        MessageSid: message.messageId,
+        ThreadId: message.taskId ?? undefined,
+        Timestamp: message.createdAt,
+        AccountId: ctx.accountId,
+        FromName: message.userName ?? 'Unknown',
+    });
+    try {
+        const cfg = runtime.config.loadConfig();
+        const dispatcher = runtime.channel.reply.createReplyDispatcherWithTyping({
+            channel: 'clawhouse',
+            accountId: ctx.accountId,
+        });
+        await runtime.channel.reply.dispatchReplyFromConfig({
+            ctx: msgCtx,
+            cfg,
+            dispatcher,
+        });
+    }
+    catch {
+        // Non-fatal — agent routing may not be configured yet
+    }
+}
+//# sourceMappingURL=deliver.js.map

package/dist/deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver.js","sourceRoot":"","sources":["../src/deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAA0B,EAC1B,OAAoB;IAEpB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC;QAC1D,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,EAAE,EAAE,OAAO,CAAC,KAAK;QACjB,UAAU,EAAE,OAAO,CAAC,SAAS;QAC7B,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;QACrC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;KACxC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC;YACvE,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC;YAClD,GAAG,EAAE,MAAM;YACX,GAAG;YACH,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC"}

package/dist/gateway.d.ts

@@ -0,0 +1,11 @@
+import type { ChannelGatewayContext } from './types';
+/**
+ * Main entry point for the ClawHouse channel gateway.
+ * Called by OpenClaw's channel manager via gateway.startAccount().
+ *
+ * Maintains a WebSocket connection for real-time notifications
+ * and polls the messages endpoint for actual data.
+ * Falls back to interval-based polling if WebSocket is unavailable.
+ */
+export declare function startClawHouseConnection(ctx: ChannelGatewayContext): Promise<void>;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,qBAAqB,EAItB,MAAM,SAAS,CAAC;AAyEjB;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/gateway.js

@@ -0,0 +1,214 @@
+import WebSocket from 'ws';
+import { ClawHouseClient } from './client';
+import { deliverMessageToAgent } from './deliver';
+import { getClawHouseRuntime } from './runtime';
+const PING_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes (API GW idle timeout = 10 min)
+const POLL_FALLBACK_INTERVAL_MS = 30 * 1000; // 30s fallback when WS is down
+const BACKOFF_INITIAL_MS = 2000;
+const BACKOFF_MAX_MS = 30000;
+const BACKOFF_FACTOR = 1.8;
+function nextBackoff(state) {
+    const delay = Math.min(BACKOFF_INITIAL_MS * Math.pow(BACKOFF_FACTOR, state.attempt), BACKOFF_MAX_MS);
+    const jitter = delay * 0.25 * Math.random();
+    state.attempt++;
+    return delay + jitter;
+}
+function resetBackoff(state) {
+    state.attempt = 0;
+}
+function sleepWithAbort(ms, signal) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}
+/**
+ * Persistent cursor management.
+ * Stores cursor on disk so we can resume from the right position after restart.
+ */
+function loadCursor(ctx) {
+    try {
+        const runtime = getClawHouseRuntime();
+        const fs = require('fs');
+        const path = runtime.state.resolveStorePath(`clawhouse/${ctx.accountId}/cursor`);
+        return fs.readFileSync(path, 'utf-8').trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function saveCursor(ctx, cursor) {
+    try {
+        const runtime = getClawHouseRuntime();
+        const fs = require('fs');
+        const path = require('path');
+        const filePath = runtime.state.resolveStorePath(`clawhouse/${ctx.accountId}/cursor`);
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(filePath, cursor, 'utf-8');
+    }
+    catch {
+        // Non-fatal — we'll just re-process some messages on restart
+    }
+}
+/**
+ * Main entry point for the ClawHouse channel gateway.
+ * Called by OpenClaw's channel manager via gateway.startAccount().
+ *
+ * Maintains a WebSocket connection for real-time notifications
+ * and polls the messages endpoint for actual data.
+ * Falls back to interval-based polling if WebSocket is unavailable.
+ */
+export async function startClawHouseConnection(ctx) {
+    const account = ctx.account;
+    const client = new ClawHouseClient(account.botToken, account.apiUrl);
+    const log = ctx.log ?? getClawHouseRuntime().logging.createLogger('clawhouse');
+    let cursor = loadCursor(ctx);
+    const backoff = { attempt: 0 };
+    log.info(`Starting ClawHouse connection for account ${ctx.accountId}` +
+        (cursor ? ` (resuming from cursor ${cursor})` : ' (fresh start)'));
+    // Outer reconnection loop — runs until OpenClaw shuts down
+    while (!ctx.abortSignal.aborted) {
+        try {
+            const { ticket, wsUrl } = await client.getWsTicket();
+            resetBackoff(backoff);
+            log.info(`Got WS ticket, connecting to ${wsUrl}...`);
+            cursor = await runWebSocketConnection({
+                ticket,
+                wsUrl,
+                client,
+                ctx,
+                cursor,
+                log,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // If ticket fetch fails, fall back to polling
+            if (message.includes('API error')) {
+                log.warn(`Ticket fetch failed: ${message}. Falling back to polling.`);
+                cursor = await runPollingFallback({ client, ctx, cursor, log });
+            }
+            else {
+                log.warn(`Connection error: ${message}`);
+            }
+            if (ctx.abortSignal.aborted)
+                break;
+            const delay = nextBackoff(backoff);
+            log.info(`Reconnecting in ${Math.round(delay)}ms...`);
+            await sleepWithAbort(delay, ctx.abortSignal);
+        }
+    }
+    log.info('ClawHouse connection loop exited.');
+}
+/**
+ * Runs a single WebSocket connection session.
+ * Returns the latest cursor when the connection closes.
+ */
+async function runWebSocketConnection(opts) {
+    const { ticket, wsUrl, client, ctx, log } = opts;
+    let cursor = opts.cursor;
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`${wsUrl}?ticket=${ticket}`);
+        let pingInterval;
+        ws.on('open', () => {
+            ctx.setStatus({ running: true, lastStartAt: Date.now() });
+            log.info('WebSocket connected.');
+            // Keepalive ping every 5 minutes
+            pingInterval = setInterval(() => {
+                if (ws.readyState === WebSocket.OPEN) {
+                    ws.send(JSON.stringify({ action: 'ping' }));
+                }
+            }, PING_INTERVAL_MS);
+            // Initial catch-up poll
+            pollAndDeliver(client, ctx, cursor, log).then((newCursor) => {
+                if (newCursor)
+                    cursor = newCursor;
+            });
+        });
+        ws.on('message', async (data) => {
+            try {
+                const msg = JSON.parse(data.toString());
+                if (msg.action === 'notify') {
+                    // Thin notification — poll for full data
+                    const newCursor = await pollAndDeliver(client, ctx, cursor, log);
+                    if (newCursor)
+                        cursor = newCursor;
+                }
+                // Ignore pong and other messages
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                log.warn(`Error processing WS message: ${message}`);
+            }
+        });
+        ws.on('close', (code, reason) => {
+            clearInterval(pingInterval);
+            ctx.setStatus({ running: false, lastStopAt: Date.now() });
+            log.info(`WebSocket closed: ${code} ${reason.toString()}`);
+            resolve(cursor);
+        });
+        ws.on('error', (err) => {
+            clearInterval(pingInterval);
+            ctx.setStatus({ running: false, lastError: err.message });
+            reject(err);
+        });
+        // Clean shutdown
+        ctx.abortSignal.addEventListener('abort', () => {
+            clearInterval(pingInterval);
+            ws.close(1000, 'shutdown');
+        }, { once: true });
+    });
+}
+/**
+ * Fallback polling loop when WebSocket is unavailable.
+ * Polls every 30s until aborted or until we should retry WebSocket.
+ */
+async function runPollingFallback(opts) {
+    const { client, ctx, log } = opts;
+    let cursor = opts.cursor;
+    let iterations = 0;
+    const maxIterations = 10; // After 10 polls (~5 min), try WebSocket again
+    ctx.setStatus({ running: true, lastStartAt: Date.now() });
+    log.info('Running in polling fallback mode.');
+    while (!ctx.abortSignal.aborted && iterations < maxIterations) {
+        const newCursor = await pollAndDeliver(client, ctx, cursor, log);
+        if (newCursor)
+            cursor = newCursor;
+        iterations++;
+        await sleepWithAbort(POLL_FALLBACK_INTERVAL_MS, ctx.abortSignal);
+    }
+    ctx.setStatus({ running: false, lastStopAt: Date.now() });
+    return cursor;
+}
+/**
+ * Poll the messages endpoint and deliver new messages to the OpenClaw agent.
+ * Returns the new cursor, or null if no messages.
+ */
+async function pollAndDeliver(client, ctx, cursor, log) {
+    try {
+        const response = await client.listMessages({
+            cursor,
+        });
+        if (response.items.length === 0)
+            return null;
+        log.info(`Received ${response.items.length} new message(s).`);
+        for (const message of response.items) {
+            await deliverMessageToAgent(ctx, message);
+        }
+        // Persist cursor
+        if (response.cursor) {
+            saveCursor(ctx, response.cursor);
+        }
+        return response.cursor;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn(`Poll failed: ${message}`);
+        return null;
+    }
+}
+//# sourceMappingURL=gateway.js.map

package/dist/gateway.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { OpenClawPluginApi } from './types';
+declare const plugin: {
+    id: string;
+    name: string;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,QAAA,MAAM,MAAM;;;kBAII,iBAAiB;CAQhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+import { clawHousePlugin } from './channel';
+import { setClawHouseRuntime } from './runtime';
+import { createClawHouseTools } from './tools';
+const plugin = {
+    id: 'clawhouse',
+    name: 'ClawHouse',
+    register(api) {
+        setClawHouseRuntime(api.runtime);
+        api.registerChannel({ plugin: clawHousePlugin });
+        api.registerTool((ctx) => {
+            if (ctx.sandboxed)
+                return null;
+            return createClawHouseTools(api);
+        });
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,WAAW;IAEjB,QAAQ,CAAC,GAAsB;QAC7B,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QACjD,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;YACvB,IAAI,GAAG,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC/B,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { PluginRuntime } from './types';
+export declare function setClawHouseRuntime(runtime: PluginRuntime): void;
+export declare function getClawHouseRuntime(): PluginRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhE;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAOnD"}

package/dist/runtime.js

@@ -0,0 +1,11 @@
+let _runtime = null;
+export function setClawHouseRuntime(runtime) {
+    _runtime = runtime;
+}
+export function getClawHouseRuntime() {
+    if (!_runtime) {
+        throw new Error('ClawHouse runtime not initialized. Ensure setClawHouseRuntime() is called during plugin registration.');
+    }
+    return _runtime;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAEA,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,QAAQ,GAAG,OAAO,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,7 @@
+import type { AnyAgentTool, OpenClawPluginApi } from './types';
+/**
+ * Creates all ClawHouse agent tools.
+ * Returns null if the channel is not configured.
+ */
+export declare function createClawHouseTools(api: OpenClawPluginApi): AnyAgentTool[] | null;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAA4B,MAAM,SAAS,CAAC;AAoDzF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,YAAY,EAAE,GAAG,IAAI,CA4JlF"}

package/dist/tools.js

@@ -0,0 +1,178 @@
+import { Type } from '@sinclair/typebox';
+import { ClawHouseClient } from './client';
+/**
+ * Resolve the ClawHouse account from the plugin config.
+ * Shared logic with channel.ts — reads channels.clawhouse from config.
+ */
+function resolveAccountFromConfig(api) {
+    const cfg = api.runtime.config.loadConfig();
+    const ch = cfg?.channels?.clawhouse;
+    if (!ch)
+        return null;
+    // Use first explicit account, or fall back to top-level config
+    if (ch.accounts && Object.keys(ch.accounts).length > 0) {
+        const [accountId, acct] = Object.entries(ch.accounts)[0];
+        if (!acct.botToken || !acct.apiUrl)
+            return null;
+        return {
+            accountId,
+            botToken: acct.botToken,
+            apiUrl: acct.apiUrl,
+            wsUrl: acct.wsUrl ?? '',
+            enabled: acct.enabled !== false,
+        };
+    }
+    if (!ch.botToken || !ch.apiUrl)
+        return null;
+    return {
+        accountId: 'default',
+        botToken: ch.botToken,
+        apiUrl: ch.apiUrl,
+        wsUrl: ch.wsUrl ?? '',
+        enabled: ch.enabled !== false,
+    };
+}
+function textResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Creates all ClawHouse agent tools.
+ * Returns null if the channel is not configured.
+ */
+export function createClawHouseTools(api) {
+    const account = resolveAccountFromConfig(api);
+    if (!account)
+        return null;
+    const client = new ClawHouseClient(account.botToken, account.apiUrl);
+    return [
+        {
+            name: 'clawhouse_get_next_task',
+            description: 'Pick up the next available task from ClawHouse. Atomically claims the oldest ready_for_bot task and moves it to working_on_it. Returns the task object with instructions, or null if none available.',
+            parameters: Type.Object({
+                projectId: Type.Optional(Type.String({ description: 'Filter to a specific project UUID' })),
+            }),
+            async execute(_id, params) {
+                const result = await client.getNextTask({
+                    projectId: params.projectId,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_list_tasks',
+            description: 'List all tasks in a ClawHouse project, ordered by most recently updated.',
+            parameters: Type.Object({
+                projectId: Type.String({ description: 'Project UUID (required)' }),
+                status: Type.Optional(Type.String({
+                    description: 'Filter by status: ready_for_bot, working_on_it, waiting_for_human, done',
+                })),
+            }),
+            async execute(_id, params) {
+                const result = await client.listTasks({
+                    projectId: params.projectId,
+                    status: params.status,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_comment',
+            description: 'Post a progress update comment on a ClawHouse task. Works on any accessible task regardless of status.',
+            parameters: Type.Object({
+                taskId: Type.String({ description: 'Task UUID' }),
+                content: Type.String({ description: 'Comment text (supports markdown)' }),
+            }),
+            async execute(_id, params) {
+                const result = await client.comment({
+                    taskId: params.taskId,
+                    content: params.content,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_done',
+            description: 'Mark a working_on_it task as completed. Moves it to waiting_for_human. Always include a deliverable documenting your work in markdown.',
+            parameters: Type.Object({
+                taskId: Type.String({ description: 'Task UUID' }),
+                reason: Type.String({ description: 'Why the task is complete' }),
+                deliverable: Type.Optional(Type.String({
+                    description: 'Markdown deliverable documenting what was done and results',
+                })),
+            }),
+            async execute(_id, params) {
+                const result = await client.done({
+                    taskId: params.taskId,
+                    reason: params.reason,
+                    deliverable: params.deliverable,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_giveup',
+            description: 'Give up on a working_on_it task. Moves it to waiting_for_human so a human can help. Always include a deliverable with partial progress.',
+            parameters: Type.Object({
+                taskId: Type.String({ description: 'Task UUID' }),
+                reason: Type.String({ description: 'Why the task cannot be completed' }),
+                deliverable: Type.Optional(Type.String({
+                    description: 'Markdown deliverable documenting partial progress and blockers',
+                })),
+            }),
+            async execute(_id, params) {
+                const result = await client.giveup({
+                    taskId: params.taskId,
+                    reason: params.reason,
+                    deliverable: params.deliverable,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_list_projects',
+            description: 'List all projects accessible to this bot in ClawHouse.',
+            parameters: Type.Object({}),
+            async execute() {
+                const result = await client.listProjects();
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_create_task',
+            description: 'Create a new task in a ClawHouse project. The task starts in ready_for_bot status.',
+            parameters: Type.Object({
+                projectId: Type.String({ description: 'Project UUID' }),
+                title: Type.String({ description: 'Task title (max 200 chars)' }),
+                instructions: Type.Optional(Type.String({ description: 'Detailed instructions for the task' })),
+            }),
+            async execute(_id, params) {
+                const result = await client.createTask({
+                    projectId: params.projectId,
+                    title: params.title,
+                    instructions: params.instructions,
+                });
+                return textResult(result);
+            },
+        },
+        {
+            name: 'clawhouse_create_project',
+            description: 'Create a new project in ClawHouse.',
+            parameters: Type.Object({
+                name: Type.String({ description: 'Project name' }),
+                key: Type.String({ description: 'Project key (2-10 uppercase letters)' }),
+                description: Type.Optional(Type.String({ description: 'Project description' })),
+                color: Type.Optional(Type.String({ description: 'Hex color code (e.g. #3B82F6)' })),
+            }),
+            async execute(_id, params) {
+                const result = await client.createProject({
+                    name: params.name,
+                    key: params.key,
+                    description: params.description,
+                    color: params.color,
+                });
+                return textResult(result);
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Minimal type definitions for the OpenClaw plugin API.
+ * These mirror the actual OpenClaw types but are defined inline
+ * to avoid a hard dependency on the openclaw package at build time.
+ * At runtime, the real types are provided by OpenClaw.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export interface AnyAgentTool {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (id: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }>;
+    optional?: boolean;
+}
+export interface OpenClawPluginToolContext {
+    config?: unknown;
+    messageChannel?: unknown;
+    agentAccountId?: string;
+    sandboxed?: boolean;
+}
+export type OpenClawPluginToolFactory = (ctx: OpenClawPluginToolContext) => AnyAgentTool | AnyAgentTool[] | null | undefined;
+export interface OpenClawPluginToolOptions {
+    optional?: boolean;
+}
+export interface OpenClawPluginApi {
+    runtime: PluginRuntime;
+    config: unknown;
+    pluginConfig: unknown;
+    logger: PluginLogger;
+    registerChannel(registration: {
+        plugin: ChannelPlugin;
+    }): void;
+    registerHttpRoute(params: {
+        path: string;
+        handler: (req: IncomingMessage, res: ServerResponse) => Promise<void> | void;
+    }): void;
+    registerTool(tool: AnyAgentTool | OpenClawPluginToolFactory, opts?: OpenClawPluginToolOptions): void;
+}
+export interface PluginRuntime {
+    config: {
+        loadConfig(): unknown;
+    };
+    channel: {
+        reply: {
+            finalizeInboundContext<T extends Record<string, unknown>>(ctx: T): T & FinalizedMsgContext;
+            dispatchReplyFromConfig(params: {
+                ctx: FinalizedMsgContext;
+                cfg: unknown;
+                dispatcher: ReplyDispatcher;
+            }): Promise<{
+                queuedFinal: boolean;
+            }>;
+            createReplyDispatcherWithTyping(params: unknown): ReplyDispatcher;
+        };
+        text: {
+            chunkMarkdownText(text: string, limit: number): string[];
+        };
+    };
+    logging: {
+        createLogger(name: string): PluginLogger;
+    };
+    state: {
+        resolveStorePath(subpath: string): string;
+    };
+}
+export interface FinalizedMsgContext {
+    Body: string;
+    RawBody?: string;
+    ChatType: string;
+    Provider: string;
+    Surface: string;
+    From: string;
+    To: string;
+    MessageSid: string;
+    Timestamp?: string;
+    BodyForAgent?: string;
+    [key: string]: unknown;
+}
+export interface ReplyDispatcher {
+    send(reply: unknown): Promise<void>;
+    getQueuedCounts(): unknown;
+}
+export interface PluginLogger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+}
+export interface ChannelPlugin {
+    id: string;
+    meta: ChannelMeta;
+    capabilities: ChannelCapabilities;
+    config: ChannelConfigAdapter;
+    outbound?: ChannelOutboundAdapter;
+    gateway?: ChannelGatewayAdapter;
+    setup?: ChannelSetupAdapter;
+    security?: ChannelSecurityAdapter;
+}
+export interface ChannelMeta {
+    name: string;
+    icon?: string;
+    description?: string;
+}
+export interface ChannelCapabilities {
+    text: boolean;
+    media: boolean;
+    reactions: boolean;
+    threads: boolean;
+    editing: boolean;
+}
+export interface ChannelConfigAdapter {
+    listAccountIds(cfg: unknown): string[];
+    resolveAccount(cfg: unknown, accountId?: string | null): ResolvedClawHouseAccount;
+    isConfigured?(account: ResolvedClawHouseAccount, cfg: unknown): boolean;
+    isEnabled?(account: ResolvedClawHouseAccount, cfg: unknown): boolean;
+    describeAccount?(account: ResolvedClawHouseAccount, cfg: unknown): ChannelAccountSnapshot;
+}
+export interface ChannelOutboundAdapter {
+    deliveryMode: 'direct' | 'gateway' | 'hybrid';
+    sendText?(ctx: ChannelOutboundContext): Promise<OutboundDeliveryResult>;
+    textChunkLimit?: number;
+    chunkerMode?: 'text' | 'markdown';
+}
+export interface ChannelGatewayAdapter {
+    startAccount?(ctx: ChannelGatewayContext): Promise<unknown>;
+    stopAccount?(ctx: ChannelGatewayContext): Promise<void>;
+}
+export interface ChannelGatewayContext {
+    cfg: unknown;
+    accountId: string;
+    account: ResolvedClawHouseAccount;
+    runtime: unknown;
+    abortSignal: AbortSignal;
+    log?: PluginLogger;
+    getStatus(): ChannelAccountSnapshot;
+    setStatus(next: ChannelAccountSnapshot): void;
+}
+export interface ChannelSetupAdapter {
+    applyAccountConfig(params: {
+        cfg: unknown;
+        accountId: string;
+        input: Record<string, string>;
+    }): unknown;
+    validateInput?(params: {
+        cfg: unknown;
+        accountId: string;
+        input: Record<string, string>;
+    }): string | null;
+}
+export interface ChannelSecurityAdapter {
+    resolveDmPolicy?(): {
+        policy: string;
+    };
+}
+export interface ChannelOutboundContext {
+    cfg: unknown;
+    to: string;
+    text: string;
+    threadId?: string | number | null;
+    replyToId?: string | null;
+    accountId?: string | null;
+}
+export interface OutboundDeliveryResult {
+    channel: string;
+    success: boolean;
+    threadId?: string;
+}
+export interface ChannelAccountSnapshot {
+    running?: boolean;
+    lastStartAt?: number;
+    lastStopAt?: number;
+    lastError?: string;
+}
+export interface ResolvedClawHouseAccount {
+    accountId: string;
+    botToken: string;
+    apiUrl: string;
+    wsUrl: string;
+    enabled: boolean;
+}
+export interface ClawHouseChannelConfig {
+    enabled?: boolean;
+    botToken: string;
+    apiUrl: string;
+    wsUrl: string;
+    accounts?: Record<string, Omit<ClawHouseChannelConfig, 'accounts'>>;
+}
+export interface ChatMessage {
+    messageId: string;
+    botId: string;
+    userId: string;
+    authorType: 'bot' | 'user';
+    content: string;
+    taskId?: string | null;
+    createdAt: string;
+    userName?: string | null;
+    botName?: string | null;
+}
+export interface MessagesResponse {
+    items: ChatMessage[];
+    cursor: string | null;
+    hasMore: boolean;
+}
+export interface WsTicketResponse {
+    ticket: string;
+    wsUrl: string;
+    expiresAt: string;
+}
+export interface WsNotification {
+    action: 'notify';
+    hint: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Minimal type definitions for the OpenClaw plugin API.
+ * These mirror the actual OpenClaw types but are defined inline
+ * to avoid a hard dependency on the openclaw package at build time.
+ * At runtime, the real types are provided by OpenClaw.
+ */
+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":"AAAA;;;;;GAKG"}

package/openclaw.plugin.json

@@ -0,0 +1,8 @@
+{
+  "id": "clawhouse",
+  "name": "ClawHouse",
+  "description": "Channel plugin and agent tools for ClawHouse project management",
+  "configSchema": { "type": "object", "additionalProperties": false, "properties": {} },
+  "channels": ["clawhouse"],
+  "skills": ["./skills"]
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@clawhouse/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "OpenClaw channel plugin for ClawHouse — turns ClawHouse into a messaging platform for OpenClaw AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "openclaw.plugin.json",
+    "skills/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawhouse/openclaw-plugin.git"
+  },
+  "peerDependencies": {
+    "openclaw": ">=0.1.0"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.0"
+  },
+  "keywords": [
+    "openclaw",
+    "clawhouse",
+    "channel",
+    "plugin",
+    "ai",
+    "agent"
+  ],
+  "license": "MIT"
+}

package/skills/clawhouse/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: clawhouse
+description: Workflow knowledge for ClawHouse task management. Use with the clawhouse_* tools.
+version: 1.0.0
+metadata: {"openclaw":{"emoji":"🏠"}}
+---
+
+## Task Workflow
+
+Tasks follow a strict state machine. Understand this before using any tool.
+
+```
+ready_for_bot ──[clawhouse_get_next_task]──> working_on_it ──[clawhouse_done]───> waiting_for_human
+                                                    │
+                                                    └────[clawhouse_giveup]───> waiting_for_human
+```
+
+## Decision Tree
+
+1. Call `clawhouse_get_next_task` to check for available tasks
+2. **Got a task?** Work on it, post `clawhouse_comment` updates, then call `clawhouse_done` or `clawhouse_giveup`
+3. **Got null?** No tasks available — stop checking
+4. **Can't complete?** Call `clawhouse_giveup` immediately with a partial deliverable so a human can help
+5. **One task at a time.** Spawn a dedicated subagent per task to keep context clean
+
+## Rules
+
+1. **Status gates:** You can only `clawhouse_done` or `clawhouse_giveup` on tasks in `working_on_it` status
+2. **Comments are unrestricted:** You can `clawhouse_comment` on any accessible task regardless of status
+3. **No manual status changes:** All state transitions happen through the tools above
+4. **Deliverables in markdown:** Always provide a deliverable documenting your work, even partial work on `clawhouse_giveup`
+5. **Give up early:** If you can't complete a task, `clawhouse_giveup` immediately — don't spin
+6. **One task per subagent:** Spawn a dedicated subagent for each task to keep context clean
+7. **No assignment required:** Any bot can pick up any `ready_for_bot` task via `clawhouse_get_next_task`
+
+## Error Handling
+
+| Error | Meaning | Action |
+|-------|---------|--------|
+| `clawhouse_get_next_task` returns `null` | No tasks available | Stop checking — do not retry in a loop |
+| 404 on `clawhouse_done` or `clawhouse_giveup` | Task not in `working_on_it` status | Check if task was already completed or given up |
+| 404 on `clawhouse_comment` | Task not found or not accessible | Verify task ID and project access |
+| 401 Unauthorized | Bot token invalid | Check channel configuration |