agentdev 0.1.8 → 0.1.9

package/dist/index.js

@@ -1,17 +1,20 @@
 import {
   BasicAgent
-} from "./chunk-LQTEETML.js";
+} from "./chunk-5T4C2XRT.js";
 import {
   ExplorerAgent
-} from "./chunk-F3PR7UTL.js";
+} from "./chunk-QFHPUAUQ.js";
 import {
   AgentBase,
   AgentPool,
   AnthropicLLM,
+  AudioFeedbackFeature,
+  AuditFeature,
   CallFinish,
   CallStart,
   Context,
   DataSourceRegistry,
+  Decision,
   ExampleFeature,
   FileSessionStore,
   MCPClient,
@@ -19,19 +22,25 @@ import {
   MCPConnectionState,
   MCPFeature,
   MCPToolAdapter,
+  MemoryFeature,
   OpenAILLM,
   OpencodeBasicFeature,
+  PluginCompatFeature,
+  QQBotFeature,
+  ShellFeature,
   SkillFeature,
   StepFinish,
   StepStart,
   SubAgentFeature,
+  TTSFeature,
   TemplateComposer,
   TemplateLoader,
   TodoFeature,
   ToolFinished,
-  ToolRegistry,
   ToolUse,
   UserInputFeature,
+  VisualFeature,
+  WebSearchFeature,
   assistant,
   compileContextForAnthropic,
   createAnthropicLLM,
@@ -45,7 +54,6 @@ import {
   createManagedMCPToolsFromClient,
   createMessage,
   createOpenAILLM,
-  createTool,
   discover,
   discoverMCPTools,
   discoverManagedMCPTools,
@@ -63,7 +71,7 @@ import {
   system,
   toolResult,
   user
-} from "./chunk-OBOU27DM.js";
+} from "./chunk-A354ZCZF.js";
 import {
   PlaceholderResolver
 } from "./chunk-BVF7RUXV.js";
@@ -72,13 +80,17 @@ import {
   getClawRuntimeUrl,
   getDebugCapabilities,
   resolveDebugTransportMode
-} from "./chunk-3BPSNNK3.js";
+} from "./chunk-EECW6PYP.js";
+import {
+  ToolRegistry,
+  createTool
+} from "./chunk-G5ECPY4K.js";
 import {
   ViewerWorker
-} from "./chunk-LLV3W326.js";
+} from "./chunk-NORTAQIL.js";
 import {
   getDefaultUDSPath
-} from "./chunk-TSASFMRF.js";
+} from "./chunk-BAP2GCYH.js";
 import "./chunk-BDS2QGZ5.js";
 
 // src/template/types.ts
@@ -216,12 +228,15 @@ export {
   AgentBase as Agent,
   AgentPool,
   AnthropicLLM,
+  AudioFeedbackFeature,
+  AuditFeature,
   BasicAgent,
   CallFinish,
   CallStart,
   Context,
   DataSourceRegistry,
   DebugHub,
+  Decision,
   ExampleFeature,
   ExplorerAgent,
   FileSessionStore,
@@ -231,13 +246,18 @@ export {
   MCPFeature,
   MCPToolAdapter,
   MCP_RENDER_TEMPLATES,
+  MemoryFeature,
   OpenAILLM,
   OpencodeBasicFeature,
   PlaceholderResolver,
+  PluginCompatFeature,
+  QQBotFeature,
+  ShellFeature,
   SkillFeature,
   StepFinish,
   StepStart,
   SubAgentFeature,
+  TTSFeature,
   TemplateComposer,
   TemplateError,
   TemplateLoader,
@@ -247,6 +267,8 @@ export {
   ToolUse,
   UserInputFeature,
   ViewerWorker,
+  VisualFeature,
+  WebSearchFeature,
   assistant,
   compileContextForAnthropic,
   createAnthropicLLM,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/template/types.ts","../src/mcp/render.ts"],"sourcesContent":["/**\n * 提示词模板系统 - 核心类型定义\n */\n\n/**\n * 模板源\n * - string: 硬编码字符串\n * - { file: string }: 文件路径\n * - [dataSourceName: string]: 数据源名称（如 skills, tasks 等）\n * - TemplateComposer: 组合模板\n *\n * @example\n * ```typescript\n * // 静态字符串\n * 'Hello {{name}}'\n *\n * // 文件\n * { file: 'prompts/system.md' }\n *\n * // 数据源（列表渲染）\n * { skills: '- **{{name}}**: {{description}}' }\n * { tasks: '- [{{title}}](#{{id}}) ({{priority}})' }\n *\n * // 条件渲染\n * { conditional: { part: { file: 'advanced.md' }, condition: (ctx) => ctx.advanced } }\n * ```\n */\nexport type TemplateSource =\n  | string\n  | { file: string }\n  | { conditional: ConditionalSource }\n  | { [dataSourceName: string]: string }  // 数据源 -> 模板\n  | import('./composer.js').TemplateComposer;\n\n/**\n * 条件源配置\n */\nexport interface ConditionalSource {\n  /** 条件模板源 */\n  part: TemplateSource;\n  /** 条件函数（true 时渲染） */\n  condition: (context: PlaceholderContext) => boolean;\n}\n\n/**\n * 占位符上下文 - 变量替换的键值对\n * 支持原始类型和复杂对象（用于数据源渲染）\n */\nexport type PlaceholderContext = Record<string, string | number | boolean | undefined | object>;\n\n/**\n * 模板渲染结果\n */\nexport interface TemplateResult {\n  /** 渲染后的内容 */\n  content: string;\n  /** 使用的源文件列表（用于调试） */\n  sources: string[];\n}\n\n/**\n * 模板加载器配置\n */\nexport interface TemplateLoaderOptions {\n  /** 缓存启用状态，默认 true */\n  cacheEnabled?: boolean;\n  /** 模板搜索目录（相对于项目根目录） */\n  searchDirs?: string[];\n  /** 项目根目录（自动检测） */\n  projectRoot?: string;\n}\n\n/**\n * 缓存统计\n */\nexport interface CacheStats {\n  size: number;      // 缓存条目数\n  hits: number;      // 命中次数\n  misses: number;    // 未命中次数\n  hitRate: number;   // 命中率\n}\n\n/**\n * 模板相关错误\n */\nexport class TemplateError extends Error {\n  constructor(\n    message: string,\n    public code:\n      | 'FILE_NOT_FOUND'\n      | 'INVALID_PATH'\n      | 'READ_ERROR'\n      | 'UNSUPPORTED_FORMAT',\n    public path?: string\n  ) {\n    super(message);\n    this.name = 'TemplateError';\n  }\n}\n","/**\n * MCP 工具渲染模板\n *\n * 定义 MCP 工具在 DebugHub 中的显示样式\n */\n\n/**\n * 转义 HTML\n */\nfunction escapeHtml(text: any): string {\n  const str = String(text);\n  const map: Record<string, string> = {\n    '&': '&amp;',\n    '<': '&lt;',\n    '>': '&gt;',\n    '\"': '&quot;',\n    \"'\": '&#39;',\n  };\n  return str.replace(/[&<>\"']/g, m => map[m]);\n}\n\n/**\n * MCP 工具渲染模板\n */\nexport const MCP_RENDER_TEMPLATES = {\n  /**\n   * MCP 工具调用显示\n   */\n  'mcp-tool': {\n    call: (args: any) => {\n      const server = args._server || 'unknown';\n      const name = args._name || 'unknown';\n      return `\n        <div class=\"bash-command\" style=\"\n          border-left: 3px solid #ff6b6b;\n          padding-left: 8px;\n          margin: 4px 0;\n        \">\n          <span style=\"\n            color: #ff6b6b;\n            font-weight: bold;\n            font-size: 11px;\n            text-transform: uppercase;\n          \">MCP</span>\n          <span class=\"file-path\" style=\"color: #c068ff;\">${escapeHtml(server)}</span>\n          <span style=\"color: #888;\">::</span>\n          <span style=\"color: #fff;\">${escapeHtml(name)}</span>\n        </div>\n      `.trim();\n    },\n    result: (data: any, success = true) => {\n      if (!success || data.error) {\n        return `\n          <div class=\"bash-output\" style=\"\n            border-left: 3px solid #ff4444;\n            padding-left: 8px;\n            color: #ff6b6b;\n          \">\n            <div style=\"font-weight: bold; margin-bottom: 4px;\">MCP Error</div>\n            <pre style=\"margin: 0; white-space: pre-wrap;\">${escapeHtml(data.error || 'Unknown error')}</pre>\n          </div>\n        `.trim();\n      }\n\n      let content = '';\n\n      // 文本内容\n      if (data.content) {\n        content += `<pre class=\"bash-output\" style=\"max-height: 400px; overflow: auto;\">${escapeHtml(data.content)}</pre>`;\n      }\n\n      // 结构化数据\n      if (data.structuredContent) {\n        content += `<details style=\"margin-top: 8px;\">\n          <summary style=\"cursor: pointer; color: var(--accent-color);\">Structured Data</summary>\n          <pre style=\"margin: 4px 0; padding: 8px; background: var(--bg-secondary);\">${escapeHtml(JSON.stringify(data.structuredContent, null, 2))}</pre>\n        </details>`;\n      }\n\n      // 图像\n      if (data.images && data.images.length > 0) {\n        content += `<div style=\"margin-top: 8px;\">`;\n        data.images.forEach((img: any) => {\n          content += `<img src=\"data:${img.mimeType};base64,${img.data}\" style=\"max-width: 100%; border-radius: 4px;\" />`;\n        });\n        content += `</div>`;\n      }\n\n      // 资源\n      if (data.resources && data.resources.length > 0) {\n        content += `<div style=\"margin-top: 8px;\">\n          <div style=\"font-weight: bold; margin-bottom: 4px;\">Resources:</div>`;\n        data.resources.forEach((res: any) => {\n          content += `<div style=\"padding: 4px; background: var(--bg-secondary); margin: 4px 0;\">\n            <div style=\"font-size: 11px; color: var(--text-secondary);\">${escapeHtml(res.uri)}</div>\n            ${res.text ? `<pre style=\"margin: 4px 0 0 0;\">${escapeHtml(res.text)}</pre>` : ''}\n          </div>`;\n        });\n        content += `</div>`;\n      }\n\n      // 元数据\n      const meta = `\n        <div style=\"\n          font-size: 11px;\n          opacity: 0.6;\n          margin-top: 8px;\n          display: flex;\n          gap: 12px;\n        \">\n          <span>Server: ${escapeHtml(data.server)}</span>\n          <span>Duration: ${data.duration}ms</span>\n        </div>\n      `;\n\n      return content + meta;\n    },\n  },\n\n  /**\n   * MCP 结果 (简化版)\n   */\n  'mcp-result': {\n    call: () => '<div class=\"bash-command\">MCP Tool Call</div>',\n    result: (data: any, success = true) => {\n      return MCP_RENDER_TEMPLATES['mcp-tool'].result(data, success);\n    },\n  },\n} as const;\n\n/**\n * 获取 MCP 渲染模板\n */\nexport function getMCPRenderTemplate(toolName: string): string {\n  return 'mcp-tool';\n}\n\n/**\n * 渲染 MCP 工具调用\n */\nexport function renderMCPToolCall(\n  serverName: string,\n  toolName: string,\n  args: Record<string, any>\n): string {\n  const template = MCP_RENDER_TEMPLATES['mcp-tool'].call;\n  if (typeof template === 'function') {\n    return template({ _server: serverName, _name: toolName, ...args });\n  }\n  return template;\n}\n\n/**\n * 渲染 MCP 工具结果\n */\nexport function renderMCPToolResult(\n  result: any,\n  success = true\n): string {\n  const template = MCP_RENDER_TEMPLATES['mcp-tool'].result;\n  if (typeof template === 'function') {\n    return template(result, success);\n  }\n  return template;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/template/types.ts","../src/mcp/render.ts"],"sourcesContent":["/**\n * 提示词模板系统 - 核心类型定义\n */\n\n/**\n * 模板源\n * - string: 硬编码字符串\n * - { file: string }: 文件路径\n * - [dataSourceName: string]: 数据源名称（如 skills, tasks 等）\n * - TemplateComposer: 组合模板\n *\n * @example\n * ```typescript\n * // 静态字符串\n * 'Hello {{name}}'\n *\n * // 文件\n * { file: 'prompts/system.md' }\n *\n * // 数据源（列表渲染）\n * { skills: '- **{{name}}**: {{description}}' }\n * { tasks: '- [{{title}}](#{{id}}) ({{priority}})' }\n *\n * // 条件渲染\n * { conditional: { part: { file: 'advanced.md' }, condition: (ctx) => ctx.advanced } }\n * ```\n */\nexport type TemplateSource =\n  | string\n  | { file: string }\n  | { conditional: ConditionalSource }\n  | { [dataSourceName: string]: string }  // 数据源 -> 模板\n  | import('./composer.js').TemplateComposer;\n\n/**\n * 条件源配置\n */\nexport interface ConditionalSource {\n  /** 条件模板源 */\n  part: TemplateSource;\n  /** 条件函数（true 时渲染） */\n  condition: (context: PlaceholderContext) => boolean;\n}\n\n/**\n * 占位符上下文 - 变量替换的键值对\n * 支持原始类型和复杂对象（用于数据源渲染）\n */\nexport type PlaceholderContext = Record<string, string | number | boolean | undefined | object>;\n\n/**\n * 模板渲染结果\n */\nexport interface TemplateResult {\n  /** 渲染后的内容 */\n  content: string;\n  /** 使用的源文件列表（用于调试） */\n  sources: string[];\n}\n\n/**\n * 模板加载器配置\n */\nexport interface TemplateLoaderOptions {\n  /** 缓存启用状态，默认 true */\n  cacheEnabled?: boolean;\n  /** 模板搜索目录（相对于项目根目录） */\n  searchDirs?: string[];\n  /** 项目根目录（自动检测） */\n  projectRoot?: string;\n}\n\n/**\n * 缓存统计\n */\nexport interface CacheStats {\n  size: number;      // 缓存条目数\n  hits: number;      // 命中次数\n  misses: number;    // 未命中次数\n  hitRate: number;   // 命中率\n}\n\n/**\n * 模板相关错误\n */\nexport class TemplateError extends Error {\n  constructor(\n    message: string,\n    public code:\n      | 'FILE_NOT_FOUND'\n      | 'INVALID_PATH'\n      | 'READ_ERROR'\n      | 'UNSUPPORTED_FORMAT',\n    public path?: string\n  ) {\n    super(message);\n    this.name = 'TemplateError';\n  }\n}\n","/**\n * MCP 工具渲染模板\n *\n * 定义 MCP 工具在 DebugHub 中的显示样式\n */\n\n/**\n * 转义 HTML\n */\nfunction escapeHtml(text: any): string {\n  const str = String(text);\n  const map: Record<string, string> = {\n    '&': '&amp;',\n    '<': '&lt;',\n    '>': '&gt;',\n    '\"': '&quot;',\n    \"'\": '&#39;',\n  };\n  return str.replace(/[&<>\"']/g, m => map[m]);\n}\n\n/**\n * MCP 工具渲染模板\n */\nexport const MCP_RENDER_TEMPLATES = {\n  /**\n   * MCP 工具调用显示\n   */\n  'mcp-tool': {\n    call: (args: any) => {\n      const server = args._server || 'unknown';\n      const name = args._name || 'unknown';\n      return `\n        <div class=\"bash-command\" style=\"\n          border-left: 3px solid #ff6b6b;\n          padding-left: 8px;\n          margin: 4px 0;\n        \">\n          <span style=\"\n            color: #ff6b6b;\n            font-weight: bold;\n            font-size: 11px;\n            text-transform: uppercase;\n          \">MCP</span>\n          <span class=\"file-path\" style=\"color: #c068ff;\">${escapeHtml(server)}</span>\n          <span style=\"color: #888;\">::</span>\n          <span style=\"color: #fff;\">${escapeHtml(name)}</span>\n        </div>\n      `.trim();\n    },\n    result: (data: any, success = true) => {\n      if (!success || data.error) {\n        return `\n          <div class=\"bash-output\" style=\"\n            border-left: 3px solid #ff4444;\n            padding-left: 8px;\n            color: #ff6b6b;\n          \">\n            <div style=\"font-weight: bold; margin-bottom: 4px;\">MCP Error</div>\n            <pre style=\"margin: 0; white-space: pre-wrap;\">${escapeHtml(data.error || 'Unknown error')}</pre>\n          </div>\n        `.trim();\n      }\n\n      let content = '';\n\n      // 文本内容\n      if (data.content) {\n        content += `<pre class=\"bash-output\" style=\"max-height: 400px; overflow: auto;\">${escapeHtml(data.content)}</pre>`;\n      }\n\n      // 结构化数据\n      if (data.structuredContent) {\n        content += `<details style=\"margin-top: 8px;\">\n          <summary style=\"cursor: pointer; color: var(--accent-color);\">Structured Data</summary>\n          <pre style=\"margin: 4px 0; padding: 8px; background: var(--bg-secondary);\">${escapeHtml(JSON.stringify(data.structuredContent, null, 2))}</pre>\n        </details>`;\n      }\n\n      // 图像\n      if (data.images && data.images.length > 0) {\n        content += `<div style=\"margin-top: 8px;\">`;\n        data.images.forEach((img: any) => {\n          content += `<img src=\"data:${img.mimeType};base64,${img.data}\" style=\"max-width: 100%; border-radius: 4px;\" />`;\n        });\n        content += `</div>`;\n      }\n\n      // 资源\n      if (data.resources && data.resources.length > 0) {\n        content += `<div style=\"margin-top: 8px;\">\n          <div style=\"font-weight: bold; margin-bottom: 4px;\">Resources:</div>`;\n        data.resources.forEach((res: any) => {\n          content += `<div style=\"padding: 4px; background: var(--bg-secondary); margin: 4px 0;\">\n            <div style=\"font-size: 11px; color: var(--text-secondary);\">${escapeHtml(res.uri)}</div>\n            ${res.text ? `<pre style=\"margin: 4px 0 0 0;\">${escapeHtml(res.text)}</pre>` : ''}\n          </div>`;\n        });\n        content += `</div>`;\n      }\n\n      // 元数据\n      const meta = `\n        <div style=\"\n          font-size: 11px;\n          opacity: 0.6;\n          margin-top: 8px;\n          display: flex;\n          gap: 12px;\n        \">\n          <span>Server: ${escapeHtml(data.server)}</span>\n          <span>Duration: ${data.duration}ms</span>\n        </div>\n      `;\n\n      return content + meta;\n    },\n  },\n\n  /**\n   * MCP 结果 (简化版)\n   */\n  'mcp-result': {\n    call: () => '<div class=\"bash-command\">MCP Tool Call</div>',\n    result: (data: any, success = true) => {\n      return MCP_RENDER_TEMPLATES['mcp-tool'].result(data, success);\n    },\n  },\n} as const;\n\n/**\n * 获取 MCP 渲染模板\n */\nexport function getMCPRenderTemplate(toolName: string): string {\n  return 'mcp-tool';\n}\n\n/**\n * 渲染 MCP 工具调用\n */\nexport function renderMCPToolCall(\n  serverName: string,\n  toolName: string,\n  args: Record<string, any>\n): string {\n  const template = MCP_RENDER_TEMPLATES['mcp-tool'].call;\n  if (typeof template === 'function') {\n    return template({ _server: serverName, _name: toolName, ...args });\n  }\n  return template;\n}\n\n/**\n * 渲染 MCP 工具结果\n */\nexport function renderMCPToolResult(\n  result: any,\n  success = true\n): string {\n  const template = MCP_RENDER_TEMPLATES['mcp-tool'].result;\n  if (typeof template === 'function') {\n    return template(result, success);\n  }\n  return template;\n}\n"],"mappings":"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","names":[]}

package/dist/{notification-3VEAP7YF.js → notification-NWVOS2WR.js}

@@ -1,7 +1,7 @@
 import {
   DebugHub
-} from "./chunk-3BPSNNK3.js";
-import "./chunk-TSASFMRF.js";
+} from "./chunk-EECW6PYP.js";
+import "./chunk-BAP2GCYH.js";
 import "./chunk-BDS2QGZ5.js";
 
 // src/core/notification.ts
@@ -86,4 +86,4 @@ export {
   createToolStart,
   emitNotification
 };
-//# sourceMappingURL=notification-3VEAP7YF.js.map
+//# sourceMappingURL=notification-NWVOS2WR.js.map

package/dist/tools-LDR3LIJP.js

@@ -0,0 +1,14 @@
+import {
+  captureWindow,
+  createCaptureAndUnderstandAdvancedTool,
+  createCaptureAndUnderstandTool,
+  understandImage
+} from "./chunk-G5ECPY4K.js";
+import "./chunk-BDS2QGZ5.js";
+export {
+  captureWindow,
+  createCaptureAndUnderstandAdvancedTool,
+  createCaptureAndUnderstandTool,
+  understandImage
+};
+//# sourceMappingURL=tools-LDR3LIJP.js.map

package/dist/tools-LDR3LIJP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{types-DUKIIntb.d.ts → types-CF5UsxD9.d.ts}

@@ -468,6 +468,8 @@ interface AgentConfig {
     maxTurns?: number;
     systemMessage?: string | TemplateSource;
     name?: string;
+    projectRoot?: string;
+    workspaceDir?: string;
     /**
      * Feature 配置
      *
@@ -488,6 +490,7 @@ interface AgentInfo {
     id: string;
     name: string;
     registeredAt: number;
+    projectRoot?: string;
 }
 /**
  * 工具元数据（用于前端渲染）

package/node_modules/@sliverp/qqbot/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sliverp
+
+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/node_modules/@sliverp/qqbot/README.md

@@ -0,0 +1,427 @@
+<div align="center">
+
+
+
+<img width="120" src="https://img.shields.io/badge/🤖-QQ_Bot-blue?style=for-the-badge" alt="QQ Bot" />
+
+# QQ Bot Channel Plugin for OpenClaw
+
+**Connect your AI assistant to QQ — private chat, group chat, and rich media, all in one plugin.**
+
+[![npm version](https://img.shields.io/npm/v/@sliverp/qqbot?color=blue&label=npm)](https://www.npmjs.com/package/@sliverp/qqbot)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
+[![Platform](https://img.shields.io/badge/platform-OpenClaw-orange)](https://github.com/sliverp/openclaw)
+[![Node.js](https://img.shields.io/badge/Node.js->=18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+<br/>
+
+**[简体中文](README.zh.md) | English**
+
+Scan to join the QQ group chat
+
+<img width="300" height="540" alt="Clipboard_Screenshot_1773047715" src="https://github.com/user-attachments/assets/4d2d2337-229a-42ad-97ab-8a6d0607f296" />
+
+
+</div>
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔒 **Multi-Scene** | C2C private chat, group @messages, channel messages, channel DMs |
+| 🖼️ **Rich Media** | Send & receive images, voice, video, and files |
+| 🎙️ **Voice (STT/TTS)** | Speech-to-text transcription & text-to-speech replies |
+| ⏰ **Scheduled Push** | Proactive message delivery via scheduled tasks |
+| 🔗 **URL Support** | Direct URL sending in private chat (no restrictions) |
+| ⌨️ **Typing Indicator** | "Bot is typing..." status shown in real-time |
+| 🔄 **Hot Reload** | Install via npm with seamless hot updates |
+| 📝 **Markdown** | Full Markdown formatting support |
+| 🛠️ **Commands** | Native OpenClaw command integration |
+
+---
+
+## 📸 Feature Showcase
+
+> **Note:** This plugin serves as a **message channel** only — it relays messages between QQ and OpenClaw. Capabilities like image understanding, voice transcription, drawing, etc. depend on the **AI model** you configure and the **skills** installed in OpenClaw, not on this plugin itself.
+
+<details>
+<summary><b>🎙️ Voice Messages (STT)</b> — AI understands voice messages, auto-transcribes speech to text</summary>
+
+> **You**: *(send a voice message)* "What's the weather like tomorrow in Shenzhen?"
+>
+> **QQBot**: Tomorrow (March 7, Saturday) Shenzhen weather forecast 🌤️ ...
+
+<img width="360" src="docs/images/fc7b2236896cfba3a37c94be5d59ce3e_720.jpg" alt="Voice STT Demo" />
+
+</details>
+
+<details>
+<summary><b>📄 File Understanding</b> — Send any file, AI reads and understands it</summary>
+
+> **You**: *(send a TXT file of "War and Peace")*
+>
+> **QQBot**: Got it! You uploaded the Chinese version of "War and Peace" by Leo Tolstoy. This appears to be the opening of Chapter 1...
+
+<img width="360" src="docs/images/07bff56ab68e03173d2af586eeb3bcee_720.jpg" alt="File Understanding Demo" />
+
+</details>
+
+<details>
+<summary><b>🖼️ Image Understanding</b> — Vision-capable models can see and describe images</summary>
+
+> **You**: *(send an image)*
+>
+> **QQBot**: Haha, so cute! Is that a QQ penguin in a lobster costume? 🦞🐧 ...
+
+<img width="360" src="docs/images/59d421891f813b0d3c0cbe12574b6a72_720.jpg" alt="Image Understanding Demo" />
+
+</details>
+
+<details>
+<summary><b>🎨 Image Generation</b> — Ask the bot to draw, it sends the result back</summary>
+
+> **You**: Draw me a cat
+>
+> **QQBot**: Here you go! 🐱
+
+<img width="360" src="docs/images/4645f2b3a20822b7f8d6664a708529eb_720.jpg" alt="Image Generation Demo" />
+
+</details>
+
+<details>
+<summary><b>🔊 Voice Reply (TTS)</b> — Bot replies with voice messages</summary>
+
+> **You**: Tell me a joke in voice
+>
+> **QQBot**: *(sends a voice message)*
+
+<img width="360" src="docs/images/21dce8bfc553ce23d1bd1b270e9c516c.jpg" alt="TTS Voice Demo" />
+
+</details>
+
+<details>
+<summary><b>📎 File Sending</b> — Generate and send files of any format (up to 20MB)</summary>
+
+> **You**: Extract chapter 1 of War and Peace and send it as a file
+>
+> **QQBot**: *(sends a .txt file)*
+
+<img width="360" src="docs/images/17cada70df90185d45a2d6dd36e92f2f_720.jpg" alt="File Sending Demo" />
+
+</details>
+
+<details>
+<summary><b>🎬 Video Sending</b> — Send videos, large files auto-show upload progress</summary>
+
+> **You**: Send me a demo video
+>
+> **QQBot**: *(sends a video)*
+
+<img width="360" src="docs/images/85d03b8a216f267ab7b2aee248a18a41_720.jpg" alt="Video Sending Demo" />
+
+</details>
+
+> For a deep dive into rich media capabilities, see the [Media Guide](docs/qqbot-media-guide.md).
+
+---
+
+## ⭐ Star History
+
+<div align="center">
+
+[![Star History Chart](https://api.star-history.com/svg?repos=sliverp/qqbot&type=date&legend=top-left)](https://www.star-history.com/#sliverp/qqbot&type=date&legend=top-left)
+
+</div>
+
+---
+
+## 🚀 Getting Started
+
+### Step 1 — Create a QQ Bot on the QQ Open Platform
+
+1. Go to the [QQ Open Platform](https://q.qq.com/) and **scan the QR code with your phone QQ** to register / log in. If you haven't registered before, scanning will automatically complete the registration and bindyour QQ account.
+
+<img width="3246" height="1886" alt="Clipboard_Screenshot_1772980354" src="https://github.com/user-attachments/assets/d8491859-57e8-47e4-9d39-b21138be54d0" />
+
+2. After scanning, tap **Agree** on your phone — you'll land on the bot configuration page.
+3. Click **Create Bot** to create a new QQ bot.
+
+<img width="1982" height="1316" alt="Clipboard_Screenshot_1772980440" src="https://github.com/user-attachments/assets/3ccb494d-6e4d-462c-9218-b4dfd43a254f" />
+
+4. Find **AppID** and **AppSecret** on the bot's page, click **Copy** for each, and save them somewhere safe (e.g., a notepad). **AppSecret is not stored in plaintext — if you leave the page without saving it, you'll have to regenerate a new one.**
+
+<img width="1670" height="1036" alt="Clipboard_Screenshot_1772980413" src="https://github.com/user-attachments/assets/b898d171-5711-4d42-bc07-2de967b119ec" />
+
+
+> For a step-by-step walkthrough with screenshots, see the [official guide](https://cloud.tencent.com/developer/article/2626045).
+
+> ⚠️ The bot will automatically appear in your QQ message list and send a first message. However, it will reply "The bot has gone to Mars" until you complete the configuration steps below.
+
+### Step 2 — Install the Plugin
+
+```bash
+# Via OpenClaw CLI (recommended)
+openclaw plugins install @sliverp/qqbot@latest
+
+# Or from source
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+openclaw plugins install .
+```
+
+### Step 3 — Configure OpenClaw
+
+**Option 1: CLI Wizard (Recommended)**
+
+```bash
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
+```
+
+**Option 2: Edit Config File**
+
+Edit `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "Your AppID",
+      "clientSecret": "Your AppSecret"
+    }
+  }
+}
+```
+
+### Step 4 — Start & Test
+
+```bash
+openclaw gateway
+```
+
+Open QQ, find your bot, and send a message!
+
+<div align="center">
+<img width="500" alt="Chat Demo" src="https://github.com/user-attachments/assets/b2776c8b-de72-4e37-b34d-e8287ce45de1" />
+</div>
+
+---
+
+## 🤖 Multi-Account Setup (Multi-Bot)
+
+Run multiple QQ bots under a single OpenClaw instance.
+
+### Configuration
+
+Edit `~/.openclaw/openclaw.json` and add an `accounts` field under `channels.qqbot`:
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "111111111",
+      "clientSecret": "secret-of-bot-1",
+
+      "accounts": {
+        "bot2": {
+          "enabled": true,
+          "appId": "222222222",
+          "clientSecret": "secret-of-bot-2"
+        },
+        "bot3": {
+          "enabled": true,
+          "appId": "333333333",
+          "clientSecret": "secret-of-bot-3"
+        }
+      }
+    }
+  }
+}
+```
+
+**Notes:**
+
+- The top-level `appId` / `clientSecret` is the **default account** (accountId = `"default"`)
+- Each key under `accounts` (e.g. `bot2`, `bot3`) is the `accountId` for that bot
+- Each account can independently configure `enabled`, `name`, `allowFrom`, `systemPrompt`, etc.
+- You may also skip the top-level default account and only configure bots inside `accounts`
+
+Add a second bot via CLI (if the framework supports the `--account` parameter):
+
+```bash
+openclaw channels add --channel qqbot --account bot2 --token "222222222:secret-of-bot-2"
+```
+
+### Sending Messages to a Specific Account's Users
+
+When using `openclaw message send`, specify which bot to use with the `--account` parameter:
+
+```bash
+# Send with the default bot (no --account = uses "default")
+openclaw message send --channel "qqbot" \
+  --target "qqbot:c2c:OPENID" \
+  --message "hello from default bot"
+
+# Send with bot2
+openclaw message send --channel "qqbot" \
+  --account bot2 \
+  --target "qqbot:c2c:OPENID" \
+  --message "hello from bot2"
+```
+
+**Target Formats:**
+
+| Format | Description |
+|--------|-------------|
+| `qqbot:c2c:OPENID` | Private chat (C2C) |
+| `qqbot:group:GROUP_OPENID` | Group chat |
+| `qqbot:channel:CHANNEL_ID` | Guild channel |
+
+> ⚠️ **Important**: Each bot has its own set of user OpenIDs. An OpenID received by Bot A **cannot** be used to send messages via Bot B — this will result in a 500 error. Always use the matching bot's `accountId` to send messages to its users.
+
+### How It Works
+
+- When `openclaw gateway` starts, all accounts with `enabled: true` launch their own WebSocket connections
+- Each account maintains an independent Token cache (isolated by `appId`), preventing cross-contamination
+- Incoming message logs are prefixed with `[qqbot:accountId]` for easy debugging
+
+---
+
+## 🎙️ Voice Configuration (Optional)
+
+### STT (Speech-to-Text) — Transcribe Incoming Voice Messages
+
+STT supports two-level configuration with priority fallback:
+
+| Priority | Config Path | Scope |
+|----------|------------|-------|
+| 1 (highest) | `channels.qqbot.stt` | Plugin-specific |
+| 2 (fallback) | `tools.media.audio.models[0]` | Framework-level |
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "stt": {
+        "provider": "your-provider",
+        "model": "your-stt-model"
+      }
+    }
+  }
+}
+```
+
+- `provider` — references a key in `models.providers` to inherit `baseUrl` and `apiKey`
+- Set `enabled: false` to disable
+- When configured, incoming voice messages are automatically converted (SILK→WAV) and transcribed
+
+### TTS (Text-to-Speech) — Send Voice Messages
+
+| Priority | Config Path | Scope |
+|----------|------------|-------|
+| 1 (highest) | `channels.qqbot.tts` | Plugin-specific |
+| 2 (fallback) | `messages.tts` | Framework-level |
+
+```json
+{
+  "channels": {
+    "qqbot": {
+      "tts": {
+        "provider": "your-provider",
+        "model": "your-tts-model",
+        "voice": "your-voice"
+      }
+    }
+  }
+}
+```
+
+- `provider` — references a key in `models.providers` to inherit `baseUrl` and `apiKey`
+- `voice` — voice variant
+- Set `enabled: false` to disable (default: `true`)
+- When configured, AI can use `<qqvoice>` tags to generate and send voice messages
+
+---
+
+## 🔄 Upgrade
+
+### Via OpenClaw / npm (Recommended)
+
+> For installations via `openclaw plugins install`
+
+```bash
+openclaw plugins upgrade @sliverp/qqbot@latest
+```
+
+### Via npx
+
+```bash
+npx -y @sliverp/qqbot@latest upgrade
+```
+
+### Via upgrade-and-run.sh (One-Click)
+
+```bash
+bash ./upgrade-and-run.sh
+```
+
+When no `--appid` / `--secret` is provided, the script reads existing config from `~/.openclaw/openclaw.json` automatically.
+
+```bash
+# First-time or override credentials
+bash ./upgrade-and-run.sh --appid YOUR_APPID --secret YOUR_SECRET
+```
+
+<details>
+<summary>Full Options</summary>
+
+| Option | Description |
+|--------|-------------|
+| `--appid <id>` | QQ Bot AppID |
+| `--secret <secret>` | QQ Bot AppSecret |
+| `--markdown <yes\|no>` | Enable Markdown format (default: no) |
+| `-h, --help` | Show help |
+
+Environment variables `QQBOT_APPID`, `QQBOT_SECRET`, `QQBOT_TOKEN` (AppID:Secret) are also supported.
+
+</details>
+
+### Via pull-latest.sh (Git Source)
+
+```bash
+bash ./pull-latest.sh
+```
+
+<details>
+<summary>Options</summary>
+
+```bash
+bash ./pull-latest.sh --branch main            # specify branch (default: main)
+bash ./pull-latest.sh --force                   # skip prompts, force update
+bash ./pull-latest.sh --repo <git-url>          # use a different repo
+```
+
+</details>
+
+### From Source (Manual)
+
+```bash
+git clone https://github.com/sliverp/qqbot.git && cd qqbot
+bash ./scripts/upgrade.sh
+openclaw plugins install .
+openclaw channels add --channel qqbot --token "AppID:AppSecret"
+openclaw gateway restart
+```
+
+---
+
+## 📚 Documentation
+
+- [Rich Media Guide](docs/qqbot-media-guide.md) — images, voice, video, files
+- [Command Reference](docs/commands.md) — OpenClaw CLI commands
+- [Changelog](docs/changelog/) — release notes ([latest: 1.5.4](docs/changelog/1.5.4.md))
+