🦞 从零开始创建一个插件并配置到 OpenClaw。

# Windows PowerShellmkdir -p C:\Users\<你的用户名>\.openclaw\extensions\<plugin-name>cd C:\Users\<你的用户名>\.openclaw\extensions\<plugin-name>
# macOS/Linuxmkdir -p ~/.openclaw/extensions/<plugin-name>cd ~/.openclaw/extensions/<plugin-name>


的文件，用于插件发现和配置验证。

import { Type } from "@sinclair/typebox";
export default function register(api) {  // 插件代码}


1️⃣ 注册 Agent 工具（让 AI 调用）

api.registerTool(  {    name: "my_tool",    description: "工具描述",    parameters: Type.Object({      param1: Type.String({ description: "参数 1" }),      param2: Type.Optional(Type.Number())    }),    async execute(_id, params) {      // 执行逻辑      return {        content: [{ type: "text", text: "结果" }]      };    }  },  { optional: true } // 可选：需要显式启用);


api.registerCli(  ({ program }) => {    program      .command("my-command")      .description("命令描述")      .action(() => {        console.log("执行");      });  },  { commands: ["my-command"] });


api.registerHttpRoute({  path: "/my-plugin/webhook",  auth: "plugin", // 或 "gateway"  match: "exact",  handler: async (req, res) => {    res.statusCode = 200;    res.end("OK");    return true;  }});


api.registerService({  id: "my-service",  start: () => {    api.logger.info("服务启动");  },  stop: () => {    api.logger.info("服务停止");  }});


5️⃣ 注册自动回复命令（无需 AI）

api.registerCommand({  name: "ping",  description: "回复 pong",  acceptsArgs: false,  requireAuth: false,  handler: (ctx) => ({    text: `pong! 频道：${ctx.channel}`  })});


const cfg = api.config.plugins?.entries?.["<plugin-name>"]?.config || {};


📦 步骤 4：安装依赖（如需要）

cd ~/.openclaw/extensions/<plugin-name>npm install @sinclair/typeboxnpm install node-fetch  # 如果需要 fetch


{  "plugins": {    "allow": [      "your-plugin-id"    ],    ...  }}


curl http://127.0.0.1:18789/<plugin-path>


在聊天中说相关的话，AI 应该会自动调用你注册的工具。

~/.openclaw/extensions/my-plugin/├── openclaw.plugin.json    # 插件清单├── index.ts                # 插件入口├── package.json            # 可选：npm 包管理└── node_modules/           # 依赖


# 查看详细错误openclaw plugins doctor
# 查看日志openclaw gateway logs


cd ~/.openclaw/extensions/<plugin-name>npm install <missing-module>openclaw gateway restart


💻 步骤 3：创建插件入口 index.ts插件可以是 .ts 或 .js 文件。

OpenClaw 插件开发指南

从零开始创建一个插件并配置到 OpenClaw。

技术总监

开发工具

后端

低代码

本文详细介绍了OpenClaw插件开发全流程，从创建目录到配置验证，涵盖插件清单编写、API工具注册、CLI命令集成等核心功能实现。提供完整的开发步骤、常见问题解决方案和快速模板，帮助开发者快速上手OpenClaw插件开发，扩展平台功能。

TypeScript

路由

Agent

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

OpenClaw 插件开发指南

OpenClaw 插件开发指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐