@jerryliang122/openclaw-qqbot 1.0.0

package/skills/qqbot-upgrade/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: qqbot-upgrade
+description: 将 openclaw-qqbot 插件（@jerryliang122/openclaw-qqbot）升级到最新版本。当用户要求更新 QQ 机器人插件、升级 qqbot 扩展或同步最新版时使用。
+metadata: {"openclaw":{"emoji":"⬆️","requires":{"config":["channels.qqbot"]}}}
+---
+
+# QQBot 插件升级
+
+## 何时使用
+
+用户表达以下意图时，应在**本机终端**执行升级命令（不要只口头说明「去官网升级」）：
+
+- 更新 / 升级 `openclaw-qqbot` / QQBot 插件 / QQ 机器人插件
+- 同步本仓库（jerryliang122/qqbot-openclaw）最新版
+
+---
+
+## 标准命令
+
+npm 包（推荐）：
+
+```bash
+openclaw plugins install @jerryliang122/openclaw-qqbot
+```
+
+指定版本：
+
+```bash
+openclaw plugins install @jerryliang122/openclaw-qqbot@<version>
+```
+
+或从 GitHub（无法访问 npm 时）：
+
+```bash
+openclaw plugins install git+https://github.com/jerryliang122/qqbot-openclaw.git
+```
+
+升级完成后重启网关使其生效：
+
+```bash
+openclaw gateway restart
+```
+
+---
+
+## 前置条件
+
+- OpenClaw >= 2026.9.2（低版本框架无法加载本插件）
+- 需 **Node.js / npm** 环境可访问 npm registry（或 GitHub）
+- 从 2.x 旧版本升级：先阅读仓库 CHANGELOG 的 Breaking Changes 与配置迁移表
+
+---
+
+## 执行后
+
+根据命令退出码与终端输出向用户简要汇报：成功则提示新版本号并确认网关已重启；失败则摘录关键错误并提示检查网络、npm 权限与 OpenClaw 版本。

package/src/adapter/contract.ts

@@ -0,0 +1,63 @@
+/**
+ * Runtime Contract Check — 启动时校验必需 API 可用性。
+ *
+ * 在 plugin.register() 中立刻调用，console 直接输出（register 阶段
+ * runtime.logging 的 getChildLogger 存在但输出管道未接通）。
+ */
+
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import { createPluginLogger } from '../utils/plugin-logger.js';
+
+const log = createPluginLogger({ prefix: '[contract]', forceConsole: false });
+
+interface ApiProbe {
+  name: string;
+  probe: (rt: PluginRuntime) => boolean;
+}
+
+const REQUIRED: ApiProbe[] = [];
+
+const OPTIONAL: ApiProbe[] = [
+  {
+    name: 'channel.reply.dispatchReplyWithBufferedBlockDispatcher',
+    probe: (rt) => typeof (rt as any).channel?.reply?.dispatchReplyWithBufferedBlockDispatcher === 'function',
+  },
+  { name: 'channel.inbound.run (degraded)', probe: (rt) => typeof (rt as any).channel?.inbound?.run === 'function' },
+  { name: 'channel.inbound.buildContext', probe: (rt) => typeof (rt as any).channel?.inbound?.buildContext === 'function' },
+  { name: 'channel.reply.formatAgentEnvelope', probe: (rt) => typeof (rt as any).channel?.reply?.formatAgentEnvelope === 'function' },
+  { name: 'channel.text.chunkMarkdownText', probe: (rt) => typeof (rt as any).channel?.text?.chunkMarkdownText === 'function' },
+  { name: 'channel.routing.resolveAgentRoute', probe: (rt) => typeof (rt as any).channel?.routing?.resolveAgentRoute === 'function' },
+  { name: 'channel.session.resolveStorePath', probe: (rt) => typeof (rt as any).channel?.session?.resolveStorePath === 'function' },
+  { name: 'channel.session.recordInboundSession', probe: (rt) => typeof (rt as any).channel?.session?.recordInboundSession === 'function' },
+  { name: 'config.current', probe: (rt) => typeof (rt as any).config?.current === 'function' },
+];
+
+export interface ContractResult {
+  ok: boolean;
+  version: string;
+  missing: string[];
+  degraded: string[];
+}
+
+export function verifyRuntimeContract(rt: PluginRuntime): ContractResult {
+  const version = (rt as any).version ?? 'unknown';
+  const missing: string[] = [];
+  const degraded: string[] = [];
+
+  for (const r of REQUIRED) {
+    if (!r.probe(rt)) missing.push(r.name);
+  }
+  for (const r of OPTIONAL) {
+    if (!r.probe(rt)) degraded.push(r.name);
+  }
+
+  log.debug(`openclaw=${version} required=${REQUIRED.length - missing.length}/${REQUIRED.length} degraded=${degraded.length}/${OPTIONAL.length}`);
+  if (missing.length) {
+    log.error(`BROKEN — missing: ${missing.join(', ')}`);
+  }
+  if (degraded.length) {
+    log.debug(`degraded: ${degraded.join(', ')}`);
+  }
+
+  return { ok: missing.length === 0, version, missing, degraded };
+}

package/src/adapter/lint.ts

@@ -0,0 +1,144 @@
+/**
+ * Lint: 检测 adapter/ 外部直接访问 runtime.channel.* 的代码
+ *
+ * 运行方式：
+ *   npx tsx src/adapter/lint-runtime-access.ts
+ *
+ * 退出码：
+ *   0 = 无违规
+ *   1 = 存在未加白的直接 runtime 访问
+ *
+ * 加白方式（行内注释）：
+ *   // @adapter-bypass: <理由>
+ *
+ * 示例：
+ *   const tts = (runtime as any)?.tts; // @adapter-bypass: TTS 非 channel API，无需经过适配层
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+// ── 配置 ──
+
+const SRC_ROOT = path.resolve(import.meta.dirname, '..');
+const ADAPTER_DIR = path.resolve(SRC_ROOT, 'adapter');
+
+/** 匹配直接使用 runtime.channel / runtime.config / (runtime as any) 的模式 */
+const VIOLATION_PATTERNS: RegExp[] = [
+  /runtime\.channel\b/,
+  /runtime\.config\b/,
+  /\(runtime\s+as\s+any\)/,
+  /channel\??\.(inbound|turn|reply|session|routing|text|media|runtimeContexts)\b/,
+  /config\s+as\s*\{.*writeConfigFile/,
+];
+
+/** 加白注释标记 */
+const BYPASS_MARKER = '@adapter-bypass';
+
+/** 排除的目录/文件 */
+const EXCLUDE_DIRS = ['adapter', 'node_modules', 'dist', 'tests'];
+const EXCLUDE_FILES = ['types.ts', 'types-augment.d.ts', 'openclaw-plugin-sdk.d.ts'];
+
+// ── 扫描逻辑 ──
+
+interface Violation {
+  file: string;
+  line: number;
+  content: string;
+  pattern: string;
+}
+
+function shouldExclude(filePath: string): boolean {
+  const relative = path.relative(SRC_ROOT, filePath);
+  // 排除 adapter 自身
+  if (filePath.startsWith(ADAPTER_DIR)) return true;
+  // 排除配置的目录
+  for (const dir of EXCLUDE_DIRS) {
+    if (relative.startsWith(dir + '/') || relative === dir) return true;
+  }
+  // 排除特定文件
+  const fileName = path.basename(filePath);
+  if (EXCLUDE_FILES.includes(fileName)) return true;
+  return false;
+}
+
+function scanFile(filePath: string): Violation[] {
+  const violations: Violation[] = [];
+  const content = fs.readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const lineNum = i + 1;
+
+    // 跳过注释行（单行注释、JSDoc 行、多行注释体）
+    const trimmed = line.trimStart();
+    if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/**') || trimmed.startsWith('*/')) continue;
+
+    // 检查加白标记
+    if (line.includes(BYPASS_MARKER)) continue;
+
+    // 检查违规模式
+    for (const pattern of VIOLATION_PATTERNS) {
+      if (pattern.test(line)) {
+        violations.push({
+          file: path.relative(SRC_ROOT, filePath),
+          line: lineNum,
+          content: line.trim(),
+          pattern: pattern.source,
+        });
+        break; // 同一行只报一次
+      }
+    }
+  }
+
+  return violations;
+}
+
+function walkDir(dir: string): string[] {
+  const results: string[] = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (!EXCLUDE_DIRS.includes(entry.name)) {
+        results.push(...walkDir(fullPath));
+      }
+    } else if (entry.isFile() && entry.name.endsWith('.ts') && !entry.name.endsWith('.d.ts')) {
+      results.push(fullPath);
+    }
+  }
+  return results;
+}
+
+// ── 主流程 ──
+
+function main(): void {
+  const files = walkDir(SRC_ROOT).filter((f) => !shouldExclude(f));
+  const allViolations: Violation[] = [];
+
+  for (const file of files) {
+    const violations = scanFile(file);
+    allViolations.push(...violations);
+  }
+
+  if (allViolations.length === 0) {
+    console.log('✅ No direct runtime access found outside adapter/');
+    process.exit(0);
+  }
+
+  console.error(`❌ Found ${allViolations.length} direct runtime access violation(s):\n`);
+  for (const v of allViolations) {
+    console.error(`  ${v.file}:${v.line}`);
+    console.error(`    ${v.content}`);
+    console.error(`    → matched: ${v.pattern}`);
+    console.error(`    → fix: use adapter or add "// @adapter-bypass: <reason>"\n`);
+  }
+  console.error(
+    `\nTo bypass a specific line, add an inline comment:\n` +
+    `  // @adapter-bypass: <reason why this cannot go through the adapter>\n`,
+  );
+  process.exit(1);
+}
+
+main();

package/src/adapter/media.ts

@@ -0,0 +1,40 @@
+/**
+ * 远程媒体下载（plugin-sdk/media-runtime）
+ *
+ * 直接走 openclaw 的 saveRemoteMedia（含 SSRF 防护/重试/大小限制）。
+ */
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+
+let _req: NodeRequire | undefined;
+
+/**
+ * 惰性 require 工厂。
+ * CJS（tsup 产物）下用 __filename 锚定，与插件 node_modules 的解析路径一致；
+ * ESM（tsx 直跑测试）下 __filename 不存在，锚定 process.cwd()。
+ */
+function getReq(): NodeRequire {
+  _req ??= createRequire(
+    typeof __filename !== 'undefined' ? __filename : path.join(process.cwd(), 'noop.js'),
+  );
+  return _req;
+}
+
+type SaveRemoteMedia = (opts: {
+  url: string;
+  subdir?: string;
+  originalFilename?: string;
+  maxBytes?: number;
+  timeoutMs?: number;
+}) => Promise<{ path: string }>;
+
+export function downloadRemoteMedia(opts: {
+  url: string;
+  subdir?: string;
+  originalFilename?: string;
+  maxBytes?: number;
+  timeoutMs?: number;
+}): Promise<{ path: string }> {
+  const mod = getReq()('openclaw/plugin-sdk/media-runtime') as { saveRemoteMedia: SaveRemoteMedia };
+  return mod.saveRemoteMedia(opts);
+}

package/src/adapter/pairing.ts

@@ -0,0 +1,95 @@
+/**
+ * Pairing Runtime — openclaw/plugin-sdk/conversation-runtime
+ *
+ * readAllowFromStore / issueChallenge / buildReply 直接来自稳定 subpath。
+ *
+ * approveCode 例外：`approveChannelPairingCode` 在 2026.9.2 未从任何
+ * plugin-sdk subpath 导出（只存在于内部 pairing-store chunk 与
+ * `openclaw pairing approve` CLI），走与网关同源的 CLI 执行
+ * （见 secret-store-cli 的 resolveOpenClawCli 同源约束）。
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import * as path from 'node:path';
+import { resolveOpenClawCli } from '../features/secret-store-cli.js';
+
+export interface PairingApi {
+  readAllowFromStore: (params: { channel: string; accountId: string }) => Promise<string[]>;
+  issueChallenge: (params: { channel: string; id: string; accountId: string }) => Promise<{ code: string }>;
+  buildReply: (params: { code: string; channel: string }) => string;
+  /** 经 `openclaw pairing approve` 执行；返回是否成功 */
+  approveCode: (params: { channel: string; code: string; accountId?: string }) => Promise<{ approved: boolean }>;
+}
+
+let _req: NodeRequire | undefined;
+
+function getReq(): NodeRequire {
+  _req ??= createRequire(
+    typeof __filename !== 'undefined' ? __filename : path.join(process.cwd(), 'noop.js'),
+  );
+  return _req;
+}
+
+let _mod: {
+  readChannelAllowFromStore: (channel: string, env?: unknown, accountId?: string) => Promise<string[]>;
+  upsertChannelPairingRequest: (params: { channel: string; id: string; accountId?: string }) => Promise<{ code: string }>;
+  buildPairingReply: (params: { channel: string; idLine?: string; code: string }) => string;
+} | undefined;
+
+function loadMod(): NonNullable<typeof _mod> {
+  _mod ??= getReq()('openclaw/plugin-sdk/conversation-runtime');
+  return _mod!;
+}
+
+/** 获取 Pairing API（conversation-runtime 为稳定导出，加载失败即抛错） */
+export function getPairingApi(): PairingApi {
+  const mod = loadMod();
+  return {
+    readAllowFromStore: (params) =>
+      mod.readChannelAllowFromStore(params.channel, undefined, params.accountId),
+    issueChallenge: (params) =>
+      mod.upsertChannelPairingRequest({
+        channel: params.channel,
+        id: params.id,
+        accountId: params.accountId,
+      }).then((r) => ({ code: r.code })),
+    buildReply: (params) =>
+      mod.buildPairingReply({
+        channel: params.channel,
+        idLine: '', // qqbot 无额外 ID 信息，留空即可
+        code: params.code,
+      }),
+    approveCode: (params) => approveViaCli(params),
+  };
+}
+
+const APPROVE_TIMEOUT_MS = 30_000;
+
+async function approveViaCli(params: {
+  channel: string;
+  code: string;
+  accountId?: string;
+}): Promise<{ approved: boolean }> {
+  const cli = resolveOpenClawCli();
+  const args = [
+    ...cli.args,
+    'pairing',
+    'approve',
+    '--channel',
+    params.channel,
+    ...(params.accountId ? ['--account', params.accountId] : []),
+    params.code,
+  ];
+  return new Promise((resolve) => {
+    const child = spawn(cli.cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    const timer = setTimeout(() => child.kill('SIGKILL'), APPROVE_TIMEOUT_MS);
+    child.on('error', () => {
+      clearTimeout(timer);
+      resolve({ approved: false });
+    });
+    child.on('close', (codeNum) => {
+      clearTimeout(timer);
+      resolve({ approved: codeNum === 0 });
+    });
+  });
+}

package/src/adapter/resolve.ts

@@ -0,0 +1,255 @@
+/**
+ * Runtime Adapters — 一次 resolve，全程复用。
+ *
+ * Capability Probe 模式：按候选 API 路径探测，选出第一个可用函数。
+ * 构建基线为 openclaw 2026.9.2（peer >=2026.9.2），不再保留对更旧版本的回退。
+ *
+ * 调用方通过 `resolveRuntimeAdapters(runtime)` 获取适配层对象，
+ * 后续所有 dispatch / channel 代码只使用 adapters 上的方法。
+ */
+
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import type { PluginLogger } from '../utils/plugin-logger.js';
+
+// ── 类型 ──
+
+export interface RuntimeAdapters {
+  /** 入站事件处理 */
+  inboundRun: ((params: any) => Promise<any>) | null;
+  /** 回复分发（带 block buffer） */
+  dispatchReply: ((params: any) => Promise<any>) | null;
+  /** Agent 路由解析 */
+  resolveAgentRoute: ((params: any) => any) | null;
+  /** 构建入站上下文 */
+  buildInboundContext: ((params: any) => any) | null;
+  /** Session store path 解析 */
+  resolveStorePath: ((storeConfig: any, opts: any) => string) | null;
+  /** Session 记录 */
+  recordInboundSession: ((params: any) => Promise<void>) | null;
+  /** 格式化 envelope */
+  formatEnvelope: ((params: any) => string) | null;
+  /** 解析 envelope format options */
+  resolveEnvelopeFormatOptions: ((cfg: any) => any) | null;
+  /** Markdown 文本分块 */
+  chunkMarkdownText: ((text: string, limit: number) => string[]) | null;
+  /** 远程媒体保存（图片/语音下载） */
+  saveRemoteMedia: ((opts: { url: string; subdir?: string; originalFilename?: string }) => Promise<{ path: string } | null>) | null;
+  /** 获取当前配置快照 */
+  getConfig: (() => any) | null;
+  /**
+   * 持久化配置变更。
+   *
+   * 接受一个 mutator 回调，接收当前 config 对象（可变），
+   * 可直接修改或返回新对象。适配器负责确保写入和热重载。
+   */
+  persistConfig: ((mutator: (cfg: any) => any) => Promise<void>) | null;
+  /** openclaw 版本 */
+  version: string;
+}
+
+// ── Probe 辅助 ──
+
+type ProbePath = string[];
+
+/**
+ * 从 runtime 对象沿路径探测函数。返回 bound function 或 null。
+ */
+function probeFunction(rt: any, paths: ProbePath[]): ((...args: any[]) => any) | null {
+  for (const path of paths) {
+    let target = rt;
+    let parent = rt;
+    for (let i = 0; i < path.length; i++) {
+      parent = target;
+      target = target?.[path[i]];
+      if (target === undefined || target === null) break;
+    }
+    if (typeof target === 'function') {
+      // bind 到 parent（倒数第二层），确保 this 上下文正确
+      return target.bind(parent);
+    }
+  }
+  return null;
+}
+
+/**
+ * 从 runtime 对象沿路径探测值（非函数也可）。返回值或 null。
+ */
+function probeValue(rt: any, paths: ProbePath[]): any {
+  for (const path of paths) {
+    let target = rt;
+    for (const key of path) {
+      target = target?.[key];
+      if (target === undefined || target === null) break;
+    }
+    if (target !== undefined && target !== null) return target;
+  }
+  return null;
+}
+
+// ── 主入口 ──
+
+/**
+ * 一次性 resolve 所有 runtime adapter。
+ *
+ * 通常在 gateway ready 后（首条消息到来前）调用一次，结果缓存复用。
+ * 返回 null 的字段表示该能力不可用，调用方按需降级或走 fallback。
+ */
+export function resolveRuntimeAdapters(
+  rt: PluginRuntime,
+  log?: PluginLogger,
+): RuntimeAdapters {
+  const version = (rt as any).version ?? 'unknown';
+
+  const inboundRun = probeFunction(rt, [
+    ['channel', 'inbound', 'run'],
+  ]);
+
+  const dispatchReply = probeFunction(rt, [
+    ['channel', 'reply', 'dispatchReplyWithBufferedBlockDispatcher'],
+  ]);
+
+  const resolveAgentRoute = probeFunction(rt, [
+    ['channel', 'routing', 'resolveAgentRoute'],
+  ]);
+
+  const rawBuildContext = probeFunction(rt, [
+    ['channel', 'inbound', 'buildContext'],
+  ]);
+
+  const buildInboundContext: RuntimeAdapters['buildInboundContext'] = rawBuildContext
+    ? (params) => rawBuildContext(params)
+    : null;
+
+  const resolveStorePath = probeFunction(rt, [
+    ['channel', 'session', 'resolveStorePath'],
+  ]);
+
+  const recordInboundSession = probeFunction(rt, [
+    ['channel', 'session', 'recordInboundSession'],
+  ]);
+
+  const formatEnvelope = probeFunction(rt, [
+    ['channel', 'reply', 'formatAgentEnvelope'],
+  ]);
+
+  const resolveEnvelopeFormatOptions = probeFunction(rt, [
+    ['channel', 'reply', 'resolveEnvelopeFormatOptions'],
+  ]);
+
+  const chunkMarkdownText = probeFunction(rt, [
+    ['channel', 'text', 'chunkMarkdownText'],
+  ]);
+
+  const saveRemoteMedia = probeFunction(rt, [
+    ['channel', 'media', 'saveRemoteMedia'],
+  ]);
+
+  const getConfig = probeFunction(rt, [
+    ['config', 'current'],
+  ]);
+
+  const rawMutateConfig = probeFunction(rt, [['config', 'mutateConfigFile']]);
+
+  const persistConfig: RuntimeAdapters['persistConfig'] = rawMutateConfig
+    ? async (mutator: (cfg: any) => any) => {
+        await rawMutateConfig({
+          afterWrite: 'hot-reload',
+          mutate: mutator,
+        });
+      }
+    : null;
+
+  // 日志汇总
+  const resolved = [
+    inboundRun && 'inboundRun',
+    dispatchReply && 'dispatchReply',
+    resolveAgentRoute && 'resolveAgentRoute',
+    buildInboundContext && 'buildInboundContext',
+    resolveStorePath && 'resolveStorePath',
+    recordInboundSession && 'recordInboundSession',
+    formatEnvelope && 'formatEnvelope',
+    chunkMarkdownText && 'chunkMarkdownText',
+    saveRemoteMedia && 'saveRemoteMedia',
+    getConfig && 'getConfig',
+    persistConfig && 'persistConfig',
+  ].filter(Boolean);
+
+  log?.info(
+    `[qqbot:adapter] openclaw=${version} resolved ${resolved.length} adapters: ${resolved.join(', ')}`,
+  );
+
+  return {
+    inboundRun,
+    dispatchReply,
+    resolveAgentRoute,
+    buildInboundContext,
+    resolveStorePath,
+    recordInboundSession,
+    formatEnvelope,
+    resolveEnvelopeFormatOptions,
+    chunkMarkdownText,
+    saveRemoteMedia,
+    getConfig,
+    persistConfig,
+    version,
+  };
+}
+
+// ── 全局缓存（所有消费者共享同一份 adapters） ──
+
+let _cachedAdapters: RuntimeAdapters | null = null;
+let _cachedRuntimeRef: WeakRef<PluginRuntime> | null = null;
+
+/**
+ * 获取 RuntimeAdapters 的全局缓存版本。
+ *
+ * - 自动基于 runtime 实例的 WeakRef 判断是否需要重新 resolve
+ * - 如果 runtime 被替换（框架热更新、二次 register），自动刷新
+ * - 所有消费者（dispatch / channel / middleware）共用一份，避免重复 probe
+ *
+ * @param rt 当前 PluginRuntime 实例
+ * @param log 可选日志（仅在首次 resolve 或 runtime 变更时输出）
+ */
+export function getAdapters(
+  rt: PluginRuntime,
+  log?: PluginLogger,
+): RuntimeAdapters {
+  const cached = _cachedRuntimeRef?.deref();
+  if (cached === rt && _cachedAdapters) {
+    return _cachedAdapters;
+  }
+  // runtime 引用变化（首次 / 热更新）→ 重新 resolve
+  _cachedAdapters = resolveRuntimeAdapters(rt, log);
+  _cachedRuntimeRef = new WeakRef(rt);
+  return _cachedAdapters;
+}
+
+/**
+ * 持久化配置（auth.login 场景）。
+ *
+ * 走 config.mutateConfigFile（原子操作，支持 afterWrite 策略）。
+ */
+export async function persistAuthConfig(
+  runtime: Record<string, unknown>,
+  cfg: Record<string, unknown>,
+  afterWrite = 'restart',
+): Promise<void> {
+  const config: Record<string, unknown> | undefined = runtime.config as any;
+
+  if (typeof config?.mutateConfigFile !== 'function') {
+    throw new Error('persistAuthConfig: runtime.config.mutateConfigFile is unavailable (requires openclaw >= 2026.9.2)');
+  }
+  await (config.mutateConfigFile as Function)({
+    mutate: () => cfg,
+    afterWrite,
+  });
+}
+
+/**
+ * 强制清除 adapter 缓存（仅测试用）
+ */
+export function _resetAdaptersCache(): void {
+  _cachedAdapters = null;
+  _cachedRuntimeRef = null;
+}
+

package/src/adapter/setup.ts

@@ -0,0 +1,13 @@
+/**
+ * Setup 工具 re-export（plugin-sdk/setup + plugin-sdk/setup-tools）
+ *
+ * 构建基线 openclaw 2026.9.2，两个 subpath 均为正式导出，直接转发。
+ */
+export type { ChannelSetupWizard } from 'openclaw/plugin-sdk/setup';
+
+export {
+  createStandardChannelSetupStatus,
+  setSetupChannelEnabled,
+} from 'openclaw/plugin-sdk/setup';
+
+export { formatDocsLink } from 'openclaw/plugin-sdk/setup-tools';