需配置webhook回调地址：先将github插件克隆至workbuddy的plugins目录并确认skill.yaml完整；再启动claw服务获取全局webhook url；接着在github仓库settings中配置workbuddy_webhook_url和workbuddy_api_token两个secrets，并添加对应webhook；最后通过push事件触发验证，确保claw recent events显示200 ok且skill name匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装WorkBuddy并希望扩展其能力，但GitHub上发布的开源Skills插件无法正常加载或触发，可能是由于Webhook回调地址未正确配置所致。以下是导入GitHub开源技能插件并完成Webhook回调地址配置的具体操作步骤：
一、确认插件兼容性与本地存放路径
WorkBuddy基于OpenClaw技能体系设计，仅支持符合MCP协议规范、结构正确的Skill插件包。插件必须为标准的Python模块目录格式，包含__init__.py、skill.yaml及主执行文件。导入前需将插件克隆或下载至WorkBuddy指定的插件目录，否则系统无法识别。
1、打开终端或命令提示符，执行：git clone https://github.com/username/repo-name.git
2、进入WorkBuddy安装目录，定位到plugins子文件夹（Windows默认路径为C:\Program Files\WorkBuddy\plugins，macOS为/Applications/WorkBuddy.app/Contents/Resources/plugins）
3、将克隆所得的插件文件夹整体复制粘贴至plugins目录内
4、确保该插件文件夹中存在合法的skill.yaml文件，且其中name、version、entrypoint字段完整无误
二、启用Claw服务并获取全局Webhook地址
Claw是WorkBuddy内置的通信网关模块，所有外部平台（含GitHub Actions触发、企业微信、QQ等）均通过其暴露的Webhook端点与本地Skill交互。必须先启动Claw并确认其监听状态，才能生成有效回调地址。
1、启动WorkBuddy客户端，点击左侧侧边栏的Claw Tab
2、在Claw设置界面中，检查Claw Service Status显示为Running；若为Stopped，点击Start Service按钮
3、等待约3秒，页面下方自动显示形如https://claw.codebuddy.cn/wb/xxx-uuid的全局Webhook URL
4、点击右侧Copy URL按钮，将该地址完整复制到剪贴板
三、在GitHub仓库中配置Secrets与Webhook
GitHub需通过Secrets安全存储WorkBuddy的认证凭证，并通过Webhook事件（如push、pull_request）向该地址发起HTTP POST请求。未配置Secrets会导致身份校验失败，请求被Claw拒绝。
1、访问目标GitHub仓库主页，点击Settings → Secrets and variables → Actions
2、点击New repository secret，创建以下两项：
WORKBUDDY_WEBHOOK_URL：粘贴第二步中复制的完整Webhook地址
WORKBUDDY_API_TOKEN：输入WorkBuddy客户端Claw设置页中显示的API Token值（长度为32位十六进制字符串）
3、返回Settings → Webhooks → Add webhook
4、在Payload URL栏粘贴与Secret中一致的WORKBUDDY_WEBHOOK_URL
5、将Content type设为application/json，勾选Just the push event或其他所需触发事件
6、点击Add webhook完成提交
四、验证插件注册与事件路由
WorkBuddy启动时会扫描plugins目录并加载元信息，但仅当Claw接收到匹配X-WorkBuddy-Skill头的合法请求时，才将流量路由至对应插件。需手动触发一次事件以验证链路是否贯通。
1、在GitHub仓库任意文件上执行一次编辑并提交（触发push事件）
2、回到WorkBuddy客户端，切换至Claw Tab，观察Recent Events列表是否出现新条目
3、点击该条目展开详情，确认Status为200 OK且Skill Name字段显示为所导入插件的name值
4、若状态为401或404，检查skill.yaml中id字段是否与GitHub仓库名完全一致（区分大小写）
