clawdbot-macos-build

🍎 源码构建 macOS 原生 AI 助手

从源码构建 Clawdbot macOS 菜单栏应用,提供原生通知、硬件访问与权限管理,支持本地/远程双模式运行。

收藏
7k
安装
2.9k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Clawdbot macOS Build Skill 是一套完整的源码构建工作流,用于将 Clawdbot 的 macOS 配套应用从源码编译为可运行的 .app 包。该技能自动化处理依赖安装、UI 构建、Swift 编译、代码签名与应用打包的全流程。

显著优点

  • 一站式构建:单条命令完成从 Git 克隆到应用安装的全流程,大幅降低手动配置门槛。
  • 灵活签名策略:支持 Ad-hoc 签名(本地测试)与 Developer ID 签名(生产分发)双模式,满足不同场景需求。
  • 硬件深度集成:构建后的应用可直接访问 macOS 摄像头、屏幕录制、麦克风等系统级硬件,并通过 TCC 权限框架统一管理。
  • 双模式架构:支持本地模式(Gateway 运行在本机)与远程模式(通过 SSH/Tailscale 连接外部 Gateway),兼顾性能与灵活性。
  • 原生体验:提供菜单栏常驻状态、系统通知、URL Scheme 深度链接等 macOS 原生特性。

潜在缺点与局限性

  • 资源消耗大:构建过程需 30GB+ 磁盘空间,编译耗时 10-20 分钟,对低配设备压力较大。
  • 环境依赖重:强制要求 Xcode 15+、Node.js ≥22、pnpm 及 Swift 6.2+,版本错配易导致构建失败。
  • 签名限制:Ad-hoc 签名版本无法 Gatekeeper 分发,需用户手动绕过安全警告;正式分发需购买 Apple Developer ID(年费 $99)。
  • 权限繁琐:首次运行需逐项批准 Notifications、Accessibility、Screen Recording 等 TCC 提示,用户体验存在摩擦。

适合人群

  • 需要在 macOS 上深度集成 Clawdbot 硬件能力的开发者与高级用户
  • 希望自定义 Gateway 部署位置(本地笔记本或远程服务器)的技术用户
  • 愿意从源码构建、不依赖 App Store 分发渠道的专业用户

常规风险

  • 代码签名风险:Ad-hoc 签名应用无法通过系统完整性验证,可能被安全软件标记为未经验证。
  • 权限滥用面:应用请求的 Accessibility、Screen Recording 等权限具有高度敏感性,需信任源码安全性。
  • 供应链攻击面:依赖 GitHub 远程仓库与 Swift Package Manager,若上游被篡改则构建产物存在植入风险。
  • 系统稳定性:构建过程中的 xcodebuild 与 Swift 编译可能因资源不足导致系统卡顿或编译失败。

clawdbot-macos-build 内容

手动下载zip · 3.8 kB
package.jsonapplication/json
请选择文件