PhoneClaw 移动端本地运行时
把 iPhone 变成可调用原生能力的本地 AI 运行时。
这个 Agent 能做什么，适合哪些场景？
PhoneClaw 是一套面向 iPhone 的本地 AI Agent 运行时，主打在设备上执行模型推理和原生 Skills。它使用 LiteRT 运行 Gemma 4 E2B/E4B，并提供 MiniCPM-V 4.6 用于图片问答和 LIVE 摄像头识别。应用可通过文字、语音、图片、LIVE 和 LiveLand 入口处理请求，并调用日历、提醒事项、通讯录、剪贴板和 HealthKit 等设备能力。Skills 以 SKILL.md 文件组织，device 类 Skill 可映射到 ToolRegistry.swift 与 Tools/Handlers 中注册的工具。对于更重的推理，iPhone 可经局域网配对 PhoneClaw Gateway，在 Mac 上选择 Ollama、Codex CLI 或 Antigravity CLI 作为运行源。
用户在聊天、语音、图片、LIVE 或 LiveLand 中提出请求后，PhoneClaw 用本地 Gemma 4 或 MiniCPM-V 4.6 处理输入，并按 Skill 的 type 决定执行路径。device 类型会由模型发出 <tool_call>，调用已在 Tools/ToolRegistry.swift 和 Tools/Handlers/<Name>.swift 中注册的 iOS 工具；README 列出的操作包括创建和查询日历、分析忙闲、创建提醒、查询或维护联系人、读写剪贴板，以及读取 HealthKit 健康指标。content 类型如 translate 直接依据 SKILL.md 生成结果；network 类型如 web-search 仅在用户明确要求实时信息、搜索或读取 URL 时调用网络工具。结果显示在应用交互界面；LiveLand 还会显示接收指令、理解、执行、整理和完成等任务状态。远程模式下，本轮模型请求发送到已配对 Mac 的 PhoneClaw Gateway，Gateway 默认监听 18080 端口并以 Bonjour 广播 _phoneclaw-llm._tcp。
- 使用 iPhone 管理个人日程的人，可用自然语言创建事件、查询今天或本周日程，并请求忙闲或空闲时间分析。
- 希望在设备端查看个人健康摘要的 iPhone 用户，可授权 HealthKit 后查询步数、距离、活动能量、心率、睡眠、运动、体重或心率变异性。
- 需要快速维护通讯录的人，可让应用查询、保存、更新或删除联系人，并按手机号去重。
- 希望边看边问的用户，可拍照或从相册选择图片进行问答，或在 LIVE 模式开启摄像头进行实时识别。
- 拥有同一局域网 Mac 且想把较重推理移出手机的用户，可配对 PhoneClaw Gateway，并选择 Mac 上的 Ollama、Codex CLI 或 Antigravity CLI 运行源。
这个 Agent 有哪些优点和局限？
- 将 LiteRT 本地模型与日历、通讯录、提醒事项、剪贴板和 HealthKit 等 iOS 原生能力组合在同一个手机端运行时中。
- Skills 使用文件化的 SKILL.md 描述，并通过 allowed-tools 与 ToolRegistry 校验工具注册是否同步。
- 提供文字、语音、图片、LIVE 和 LiveLand 多种手机交互入口，MiniCPM-V 4.6 覆盖图片问答与实时摄像头识别。
- 可选 Mac Gateway 通过 Bonjour 发现和配对，在保留 iPhone 端 Skills 的同时使用 Mac 上的不同运行源。
- 模型下载支持取消、续传和失败重试，并针对移动端提供模型切换、缓存清理和历史裁剪。
- 核心部署边界是 iOS 17+ 真机；源码构建还依赖 macOS、Xcode 16、CocoaPods 和 Apple ID，未提供其他桌面或移动平台的运行路径。
- E2B 约 2.4 GB、E4B 约 3.4 GB；E4B 和多轮复杂任务建议较新的 iPhone，内存与设备性能会影响可用性。
- 日历、提醒事项、通讯录和 HealthKit 功能依赖用户授权；被拒绝的权限需要在系统设置中重新开启。
- 联网搜索、网页读取和 Mac 远程推理不再是纯本地路径；若 Mac 选择 CLI 或其他上游 provider，数据处理取决于该 provider。
- 许可证信息存在不一致：仓库元数据标为 NOASSERTION，而 README 声称 Apache 2.0，采用前需要自行确认。
如何安装或部署这个 Agent？
推荐路径是加入 TestFlight： https://testflight.apple.com/join/YuUSwq78 ，安装后在“模型设置”下载模型，并按需开启 Skill 权限。源码构建需要 macOS、Xcode 16、iOS 17+、CocoaPods、真机和 Apple ID；执行 git clone https://github.com/kellyvv/phoneclaw.git、cd phoneclaw、pod install，再用 open PhoneClaw.xcworkspace 打开工作区。在 Xcode 的 PhoneClaw target 中选择 Team，并把 Bundle Identifier 改为自己的唯一值，然后连接 iPhone 运行。空壳安装后，可在模型设置中下载 E2B 或 E4B；也可将 .litertlm 模型作为资源打包进应用。
如何使用这个 Agent？
首次运行时，在模型设置下载或选择模型，再授予所需的日历、提醒事项、通讯录或健康数据权限。通过右上角拼图管理 Skills，通过右上角滑杆进入模型设置、系统提示词和权限；随后可直接输入“提醒我今晚八点发文件”或“我今天有哪些日程？”。若需 Mac 远程推理，启动 PhoneClawGateway.app，允许 macOS 本地网络权限，在 Gateway 中选择 Ollama、Codex CLI 或 Antigravity CLI；然后让 iPhone 与 Mac 连接同一局域网，在“Mac 远程推理”中配对并选择远程模型。
这个 Agent 与同类方案有什么区别？
远程推理并非限定单一后端：PhoneClaw Gateway 可选择 Ollama、Codex CLI 或 Antigravity CLI。Ollama 路径在 Mac 本机运行；使用 CLI 或其他上游 provider 时，数据处理遵循对应 provider 的策略。