{"id":137,"date":"2026-06-14T09:20:39","date_gmt":"2026-06-14T01:20:39","guid":{"rendered":"http:\/\/www.longxiapro.com\/?p=137"},"modified":"2026-06-14T10:59:26","modified_gmt":"2026-06-14T02:59:26","slug":"cong-ling-kai-fa-kuo-zhan-neng-li-openclaw-cha-jian-sdk-gao-jie-kai-fa-shi-zhan-jiao-cheng","status":"publish","type":"post","link":"https:\/\/www.longxiapro.com\/index.php\/137\/","title":{"rendered":"\u4ece\u96f6\u5f00\u53d1\u6269\u5c55\u80fd\u529b\uff01OpenClaw \u63d2\u4ef6 SDK \u9ad8\u9636\u5f00\u53d1\u5b9e\u6218\u6559\u7a0b"},"content":{"rendered":"\n

\u4e00\u3001\u63d2\u4ef6\u6574\u4f53\u67b6\u6784\u4e0e\u5206\u7c7b<\/h3>\n\n\n\n

OpenClaw \u63d2\u4ef6\u8fd0\u884c\u5728 Gateway \u4e3b\u8fdb\u7a0b\u5185\uff0c\u53ef\u5bf9\u6838\u5fc3\u80fd\u529b\u505a\u7075\u6d3b\u6269\u5c55\uff0c\u6253\u901a\u5916\u90e8\u804a\u5929\u6e20\u9053\u3001\u63a5\u5165\u81ea\u5b9a\u4e49\u5927\u6a21\u578b\u3001\u65b0\u589e\u4e1a\u52a1\u529f\u80fd\u3002<\/p>\n\n\n\n

\u67b6\u6784\u5206\u5c42<\/h3>\n\n\n\n

plaintext<\/p>\n\n\n\n

Gateway \u4e3b\u8fdb\u7a0b\n\u251c\u2500 \u6838\u5fc3\u6a21\u5757\uff08\u4f1a\u8bdd\/\u4e0a\u4e0b\u6587\/\u5de5\u5177\u7cfb\u7edf\uff09\n\u2514\u2500 \u63d2\u4ef6\u5c42\n   \u251c\u2500 \u6e20\u9053\u63d2\u4ef6 Channel Plugins  \u2192 \u5bf9\u63a5\u5404\u7c7b\u804a\u5929\u5e73\u53f0\n   \u251c\u2500 \u6a21\u578b\u63d0\u4f9b\u5546\u63d2\u4ef6 Provider Plugins \u2192 \u63a5\u5165\u81ea\u7814\/\u7b2c\u4e09\u65b9 LLM\n   \u2514\u2500 \u901a\u7528\u529f\u80fd\u63d2\u4ef6 Extension \u2192 \u65b0\u589e\u81ea\u5b9a\u4e49\u5de5\u5177\u3001\u8bed\u97f3\u3001\u4e1a\u52a1\u903b\u8f91\n<\/code><\/pre>\n\n\n\n
\u63d2\u4ef6\u7c7b\u578b\u8bf4\u660e<\/h3>\n\n\n\n
\u8868\u683c<\/p>\n\n\n\n
\u63d2\u4ef6\u7c7b\u578b<\/th>type \u5b57\u6bb5\u503c<\/th>\u6838\u5fc3\u7528\u9014<\/th>\u5178\u578b\u573a\u666f<\/th><\/tr><\/thead>
\u6e20\u9053\u63d2\u4ef6<\/td>channel<\/code><\/td>\u65b0\u589e\u5bf9\u8bdd\u63a5\u5165\u7aef<\/td>\u9489\u9489\u3001\u4f01\u4e1a\u5fae\u4fe1\u3001\u81ea\u5b9a\u4e49 WebSocket \u804a\u5929<\/td><\/tr>
\u63d0\u4f9b\u5546\u63d2\u4ef6<\/td>provider<\/code><\/td>\u5bf9\u63a5 AI \u6a21\u578b\u63a5\u53e3<\/td>\u79c1\u6709\u90e8\u7f72 LLM\u3001\u79c1\u6709\u5316 API\u3001\u7b2c\u4e09\u65b9\u5927\u6a21\u578b<\/td><\/tr>
\u529f\u80fd\u63d2\u4ef6<\/td>extension<\/code><\/td>\u62d3\u5c55\u7f51\u5173\u901a\u7528\u80fd\u529b<\/td>\u8bed\u97f3\u901a\u8bdd\u3001\u81ea\u5b9a\u4e49\u5de5\u5177\u3001\u6d88\u606f\u56de\u8c03\u3001\u6570\u636e\u7edf\u8ba1<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n
\u4e8c\u3001\u5f00\u53d1\u73af\u5883\u642d\u5efa<\/h3>\n\n\n\n
\u524d\u7f6e\u4f9d\u8d56<\/h3>\n\n\n\n
    \n
  • Node.js\uff1a22.14+ \/ 24+<\/strong><\/li>\n\n\n\n
  • \u5305\u7ba1\u7406\u5668\uff1apnpm\uff08\u63a8\u8350\uff09\u3001npm<\/li>\n\n\n\n
  • TypeScript\uff1a5.0+<\/li>\n\n\n\n
  • \u672c\u5730\u5df2\u90e8\u7f72\u53ef\u6b63\u5e38\u8fd0\u884c\u7684 OpenClaw<\/li>\n<\/ul>\n\n\n\n
    1. \u521d\u59cb\u5316\u9879\u76ee<\/h3>\n\n\n\n
    bash<\/p>\n\n\n\n
    \u8fd0\u884c<\/p>\n\n\n\n
    # \u521b\u5efa\u9879\u76ee\u76ee\u5f55\nmkdir my-openclaw-plugin\ncd my-openclaw-plugin\n\n# \u521d\u59cb\u5316\u5305\u7ba1\u7406\npnpm init\n\n# \u5b89\u88c5 SDK \u4e0e\u7f16\u8bd1\u4f9d\u8d56\npnpm add -D @openclaw\/plugin-sdk typescript @types\/node\n\n# \u751f\u6210 tsconfig \u914d\u7f6e\u6587\u4ef6\nnpx tsc --init\n<\/code><\/pre>\n\n\n\n
    2. \u6807\u51c6 tsconfig.json<\/h3>\n\n\n\n
    \u66ff\u6362\u9ed8\u8ba4\u914d\u7f6e\uff0c\u9002\u914d\u63d2\u4ef6\u7f16\u8bd1\u89c4\u8303\uff1a<\/p>\n\n\n\n
    json<\/p>\n\n\n\n
    {\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"bundler\",\n    \"outDir\": \".\/dist\",\n    \"rootDir\": \".\/src\",\n    \"strict\": true,\n    \"esModuleInterop\": true,\n    \"declaration\": true,\n    \"sourceMap\": true\n  },\n  \"include\": [\"src\/**\/*\"]\n}\n<\/code><\/pre>\n\n\n\n
    3. \u6807\u51c6\u9879\u76ee\u76ee\u5f55\u7ed3\u6784<\/h3>\n\n\n\n
    plaintext<\/p>\n\n\n\n
    my-openclaw-plugin\/\n\u251c\u2500\u2500 src\/\n\u2502   \u2514\u2500\u2500 index.ts        # \u63d2\u4ef6\u5165\u53e3\u6587\u4ef6\n\u251c\u2500\u2500 openclaw.plugin.json # \u63d2\u4ef6\u6e05\u5355\uff08\u5fc5\u586b\uff0c\u6838\u5fc3\u914d\u7f6e\uff09\n\u251c\u2500\u2500 package.json\n\u251c\u2500\u2500 tsconfig.json\n\u2514\u2500\u2500 README.md\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    \u4e09\u3001\u63d2\u4ef6\u6e05\u5355\uff1aopenclaw.plugin.json\uff08\u6838\u5fc3\u914d\u7f6e\uff09<\/h3>\n\n\n\n
    \u8be5\u6587\u4ef6\u662f\u63d2\u4ef6\u7684\u8eab\u4efd\u6807\u8bc6\uff0c\u5b9a\u4e49\u5143\u6570\u636e\u3001\u7c7b\u578b\u3001\u53ef\u914d\u7f6e\u9879\uff0c\u6240\u6709\u63d2\u4ef6\u5fc5\u987b\u5b58\u5728<\/strong>\u3002<\/p>\n\n\n\n
    \u5b8c\u6574\u6a21\u677f<\/h3>\n\n\n\n
    json<\/p>\n\n\n\n
    {\n  \"name\": \"my-custom-channel\",\n  \"version\": \"1.0.0\",\n  \"displayName\": \"\u81ea\u5b9a\u4e49\u804a\u5929\u6e20\u9053\",\n  \"description\": \"\u5bf9\u63a5\u81ea\u7814\u804a\u5929\u5e73\u53f0\u7684\u6e20\u9053\u63d2\u4ef6\",\n  \"author\": \"your-name\",\n  \"license\": \"MIT\",\n  \"main\": \"dist\/index.js\",\n  \"type\": \"channel\",\n  \"openclaw\": {\n    \"minVersion\": \"1.0.0\"\n  },\n  \"config\": {\n    \"apiKey\": {\n      \"type\": \"string\",\n      \"description\": \"\u5e73\u53f0\u63a5\u53e3\u5bc6\u94a5\",\n      \"required\": true,\n      \"secret\": true\n    },\n    \"webhookPort\": {\n      \"type\": \"number\",\n      \"description\": \"Webhook \u76d1\u542c\u7aef\u53e3\",\n      \"default\": 8080\n    },\n    \"enableDebug\": {\n      \"type\": \"boolean\",\n      \"description\": \"\u5f00\u542f\u8c03\u8bd5\u65e5\u5fd7\",\n      \"default\": false\n    }\n  }\n}\n<\/code><\/pre>\n\n\n\n
    \u5b57\u6bb5\u8be6\u89e3<\/h3>\n\n\n\n
    \u8868\u683c<\/p>\n\n\n\n
    \u5b57\u6bb5<\/th>\u5fc5\u586b<\/th>\u8bf4\u660e<\/th><\/tr><\/thead>
    name<\/code><\/td>\u662f<\/td>\u63d2\u4ef6\u552f\u4e00\u6807\u8bc6\uff0c\u5c0f\u5199\u8fde\u5b57\u7b26\u683c\u5f0f\uff08kebab-case\uff09<\/td><\/tr>
    version<\/code><\/td>\u662f<\/td>\u8bed\u4e49\u5316\u7248\u672c\u53f7\uff08\u4e3b\u3002\u6b21. \u4fee\u8ba2\uff09<\/td><\/tr>
    displayName<\/code><\/td>\u662f<\/td>\u524d\u7aef\u5c55\u793a\u540d\u79f0<\/td><\/tr>
    description<\/code><\/td>\u662f<\/td>\u63d2\u4ef6\u529f\u80fd\u63cf\u8ff0<\/td><\/tr>
    main<\/code><\/td>\u662f<\/td>\u7f16\u8bd1\u540e\u5165\u53e3\u6587\u4ef6\u8def\u5f84<\/td><\/tr>
    type<\/code><\/td>\u662f<\/td>\u63d2\u4ef6\u7c7b\u578b\uff1achannel<\/code> \/ provider<\/code> \/ extension<\/code><\/td><\/tr>
    openclaw.minVersion<\/code><\/td>\u5426<\/td>\u517c\u5bb9\u7684\u6700\u4f4e OpenClaw \u7248\u672c<\/td><\/tr>
    config<\/code><\/td>\u5426<\/td>\u81ea\u5b9a\u4e49\u914d\u7f6e\u9879\uff0c\u652f\u6301\u5b57\u7b26\u4e32 \/ \u6570\u5b57 \/ \u5e03\u5c14\uff0csecret=true<\/code> \u4ee3\u8868\u5bc6\u94a5\uff0c\u540e\u53f0\u4e0d\u5c55\u793a\u660e\u6587<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    \u914d\u7f6e\u9879\u7c7b\u578b\u6c47\u603b<\/h3>\n\n\n\n
    json<\/p>\n\n\n\n
    \"config\": {\n  \"str\": { \"type\": \"string\", \"required\": true, \"default\": \"demo\" },\n  \"num\": { \"type\": \"number\", \"default\": 8080 },\n  \"bool\": { \"type\": \"boolean\", \"default\": true },\n  \"secretKey\": { \"type\": \"string\", \"secret\": true }\n}\n<\/code><\/pre>\n\n\n\n
    \n\n\n\n
    \u56db\u3001\u6e20\u9053\u63d2\u4ef6\u5f00\u53d1\uff08Channel Plugin\uff09<\/h3>\n\n\n\n
    \u7528\u4e8e\u5bf9\u63a5\u5404\u7c7b\u804a\u5929\u5e73\u53f0\uff0c\u5b9e\u73b0\u6d88\u606f\u6536\u53d1\u3001\u72b6\u6001\u63d0\u793a\u3001\u5a92\u4f53\u6d88\u606f\u5904\u7406\u3002<\/p>\n\n\n\n
    1. \u57fa\u7840\u5165\u53e3\u4ee3\u7801\uff08src\/index.ts\uff09<\/h3>\n\n\n\n
    typescript<\/p>\n\n\n\n
    \u8fd0\u884c<\/p>\n\n\n\n
    import { ChannelPlugin, Message, SendOptions } from '@openclaw\/plugin-sdk'\n\nexport default class CustomChannel extends ChannelPlugin {\n  \/** \u63d2\u4ef6\u52a0\u8f7d\uff0c\u521d\u59cb\u5316\u8fde\u63a5\u3001\u670d\u52a1 *\/\n  async onLoad(): Promise<void> {\n    const apiKey = this.config.get<string>('apiKey')\n    const port = this.config.get<number>('webhookPort')\n    this.logger.info(`\u6e20\u9053\u63d2\u4ef6\u52a0\u8f7d\u5b8c\u6210\uff0c\u7aef\u53e3\uff1a${port}`)\n\n    \/\/ \u6b64\u5904\u521d\u59cb\u5316 WebSocket \/ Webhook \u670d\u52a1\u3001\u5bf9\u63a5\u7b2c\u4e09\u65b9\u5e73\u53f0\n    this.startListen()\n  }\n\n  \/** \u5411\u5916\u53d1\u9001\u6587\u672c\/\u5a92\u4f53\u6d88\u606f *\/\n  async sendMessage(message: Message, options: SendOptions): Promise<void> {\n    const { chatId, text, attachments } = message\n\n    \/\/ \u5904\u7406\u5a92\u4f53\u9644\u4ef6\n    if (attachments && attachments.length > 0) {\n      for (const att of attachments) {\n        if (att.type === 'image') {\n          await this.sendImage(chatId, att.url)\n        }\n        if (att.type === 'file') {\n          await this.sendFile(chatId, att.url, att.name)\n        }\n      }\n    }\n\n    \/\/ \u53d1\u9001\u6587\u672c\u6d88\u606f\n    if (text) {\n      await this.sendText(chatId, text)\n    }\n  }\n\n  \/** \u8f93\u5165\u4e2d\u72b6\u6001\u63d0\u793a *\/\n  async sendTypingIndicator(chatId: string): Promise<void> {\n    \/\/ \u8c03\u7528\u5e73\u53f0\u63a5\u53e3\uff0c\u5c55\u793a\u300c\u5bf9\u65b9\u6b63\u5728\u8f93\u5165\u300d\n  }\n\n  \/** \u63d2\u4ef6\u5378\u8f7d\uff0c\u91ca\u653e\u8d44\u6e90 *\/\n  async onUnload(): Promise<void> {\n    this.logger.info('\u6e20\u9053\u63d2\u4ef6\u5df2\u5378\u8f7d\uff0c\u5173\u95ed\u8fde\u63a5')\n    \/\/ \u5173\u95ed\u7aef\u53e3\u3001\u65ad\u5f00\u8fde\u63a5\u3001\u9500\u6bc1\u5b9a\u65f6\u5668\n  }\n\n  \/\/ \u5185\u90e8\uff1a\u76d1\u542c\u5916\u90e8\u6d88\u606f\uff0c\u8f6c\u53d1\u7ed9 Gateway\n  private startListen() {\n    \/\/ \u6a21\u62df\u6536\u5230\u7b2c\u4e09\u65b9\u5e73\u53f0\u6d88\u606f\n    setInterval(() => {\n      \/\/ \u63a8\u9001\u6d88\u606f\u81f3\u7f51\u5173\u6838\u5fc3\u5904\u7406\n      this.emitMessage({\n        text: \"\u4f60\u597d\uff0c\u6211\u662f\u5916\u90e8\u7528\u6237\",\n        chatId: \"chat_1001\",\n        senderId: \"user_001\",\n        senderName: \"\u8bbf\u5ba2\",\n        timestamp: Date.now()\n      })\n    }, 3000)\n  }\n\n  \/\/ \u6a21\u62df\u63a5\u53e3\u65b9\u6cd5\n  private async sendText(chatId: string, text: string) {}\n  private async sendImage(chatId: string, url: string) {}\n  private async sendFile(chatId: string, url: string, name: string) {}\n}\n<\/code><\/pre>\n\n\n\n
    \u6838\u5fc3\u80fd\u529b\u8bf4\u660e<\/h3>\n\n\n\n
      \n
    1. \u6d88\u606f\u4e0a\u884c<\/strong>\uff1a\u5916\u90e8\u6d88\u606f\u901a\u8fc7 emitMessage<\/code> \u63a8\u9001\u7ed9 Gateway\uff1b<\/li>\n\n\n\n
    2. \u6d88\u606f\u4e0b\u884c<\/strong>\uff1a\u7f51\u5173\u56de\u590d\u901a\u8fc7 sendMessage<\/code> \u53d1\u9001\u5230\u804a\u5929\u5e73\u53f0\uff1b<\/li>\n\n\n\n
    3. \u5a92\u4f53\u652f\u6301<\/strong>\uff1a\u539f\u751f\u652f\u6301\u56fe\u7247\u3001\u6587\u4ef6\u7b49\u9644\u4ef6\u5206\u53d1\uff1b<\/li>\n\n\n\n
    4. \u751f\u547d\u5468\u671f<\/strong>\uff1aonLoad<\/code> \u521d\u59cb\u5316\u3001onUnload<\/code> \u6e05\u7406\u8d44\u6e90\u3002<\/li>\n<\/ol>\n\n\n\n
      \n\n\n\n
      \u4e94\u3001\u6a21\u578b\u63d0\u4f9b\u5546\u63d2\u4ef6\u5f00\u53d1\uff08Provider Plugin\uff09<\/h3>\n\n\n\n
      \u5bf9\u63a5\u81ea\u5b9a\u4e49 \/ \u79c1\u6709\u5316 LLM \u63a5\u53e3\uff0c\u652f\u6301\u666e\u901a\u5bf9\u8bdd\u3001\u6d41\u5f0f SSE \u8f93\u51fa\u3001\u6a21\u578b\u5217\u8868\u67e5\u8be2\u3002<\/p>\n\n\n\n
      \u5b8c\u6574\u793a\u4f8b\u4ee3\u7801<\/h3>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      import { ProviderPlugin, ChatRequest, ChatResponse } from '@openclaw\/plugin-sdk'\n\nexport default class CustomLLMProvider extends ProviderPlugin {\n  private apiKey: string = ''\n  private baseUrl: string = ''\n\n  async onLoad(): Promise<void> {\n    this.apiKey = this.config.get<string>('apiKey')\n    this.baseUrl = this.config.get<string>('baseUrl')\n    this.logger.info('\u81ea\u5b9a\u4e49\u6a21\u578b\u63d0\u4f9b\u5546\u52a0\u8f7d\u6210\u529f')\n  }\n\n  \/** \u975e\u6d41\u5f0f\u5bf9\u8bdd *\/\n  async chat(request: ChatRequest): Promise<ChatResponse> {\n    const { messages, model, temperature, maxTokens } = request\n\n    const res = await fetch(`${this.baseUrl}\/v1\/chat\/completions`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application\/json',\n        'Authorization': `Bearer ${this.apiKey}`\n      },\n      body: JSON.stringify({\n        model,\n        messages,\n        temperature,\n        max_tokens: maxTokens\n      })\n    })\n\n    const data = await res.json()\n    return {\n      content: data.choices[0].message.content,\n      usage: {\n        promptTokens: data.usage.prompt_tokens,\n        completionTokens: data.usage.completion_tokens\n      }\n    }\n  }\n\n  \/** \u6d41\u5f0f SSE \u5bf9\u8bdd\uff08\u53ef\u9009\uff0c\u9002\u914d\u6253\u5b57\u673a\u6548\u679c\uff09 *\/\n  async *chatStream(request: ChatRequest): AsyncGenerator<Partial<ChatResponse>> {\n    const res = await fetch(`${this.baseUrl}\/v1\/chat\/completions`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application\/json',\n        'Authorization': `Bearer ${this.apiKey}`\n      },\n      body: JSON.stringify({ ...request, stream: true })\n    })\n\n    \/\/ \u89e3\u6790 SSE \u6d41\n    for await (const chunk of this.parseSSE(res.body!)) {\n      yield { content: chunk.content }\n    }\n  }\n\n  \/** \u83b7\u53d6\u5f53\u524d\u53ef\u7528\u6a21\u578b\u5217\u8868 *\/\n  async listModels(): Promise<string[]> {\n    return ['my-7b', 'my-13b', 'my-70b']\n  }\n\n  async onUnload(): Promise<void> {\n    this.logger.info('\u6a21\u578b\u63d2\u4ef6\u5df2\u5378\u8f7d')\n  }\n}\n<\/code><\/pre>\n\n\n\n
      \n\n\n\n
      \u516d\u3001\u901a\u7528\u751f\u547d\u5468\u671f\u4e0e\u8fd0\u884c\u65f6 API<\/h3>\n\n\n\n
      1. \u5168\u751f\u547d\u5468\u671f\u94a9\u5b50<\/h3>\n\n\n\n
      \u6240\u6709\u63d2\u4ef6\u901a\u7528\uff0c\u7ba1\u63a7\u52a0\u8f7d\u3001\u5378\u8f7d\u3001\u914d\u7f6e\u53d8\u66f4\u3001\u5065\u5eb7\u68c0\u6d4b\uff1a<\/p>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      export default class DemoPlugin extends ChannelPlugin {\n  \/\/ \u63d2\u4ef6\u52a0\u8f7d\/\u542f\u52a8\n  async onLoad(): Promise<void> {}\n\n  \/\/ \u63d2\u4ef6\u5378\u8f7d\/\u505c\u6b62\n  async onUnload(): Promise<void> {}\n\n  \/\/ \u63d2\u4ef6\u914d\u7f6e\u4fee\u6539\u65f6\u89e6\u53d1\n  async onConfigChange(key: string, value: unknown): Promise<void> {}\n\n  \/\/ \u7f51\u5173\u5065\u5eb7\u5de1\u68c0\n  async onHealthCheck(): Promise<boolean> {\n    return true \/\/ true = \u5065\u5eb7\n  }\n}\n<\/code><\/pre>\n\n\n\n
      2. \u5185\u7f6e\u8fd0\u884c\u65f6 API<\/h3>\n\n\n\n
      \u65e5\u5fd7 Logger<\/h4>\n\n\n\n
      \u7edf\u4e00\u65e5\u5fd7\u8f93\u51fa\uff0c\u66ff\u4ee3 console.log<\/code><\/p>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      this.logger.info('\u666e\u901a\u4fe1\u606f')\nthis.logger.warn('\u8b66\u544a\u4fe1\u606f')\nthis.logger.error('\u9519\u8bef\u4fe1\u606f', err)\nthis.logger.debug('\u8c03\u8bd5\u65e5\u5fd7')\n<\/code><\/pre>\n\n\n\n
      \u914d\u7f6e\u8bfb\u53d6 Config<\/h4>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      \/\/ \u8bfb\u53d6\u914d\u7f6e\uff0c\u652f\u6301\u9ed8\u8ba4\u503c\nconst key = this.config.get<string>('apiKey')\nconst port = this.config.get<number>('port', 8080)\n\n\/\/ \u5224\u65ad\u914d\u7f6e\u9879\u662f\u5426\u5b58\u5728\nif (this.config.has('enableDebug')) {}\n<\/code><\/pre>\n\n\n\n
      \u6301\u4e45\u5316\u5b58\u50a8 Storage<\/h4>\n\n\n\n
      \u63d2\u4ef6\u672c\u5730\u8f7b\u91cf\u6570\u636e\u6301\u4e45\u5316<\/p>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      \/\/ \u5199\u5165\nawait this.storage.set('lastRunTime', Date.now())\n\/\/ \u8bfb\u53d6\nconst time = await this.storage.get<number>('lastRunTime')\n\/\/ \u5220\u9664\nawait this.storage.delete('lastRunTime')\n<\/code><\/pre>\n\n\n\n
      \u4e8b\u4ef6\u901a\u4fe1 Events<\/h4>\n\n\n\n
      \u63d2\u4ef6\u4e4b\u95f4\u8de8\u7ec4\u4ef6\u901a\u4fe1<\/p>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      \/\/ \u53d1\u9001\u4e8b\u4ef6\nthis.emit('custom-event', { data: 'hello' })\n\n\/\/ \u76d1\u542c\u4e8b\u4ef6\nthis.on('other-event', (payload) => {\n  this.logger.info('\u6536\u5230\u8de8\u63d2\u4ef6\u4e8b\u4ef6', payload)\n})\n<\/code><\/pre>\n\n\n\n
      \n\n\n\n
      \u4e03\u3001\u672c\u5730\u8c03\u8bd5\u4e0e\u52a0\u8f7d<\/h3>\n\n\n\n
      1. \u7f16\u8bd1\u4ee3\u7801<\/h3>\n\n\n\n
      bash<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      pnpm build\n<\/code><\/pre>\n\n\n\n
      2. \u672c\u5730\u6302\u8f7d\u63d2\u4ef6<\/h3>\n\n\n\n
      \u7f16\u8f91 OpenClaw \u4e3b\u914d\u7f6e openclaw.json<\/code>\uff0c\u6307\u5411\u63d2\u4ef6\u76ee\u5f55\uff1a<\/p>\n\n\n\n
      json<\/p>\n\n\n\n
      {\n  \"plugins\": {\n    \"entries\": [\n      {\n        \"source\": \"local\",\n        \"path\": \"\/\u4f60\u7684\u63d2\u4ef6\u7edd\u5bf9\u8def\u5f84\/my-openclaw-plugin\"\n      }\n    ]\n  }\n}\n<\/code><\/pre>\n\n\n\n
      3. \u91cd\u542f\u7f51\u5173\u751f\u6548<\/h3>\n\n\n\n
      bash<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      openclaw gateway restart\n<\/code><\/pre>\n\n\n\n
      4. \u65e5\u5fd7\u6392\u67e5<\/h3>\n\n\n\n
      bash<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      # \u67e5\u770b\u63d2\u4ef6\u76f8\u5173\u65e5\u5fd7\nopenclaw logs | grep plugin\n\n# \u5f00\u542f\u5168\u91cf\u8c03\u8bd5\u65e5\u5fd7\nOPENCLAW_LOG_LEVEL=debug openclaw gateway run\n<\/code><\/pre>\n\n\n\n
      5. \u5355\u5143\u6d4b\u8bd5\uff08Vitest\uff09<\/h3>\n\n\n\n
      \u5b89\u88c5\u6d4b\u8bd5\u4f9d\u8d56\uff1a<\/p>\n\n\n\n
      bash<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      pnpm add -D vitest\n<\/code><\/pre>\n\n\n\n
      \u7f16\u5199\u6d4b\u8bd5\u7528\u4f8b\uff1a<\/p>\n\n\n\n
      typescript<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      import { describe, it, expect } from 'vitest'\nimport MyPlugin from '..\/src\/index'\n\ndescribe('\u63d2\u4ef6\u6d4b\u8bd5', () => {\n  it('\u521d\u59cb\u5316\u6b63\u5e38', () => {\n    const plugin = new MyPlugin()\n    expect(plugin).toBeDefined()\n  })\n})\n<\/code><\/pre>\n\n\n\n
      \u6267\u884c\u6d4b\u8bd5\uff1a<\/p>\n\n\n\n
      bash<\/p>\n\n\n\n
      \u8fd0\u884c<\/p>\n\n\n\n
      pnpm test\n<\/code><\/pre>\n\n\n\n
      \n\n\n\n
      \u516b\u3001\u63d2\u4ef6\u6253\u5305\u4e0e\u53d1\u5e03<\/h3>\n\n\n\n
      1. \u53d1\u5e03\u524d\u68c0\u67e5<\/h3>\n\n\n\n
        \n
      1. \u6267\u884c pnpm build<\/code> \u786e\u4fdd\u4ee3\u7801\u7f16\u8bd1\u6b63\u5e38\uff1b<\/li>\n\n\n\n
      2. \u5b8c\u5584 openclaw.plugin.json<\/code>\u3001README\uff1b<\/li>\n\n\n\n
      3. \u914d\u7f6e package.json<\/code> \u6253\u5305\u6587\u4ef6\u5217\u8868\uff1a<\/li>\n<\/ol>\n\n\n\n
        json<\/p>\n\n\n\n
        {\n  \"files\": [\n    \"dist\/\",\n    \"openclaw.plugin.json\",\n    \"README.md\"\n  ]\n}\n<\/code><\/pre>\n\n\n\n
        2. \u53d1\u5e03\u5230 ClawHub<\/h3>\n\n\n\n
        bash<\/p>\n\n\n\n
        \u8fd0\u884c<\/p>\n\n\n\n
        # \u767b\u5f55\u63d2\u4ef6\u5e02\u573a\nclawhub login\n\n# \u53d1\u5e03\u63d2\u4ef6\nclawhub publish\n<\/code><\/pre>\n\n\n\n
        3. \u4ed6\u4eba\u5b89\u88c5\u4f7f\u7528<\/h3>\n\n\n\n
        bash<\/p>\n\n\n\n
        \u8fd0\u884c<\/p>\n\n\n\n
        openclaw plugins install \u4f60\u7684\u63d2\u4ef6name\n<\/code><\/pre>\n\n\n\n
        4. \u7248\u672c\u8fed\u4ee3<\/h3>\n\n\n\n
        \u4fee\u6539\u7248\u672c\u53f7\u540e\u91cd\u65b0\u53d1\u5e03\uff1a<\/p>\n\n\n\n
        bash<\/p>\n\n\n\n
        \u8fd0\u884c<\/p>\n\n\n\n
        npm version patch\nclawhub publish\n<\/code><\/pre>\n\n\n\n
        \n\n\n\n
        \u4e5d\u3001\u5f00\u53d1\u6700\u4f73\u5b9e\u8df5<\/h3>\n\n\n\n
          \n
        1. \u5f02\u5e38\u6355\u83b7<\/strong>\uff1a\u6240\u6709\u5f02\u6b65\u903b\u8f91\u5fc5\u987b\u52a0 try\/catch<\/code>\uff0c\u907f\u514d\u63d2\u4ef6\u5d29\u6e83\u5bfc\u81f4\u7f51\u5173\u5b95\u673a\uff1b<\/li>\n\n\n\n
        2. \u8d44\u6e90\u56de\u6536<\/strong>\uff1aonUnload<\/code> \u4e2d\u5173\u95ed\u7aef\u53e3\u3001\u5b9a\u65f6\u5668\u3001\u957f\u8fde\u63a5\u3001\u8f6e\u8be2\uff1b<\/li>\n\n\n\n
        3. \u914d\u7f6e\u6821\u9a8c<\/strong>\uff1aonLoad<\/code> \u9636\u6bb5\u68c0\u67e5\u5fc5\u586b\u914d\u7f6e\uff0c\u7f3a\u5931\u76f4\u63a5\u629b\u51fa\u660e\u786e\u63d0\u793a\uff1b<\/li>\n\n\n\n
        4. \u65e5\u5fd7\u89c4\u8303<\/strong>\uff1a\u7edf\u4e00\u4f7f\u7528 this.logger<\/code>\uff0c\u7981\u6b62\u539f\u751f console<\/code>\uff1b<\/li>\n\n\n\n
        5. \u7c7b\u578b\u7ea6\u675f<\/strong>\uff1a\u5168\u7a0b\u4f7f\u7528 TypeScript \u5f3a\u7c7b\u578b\uff0c\u51cf\u5c11\u7ebf\u4e0a BUG\uff1b<\/li>\n\n\n\n
        6. \u5bc6\u94a5\u5b89\u5168<\/strong>\uff1a\u654f\u611f\u914d\u7f6e\u6807\u8bb0 secret: true<\/code>\uff0c\u7981\u6b62\u786c\u7f16\u7801\u5bc6\u94a5\uff1b<\/li>\n\n\n\n
        7. \u63a5\u53e3\u5bb9\u9519<\/strong>\uff1a\u5bf9\u63a5\u7b2c\u4e09\u65b9\u63a5\u53e3\u589e\u52a0\u8d85\u65f6\u3001\u91cd\u8bd5\u3001\u7194\u65ad\u903b\u8f91\u3002<\/li>\n<\/ol>\n\n\n\n
          \n\n\n\n
          \u5341\u3001\u603b\u7ed3<\/h3>\n\n\n\n
            \n
          1. \u63d2\u4ef6\u5206\u6e20\u9053\u3001\u6a21\u578b\u63d0\u4f9b\u5546\u3001\u901a\u7528\u529f\u80fd<\/strong>\u4e09\u5927\u7c7b\uff0c\u8fd0\u884c\u5728 Gateway \u4e3b\u8fdb\u7a0b\uff1b<\/li>\n\n\n\n
          2. openclaw.plugin.json<\/code> \u662f\u63d2\u4ef6\u8eab\u4efd\u4e0e\u914d\u7f6e\u6838\u5fc3\uff0c\u7f3a\u4e00\u4e0d\u53ef\uff1b<\/li>\n\n\n\n
          3. \u4f9d\u6258\u751f\u547d\u5468\u671f\u94a9\u5b50\u7ba1\u7406\u63d2\u4ef6\u542f\u505c\u3001\u914d\u7f6e\u53d8\u66f4\u3001\u5065\u5eb7\u72b6\u6001\uff1b<\/li>\n\n\n\n
          4. \u5185\u7f6e\u65e5\u5fd7\u3001\u914d\u7f6e\u3001\u5b58\u50a8\u3001\u4e8b\u4ef6\u56db\u5927\u8fd0\u884c\u65f6 API\uff0c\u6ee1\u8db3\u5927\u90e8\u5206\u5f00\u53d1\u573a\u666f\uff1b<\/li>\n\n\n\n
          5. \u672c\u5730\u901a\u8fc7\u76ee\u5f55\u6302\u8f7d\u8c03\u8bd5\uff0c\u7f16\u8bd1\u540e\u53ef\u53d1\u5e03\u81f3 ClawHub \u5171\u4eab\uff1b<\/li>\n\n\n\n
          6. \u5f00\u53d1\u52a1\u5fc5\u91cd\u89c6\u5f02\u5e38\u5904\u7406\u4e0e\u8d44\u6e90\u91ca\u653e\uff0c\u4fdd\u969c\u7f51\u5173\u6574\u4f53\u7a33\u5b9a\u6027\u3002<\/li>\n<\/ol>\n\n\n\n
            \u57fa\u4e8e\u8fd9\u5957 SDK\uff0c\u4f60\u53ef\u4ee5\u81ea\u7531\u6269\u5c55 OpenClaw \u7684\u63a5\u5165\u6e20\u9053\u4e0e\u6a21\u578b\u80fd\u529b\uff0c\u5b9e\u73b0\u4e2a\u6027\u5316\u79c1\u6709\u5316\u90e8\u7f72\u3002<\/p>\n","protected":false},"excerpt":{"rendered":"
            \u4e00\u3001\u63d2\u4ef6\u6574\u4f53\u67b6\u6784\u4e0e\u5206\u7c7b OpenClaw \u63d2\u4ef6\u8fd0\u884c\u5728 Gateway \u4e3b\u8fdb\u7a0b\u5185\uff0c\u53ef\u5bf9\u6838\u5fc3\u80fd\u529b\u505a\u7075\u6d3b\u6269\u5c55\uff0c\u6253\u901a\u5916 […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[],"class_list":["post-137","post","type-post","status-publish","format-standard","hentry","category-openclawjiaocheng"],"_links":{"self":[{"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/posts\/137","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/comments?post=137"}],"version-history":[{"count":1,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/posts\/137\/revisions"}],"predecessor-version":[{"id":138,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/posts\/137\/revisions\/138"}],"wp:attachment":[{"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/media?parent=137"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/categories?post=137"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.longxiapro.com\/index.php\/wp-json\/wp\/v2\/tags?post=137"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}