必须基于openclaw sdk规范编写go模块形式的自定义skill：先初始化go.mod并实现sdk.skill接口，再通过skill.yaml声明元信息，接着静态编译为linux amd64二进制并打包zip，然后用--debug-skill本地调试，最后上传启用并重启机器人实例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在OpenClaw平台中扩展功能，需通过自定义SKILL实现特定逻辑行为，则必须基于其SDK规范编写可加载的技能模块。以下是创建OpenClaw自定义SKILL的全流程操作步骤：
一、准备开发环境与项目结构
OpenClaw要求SKILL以独立Go模块形式存在，并遵循预定义的接口契约。项目根目录需包含go.mod文件及主入口文件，确保能被OpenClaw运行时动态识别和加载。
1、新建空目录，例如my_skill，进入该目录执行go mod init my_skill初始化模块。
2、创建main.go文件，在其中导入github.com/openclaw/sdk并声明符合sdk.Skill接口的结构体。
3、在main.go中实现Name()、Description()、Execute()三个必需方法，其中Execute()接收*sdk.Context参数并返回error。
4、在项目根目录下新建skill.yaml，填写id、version、entry（设为main.go）、runtime（设为go1.21）等元信息字段。
二、实现Skill核心逻辑
SKILL的行为由Execute()方法驱动，该方法在每次触发时被调用。上下文对象提供消息解析、状态读写、外部服务调用等能力，是业务逻辑落地的关键载体。
1、在Execute()函数体内，调用ctx.Input().Text()获取用户输入文本内容。
2、使用ctx.State().Get("counter")读取当前会话状态值，或用ctx.State().Set("counter", 5)写入新状态。
3、若需响应用户，调用ctx.Output().Text("收到指令")发送纯文本；调用ctx.Output().Card(...)构造结构化卡片。
4、如需异步处理，启用ctx.Background()获取后台上下文，并启动goroutine执行耗时操作，避免阻塞主线程。
三、编译为OpenClaw可加载格式
OpenClaw不直接运行源码，而是加载预编译的二进制插件。因此需将SKILL构建为静态链接、无CGO依赖的Linux AMD64可执行文件，并打包为ZIP归档。
1、设置环境变量：CGO_ENABLED=0 GOOS=linux GOARCH=amd64。
2、执行go build -a -ldflags '-extldflags "-static"' -o skill-bin .生成静态二进制文件。
3、创建ZIP包：将skill-bin、skill.yaml、icon.png（可选，尺寸128×128）一同压缩为my_skill.zip。
4、校验ZIP内文件路径均为根级，不可嵌套在子文件夹中，否则OpenClaw加载失败。
四、本地调试与日志验证
OpenClaw提供内置调试模式，允许在不部署到生产环境的情况下验证SKILL行为是否符合预期。调试过程依赖标准输出重定向与实时日志捕获机制。
1、启动OpenClaw服务时添加--debug-skill=my_skill.zip参数，指定待调试的ZIP路径。
2、在Execute()中插入log.Printf("DEBUG: input is %s", ctx.Input().Text())，所有log.Print*输出将出现在控制台。
3、使用curl -X POST http://localhost:8080/api/v1/skill/test -d '{"skill_id":"my_skill","text":"hello"}'模拟触发请求。
4、观察终端输出是否包含预期日志行，且HTTP响应体中output.text字段匹配设定的返回内容。
五、注册与启用Skill实例
完成调试后，需将SKILL上传至OpenClaw管理后台并绑定到具体机器人实例，使其对真实用户生效。该过程涉及权限校验与配置快照持久化。
1、登录OpenClaw Web控制台，进入Skills → Upload New页面，选择已构建的my_skill.zip文件上传。
2、上传成功后，在列表中找到该SKILL，点击Enable按钮激活其全局可用性。
3、进入目标机器人配置页，在Enabled Skills区域勾选刚启用的SKILL ID，并保存配置变更。
4、重启该机器人实例，使新SKILL加载进内存；可通过docker logs <robot-container-id></robot-container-id>确认日志中出现loaded skill: my_skill提示。
