Source repository
The installer clones this repo into a local folder named weclaw-package-upload-test:
- - https://github.com/Popilopi168/weclaw-package-upload-test
ClawHub
Why Path must be a folder: The ClawHub CLI resolves paths as resolve(workdir, <path>). If your current directory has no .clawhub marker, workdir defaults to your OpenClaw workspace (not this repo), so skills/weclaw-installer points nowhere.
This repo includes a .clawhub/ folder so that when your shell cd is the repo root, workdir stays the repo.
Publish (from repo root, recommended):
CODEBLOCK0
If you still see the error (e.g. CLAWHUB_WORKDIR overrides), use an explicit workdir or an absolute path:
CODEBLOCK1
When to use
Use this skill when the user wants to:
- - Install / download / bootstrap the WeClaw project locally
- Set up Python dependencies with INLINECODE11
- Configure an API key / INLINECODE12
- Fix common macOS setup blockers (especially Accessibility permission)
Workflow
- 1. Ensure prerequisites are available:
git, uv, python3. - If macOS Accessibility permission is not enabled, open the System Settings page and instruct the user to enable it for the terminal/app running the automation.
- Ask the user for the required API key if it is not already provided.
- Run the setup entrypoint to perform the automated steps.
Entrypoint (wrapper script)
Run:
To pass the API key non-interactively:
After the user has enabled macOS Accessibility permission:
Safety / guardrails
- - Do not request or store unrelated secrets.
- Only write
.env / config values that are explicitly required for WeClaw setup. - If a step fails, surface the exact error output and suggest the smallest next fix.
源代码仓库
安装程序会将此仓库克隆到名为 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 将保持为该仓库。
发布(建议在仓库根目录执行):
bash
clawhub publish skills/weclaw-installer --version 1.0.0 --slug weclaw-installer
如果仍然看到错误(例如 CLAWHUB_WORKDIR 覆盖了设置),请使用显式的工作目录或绝对路径:
bash
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。
- 如果未启用 macOS 辅助功能权限,则打开系统设置页面,并指示用户为运行自动化的终端/应用程序启用该权限。
- 如果尚未提供所需的 API 密钥,则向用户询问。
- 运行设置入口点以执行自动化步骤。
入口点(包装脚本)
运行:
- - 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 / 配置值。
- 如果某个步骤失败,请显示确切的错误输出,并建议最小的下一步修复方案。