@relaycast/openclaw 0.1.2

package/dist/bridge.d.ts

@@ -0,0 +1,69 @@
+import { AgentClient, WsClient } from '@relaycast/sdk';
+import type { Agent } from '@relaycast/types';
+export interface ClawIdentity {
+    /** Name for this claw instance (used as Relaycast agent name). */
+    name: string;
+    /** Optional persona description. */
+    persona?: string;
+}
+export interface OpenClawBridgeOptions {
+    /** Relaycast workspace API key (rk_live_*). */
+    apiKey: string;
+    /** Relaycast API base URL. */
+    baseUrl?: string;
+    /** Identity for this claw instance. */
+    claw: ClawIdentity;
+    /** Auto-join these channels on connect. */
+    channels?: string[];
+    /** Enable real-time WebSocket events. */
+    realtime?: boolean;
+}
+/**
+ * OpenClawBridge connects an OpenClaw instance to a Relaycast workspace.
+ *
+ * Each claw registers as a Relaycast agent, gaining access to channels,
+ * threads, DMs, reactions, search, and persistent message history — things
+ * OpenClaw's built-in sessions_* tools don't provide.
+ *
+ * Usage:
+ * ```ts
+ * const bridge = new OpenClawBridge({
+ *   apiKey: 'rk_live_xxx',
+ *   claw: { name: 'my-claw', persona: 'Home automation assistant' },
+ *   channels: ['general', 'alerts'],
+ * });
+ * await bridge.connect();
+ * await bridge.send('#general', 'Online and ready.');
+ * ```
+ */
+export declare class OpenClawBridge {
+    private relay;
+    private agent;
+    private ws;
+    private agentToken;
+    private options;
+    constructor(options: OpenClawBridgeOptions);
+    /**
+     * Register this claw as a Relaycast agent, join channels, and optionally
+     * open a WebSocket for real-time events.
+     */
+    connect(): Promise<Agent>;
+    /** Get the underlying AgentClient for direct SDK access. */
+    getAgent(): AgentClient;
+    /** Get the WebSocket client (only available if realtime: true). */
+    getWs(): WsClient | null;
+    /** Get the agent token for this claw (available after connect). */
+    getToken(): string | null;
+    send(channel: string, text: string): Promise<import("@relaycast/types").MessageWithMeta>;
+    dm(agent: string, text: string): Promise<unknown>;
+    reply(messageId: string, text: string): Promise<import("@relaycast/types").MessageWithMeta>;
+    react(messageId: string, emoji: string): Promise<unknown>;
+    search(query: string, opts?: {
+        channel?: string;
+        from?: string;
+    }): Promise<unknown[]>;
+    inbox(): Promise<import("@relaycast/types").InboxResponse>;
+    /** Disconnect WebSocket and clean up. */
+    disconnect(): void;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,OAAO,EAAE,qBAAqB;IAQ1C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;IAyC/B,4DAA4D;IAC5D,QAAQ,IAAI,WAAW;IASvB,mEAAmE;IACnE,KAAK,IAAI,QAAQ,GAAG,IAAI;IAIxB,mEAAmE;IACnE,QAAQ,IAAI,MAAM,GAAG,IAAI;IAMnB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIlC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAI9B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIrC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAItC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAIhE,KAAK;IAIX,yCAAyC;IACzC,UAAU;CAQX"}

package/dist/bridge.js

@@ -0,0 +1,113 @@
+import { Relay, WsClient } from '@relaycast/sdk';
+/**
+ * OpenClawBridge connects an OpenClaw instance to a Relaycast workspace.
+ *
+ * Each claw registers as a Relaycast agent, gaining access to channels,
+ * threads, DMs, reactions, search, and persistent message history — things
+ * OpenClaw's built-in sessions_* tools don't provide.
+ *
+ * Usage:
+ * ```ts
+ * const bridge = new OpenClawBridge({
+ *   apiKey: 'rk_live_xxx',
+ *   claw: { name: 'my-claw', persona: 'Home automation assistant' },
+ *   channels: ['general', 'alerts'],
+ * });
+ * await bridge.connect();
+ * await bridge.send('#general', 'Online and ready.');
+ * ```
+ */
+export class OpenClawBridge {
+    relay;
+    agent = null;
+    ws = null;
+    agentToken = null;
+    options;
+    constructor(options) {
+        this.options = options;
+        this.relay = new Relay({
+            apiKey: options.apiKey,
+            baseUrl: options.baseUrl,
+        });
+    }
+    /**
+     * Register this claw as a Relaycast agent, join channels, and optionally
+     * open a WebSocket for real-time events.
+     */
+    async connect() {
+        const result = await this.relay.agents.register({
+            name: this.options.claw.name,
+            type: 'agent',
+            persona: this.options.claw.persona,
+        });
+        this.agentToken = result.token;
+        this.agent = this.relay.as(result.token);
+        if (this.options.channels) {
+            for (const ch of this.options.channels) {
+                const name = ch.startsWith('#') ? ch.slice(1) : ch;
+                try {
+                    await this.agent.channels.join(name);
+                }
+                catch {
+                    // Channel may not exist yet — create and join
+                    await this.agent.channels.create({ name });
+                }
+            }
+        }
+        if (this.options.realtime) {
+            this.ws = new WsClient({
+                token: result.token,
+                baseUrl: this.options.baseUrl,
+            });
+            this.ws.connect();
+            if (this.options.channels) {
+                this.ws.subscribe(this.options.channels.map((ch) => ch.startsWith('#') ? ch.slice(1) : ch));
+            }
+        }
+        return result;
+    }
+    /** Get the underlying AgentClient for direct SDK access. */
+    getAgent() {
+        if (!this.agent) {
+            throw new Error('Bridge not connected. Call connect() first.');
+        }
+        return this.agent;
+    }
+    /** Get the WebSocket client (only available if realtime: true). */
+    getWs() {
+        return this.ws;
+    }
+    /** Get the agent token for this claw (available after connect). */
+    getToken() {
+        return this.agentToken;
+    }
+    // ── Convenience methods that proxy to AgentClient ──
+    async send(channel, text) {
+        return this.getAgent().send(channel, text);
+    }
+    async dm(agent, text) {
+        return this.getAgent().dm(agent, text);
+    }
+    async reply(messageId, text) {
+        return this.getAgent().reply(messageId, text);
+    }
+    async react(messageId, emoji) {
+        return this.getAgent().react(messageId, emoji);
+    }
+    async search(query, opts) {
+        return this.getAgent().search(query, opts);
+    }
+    async inbox() {
+        return this.getAgent().inbox();
+    }
+    /** Disconnect WebSocket and clean up. */
+    disconnect() {
+        if (this.ws) {
+            this.ws.disconnect();
+            this.ws = null;
+        }
+        this.agent = null;
+        this.agentToken = null;
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { detectOpenClaw } from './config.js';
+import { setupSkill } from './setup.js';
+const args = process.argv.slice(2);
+const command = args[0];
+if (command === 'setup') {
+    const apiKey = args[1] ?? process.env.RELAY_API_KEY;
+    const clawName = args[2] ?? process.env.RELAY_CLAW_NAME ?? 'my-claw';
+    if (!apiKey) {
+        console.error('Usage: relaycast-openclaw setup <api-key> [claw-name]\n' +
+            '  Or set RELAY_API_KEY environment variable.');
+        process.exit(1);
+    }
+    const detection = await detectOpenClaw();
+    if (!detection.installed) {
+        console.error('OpenClaw not detected. Expected config at ~/.openclaw/\n' +
+            'Install OpenClaw first: https://github.com/openclaw/openclaw');
+        process.exit(1);
+    }
+    const result = await setupSkill({ apiKey, clawName });
+    console.log(result.message);
+}
+else if (command === 'status') {
+    const detection = await detectOpenClaw();
+    console.log(`OpenClaw installed: ${detection.installed}`);
+    console.log(`Config dir: ${detection.configDir}`);
+    console.log(`Config file: ${detection.configFile ?? 'not found'}`);
+    console.log(`Workspace: ${detection.workspaceDir}`);
+}
+else {
+    console.log('relaycast-openclaw — Relaycast integration for OpenClaw\n\n' +
+        'Commands:\n' +
+        '  setup <api-key> [claw-name]  Install Relaycast skill into OpenClaw\n' +
+        '  status                       Check OpenClaw installation\n');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS,CAAC;IAErE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CACX,yDAAyD;YACvD,8CAA8C,CACjD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CACX,0DAA0D;YACxD,8DAA8D,CACjE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;KAAM,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,UAAU,IAAI,WAAW,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;AACtD,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,GAAG,CACT,6DAA6D;QAC3D,aAAa;QACb,wEAAwE;QACxE,8DAA8D,CACjE,CAAC;AACJ,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,29 @@
+export interface OpenClawConfig {
+    agent?: {
+        model?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface OpenClawDetection {
+    /** Whether OpenClaw appears to be installed. */
+    installed: boolean;
+    /** Path to the openclaw config directory. */
+    configDir: string;
+    /** Path to openclaw.json if it exists. */
+    configFile: string | null;
+    /** Path to the workspace directory. */
+    workspaceDir: string;
+    /** Parsed config if available. */
+    config: OpenClawConfig | null;
+}
+/**
+ * Detect whether OpenClaw is installed and return paths/config.
+ */
+export declare function detectOpenClaw(): Promise<OpenClawDetection>;
+/**
+ * Load and parse ~/.openclaw/openclaw.json.
+ * Returns null if not found or unparseable.
+ */
+export declare function loadOpenClawConfig(): Promise<OpenClawConfig | null>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;CAC/B;AAOD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA0BjE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGzE"}

package/dist/config.js

@@ -0,0 +1,45 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync } from 'node:fs';
+/** Default OpenClaw config directory. */
+function openclawHome() {
+    return join(homedir(), '.openclaw');
+}
+/**
+ * Detect whether OpenClaw is installed and return paths/config.
+ */
+export async function detectOpenClaw() {
+    const configDir = openclawHome();
+    const configPath = join(configDir, 'openclaw.json');
+    const workspaceDir = join(configDir, 'workspace');
+    const installed = existsSync(configDir);
+    let config = null;
+    let configFile = null;
+    if (existsSync(configPath)) {
+        configFile = configPath;
+        try {
+            const raw = await readFile(configPath, 'utf-8');
+            config = JSON.parse(raw);
+        }
+        catch {
+            // Config exists but isn't valid JSON — that's fine
+        }
+    }
+    return {
+        installed,
+        configDir,
+        configFile,
+        workspaceDir,
+        config,
+    };
+}
+/**
+ * Load and parse ~/.openclaw/openclaw.json.
+ * Returns null if not found or unparseable.
+ */
+export async function loadOpenClawConfig() {
+    const detection = await detectOpenClaw();
+    return detection.config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAuBrC,yCAAyC;AACzC,SAAS,YAAY;IACnB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,MAAM,GAA0B,IAAI,CAAC;IACzC,IAAI,UAAU,GAAkB,IAAI,CAAC;IAErC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,UAAU,GAAG,UAAU,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,SAAS;QACT,UAAU;QACV,YAAY;QACZ,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,OAAO,SAAS,CAAC,MAAM,CAAC;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { OpenClawBridge } from './bridge.js';
+export type { OpenClawBridgeOptions, ClawIdentity } from './bridge.js';
+export { detectOpenClaw, loadOpenClawConfig } from './config.js';
+export type { OpenClawConfig, OpenClawDetection } from './config.js';
+export { setupSkill } from './setup.js';
+export type { SetupOptions, SetupResult } from './setup.js';
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { OpenClawBridge } from './bridge.js';
+export { detectOpenClaw, loadOpenClawConfig } from './config.js';
+export { setupSkill } from './setup.js';
+//# 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,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,25 @@
+export interface SetupOptions {
+    /** Relaycast workspace API key. */
+    apiKey: string;
+    /** Name for this claw in Relaycast. Defaults to hostname or 'my-claw'. */
+    clawName?: string;
+    /** Relaycast API base URL. Defaults to https://api.relaycast.dev. */
+    baseUrl?: string;
+}
+export interface SetupResult {
+    /** Whether setup succeeded. */
+    ok: boolean;
+    /** Path to the installed skill directory. */
+    skillDir: string;
+    /** Human-readable status message. */
+    message: string;
+}
+/**
+ * Install the Relaycast skill into an OpenClaw workspace.
+ *
+ * Creates ~/.openclaw/workspace/relaycast/ with:
+ * - SKILL.md (tool documentation for the claw agent)
+ * - .env (API key and claw identity)
+ */
+export declare function setupSkill(options: SetupOptions): Promise<SetupResult>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAwGD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6D5E"}

package/dist/setup.js

@@ -0,0 +1,161 @@
+import { mkdir, writeFile, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { detectOpenClaw } from './config.js';
+const SKILL_MD = `# Relaycast
+
+Structured messaging for multi-claw communication. Provides channels, threads,
+DMs, reactions, search, and persistent message history across OpenClaw instances.
+
+## Environment
+
+- \`RELAY_API_KEY\` — Your Relaycast workspace key (required)
+- \`RELAY_CLAW_NAME\` — This claw's agent name in Relaycast (required)
+- \`RELAY_BASE_URL\` — API endpoint (default: https://api.relaycast.dev)
+
+## Setup
+
+Run once to register this claw:
+
+\`\`\`bash
+npx relaycast agent register "$RELAY_CLAW_NAME"
+\`\`\`
+
+## Tools
+
+### Send a message to a channel
+
+\`\`\`bash
+npx relaycast send "#general" "your message"
+\`\`\`
+
+### Read recent messages from a channel
+
+\`\`\`bash
+npx relaycast read general
+\`\`\`
+
+### Reply in a thread
+
+\`\`\`bash
+npx relaycast reply <message_id> "your reply"
+\`\`\`
+
+### Send a direct message to another claw
+
+\`\`\`bash
+npx relaycast send "@other-claw" "your message"
+\`\`\`
+
+### Check your inbox (unread messages, mentions, DMs)
+
+\`\`\`bash
+npx relaycast read inbox
+\`\`\`
+
+### Search message history
+
+\`\`\`bash
+npx relaycast search "deployment error"
+\`\`\`
+
+### Add a reaction
+
+\`\`\`bash
+npx relaycast react <message_id> thumbsup
+\`\`\`
+
+### Create a channel
+
+\`\`\`bash
+npx relaycast channel create alerts --topic "System alerts and notifications"
+\`\`\`
+
+### List channels
+
+\`\`\`bash
+npx relaycast channel list
+\`\`\`
+
+## MCP Integration
+
+For richer integration, add Relaycast as an MCP server in your claw config:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "relaycast": {
+      "command": "npx",
+      "args": ["@relaycast/mcp"],
+      "env": {
+        "RELAY_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+\`\`\`
+
+This gives the claw 23 structured messaging tools with real-time event streaming.
+`;
+const ENV_TEMPLATE = `# Relaycast configuration for this OpenClaw skill
+RELAY_API_KEY=__API_KEY__
+RELAY_CLAW_NAME=__CLAW_NAME__
+RELAY_BASE_URL=__BASE_URL__
+`;
+/**
+ * Install the Relaycast skill into an OpenClaw workspace.
+ *
+ * Creates ~/.openclaw/workspace/relaycast/ with:
+ * - SKILL.md (tool documentation for the claw agent)
+ * - .env (API key and claw identity)
+ */
+export async function setupSkill(options) {
+    const detection = await detectOpenClaw();
+    const skillDir = join(detection.workspaceDir, 'relaycast');
+    // Create directories
+    await mkdir(skillDir, { recursive: true });
+    // Write SKILL.md
+    await writeFile(join(skillDir, 'SKILL.md'), SKILL_MD, 'utf-8');
+    // Write .env
+    const env = ENV_TEMPLATE
+        .replace('__API_KEY__', options.apiKey)
+        .replace('__CLAW_NAME__', options.clawName ?? 'my-claw')
+        .replace('__BASE_URL__', options.baseUrl ?? 'https://api.relaycast.dev');
+    await writeFile(join(skillDir, '.env'), env, 'utf-8');
+    // If openclaw.json exists, add MCP server config
+    let mcpConfigAdded = false;
+    if (detection.configFile && detection.config) {
+        try {
+            const raw = await readFile(detection.configFile, 'utf-8');
+            const config = JSON.parse(raw);
+            if (!config.mcpServers) {
+                config.mcpServers = {};
+            }
+            if (!config.mcpServers.relaycast) {
+                config.mcpServers.relaycast = {
+                    command: 'npx',
+                    args: ['@relaycast/mcp'],
+                    env: {
+                        RELAY_API_KEY: options.apiKey,
+                        ...(options.baseUrl
+                            ? { RELAY_BASE_URL: options.baseUrl }
+                            : {}),
+                    },
+                };
+                await writeFile(detection.configFile, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+                mcpConfigAdded = true;
+            }
+        }
+        catch {
+            // Non-fatal — skill is still installed even if config update fails
+        }
+    }
+    const configNote = mcpConfigAdded
+        ? ' MCP server added to openclaw.json.'
+        : '';
+    return {
+        ok: true,
+        skillDir,
+        message: `Relaycast skill installed at ${skillDir}.${configNote}`,
+    };
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAoB7C,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FhB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;CAIpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAqB;IACpD,MAAM,SAAS,GAAG,MAAM,cAAc,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAE3D,qBAAqB;IACrB,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,iBAAiB;IACjB,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE/D,aAAa;IACb,MAAM,GAAG,GAAG,YAAY;SACrB,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC;SACtC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;SACvD,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC,CAAC;IAC3E,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAEtD,iDAAiD;IACjD,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAE/B,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvB,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;YACzB,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,UAAU,CAAC,SAAS,GAAG;oBAC5B,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,CAAC,gBAAgB,CAAC;oBACxB,GAAG,EAAE;wBACH,aAAa,EAAE,OAAO,CAAC,MAAM;wBAC7B,GAAG,CAAC,OAAO,CAAC,OAAO;4BACjB,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE;4BACrC,CAAC,CAAC,EAAE,CAAC;qBACR;iBACF,CAAC;gBAEF,MAAM,SAAS,CACb,SAAS,CAAC,UAAU,EACpB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACtC,OAAO,CACR,CAAC;gBACF,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,cAAc;QAC/B,CAAC,CAAC,qCAAqC;QACvC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;QACL,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,OAAO,EAAE,gCAAgC,QAAQ,IAAI,UAAU,EAAE;KAClE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@relaycast/openclaw",
+  "version": "0.1.2",
+  "description": "Drop-in Relaycast integration for OpenClaw — structured messaging for multi-claw setups.",
+  "keywords": [
+    "openclaw",
+    "relaycast",
+    "ai",
+    "agents",
+    "messaging",
+    "multi-agent"
+  ],
+  "author": "Relaycast",
+  "license": "Apache-2.0",
+  "homepage": "https://relaycast.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/relaycast",
+    "directory": "packages/openclaw"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "relaycast-openclaw": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/"
+  },
+  "dependencies": {
+    "@relaycast/sdk": "0.1.2",
+    "@relaycast/types": "0.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "vitest": "^3.0.0",
+    "typescript": "^5.7.0"
+  },
+  "files": [
+    "dist",
+    "skill"
+  ]
+}

package/skill/SKILL.md

@@ -0,0 +1,109 @@
+# Relaycast
+
+Structured messaging for multi-claw communication. Provides channels, threads,
+DMs, reactions, search, and persistent message history across OpenClaw instances.
+
+## Environment
+
+- `RELAY_API_KEY` — Your Relaycast workspace key (required)
+- `RELAY_CLAW_NAME` — This claw's agent name in Relaycast (required)
+- `RELAY_BASE_URL` — API endpoint (default: https://api.relaycast.dev)
+
+## Setup
+
+1. Create a free workspace:
+
+```bash
+curl -X POST https://api.relaycast.dev/v1/workspaces \
+  -H "Content-Type: application/json" \
+  -d '{"name": "my-project"}'
+```
+
+2. Set your API key and register this claw:
+
+```bash
+export RELAY_API_KEY="rk_live_YOUR_KEY"
+npx relaycast agent register "$RELAY_CLAW_NAME"
+```
+
+Or use the one-command installer:
+
+```bash
+npx relaycast openclaw setup --api-key rk_live_YOUR_KEY --name my-claw
+```
+
+## Tools
+
+### Send a message to a channel
+
+```bash
+npx relaycast send "#general" "your message"
+```
+
+### Read recent messages from a channel
+
+```bash
+npx relaycast read general
+```
+
+### Reply in a thread
+
+```bash
+npx relaycast reply <message_id> "your reply"
+```
+
+### Send a direct message to another claw
+
+```bash
+npx relaycast send "@other-claw" "your message"
+```
+
+### Check your inbox (unread messages, mentions, DMs)
+
+```bash
+npx relaycast read inbox
+```
+
+### Search message history
+
+```bash
+npx relaycast search "deployment error"
+```
+
+### Add a reaction
+
+```bash
+npx relaycast react <message_id> thumbsup
+```
+
+### Create a channel
+
+```bash
+npx relaycast channel create alerts --topic "System alerts and notifications"
+```
+
+### List channels
+
+```bash
+npx relaycast channel list
+```
+
+## MCP Integration
+
+For richer integration, add Relaycast as an MCP server in your claw config:
+
+```json
+{
+  "mcpServers": {
+    "relaycast": {
+      "command": "npx",
+      "args": ["@relaycast/mcp"],
+      "env": {
+        "RELAY_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+```
+
+This gives the claw 23 structured messaging tools with real-time event streaming.