@dailyflows/openclaw-dailyflows 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dailyflows Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+# Dailyflows Plugin for OpenClaw
+
+This directory is designed to be maintained as a standalone open-source repository (for example `dailyflows-plugin`). You can maintain only the plugin without maintaining a full OpenClaw fork.
+
+For Chinese documentation, see [README.zh-CN.md](./README.zh-CN.md).
+
+## 1) Install OpenClaw (official)
+
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash
+```
+
+Or:
+
+```bash
+npm install -g openclaw@latest
+```
+
+Initial setup:
+
+```bash
+openclaw onboard --install-daemon
+openclaw gateway status
+```
+
+If you see `Runtime: running` + `RPC probe: ok`, your Gateway is healthy.
+
+## 2) Install the Dailyflows plugin
+
+### Option A: Install from npm (recommended)
+
+```bash
+openclaw plugins install @dailyflows/dailyflows
+openclaw gateway restart
+```
+
+### Option B: Install from local source (development)
+
+```bash
+openclaw plugins install -l ./dailyflows-plugin
+openclaw gateway restart
+```
+
+> You usually install the plugin only once. Reinstall only when you switch machines/profiles or reset config.
+
+## 3) Minimal config
+
+```json5
+{
+  channels: {
+    dailyflows: {
+      webhookPath: "/dailyflows/webhook",
+      accounts: {
+        default: {
+          enabled: true,
+          outboundUrl: "https://dailyflows.example.com/openclaw/outbound",
+          outboundToken: "REPLACE_ME"
+        }
+      }
+    }
+  },
+  plugins: {
+    entries: {
+      dailyflows: { enabled: true }
+    }
+  }
+}
+```
+
+Use environment variables for webhook secrets:
+
+```bash
+export DAILYFLOWS_WEBHOOK_SECRET="replace-with-random"
+# Optional: per-account override
+export DAILYFLOWS_WEBHOOK_SECRET_DEFAULT="replace-with-random"
+```
+
+## 4) Pair Dailyflows App with OpenClaw
+
+The Dailyflows cloud must call back into your Gateway, so you need a public HTTPS URL (Tailscale Funnel is a common choice).
+
+Example:
+
+```bash
+openclaw config set gateway.mode local
+openclaw config set gateway.bind loopback
+openclaw config set gateway.auth.mode password
+openclaw config set gateway.auth.password "<strong-password>"
+openclaw config set gateway.tailscale.mode funnel
+openclaw gateway restart
+```
+
+Pairing flow:
+
+1. Open `https://<gateway-host>/dailyflows/pair`
+2. In Dailyflows App, go to `Voice Assistant -> OpenClaw`
+3. Scan the QR code
+
+You can also print the QR in CLI:
+
+```bash
+openclaw dailyflows pair --gateway-url https://<your-funnel-url>
+```
+
+## 5) Send messages
+
+After pairing, send text or attachments to OpenClaw in the Dailyflows chat.
+
+Message path:
+
+1. Dailyflows -> `POST /dailyflows/webhook`
+2. OpenClaw agent processes the message
+3. Gateway -> `outboundUrl` sends the reply back to Dailyflows
+
+Manual outbound check from CLI:
+
+```bash
+openclaw message send --channel dailyflows --target <conversationId> --message "hello from openclaw"
+```
+
+## 6) Troubleshooting commands
+
+```bash
+openclaw gateway status
+openclaw health
+openclaw status --deep
+openclaw plugins list
+```
+
+Focus checks:
+
+- Model authentication is completed (`onboard`)
+- Gateway is publicly reachable via HTTPS
+- `plugins.entries.dailyflows.enabled` is `true`
+- `channels.dailyflows.accounts.default` has valid `outboundUrl/outboundToken/webhookSecret`
+
+---
+
+## 7) Maintainer workflow (standalone repo)
+
+Recommended structure (already included):
+
+- `src/` plugin source
+- `openclaw.plugin.json` plugin manifest
+- `package.json` npm + OpenClaw plugin metadata
+- `.github/workflows/ci.yml` CI workflow
+- `scripts/release.sh` one-command publish script
+
+Install and verify:
+
+```bash
+pnpm install
+pnpm check
+```
+
+Publish to npm:
+
+```bash
+npm login
+pnpm release
+```
+
+If CI already validated and you want to skip local tests:
+
+```bash
+SKIP_TESTS=1 pnpm release
+```
+
+## 8) One-click export as standalone Git repo
+
+This directory includes two helper scripts:
+
+```bash
+# Local-only init (git init + first commit)
+./scripts/init-standalone-local.sh
+
+# Init and attach GitHub remote (optional --push)
+./scripts/init-standalone-with-remote.sh git@github.com:<you>/<repo>.git main
+./scripts/init-standalone-with-remote.sh git@github.com:<you>/<repo>.git main --push
+```
+
+If you already ran `git init` elsewhere, the second script reuses the existing repository and only updates `origin`.

package/README.zh-CN.md

@@ -0,0 +1,182 @@
+# Dailyflows Plugin for OpenClaw
+
+英文版文档请见 [README.md](./README.md)。
+
+这个目录可以直接独立成一个开源仓库（例如 `dailyflows-plugin`），只维护插件，不需要维护整份 OpenClaw fork。
+
+## 1) 用户侧：安装 OpenClaw（官方）
+
+```bash
+curl -fsSL https://openclaw.ai/install.sh | bash
+```
+
+或：
+
+```bash
+npm install -g openclaw@latest
+```
+
+首次初始化：
+
+```bash
+openclaw onboard --install-daemon
+openclaw gateway status
+```
+
+看到 `Runtime: running` + `RPC probe: ok`，说明 Gateway 正常。
+
+## 2) 用户侧：安装 Dailyflows 插件
+
+### 方式 A：npm 安装（推荐）
+
+```bash
+openclaw plugins install @dailyflows/dailyflows
+openclaw gateway restart
+```
+
+### 方式 B：本地源码安装（开发调试）
+
+```bash
+openclaw plugins install -l ./dailyflows-plugin
+openclaw gateway restart
+```
+
+> 插件一般只安装一次。除非换机器、清理配置、切 profile，平时不需要重复安装。
+
+## 3) 用户侧：最小配置
+
+```json5
+{
+  channels: {
+    dailyflows: {
+      webhookPath: "/dailyflows/webhook",
+      accounts: {
+        default: {
+          enabled: true,
+          outboundUrl: "https://dailyflows.example.com/openclaw/outbound",
+          outboundToken: "REPLACE_ME"
+        }
+      }
+    }
+  },
+  plugins: {
+    entries: {
+      dailyflows: { enabled: true }
+    }
+  }
+}
+```
+
+建议用环境变量配置 webhook secret：
+
+```bash
+export DAILYFLOWS_WEBHOOK_SECRET="replace-with-random"
+# 可选，按 accountId 覆盖
+export DAILYFLOWS_WEBHOOK_SECRET_DEFAULT="replace-with-random"
+```
+
+## 4) 用户侧：扫码绑定（Dailyflows App -> OpenClaw）
+
+Dailyflows 云端需要回调你的 Gateway，所以要有公网 HTTPS 地址（常见方案：Tailscale Funnel）。
+
+示例：
+
+```bash
+openclaw config set gateway.mode local
+openclaw config set gateway.bind loopback
+openclaw config set gateway.auth.mode password
+openclaw config set gateway.auth.password "<strong-password>"
+openclaw config set gateway.tailscale.mode funnel
+openclaw gateway restart
+```
+
+绑定流程：
+
+1. 打开 `https://<gateway-host>/dailyflows/pair`
+2. Dailyflows App 进入 `Voice Assistant -> OpenClaw`
+3. 扫码完成绑定
+
+也可以在终端生成二维码：
+
+```bash
+openclaw dailyflows pair --gateway-url https://<your-funnel-url>
+```
+
+## 5) 用户侧：发送消息
+
+绑定后，直接在 Dailyflows 聊天中给 OpenClaw 发文字/附件即可。
+
+链路：
+
+1. Dailyflows -> `POST /dailyflows/webhook`
+2. OpenClaw Agent 处理
+3. Gateway -> `outboundUrl` 回发 Dailyflows
+
+手动验证（从 OpenClaw 主动发消息）：
+
+```bash
+openclaw message send --channel dailyflows --target <conversationId> --message "hello from openclaw"
+```
+
+## 6) 排查命令
+
+```bash
+openclaw gateway status
+openclaw health
+openclaw status --deep
+openclaw plugins list
+```
+
+重点检查：
+
+- 模型认证是否完成（onboard）
+- Gateway 是否可公网 HTTPS 访问
+- `plugins.entries.dailyflows.enabled` 是否为 `true`
+- `channels.dailyflows.accounts.default` 的 `outboundUrl/outboundToken/webhookSecret` 是否有效
+
+---
+
+## 7) 维护者侧：把本目录作为独立仓库
+
+建议结构（本目录已包含）：
+
+- `src/` 插件源码
+- `openclaw.plugin.json` 插件声明
+- `package.json` 发布配置（npm + OpenClaw 元信息）
+- `.github/workflows/ci.yml` 持续集成
+- `scripts/release.sh` 一键发布脚本
+
+安装依赖与测试：
+
+```bash
+pnpm install
+pnpm check
+```
+
+发布到 npm：
+
+```bash
+npm login
+pnpm release
+```
+
+如果你已经在 CI 里跑过测试，想跳过本地测试：
+
+```bash
+SKIP_TESTS=1 pnpm release
+```
+
+## 8) 一键导出为独立 Git 仓库
+
+本目录已内置两个脚本：
+
+```bash
+# 仅本地初始化（git init + 首次 commit）
+./scripts/init-standalone-local.sh
+
+# 初始化并绑定 GitHub 远端（可选 --push 直接推送）
+./scripts/init-standalone-with-remote.sh git@github.com:<you>/<repo>.git main
+./scripts/init-standalone-with-remote.sh git@github.com:<you>/<repo>.git main --push
+```
+
+如果你已经在别处 `git init` 过，第二个脚本会复用已有仓库，只更新 `origin`。

package/index.ts

@@ -0,0 +1,33 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { dailyflowsPlugin } from "./src/channel.js";
+import { registerDailyflowsCli } from "./src/cli.js";
+import { createDailyflowsPairingRoute } from "./src/pairing-http.js";
+import { setDailyflowsRuntime } from "./src/runtime.js";
+import { createDailyflowsUnpairRoute } from "./src/unpair-http.js";
+import { createDailyflowsWebhookHandler } from "./src/webhook.js";
+
+const plugin = {
+  id: "dailyflows",
+  name: "Dailyflows",
+  description: "Dailyflows webhook channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setDailyflowsRuntime(api.runtime);
+    api.registerChannel({ plugin: dailyflowsPlugin });
+    api.registerHttpHandler(createDailyflowsWebhookHandler(api));
+    api.registerHttpRoute({
+      path: "/dailyflows/pair",
+      handler: createDailyflowsPairingRoute(api),
+    });
+    api.registerHttpRoute({
+      path: "/dailyflows/unpair",
+      handler: createDailyflowsUnpairRoute(api),
+    });
+    api.registerCli(({ program, config }) => registerDailyflowsCli({ program, config }), {
+      commands: ["dailyflows"],
+    });
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "dailyflows",
+  "channels": ["dailyflows"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@dailyflows/openclaw-dailyflows",
+  "version": "1.0.0",
+  "description": "Dailyflows webhook channel plugin for OpenClaw",
+  "license": "MIT",
+  "type": "module",
+  "main": "index.ts",
+  "packageManager": "pnpm@8.14.3",
+  "keywords": [
+    "openclaw",
+    "dailyflows",
+    "plugin",
+    "channel",
+    "webhook"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "src/**",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.2.1"
+  },
+  "devDependencies": {
+    "openclaw": "^2026.2.1",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "pack:check": "npm pack --dry-run",
+    "check": "pnpm test && pnpm pack:check",
+    "release": "bash ./scripts/release.sh"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "channel": {
+      "id": "dailyflows",
+      "label": "Dailyflows",
+      "selectionLabel": "Dailyflows (Webhook)",
+      "docsPath": "/channels/dailyflows",
+      "docsLabel": "dailyflows",
+      "blurb": "Dailyflows webhook channel.",
+      "order": 90,
+      "aliases": [
+        "dailyflow"
+      ]
+    },
+    "install": {
+      "npmSpec": "@dailyflows/openclaw-dailyflows",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/src/channel.ts

@@ -0,0 +1,86 @@
+import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk";
+import type {
+  DailyflowsChannelPlugin,
+  DailyflowsOutboundContext,
+  DailyflowsOutboundResult,
+} from "./types.js";
+import { listDailyflowsAccountIds, resolveDailyflowsAccount } from "./config.js";
+import { sendDailyflowsMessage } from "./send.js";
+
+const meta = {
+  id: "dailyflows",
+  label: "Dailyflows",
+  selectionLabel: "Dailyflows (Webhook)",
+  detailLabel: "Dailyflows",
+  docsPath: "/channels/dailyflows",
+  docsLabel: "dailyflows",
+  blurb: "Dailyflows webhook channel.",
+  systemImage: "message.fill",
+};
+
+export const dailyflowsPlugin: DailyflowsChannelPlugin = {
+  id: "dailyflows",
+  meta,
+  capabilities: {
+    chatTypes: ["direct", "group"],
+    reactions: false,
+    threads: false,
+    media: true,
+    nativeCommands: false,
+    blockStreaming: true,
+  },
+  reload: { configPrefixes: ["channels.dailyflows"] },
+  config: {
+    listAccountIds: (cfg) => listDailyflowsAccountIds(cfg),
+    resolveAccount: (cfg, accountId) => resolveDailyflowsAccount(cfg, accountId),
+    defaultAccountId: () => DEFAULT_ACCOUNT_ID,
+    isEnabled: (account) => account.enabled,
+    isConfigured: (account) => Boolean(account.webhookSecret || account.outboundUrl),
+    unconfiguredReason: () => "Set channels.dailyflows.accounts.<id>.outboundUrl or webhookSecret",
+    describeAccount: (account) => ({
+      accountId: account.accountId,
+      name: account.name,
+      enabled: account.enabled,
+      configured: Boolean(account.webhookSecret || account.outboundUrl),
+      meta: {
+        outboundUrl: account.outboundUrl ?? null,
+      },
+    }),
+  },
+  outbound: {
+    deliveryMode: "direct",
+    resolveTarget: ({ to }) => {
+      const trimmed = to?.trim();
+      if (!trimmed) {
+        return {
+          ok: false,
+          error: new Error("Dailyflows target required. Provide a conversationId or senderId."),
+        };
+      }
+      return { ok: true, to: trimmed };
+    },
+    sendText: async (params: DailyflowsOutboundContext): Promise<DailyflowsOutboundResult> => {
+      const { cfg, to, text, accountId } = params;
+      return sendDailyflowsMessage({
+        cfg,
+        payload: {
+          accountId: accountId ?? DEFAULT_ACCOUNT_ID,
+          conversationId: to,
+          text,
+        },
+      });
+    },
+    sendMedia: async (params: DailyflowsOutboundContext): Promise<DailyflowsOutboundResult> => {
+      const { cfg, to, text, mediaUrl, accountId } = params;
+      return sendDailyflowsMessage({
+        cfg,
+        payload: {
+          accountId: accountId ?? DEFAULT_ACCOUNT_ID,
+          conversationId: to,
+          text: text?.trim() ? text : undefined,
+          attachments: mediaUrl ? [{ type: "file", url: mediaUrl }] : undefined,
+        },
+      });
+    },
+  },
+};

package/src/cli.ts

@@ -0,0 +1,82 @@
+import type { Command } from "commander";
+import qrcode from "qrcode-terminal";
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+
+import { normalizeGatewayUrl } from "./pairing.js";
+
+const DEFAULT_GATEWAY_PORT = 18789;
+
+function resolveLocalGatewayUrl(config: OpenClawConfig, override?: string) {
+  if (override?.trim()) {
+    return override.trim();
+  }
+  const port = typeof config.gateway?.port === "number" ? config.gateway.port : DEFAULT_GATEWAY_PORT;
+  return `http://127.0.0.1:${port}`;
+}
+
+export function registerDailyflowsCli(params: {
+  program: Command;
+  config: OpenClawConfig;
+}) {
+  const { program, config } = params;
+
+  const root = program
+    .command("dailyflows")
+    .description("Dailyflows pairing helpers")
+    .addHelpText("after", () => "\nDocs: https://docs.openclaw.ai/channels/dailyflows\n");
+
+  root
+    .command("pair")
+    .description("Generate a Dailyflows pairing QR from the running gateway")
+    .requiredOption("--gateway-url <url>", "Public HTTPS gateway URL (Tailscale Funnel)")
+    .option("--account <id>", "Dailyflows account id", "default")
+    .option("--gateway-http <url>", "Local gateway HTTP base URL")
+    .option("--json", "Print JSON only")
+    .action(async (options: { gatewayUrl: string; account: string; gatewayHttp?: string; json?: boolean }) => {
+      const publicUrl = normalizeGatewayUrl(options.gatewayUrl);
+      if (!publicUrl) {
+        throw new Error("--gateway-url must be a public https:// URL (Tailscale Funnel)");
+      }
+
+      const localGateway = resolveLocalGatewayUrl(config, options.gatewayHttp);
+      const pairingUrl = new URL("/dailyflows/pair", localGateway);
+      pairingUrl.searchParams.set("gatewayUrl", publicUrl);
+      pairingUrl.searchParams.set("accountId", options.account);
+      pairingUrl.searchParams.set("format", "json");
+
+      const res = await fetch(pairingUrl.toString());
+      if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Gateway pairing endpoint failed: ${res.status} ${res.statusText} ${text}`);
+      }
+      const payload = (await res.json()) as {
+        ok?: boolean;
+        error?: string;
+        gatewayUrl?: string;
+        accountId?: string;
+        pairCode?: string;
+        payload?: string;
+        expiresAt?: number;
+      };
+
+      if (!payload.ok || !payload.payload) {
+        throw new Error(payload.error || "Failed to generate pairing payload");
+      }
+
+      if (options.json) {
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(payload, null, 2));
+        return;
+      }
+
+      qrcode.generate(payload.payload, { small: true });
+      // eslint-disable-next-line no-console
+      console.log("\nDailyflows pairing payload:");
+      // eslint-disable-next-line no-console
+      console.log(payload.payload);
+      // eslint-disable-next-line no-console
+      console.log(`\nGateway URL: ${payload.gatewayUrl}`);
+      // eslint-disable-next-line no-console
+      console.log(`Pair code: ${payload.pairCode}`);
+    });
+}