@folotoy/folotoy-openclaw-plugin 0.3.1 → 0.4.1

package/bin/folotoy.mjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli/install.js')

package/dist/cli/install.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/install.d.ts.map

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

package/dist/cli/install.js

@@ -0,0 +1,113 @@
+import { execSync } from 'node:child_process';
+import qrcode from 'qrcode-terminal';
+import { DEFAULT_MQTT_HOST, DEFAULT_MQTT_PORT } from '../config.js';
+const PAIR_API_BASE = process.env.PAIR_API_BASE ?? 'https://pair.folotoy.cn';
+const POLL_INTERVAL_MS = 3000;
+const POLL_TIMEOUT_MS = 300_000; // 5 minutes
+// ── Helpers ────────────────────────────────────────────
+function checkOpenClaw() {
+    try {
+        execSync('openclaw --version', { stdio: 'pipe' });
+    }
+    catch {
+        console.error('Error: openclaw is not installed or not in PATH.');
+        console.error('Install it first: npm i -g openclaw');
+        process.exit(1);
+    }
+}
+function installPlugin() {
+    try {
+        const list = execSync('openclaw plugins list', { stdio: 'pipe' }).toString();
+        if (list.includes('folotoy-openclaw-plugin')) {
+            return; // already installed
+        }
+    }
+    catch {
+        // ignore
+    }
+    console.log('Installing FoloToy plugin...');
+    execSync('openclaw plugins install @folotoy/folotoy-openclaw-plugin', { stdio: 'inherit' });
+}
+async function createSession() {
+    const res = await fetch(`${PAIR_API_BASE}/api/pair`, { method: 'POST' });
+    if (!res.ok)
+        throw new Error(`Failed to create pairing session (HTTP ${res.status})`);
+    return res.json();
+}
+function displayQR(url) {
+    qrcode.generate(url, { small: true }, (qr) => {
+        console.log(qr);
+    });
+    console.log(`Or open this URL on your phone: ${url}\n`);
+}
+async function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+async function pollSession(sessionId) {
+    const deadline = Date.now() + POLL_TIMEOUT_MS;
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    while (Date.now() < deadline) {
+        process.stdout.write(`\r${frames[i++ % frames.length]} Waiting for pairing...`);
+        const res = await fetch(`${PAIR_API_BASE}/api/pair/${sessionId}`);
+        if (!res.ok)
+            throw new Error(`Poll failed (HTTP ${res.status})`);
+        const data = (await res.json());
+        if (data.status === 'completed') {
+            process.stdout.write('\r\x1b[32m✓\x1b[0m Paired successfully!        \n');
+            return data;
+        }
+        if (data.status === 'expired') {
+            process.stdout.write('\r');
+            throw new Error('Pairing session expired. Please try again.');
+        }
+        await sleep(POLL_INTERVAL_MS);
+    }
+    throw new Error('Pairing timed out after 5 minutes.');
+}
+function writeConfig(result) {
+    execSync(`openclaw config set channels.folotoy.flow direct`, { stdio: 'pipe' });
+    execSync(`openclaw config set channels.folotoy.toy_sn ${result.toy_sn}`, { stdio: 'pipe' });
+    execSync(`openclaw config set channels.folotoy.toy_key ${result.toy_key}`, { stdio: 'pipe' });
+    const mqttHost = result.mqtt_host ?? DEFAULT_MQTT_HOST;
+    const mqttPort = result.mqtt_port ?? DEFAULT_MQTT_PORT;
+    execSync(`openclaw config set channels.folotoy.mqtt_host ${mqttHost}`, { stdio: 'pipe' });
+    execSync(`openclaw config set channels.folotoy.mqtt_port ${mqttPort}`, { stdio: 'pipe' });
+}
+// ── Main ───────────────────────────────────────────────
+async function main() {
+    const command = process.argv[2];
+    if (command !== 'install') {
+        console.log('Usage: npx @folotoy/folotoy-openclaw-plugin install');
+        process.exit(command ? 1 : 0);
+    }
+    console.log('🧸 FoloToy OpenClaw Plugin Installer\n');
+    // Step 1: check prerequisites
+    console.log('Checking openclaw...');
+    checkOpenClaw();
+    console.log('✓ openclaw found\n');
+    // Step 2: install plugin if not present
+    installPlugin();
+    // Step 3: create pairing session
+    console.log('Creating pairing session...\n');
+    const session = await createSession();
+    // Step 4: display QR code
+    console.log('Scan this QR code with your phone,');
+    console.log('then scan your toy\'s QR code on the phone:\n');
+    displayQR(session.pair_url);
+    // Step 5: poll for result
+    const result = await pollSession(session.session_id);
+    // Step 6: write config
+    console.log('\nWriting configuration...');
+    writeConfig(result);
+    // Step 7: done
+    console.log('\n\x1b[32m✓ FoloToy plugin installed and configured!\x1b[0m');
+    console.log(`  Toy SN:    ${result.toy_sn}`);
+    console.log(`  MQTT Host: ${result.mqtt_host ?? DEFAULT_MQTT_HOST}`);
+    console.log('\nRestart the gateway to apply: openclaw gateway start --force');
+}
+main().catch((err) => {
+    console.error(`\n\x1b[31mError:\x1b[0m ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,33 @@
+export type AuthFlow1Config = {
+    flow: 'api';
+    api_url: string;
+    api_key: string;
+    toy_sn: string;
+};
+export type AuthFlow2Config = {
+    flow: 'direct';
+    toy_sn: string;
+    toy_key: string;
+};
+export type PluginConfig = {
+    auth: AuthFlow1Config | AuthFlow2Config;
+    mqtt: {
+        host: string;
+        port: number;
+    };
+};
+/** Flat config as stored in openclaw.json channels.folotoy */
+export type FlatChannelConfig = {
+    flow?: string;
+    toy_sn?: string;
+    toy_key?: string;
+    api_url?: string;
+    api_key?: string;
+    mqtt_host?: string;
+    mqtt_port?: number;
+};
+export declare const DEFAULT_API_URL = "https://api.folotoy.cn";
+export declare const DEFAULT_MQTT_HOST: string;
+export declare const DEFAULT_MQTT_PORT = 1883;
+export declare function flatToPluginConfig(flat: FlatChannelConfig): PluginConfig;
+//# 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":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,eAAe,GAAG,eAAe,CAAA;IACvC,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;CACF,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,eAAe,2BAA2B,CAAA;AACvD,eAAO,MAAM,iBAAiB,QAAgD,CAAA;AAC9E,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAaxE"}

package/dist/config.js

@@ -0,0 +1,17 @@
+export const DEFAULT_API_URL = 'https://api.folotoy.cn';
+export const DEFAULT_MQTT_HOST = process.env.FOLOTOY_MQTT_HOST ?? 'f.qrc92.cn';
+export const DEFAULT_MQTT_PORT = 1883;
+export function flatToPluginConfig(flat) {
+    const flow = flat.flow ?? 'direct';
+    const auth = flow === 'api'
+        ? { flow: 'api', api_url: flat.api_url ?? DEFAULT_API_URL, api_key: flat.api_key ?? '', toy_sn: flat.toy_sn ?? '' }
+        : { flow: 'direct', toy_sn: flat.toy_sn ?? '', toy_key: flat.toy_key ?? '' };
+    return {
+        auth,
+        mqtt: {
+            host: flat.mqtt_host ?? DEFAULT_MQTT_HOST,
+            port: flat.mqtt_port ?? DEFAULT_MQTT_PORT,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAA;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,YAAY,CAAA;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAA;AAErC,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAA;IAClC,MAAM,IAAI,GAAG,IAAI,KAAK,KAAK;QACzB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE;QAC5H,CAAC,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAA;IAEvF,OAAO;QACL,IAAI;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,iBAAiB;YACzC,IAAI,EAAE,IAAI,CAAC,SAAS,IAAI,iBAAiB;SAC1C;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk/core';
+export declare function sendNotification({ text, accountId }: {
+    text: string;
+    accountId?: string;
+}): {
+    channel: string;
+    messageId: string;
+};
+declare const _default: (api: OpenClawPluginApi) => void;
+export default _default;
+//# 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,KAAK,EAAE,iBAAiB,EAAiB,MAAM,0BAA0B,CAAA;AAgOhF,wBAAgB,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;;;EAczF;yBAEe,KAAK,iBAAiB;AAAtC,wBAEC"}

package/dist/index.js

@@ -0,0 +1,208 @@
+import { resolveCredentials, createMqttClient, buildInboundTopic, buildOutboundTopic, buildNotificationTopic } from './mqtt.js';
+import { DEFAULT_MQTT_HOST, DEFAULT_MQTT_PORT, flatToPluginConfig } from './config.js';
+/** Pick a soothing acknowledgment that loosely matches the input. */
+function pickSoothingReply(text) {
+    const t = text.toLowerCase();
+    if (/难过|伤心|哭|不开心|sad|upset|cry/.test(t))
+        return '抱抱你，我在听呢，让我想想怎么帮你。';
+    if (/害怕|恐惧|怕|scared|afraid/.test(t))
+        return '别怕，有我在呢，让我想一想。';
+    if (/生气|愤怒|烦|angry|mad/.test(t))
+        return '我理解你的感受，让我来帮你想想办法。';
+    if (/累|疲|困|tired|exhausted/.test(t))
+        return '辛苦了，休息一下，我来帮你想。';
+    if (/无聊|没意思|bored/.test(t))
+        return '我来陪你聊聊吧，让我想想。';
+    if (/谢|感谢|thank/.test(t))
+        return '不客气呀，让我想想还能帮你什么。';
+    if (/你好|嗨|hello|hi|hey/.test(t))
+        return '你好呀！让我想想怎么回答你。';
+    if (/帮|help|怎么办/.test(t))
+        return '没问题，让我帮你想想办法。';
+    return '好的，让我想一想，马上回复你。';
+}
+// Per-account MQTT clients and msgId counters
+const activeClients = new Map();
+const folotoyChannel = {
+    id: 'folotoy',
+    meta: {
+        id: 'folotoy',
+        label: 'FoloToy',
+        selectionLabel: 'FoloToy',
+        docsPath: '/channels/folotoy',
+        blurb: 'Empower your FoloToy with OpenClaw AI capabilities.',
+    },
+    capabilities: {
+        chatTypes: ['direct'],
+    },
+    configSchema: {
+        schema: {
+            type: 'object',
+            properties: {
+                flow: { type: 'string', enum: ['direct', 'api'], default: 'direct' },
+                toy_sn: { type: 'string' },
+                toy_key: { type: 'string' },
+                api_url: { type: 'string', default: 'https://api.folotoy.cn' },
+                api_key: { type: 'string' },
+                mqtt_host: { type: 'string', default: DEFAULT_MQTT_HOST },
+                mqtt_port: { type: 'number', default: DEFAULT_MQTT_PORT },
+            },
+        },
+        uiHints: {
+            flow: { label: 'Auth Flow' },
+            toy_sn: { label: 'Toy SN' },
+            toy_key: { label: 'Toy Key', sensitive: true },
+            api_url: { label: 'API URL', placeholder: 'https://api.folotoy.com' },
+            api_key: { label: 'API Key', sensitive: true },
+            mqtt_host: { label: 'MQTT Host', placeholder: DEFAULT_MQTT_HOST },
+            mqtt_port: { label: 'MQTT Port' },
+        },
+    },
+    config: {
+        listAccountIds: (cfg) => {
+            const folotoy = cfg
+                .channels?.folotoy;
+            return folotoy ? ['default'] : [];
+        },
+        resolveAccount: (cfg, _accountId) => {
+            const folotoy = cfg
+                .channels?.folotoy;
+            return folotoy ?? {};
+        },
+    },
+    gateway: {
+        startAccount: async (ctx) => {
+            const { account, cfg, accountId, abortSignal, channelRuntime, log } = ctx;
+            if (!channelRuntime) {
+                log?.warn?.('channelRuntime not available — skipping MQTT connection');
+                return;
+            }
+            if (!account.toy_sn) {
+                log?.warn?.('toy_sn not configured — skipping MQTT connection');
+                return;
+            }
+            const mqttConfig = flatToPluginConfig(account);
+            log?.info?.(`Connecting to MQTT broker ${mqttConfig.mqtt.host}:${mqttConfig.mqtt.port}...`);
+            const credentials = await resolveCredentials(mqttConfig);
+            const client = await createMqttClient(mqttConfig, credentials);
+            const inboundTopic = buildInboundTopic(credentials.toy_sn);
+            const outboundTopic = buildOutboundTopic(credentials.toy_sn);
+            activeClients.set(accountId, { client, toy_sn: credentials.toy_sn, nextMsgId: 1 });
+            log?.info?.(`Connected to MQTT broker, subscribed to ${inboundTopic}`);
+            client.subscribe(inboundTopic, (err) => {
+                if (err)
+                    log?.error?.(`Failed to subscribe: ${err.message}`);
+            });
+            client.on('message', (_topic, payload) => {
+                let msg;
+                try {
+                    msg = JSON.parse(payload.toString());
+                }
+                catch {
+                    return;
+                }
+                if (msg.identifier !== 'chat_input' || typeof msg.inputParams?.text !== 'string')
+                    return;
+                const { msgId, inputParams: { text, recording_id } } = msg;
+                let order = 1;
+                // Send a quick soothing acknowledgment before AI processing (order=1).
+                // AI replies continue from order=2.
+                const ackMsg = {
+                    msgId,
+                    identifier: 'chat_output',
+                    outParams: { content: pickSoothingReply(text), recording_id, order, is_finished: false },
+                };
+                client.publish(outboundTopic, JSON.stringify(ackMsg));
+                const inboundCtx = channelRuntime.reply.finalizeInboundContext({
+                    Body: text,
+                    From: credentials.toy_sn,
+                    To: credentials.toy_sn,
+                    SessionKey: `folotoy-${accountId}-${credentials.toy_sn}`,
+                    AccountId: accountId,
+                    Provider: 'folotoy',
+                });
+                // dispatch and send finish message when done
+                void (async () => {
+                    try {
+                        await channelRuntime.reply.dispatchReplyWithBufferedBlockDispatcher({
+                            ctx: inboundCtx,
+                            cfg,
+                            dispatcherOptions: {
+                                deliver: async (replyPayload) => {
+                                    if (!replyPayload.text)
+                                        return;
+                                    order++;
+                                    const outMsg = {
+                                        msgId,
+                                        identifier: 'chat_output',
+                                        outParams: { content: replyPayload.text, recording_id, order, is_finished: false },
+                                    };
+                                    client.publish(outboundTopic, JSON.stringify(outMsg));
+                                },
+                                onError: (err) => log?.error?.(`Dispatch error: ${String(err)}`),
+                            },
+                        });
+                    }
+                    finally {
+                        order++;
+                        const finishMsg = {
+                            msgId,
+                            identifier: 'chat_output',
+                            outParams: { content: '', recording_id, order, is_finished: true },
+                        };
+                        client.publish(outboundTopic, JSON.stringify(finishMsg));
+                    }
+                })();
+            });
+            // Keep the account alive until aborted
+            return new Promise((resolve) => {
+                abortSignal.addEventListener('abort', () => {
+                    activeClients.delete(accountId);
+                    client.end();
+                    log?.info?.('MQTT client disconnected');
+                    resolve();
+                });
+            });
+        },
+        stopAccount: async (_ctx) => {
+            // cleanup handled by abortSignal listener in startAccount
+        },
+    },
+    outbound: {
+        deliveryMode: 'direct',
+        sendText: async ({ text, accountId }) => {
+            const key = accountId ?? 'default';
+            const entry = activeClients.get(key);
+            if (!entry)
+                throw new Error(`No active MQTT client for account "${key}"`);
+            const outboundTopic = buildOutboundTopic(entry.toy_sn);
+            const msgId = entry.nextMsgId++;
+            const outMsg = {
+                msgId,
+                identifier: 'chat_output',
+                outParams: { content: text },
+            };
+            entry.client.publish(outboundTopic, JSON.stringify(outMsg));
+            return { channel: 'folotoy', messageId: String(msgId) };
+        },
+    },
+};
+export function sendNotification({ text, accountId }) {
+    const key = accountId ?? 'default';
+    const entry = activeClients.get(key);
+    if (!entry)
+        throw new Error(`No active MQTT client for account "${key}"`);
+    const notificationTopic = buildNotificationTopic(entry.toy_sn);
+    const msgId = entry.nextMsgId++;
+    const notifMsg = {
+        msgId,
+        identifier: 'send_notification',
+        outParams: { text },
+    };
+    entry.client.publish(notificationTopic, JSON.stringify(notifMsg));
+    return { channel: 'folotoy', messageId: String(msgId) };
+}
+export default (api) => {
+    api.registerChannel({ plugin: folotoyChannel });
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAC/H,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAsBtF,qEAAqE;AACrE,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IAE5B,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,OAAO,oBAAoB,CAAA;IAC7B,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO,gBAAgB,CAAA;IACzB,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,OAAO,oBAAoB,CAAA;IAC7B,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,OAAO,iBAAiB,CAAA;IAC1B,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACxB,OAAO,eAAe,CAAA;IACxB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACtB,OAAO,kBAAkB,CAAA;IAC3B,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,OAAO,gBAAgB,CAAA;IACzB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACtB,OAAO,eAAe,CAAA;IAExB,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED,8CAA8C;AAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqE,CAAA;AAElG,MAAM,cAAc,GAAqC;IACvD,EAAE,EAAE,SAAS;IACb,IAAI,EAAE;QACJ,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,cAAc,EAAE,SAAS;QACzB,QAAQ,EAAE,mBAAmB;QAC7B,KAAK,EAAE,qDAAqD;KAC7D;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,CAAC,QAAQ,CAAC;KACtB;IACD,YAAY,EAAE;QACZ,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE;gBACpE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,wBAAwB,EAAE;gBAC9D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE;gBACzD,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,EAAE;aAC1D;SACF;QACD,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;YAC5B,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC3B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;YAC9C,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACrE,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;YAC9C,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE;YACjE,SAAS,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;SAClC;KACF;IACD,MAAM,EAAE;QACN,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,OAAO,GAAI,GAAgF;iBAC9F,QAAQ,EAAE,OAAO,CAAA;YACpB,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACnC,CAAC;QACD,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE;YAClC,MAAM,OAAO,GAAI,GAAgF;iBAC9F,QAAQ,EAAE,OAAO,CAAA;YACpB,OAAO,OAAO,IAAK,EAAwB,CAAA;QAC7C,CAAC;KACF;IACD,OAAO,EAAE;QACP,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,CAAA;YAEzE,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,GAAG,EAAE,IAAI,EAAE,CAAC,yDAAyD,CAAC,CAAA;gBACtE,OAAM;YACR,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,GAAG,EAAE,IAAI,EAAE,CAAC,kDAAkD,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;YAC9C,GAAG,EAAE,IAAI,EAAE,CAAC,6BAA6B,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAA;YAC3F,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAA;YACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;YAC9D,MAAM,YAAY,GAAG,iBAAiB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YAC1D,MAAM,aAAa,GAAG,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;YAE5D,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAA;YAClF,GAAG,EAAE,IAAI,EAAE,CAAC,2CAA2C,YAAY,EAAE,CAAC,CAAA;YAEtE,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;gBACrC,IAAI,GAAG;oBAAE,GAAG,EAAE,KAAK,EAAE,CAAC,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;YAC9D,CAAC,CAAC,CAAA;YAEF,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;gBACvC,IAAI,GAAmB,CAAA;gBACvB,IAAI,CAAC;oBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAmB,CAAA;gBACxD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAM;gBACR,CAAC;gBACD,IAAI,GAAG,CAAC,UAAU,KAAK,YAAY,IAAI,OAAO,GAAG,CAAC,WAAW,EAAE,IAAI,KAAK,QAAQ;oBAAE,OAAM;gBAExF,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,GAAG,GAAG,CAAA;gBAC1D,IAAI,KAAK,GAAG,CAAC,CAAA;gBAEb,uEAAuE;gBACvE,oCAAoC;gBACpC,MAAM,MAAM,GAAoB;oBAC9B,KAAK;oBACL,UAAU,EAAE,aAAa;oBACzB,SAAS,EAAE,EAAE,OAAO,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;iBACzF,CAAA;gBACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;gBAErD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,sBAAsB,CAAC;oBAC7D,IAAI,EAAE,IAAI;oBACV,IAAI,EAAE,WAAW,CAAC,MAAM;oBACxB,EAAE,EAAE,WAAW,CAAC,MAAM;oBACtB,UAAU,EAAE,WAAW,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE;oBACxD,SAAS,EAAE,SAAS;oBACpB,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAA;gBAEF,6CAA6C;gBAC7C,KAAK,CAAC,KAAK,IAAI,EAAE;oBACf,IAAI,CAAC;wBACH,MAAM,cAAc,CAAC,KAAK,CAAC,wCAAwC,CAAC;4BAClE,GAAG,EAAE,UAAU;4BACf,GAAG;4BACH,iBAAiB,EAAE;gCACjB,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE;oCAC9B,IAAI,CAAC,YAAY,CAAC,IAAI;wCAAE,OAAM;oCAC9B,KAAK,EAAE,CAAA;oCACP,MAAM,MAAM,GAAoB;wCAC9B,KAAK;wCACL,UAAU,EAAE,aAAa;wCACzB,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE;qCACnF,CAAA;oCACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;gCACvD,CAAC;gCACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,mBAAmB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;6BACjE;yBACF,CAAC,CAAA;oBACJ,CAAC;4BAAS,CAAC;wBACT,KAAK,EAAE,CAAA;wBACP,MAAM,SAAS,GAAoB;4BACjC,KAAK;4BACL,UAAU,EAAE,aAAa;4BACzB,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;yBACnE,CAAA;wBACD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;oBAC1D,CAAC;gBACH,CAAC,CAAC,EAAE,CAAA;YACN,CAAC,CAAC,CAAA;YAEF,uCAAuC;YACvC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACnC,WAAW,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;oBACzC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;oBAC/B,MAAM,CAAC,GAAG,EAAE,CAAA;oBACZ,GAAG,EAAE,IAAI,EAAE,CAAC,0BAA0B,CAAC,CAAA;oBACvC,OAAO,EAAE,CAAA;gBACX,CAAC,CAAC,CAAA;YACJ,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1B,0DAA0D;QAC5D,CAAC;KACF;IAED,QAAQ,EAAE;QACR,YAAY,EAAE,QAAQ;QACtB,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;YACtC,MAAM,GAAG,GAAG,SAAS,IAAI,SAAS,CAAA;YAClC,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACpC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,GAAG,CAAC,CAAA;YAEzE,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACtD,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;YAC/B,MAAM,MAAM,GAAG;gBACb,KAAK;gBACL,UAAU,EAAE,aAAsB;gBAClC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;aAC7B,CAAA;YACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;YAC3D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;QACzD,CAAC;KACF;CACF,CAAA;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAwC;IACxF,MAAM,GAAG,GAAG,SAAS,IAAI,SAAS,CAAA;IAClC,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,GAAG,CAAC,CAAA;IAEzE,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,CAAA;IAC/B,MAAM,QAAQ,GAAwB;QACpC,KAAK;QACL,UAAU,EAAE,mBAAmB;QAC/B,SAAS,EAAE,EAAE,IAAI,EAAE;KACpB,CAAA;IACD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;AACzD,CAAC;AAED,eAAe,CAAC,GAAsB,EAAE,EAAE;IACxC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;AACjD,CAAC,CAAA"}

package/dist/mqtt.d.ts

@@ -0,0 +1,13 @@
+import { MqttClient } from 'mqtt';
+import { PluginConfig } from './config.js';
+export type MqttCredentials = {
+    username: string;
+    password: string;
+    toy_sn: string;
+};
+export declare function resolveCredentials(config: PluginConfig): Promise<MqttCredentials>;
+export declare function buildInboundTopic(toy_sn: string): string;
+export declare function buildOutboundTopic(toy_sn: string): string;
+export declare function buildNotificationTopic(toy_sn: string): string;
+export declare function createMqttClient(config: PluginConfig, credentials: MqttCredentials): Promise<MqttClient>;
+//# sourceMappingURL=mqtt.d.ts.map

package/dist/mqtt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mqtt.d.ts","sourceRoot":"","sources":["../src/mqtt.ts"],"names":[],"mappings":"AAAA,OAAa,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AACvC,OAAO,EAAoC,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAgCD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAKvF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB9G"}

package/dist/mqtt.js

@@ -0,0 +1,58 @@
+import mqtt from 'mqtt';
+async function fetchCredentials(auth) {
+    const res = await fetch(`${auth.api_url}/v1/openapi/create_mqtt_token`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${auth.api_key}`,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ toy_sn: auth.toy_sn }),
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch MQTT token: ${res.status} ${res.statusText}`);
+    }
+    const data = await res.json();
+    return {
+        username: data.username,
+        password: data.password,
+        toy_sn: auth.toy_sn,
+    };
+}
+function directCredentials(auth) {
+    return {
+        username: auth.toy_sn,
+        password: auth.toy_key,
+        toy_sn: auth.toy_sn,
+    };
+}
+export async function resolveCredentials(config) {
+    if (config.auth.flow === 'api') {
+        return fetchCredentials(config.auth);
+    }
+    return directCredentials(config.auth);
+}
+export function buildInboundTopic(toy_sn) {
+    return `/openapi/folotoy/${toy_sn}/thing/command/call`;
+}
+export function buildOutboundTopic(toy_sn) {
+    return `/openapi/folotoy/${toy_sn}/thing/command/callAck`;
+}
+export function buildNotificationTopic(toy_sn) {
+    return `/openapi/folotoy/${toy_sn}/thing/event/post`;
+}
+export async function createMqttClient(config, credentials) {
+    const { host, port } = config.mqtt;
+    const { username, password } = credentials;
+    return new Promise((resolve, reject) => {
+        const clientId = `openapi:${username}`;
+        const client = mqtt.connect(`mqtt://${host}:${port}`, {
+            clientId,
+            username: `openapi:${username}`,
+            password,
+            clean: true,
+        });
+        client.once('connect', () => resolve(client));
+        client.once('error', reject);
+    });
+}
+//# sourceMappingURL=mqtt.js.map

package/dist/mqtt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mqtt.js","sourceRoot":"","sources":["../src/mqtt.ts"],"names":[],"mappings":"AAAA,OAAO,IAAoB,MAAM,MAAM,CAAA;AASvC,KAAK,UAAU,gBAAgB,CAAC,IAAqB;IACnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,+BAA+B,EAAE;QACtE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE;YACzC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;KAC9C,CAAC,CAAA;IAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;IAChF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA4C,CAAA;IACvE,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAA;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAqB;IAC9C,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoB;IAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,oBAAoB,MAAM,qBAAqB,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,OAAO,oBAAoB,MAAM,mBAAmB,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAoB,EAAE,WAA4B;IACvF,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IAClC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAA;IAE1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,WAAW,QAAQ,EAAE,CAAA;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,EAAE;YACpD,QAAQ;YACR,QAAQ,EAAE,WAAW,QAAQ,EAAE;YAC/B,QAAQ;YACR,KAAK,EAAE,IAAI;SACZ,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@folotoy/folotoy-openclaw-plugin",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Empower your FoloToy with OpenClaw AI capabilities.",
   "keywords": [
     "folotoy",
@@ -22,12 +22,18 @@
   },
   "main": "./src/index.ts",
   "types": "./src/index.ts",
+  "bin": {
+    "folotoy-openclaw-plugin": "./bin/folotoy.mjs"
+  },
   "files": [
     "src",
+    "bin",
+    "dist",
     "openclaw.plugin.json"
   ],
   "scripts": {
     "build": "tsc",
+    "prepublishOnly": "npm run build",
     "dev": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
@@ -35,7 +41,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "mqtt": "^5.10.1"
+    "mqtt": "^5.10.1",
+    "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {
     "@types/node": "^22.13.10",

package/src/cli/install.ts

@@ -0,0 +1,147 @@
+import { execSync } from 'node:child_process'
+import qrcode from 'qrcode-terminal'
+import { DEFAULT_MQTT_HOST, DEFAULT_MQTT_PORT } from '../config.js'
+
+const PAIR_API_BASE = process.env.PAIR_API_BASE ?? 'https://pair.folotoy.cn'
+const POLL_INTERVAL_MS = 3000
+const POLL_TIMEOUT_MS = 300_000 // 5 minutes
+
+// ── Types ──────────────────────────────────────────────
+
+type CreateSessionResponse = {
+  session_id: string
+  pair_url: string
+  expires_at: string
+}
+
+type PollResponse =
+  | { status: 'pending' }
+  | { status: 'completed'; toy_sn: string; toy_key: string; mqtt_host?: string; mqtt_port?: number }
+  | { status: 'expired' }
+
+// ── Helpers ────────────────────────────────────────────
+
+function checkOpenClaw(): void {
+  try {
+    execSync('openclaw --version', { stdio: 'pipe' })
+  } catch {
+    console.error('Error: openclaw is not installed or not in PATH.')
+    console.error('Install it first: npm i -g openclaw')
+    process.exit(1)
+  }
+}
+
+function installPlugin(): void {
+  try {
+    const list = execSync('openclaw plugins list', { stdio: 'pipe' }).toString()
+    if (list.includes('folotoy-openclaw-plugin')) {
+      return // already installed
+    }
+  } catch {
+    // ignore
+  }
+  console.log('Installing FoloToy plugin...')
+  execSync('openclaw plugins install @folotoy/folotoy-openclaw-plugin', { stdio: 'inherit' })
+}
+
+async function createSession(): Promise<CreateSessionResponse> {
+  const res = await fetch(`${PAIR_API_BASE}/api/pair`, { method: 'POST' })
+  if (!res.ok) throw new Error(`Failed to create pairing session (HTTP ${res.status})`)
+  return res.json() as Promise<CreateSessionResponse>
+}
+
+function displayQR(url: string): void {
+  qrcode.generate(url, { small: true }, (qr: string) => {
+    console.log(qr)
+  })
+  console.log(`Or open this URL on your phone: ${url}\n`)
+}
+
+async function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms))
+}
+
+async function pollSession(sessionId: string): Promise<PollResponse & { status: 'completed' }> {
+  const deadline = Date.now() + POLL_TIMEOUT_MS
+  const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+  let i = 0
+
+  while (Date.now() < deadline) {
+    process.stdout.write(`\r${frames[i++ % frames.length]} Waiting for pairing...`)
+
+    const res = await fetch(`${PAIR_API_BASE}/api/pair/${sessionId}`)
+    if (!res.ok) throw new Error(`Poll failed (HTTP ${res.status})`)
+    const data = (await res.json()) as PollResponse
+
+    if (data.status === 'completed') {
+      process.stdout.write('\r\x1b[32m✓\x1b[0m Paired successfully!        \n')
+      return data as PollResponse & { status: 'completed' }
+    }
+    if (data.status === 'expired') {
+      process.stdout.write('\r')
+      throw new Error('Pairing session expired. Please try again.')
+    }
+
+    await sleep(POLL_INTERVAL_MS)
+  }
+  throw new Error('Pairing timed out after 5 minutes.')
+}
+
+function writeConfig(result: { toy_sn: string; toy_key: string; mqtt_host?: string; mqtt_port?: number }): void {
+  execSync(`openclaw config set channels.folotoy.flow direct`, { stdio: 'pipe' })
+  execSync(`openclaw config set channels.folotoy.toy_sn ${result.toy_sn}`, { stdio: 'pipe' })
+  execSync(`openclaw config set channels.folotoy.toy_key ${result.toy_key}`, { stdio: 'pipe' })
+
+  const mqttHost = result.mqtt_host ?? DEFAULT_MQTT_HOST
+  const mqttPort = result.mqtt_port ?? DEFAULT_MQTT_PORT
+  execSync(`openclaw config set channels.folotoy.mqtt_host ${mqttHost}`, { stdio: 'pipe' })
+  execSync(`openclaw config set channels.folotoy.mqtt_port ${mqttPort}`, { stdio: 'pipe' })
+}
+
+// ── Main ───────────────────────────────────────────────
+
+async function main() {
+  const command = process.argv[2]
+
+  if (command !== 'install') {
+    console.log('Usage: npx @folotoy/folotoy-openclaw-plugin install')
+    process.exit(command ? 1 : 0)
+  }
+
+  console.log('🧸 FoloToy OpenClaw Plugin Installer\n')
+
+  // Step 1: check prerequisites
+  console.log('Checking openclaw...')
+  checkOpenClaw()
+  console.log('✓ openclaw found\n')
+
+  // Step 2: install plugin if not present
+  installPlugin()
+
+  // Step 3: create pairing session
+  console.log('Creating pairing session...\n')
+  const session = await createSession()
+
+  // Step 4: display QR code
+  console.log('Scan this QR code with your phone,')
+  console.log('then scan your toy\'s QR code on the phone:\n')
+  displayQR(session.pair_url)
+
+  // Step 5: poll for result
+  const result = await pollSession(session.session_id)
+
+  // Step 6: write config
+  console.log('\nWriting configuration...')
+  writeConfig(result)
+
+  // Step 7: done
+  console.log('\n\x1b[32m✓ FoloToy plugin installed and configured!\x1b[0m')
+  console.log(`  Toy SN:    ${result.toy_sn}`)
+  console.log(`  MQTT Host: ${result.mqtt_host ?? DEFAULT_MQTT_HOST}`)
+  console.log('\nRestart the gateway to apply: openclaw gateway start --force')
+}
+
+main().catch((err) => {
+  console.error(`\n\x1b[31mError:\x1b[0m ${err instanceof Error ? err.message : String(err)}`)
+  process.exit(1)
+})

package/src/cli/qrcode-terminal.d.ts

@@ -0,0 +1,3 @@
+declare module 'qrcode-terminal' {
+  export function generate(text: string, opts?: { small?: boolean }, cb?: (qr: string) => void): void
+}