@bajoseek/openclaw-bajoseek 0.1.0

package/index.ts

@@ -0,0 +1,25 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+
+import { bajoseekPlugin } from "./src/channel.js";
+import { setBajoseekRuntime } from "./src/runtime.js";
+
+const plugin = {
+  id: "bajoseek",
+  name: "Bajoseek",
+  description: "Bajoseek channel plugin",
+  configSchema: emptyPluginConfigSchema(),
+  register(api: OpenClawPluginApi) {
+    setBajoseekRuntime(api.runtime);
+    api.registerChannel({ plugin: bajoseekPlugin });
+  },
+};
+
+export default plugin;
+
+export { bajoseekPlugin } from "./src/channel.js";
+export { setBajoseekRuntime, getBajoseekRuntime } from "./src/runtime.js";
+export * from "./src/types.js";
+export * from "./src/config.js";
+export * from "./src/gateway.js";
+export * from "./src/outbound.js";

package/openclaw.plugin.json

@@ -0,0 +1,12 @@
+{
+  "id": "bajoseek",
+  "channels": ["bajoseek"],
+  "providerAuthEnvVars": {
+    "bajoseek": ["BAJOSEEK_BOT_ID", "BAJOSEEK_TOKEN"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@bajoseek/openclaw-bajoseek",
+  "version": "0.1.0",
+  "description": "Bajoseek channel plugin for OpenClaw — connect AI assistants to Bajoseek via WebSocket",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bajoseek/openclaw-bajoseek"
+  },
+  "keywords": [
+    "openclaw",
+    "bajoseek",
+    "channel-plugin",
+    "websocket",
+    "ai",
+    "chatbot"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "index.ts",
+    "tsconfig.json",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "id": "bajoseek",
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc || true",
+    "dev": "tsc --watch"
+  }
+}

package/src/channel.ts

@@ -0,0 +1,248 @@
+import {
+  type ChannelPlugin,
+  type OpenClawConfig,
+  applyAccountNameToChannelSection,
+  deleteAccountFromConfigSection,
+  setAccountEnabledInConfigSection,
+} from "openclaw/plugin-sdk";
+
+import type { ResolvedBajoseekAccount } from "./types.js";
+import { DEFAULT_ACCOUNT_ID, listBajoseekAccountIds, resolveBajoseekAccount, applyBajoseekAccountConfig, resolveDefaultBajoseekAccountId } from "./config.js";
+import { sendText } from "./outbound.js";
+import { startGateway } from "./gateway.js";
+import { bajoseekOnboardingAdapter } from "./onboarding.js";
+
+/**
+ * 简单的文本分块函数
+ */
+function chunkText(text: string, limit: number): string[] {
+  if (text.length <= limit) return [text];
+
+  const chunks: string[] = [];
+  let remaining = text;
+
+  while (remaining.length > 0) {
+    if (remaining.length <= limit) {
+      chunks.push(remaining);
+      break;
+    }
+
+    // 尝试在换行处分割
+    let splitAt = remaining.lastIndexOf("\n", limit);
+    if (splitAt <= 0 || splitAt < limit * 0.5) {
+      splitAt = remaining.lastIndexOf(" ", limit);
+    }
+    if (splitAt <= 0 || splitAt < limit * 0.5) {
+      splitAt = limit;
+    }
+
+    chunks.push(remaining.slice(0, splitAt));
+    remaining = remaining.slice(splitAt).trimStart();
+  }
+
+  return chunks;
+}
+
+export const bajoseekPlugin: ChannelPlugin<ResolvedBajoseekAccount> = {
+  id: "bajoseek",
+  meta: {
+    id: "bajoseek",
+    label: "Bajoseek",
+    selectionLabel: "Bajoseek",
+    docsPath: "/docs/channels/bajoseek",
+    blurb: "Connect to Bajoseek App via WebSocket",
+    order: 60,
+  },
+  capabilities: {
+    chatTypes: ["direct"],
+    media: false,
+    reactions: false,
+    threads: false,
+    blockStreaming: true,
+  },
+  agentPrompt: {
+    messageToolHints: () => [
+      "- Bajoseek is a chat channel. Always respond with text directly in the conversation.",
+      "- Do NOT write content to files or use file-writing tools to produce your response. Send all content as chat messages.",
+      "- If the user asks you to write or create content (stories, articles, code, etc.), output the full content directly in your reply text, do not save it to a file.",
+      "- Bajoseek does not support media attachments, reactions, or threads.",
+    ],
+  },
+  reload: { configPrefixes: ["channels.bajoseek"] },
+  onboarding: bajoseekOnboardingAdapter,
+
+  config: {
+    listAccountIds: (cfg) => listBajoseekAccountIds(cfg),
+    resolveAccount: (cfg, accountId) => resolveBajoseekAccount(cfg, accountId),
+    defaultAccountId: (cfg) => resolveDefaultBajoseekAccountId(cfg),
+    setAccountEnabled: ({ cfg, accountId, enabled }) =>
+      setAccountEnabledInConfigSection({
+        cfg,
+        sectionKey: "bajoseek",
+        accountId,
+        enabled,
+        allowTopLevel: true,
+      }),
+    deleteAccount: ({ cfg, accountId }) =>
+      deleteAccountFromConfigSection({
+        cfg,
+        sectionKey: "bajoseek",
+        accountId,
+        clearBaseFields: ["botId", "token", "tokenFile", "name"],
+      }),
+    isConfigured: (account) => Boolean(account?.botId && account?.token),
+    describeAccount: (account) => ({
+      accountId: account?.accountId ?? DEFAULT_ACCOUNT_ID,
+      name: account?.name,
+      enabled: account?.enabled ?? false,
+      configured: Boolean(account?.botId && account?.token),
+      tokenSource: account?.tokenSource,
+    }),
+    resolveAllowFrom: ({ cfg, accountId }: { cfg: OpenClawConfig; accountId?: string | null }) => {
+      const account = resolveBajoseekAccount(cfg, accountId);
+      const allowFrom = account.config?.allowFrom ?? [];
+      return allowFrom.map((entry: string | number) => String(entry));
+    },
+    formatAllowFrom: ({ allowFrom }: { allowFrom: Array<string | number> }) =>
+      allowFrom
+        .map((entry: string | number) => String(entry).trim())
+        .filter(Boolean)
+        .map((entry: string) => entry.replace(/^bajoseek:/i, "")),
+  },
+  setup: {
+    resolveAccountId: ({ accountId }) => accountId?.trim().toLowerCase() || DEFAULT_ACCOUNT_ID,
+    applyAccountName: ({ cfg, accountId, name }) =>
+      applyAccountNameToChannelSection({
+        cfg,
+        channelKey: "bajoseek",
+        accountId,
+        name,
+      }),
+    validateInput: ({ input }) => {
+      if (!input.botToken && !input.useEnv) {
+        return "Bajoseek requires --bot-token <botId> --token <token> [--url <wsUrl>], or --use-env";
+      }
+      if (!input.token && !input.useEnv) {
+        return "Bajoseek requires --token <token>";
+      }
+      return null;
+    },
+    applyAccountConfig: ({ cfg, accountId, input }) => {
+      return applyBajoseekAccountConfig(cfg, accountId, {
+        botId: input.botToken,
+        token: input.token,
+        tokenFile: input.tokenFile,
+        name: input.name,
+        wsUrl: input.url,
+      });
+    },
+  },
+  messaging: {
+    /**
+     * 规范化目标地址
+     * 支持格式：
+     * - bajoseek:user:userId → 私聊
+     * - user:userId → 私聊
+     * - 纯 userId
+     */
+    normalizeTarget: (target: string) => {
+      const id = target.replace(/^bajoseek:/i, "");
+
+      if (id.startsWith("user:")) {
+        return { ok: true, to: `bajoseek:${id}` };
+      }
+
+      // 纯 userId（非空字符串）
+      if (id && !id.includes(":")) {
+        return { ok: true, to: `bajoseek:user:${id}` };
+      }
+
+      return { ok: false, error: "无法识别的目标格式" };
+    },
+    targetResolver: {
+      looksLikeId: (id: string): boolean => {
+        if (/^bajoseek:user:/i.test(id)) return true;
+        if (/^user:/i.test(id)) return true;
+        // 简单的 userId 判断
+        return /^[a-zA-Z0-9_-]{1,64}$/.test(id);
+      },
+      hint: "Bajoseek 目标格式: bajoseek:user:userId",
+    },
+  },
+  outbound: {
+    deliveryMode: "direct",
+    chunker: chunkText,
+    chunkerMode: "markdown",
+    textChunkLimit: 4000,
+    sendText: async ({ to, text, accountId, replyToId }) => {
+      const result = await sendText({ to, text, accountId, replyToId });
+      return {
+        channel: "bajoseek" as const,
+        messageId: result.messageId ?? "",
+        error: result.error ? new Error(result.error) : undefined,
+      };
+    },
+  },
+  gateway: {
+    startAccount: async (ctx) => {
+      const { account, abortSignal, log, cfg } = ctx;
+
+      log?.info(`[bajoseek:${account.accountId}] Starting gateway — botId=${account.botId}, enabled=${account.enabled}, name=${account.name ?? "unnamed"}`);
+
+      await startGateway({
+        account,
+        abortSignal,
+        cfg,
+        log,
+        onReady: () => {
+          log?.info(`[bajoseek:${account.accountId}] Gateway ready`);
+          ctx.setStatus({
+            ...ctx.getStatus(),
+            running: true,
+            connected: true,
+            lastConnectedAt: Date.now(),
+          });
+        },
+        onError: (error) => {
+          log?.error(`[bajoseek:${account.accountId}] Gateway error: ${error.message}`);
+          ctx.setStatus({
+            ...ctx.getStatus(),
+            lastError: error.message,
+          });
+        },
+      });
+    },
+  },
+  status: {
+    defaultRuntime: {
+      accountId: DEFAULT_ACCOUNT_ID,
+      running: false,
+      connected: false,
+      lastConnectedAt: null,
+      lastError: null,
+      lastInboundAt: null,
+      lastOutboundAt: null,
+    },
+    buildChannelSummary: ({ snapshot }: { snapshot: Record<string, unknown> }) => ({
+      configured: snapshot.configured ?? false,
+      tokenSource: snapshot.tokenSource ?? "none",
+      running: snapshot.running ?? false,
+      connected: snapshot.connected ?? false,
+      lastConnectedAt: snapshot.lastConnectedAt ?? null,
+      lastError: snapshot.lastError ?? null,
+    }),
+    buildAccountSnapshot: ({ account, runtime }: { account: ResolvedBajoseekAccount; cfg: OpenClawConfig; runtime?: Record<string, unknown> }) => ({
+      accountId: account.accountId,
+      name: account.name,
+      enabled: account.enabled,
+      configured: Boolean(account.botId && account.token),
+      tokenSource: account.tokenSource,
+      running: (runtime?.running as boolean) ?? false,
+      connected: (runtime?.connected as boolean) ?? false,
+      lastConnectedAt: (runtime?.lastConnectedAt as number | null) ?? null,
+      lastError: (runtime?.lastError as string | null) ?? null,
+      lastInboundAt: (runtime?.lastInboundAt as number | null) ?? null,
+      lastOutboundAt: (runtime?.lastOutboundAt as number | null) ?? null,
+    }),
+  },
+};

package/src/config.ts

@@ -0,0 +1,183 @@
+import type { ResolvedBajoseekAccount, BajoseekAccountConfig } from "./types.js";
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+import * as fs from "node:fs";
+
+export const DEFAULT_ACCOUNT_ID = "default";
+const DEFAULT_WS_URL = "wss://ws.bajoseek.com";
+
+interface BajoseekChannelConfig extends BajoseekAccountConfig {
+  accounts?: Record<string, BajoseekAccountConfig>;
+}
+
+/**
+ * 列出所有 Bajoseek 账户 ID
+ */
+export function listBajoseekAccountIds(cfg: OpenClawConfig): string[] {
+  const ids = new Set<string>();
+  const bajoseek = cfg.channels?.bajoseek as BajoseekChannelConfig | undefined;
+
+  if (bajoseek?.botId) {
+    ids.add(DEFAULT_ACCOUNT_ID);
+  }
+
+  if (bajoseek?.accounts) {
+    for (const accountId of Object.keys(bajoseek.accounts)) {
+      if (bajoseek.accounts[accountId]?.botId) {
+        ids.add(accountId);
+      }
+    }
+  }
+
+  return Array.from(ids);
+}
+
+/**
+ * 获取默认账户 ID
+ */
+export function resolveDefaultBajoseekAccountId(cfg: OpenClawConfig): string {
+  const bajoseek = cfg.channels?.bajoseek as BajoseekChannelConfig | undefined;
+  if (bajoseek?.botId) {
+    return DEFAULT_ACCOUNT_ID;
+  }
+  if (bajoseek?.accounts) {
+    const ids = Object.keys(bajoseek.accounts);
+    if (ids.length > 0) {
+      return ids[0];
+    }
+  }
+  return DEFAULT_ACCOUNT_ID;
+}
+
+/**
+ * 解析 Bajoseek 账户配置
+ * 支持三级回退：config → file → env
+ */
+export function resolveBajoseekAccount(
+  cfg: OpenClawConfig,
+  accountId?: string | null
+): ResolvedBajoseekAccount {
+  const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+  const bajoseek = cfg.channels?.bajoseek as BajoseekChannelConfig | undefined;
+
+  let accountConfig: BajoseekAccountConfig = {};
+  let botId = "";
+  let token = "";
+  let tokenSource: "config" | "file" | "env" | "none" = "none";
+
+  if (resolvedAccountId === DEFAULT_ACCOUNT_ID) {
+    accountConfig = {
+      enabled: bajoseek?.enabled,
+      name: bajoseek?.name,
+      botId: bajoseek?.botId,
+      token: bajoseek?.token,
+      tokenFile: bajoseek?.tokenFile,
+      wsUrl: bajoseek?.wsUrl,
+      allowFrom: bajoseek?.allowFrom,
+      blockStreaming: (bajoseek as Record<string, unknown>)?.blockStreaming as boolean | undefined,
+    };
+    botId = (bajoseek?.botId ?? "").trim();
+  } else {
+    const account = bajoseek?.accounts?.[resolvedAccountId];
+    accountConfig = account ?? {};
+    botId = (account?.botId ?? "").trim();
+  }
+
+  // 解析 token：config → file → env
+  if (accountConfig.token) {
+    token = accountConfig.token;
+    tokenSource = "config";
+  } else if (accountConfig.tokenFile) {
+    try {
+      token = fs.readFileSync(accountConfig.tokenFile, "utf-8").trim();
+      tokenSource = "file";
+    } catch {
+      // file read failed, fall through
+    }
+  } else if (process.env.BAJOSEEK_TOKEN && resolvedAccountId === DEFAULT_ACCOUNT_ID) {
+    token = process.env.BAJOSEEK_TOKEN;
+    tokenSource = "env";
+  }
+
+  // botId 也可以从环境变量读取
+  if (!botId && process.env.BAJOSEEK_BOT_ID && resolvedAccountId === DEFAULT_ACCOUNT_ID) {
+    botId = process.env.BAJOSEEK_BOT_ID.trim();
+  }
+
+  // wsUrl：account config → channel config → default
+  const wsUrl = accountConfig.wsUrl || bajoseek?.wsUrl || DEFAULT_WS_URL;
+
+  return {
+    accountId: resolvedAccountId,
+    name: accountConfig.name,
+    enabled: accountConfig.enabled !== false,
+    botId,
+    token,
+    tokenSource,
+    wsUrl,
+    config: accountConfig,
+  };
+}
+
+/**
+ * 应用账户配置
+ */
+export function applyBajoseekAccountConfig(
+  cfg: OpenClawConfig,
+  accountId: string,
+  input: { botId?: string; token?: string; tokenFile?: string; name?: string; wsUrl?: string }
+): OpenClawConfig {
+  const next = { ...cfg };
+
+  if (accountId === DEFAULT_ACCOUNT_ID) {
+    const existingConfig = (next.channels?.bajoseek as BajoseekChannelConfig) || {};
+    const allowFrom = existingConfig.allowFrom ?? ["*"];
+
+    next.channels = {
+      ...next.channels,
+      bajoseek: {
+        ...(next.channels?.bajoseek as Record<string, unknown> || {}),
+        enabled: true,
+        blockStreaming: true,
+        allowFrom,
+        ...(input.botId ? { botId: input.botId } : {}),
+        ...(input.token
+          ? { token: input.token }
+          : input.tokenFile
+            ? { tokenFile: input.tokenFile }
+            : {}),
+        ...(input.name ? { name: input.name } : {}),
+        ...(input.wsUrl ? { wsUrl: input.wsUrl } : {}),
+      },
+    };
+  } else {
+    const existingAccountConfig = (next.channels?.bajoseek as BajoseekChannelConfig)?.accounts?.[accountId] || {};
+    const allowFrom = existingAccountConfig.allowFrom ?? ["*"];
+
+    next.channels = {
+      ...next.channels,
+      bajoseek: {
+        ...(next.channels?.bajoseek as Record<string, unknown> || {}),
+        enabled: true,
+        accounts: {
+          ...((next.channels?.bajoseek as BajoseekChannelConfig)?.accounts || {}),
+          [accountId]: {
+            ...((next.channels?.bajoseek as BajoseekChannelConfig)?.accounts?.[accountId] || {}),
+            enabled: true,
+            blockStreaming: true,
+            allowFrom,
+            ...(input.botId ? { botId: input.botId } : {}),
+            ...(input.token
+              ? { token: input.token }
+              : input.tokenFile
+                ? { tokenFile: input.tokenFile }
+                : {}),
+            ...(input.name ? { name: input.name } : {}),
+            ...(input.wsUrl ? { wsUrl: input.wsUrl } : {}),
+          },
+        },
+      },
+    };
+  }
+
+  return next;
+}