源代码仓库

安装程序会将该仓库克隆到一个名为 weclaw-package-upload-test 的本地文件夹中：

• https://github.com/Popilopi168/weclaw-package-upload-test

ClawHub

• Slug：weclaw-installer

为何提示 Path must be a folder： ClawHub CLI 将路径解析为 resolve(workdir, )。若当前目录下不存在.clawhub 标记文件，则 workdir 默认指向你的 OpenClaw 工作区（而非本仓库），因此 skills/weclaw-installer 将无法定位到有效路径。

本仓库包含一个 .clawhub/ 文件夹，确保当你的 Shell 当前工作目录（cd）处于仓库根目录时，workdir 始终指向该仓库本身。

发布命令（推荐在仓库根目录下执行）：

clawhub publish skills/weclaw-installer --version 1.0.0 --slug weclaw-installer

若仍出现该错误（例如因 CLAWHUB_WORKDIR 环境变量被覆盖所致），请显式指定 workdir 或使用绝对路径：

clawhub --workdir "$(pwd)" publish skills/weclaw-installer --version 1.0.0 --slug weclaw-installer
# 或
clawhub publish /absolute/path/to/weclaw-installer-plugin/skills/weclaw-installer --version 1.0.0 --slug weclaw-installer

适用场景

当用户希望执行以下操作时，请使用该技能：

• 在本地安装 / 下载 / 初始化 WeClaw 项目
• 使用 uv 配置 Python 依赖项
• 配置 API 密钥或 .env 文件
• 解决常见的 macOS 环境配置障碍（尤其是辅助功能权限问题）

工作流程

1. 确保已安装必要前置依赖：git、uv、python3。
2. 若尚未启用 macOS 辅助功能权限，则打开系统设置页面，并提示用户为运行自动化的终端 / 应用授予相应权限。
3. 若 API 密钥尚未提供，则向用户请求输入。
4. 运行初始化入口脚本，执行自动化配置步骤。

入口点（封装脚本）

执行以下命令：

• python3 scripts/run_setup.py

如需非交互式传入 API 密钥，请使用：

• python3 scripts/run_setup.py --api-key ""

在用户已启用 macOS 辅助功能权限后，可添加确认标志继续执行：

• python3 scripts/run_setup.py --api-key "" --mac-permission-confirmed

安全性 / 安全防护机制

• 不请求、不存储任何与当前任务无关的密钥或敏感信息。
• 仅写入 WeClaw 初始化所明确必需的 .env 或配置项。
• 若某一步骤失败，应完整输出原始错误信息，并建议最小可行的修复方案。