若WorkBuddy技能导入后无法上传文件，主因是腾讯云COS路径未正确配置；需依次检查技能依赖参数、配置application.yml中cos字段、通过Claw界面绑定存储源、校验凭证与网络、最后重载技能并测试上传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已获取一个具备文件上传能力的 WorkBuddy 技能包，但导入后无法执行上传操作，则很可能是该技能依赖的对象存储（如腾讯云 COS）路径未正确配置。以下是完成 COS 对象存储路径设置并确保技能正常上传的完整流程：
一、确认技能对 COS 的调用依赖关系
带文件上传功能的技能通常在 SKILL.md 或配套 Python 脚本中硬编码或动态读取 COS 相关参数，例如 bucket 名称、region、endpoint 及凭证字段。若这些值为空、格式错误或与实际 COS 实例不匹配，上传将直接失败并抛出 403 或 ConnectionTimeout 异常。
1、在 WorkBuddy 中打开目标技能文件夹：进入「技能中心」→ 找到该技能 → 点击「打开文件夹」图标。
2、使用编辑器打开 SKILL.md 文件，查找是否存在 storage_config、cos_config 或 upload_to_cos 等关键词段落。
3、检查脚本中是否调用 boto3.client 或 cos-python-sdk-v5 初始化语句，确认其参数来源是否指向环境变量、config.yml 或硬编码字符串。
二、在 WorkBuddy 全局配置中启用并填写 COS 参数
WorkBuddy 将 COS 配置统一托管于 application.yml，所有技能共享该配置；即使技能自身未显式声明，只要调用通用上传接口（如 claw.upload_to_storage），即会自动注入此配置。必须确保 storage.type 明确设为 cos，且各字段值可被 SDK 正确解析。
1、进入 WorkBuddy 部署目录，打开 config/application.yml 文件。
2、在 storage 节点下补充或替换以下内容（请严格按缩进与大小写书写）：
storage:
type: cos
cos:
bucket: your-game-assets-2026
region: ap-shanghai
secret-id: AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxx
secret-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
endpoint: https://cos.ap-shanghai.myqcloud.com
3、保存文件后，验证 YAML 格式合法性：可粘贴至 yamllint.com 检查缩进与冒号后空格是否合规。
三、通过 Claw 设置界面绑定 COS 存储路径（免配置方式）
部分新版技能支持“运行时路径绑定”，即不修改 application.yml，而是通过图形界面将 COS Bucket 映射为一个虚拟本地路径（如 /storage/cos/game-textures），使技能像访问普通文件夹一样调用 upload() 方法。该机制依赖 WorkBuddy 内置的 Storage Bridge 服务。
1、启动 WorkBuddy 客户端，点击右上角头像 → 进入「Claw 设置」→ 「对象存储管理」。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、点击「添加 COS 存储源」，在弹窗中依次填入：
Bucket 名称：your-game-assets-2026
地域：上海 (ap-shanghai)
SecretId：AKIDxxxxxxxxxxxxxxxxxxxxxxxxxxxx
SecretKey：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Endpoint：cos.ap-shanghai.myqcloud.com
3、点击「测试连接」，若返回绿色“✅ 已连通并具备读写权限”，则点击「保存映射」，系统自动生成路径别名 /storage/cos/default。
四、手动校验 COS 凭证与网络可达性
即使配置项全部填写正确，若 SecretKey 权限不足、Endpoint 被防火墙拦截或 Bucket 所在地域与 SDK 初始化 region 不一致，仍会导致上传中断。需逐项隔离验证。
1、在命令行执行 curl 命令检测 Endpoint 连通性：
curl -I -X HEAD https://your-game-assets-2026.cos.ap-shanghai.myqcloud.com
2、登录腾讯云控制台，进入该 Bucket 的「权限管理」→ 「存储桶策略」，确认策略中未显式拒绝来自您服务器 IP 的 PutObject 请求。
3、在密钥管理页面，定位所用 AccessKey，点击「查看权限」，确认已附加策略 QcloudCOSFullAccess 或至少包含 cos:PutObject、cos:GetObject、cos:ListBucket。
五、重载技能并触发上传行为验证
配置更新后，WorkBuddy 不会自动重载已启用技能的运行时上下文。必须显式通知系统重新加载脚本与依赖配置，否则技能仍将使用旧缓存参数发起请求。
1、在任意对话窗口输入指令：
重载技能 game-asset-uploader
2、等待 AI 返回「✅ 技能 game-asset-uploader 已重载，COS 配置已注入」。
3、上传一张测试图片并发送自然语言指令：
上传当前附件至 COS 的 /textures/hero/ 目录
4、观察控制台日志（可通过 /log 查看最近 50 行）中是否出现类似 “Upload success: https://your-game-assets-2026.cos.ap-shanghai.myqcloud.com/textures/hero/test.png” 的输出。
