效率与协作 ios on-device-inference litert healthkit calendar-automation mobile-skills ollama voice-interaction

PhoneClaw 移动端本地运行时

把 iPhone 变成可调用原生能力的本地 AI 运行时。

源仓库: kellyvv/PhoneClaw
Star 数: ★ 1.3k
最近更新: 3 个月前
License: Apache-2.0
主语言: Swift
FA 评分: 43/100 · 缺口较多

30 秒速览

运行形态: 桌面应用自托管服务
可在哪里用: 平台专用Codex（部分支持）
费用: 免费，无需付费服务
上手难度: 高 · 需要较重的基础设施
开始前需要: iOS 17+iPhone用于源码构建的 macOS 和 Xcode 16CocoaPods，用于源码构建用于设备签名的 Apple ID网络访问本地文件系统
典型场景: 使用 iPhone 管理个人日程的人，可用自然语言创建事件、查询今天或本周日程，并请求忙闲或空闲时间分析。
不适合: 没有 iPhone 真机和 macOS + Xcode 开发环境的用户
需要 Android、Windows 或桌面端运行时的团队
内存有限或使用 Sideloadly 侧载签名的旧机型用户
源码审查: 43/100 · 缺口较多 2 项安全控制未见

这个 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？

推荐路径是加入 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 有哪些优点和局限？

优点

将 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 与同类方案有什么区别？

远程推理并非限定单一后端：PhoneClaw Gateway 可选择 Ollama、Codex CLI 或 Antigravity CLI。Ollama 路径在 Mac 本机运行；使用 CLI 或其他上游 provider 时，数据处理遵循对应 provider 的策略。

与相关度最高的同类 agent 并排比较关键指标。

Agent	源码审查	形态 / 费用	Star	最近更新	主语言	完整支持的平台
PhoneClaw 移动端本地运行时当前	43 · 缺口较多	桌面应用免费	★ 1.3k	3 个月前	Swift	—
Conduit	73 · 存在缺口	桌面应用免费 + 模型费	★ 2.4k	3 天前	Dart	OpenAI API
Grux for Mac	67 · 存在缺口	桌面应用免费	★ 31	5 天前	Swift	Claude API
DeepChat	66 · 存在缺口	桌面应用免费 + 模型费	★ 6.4k	1 天前	TypeScript	OpenAI API · Claude API

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1

缺口较多

43/ 100 五分制 2.2 / 5

信任安全 8/29

可靠稳定 6/14

适用触发 10/18

规范维护 10/18

有效结果 7/13

证据核验 2/8

查看各维度的扣分理由

信任安全8 / 29 · 1.4/5

证据显示：README 明确说明默认本地处理，Web 搜索、网页读取和 Mac 远程推理是显式用户触发的；Mac 远程推理需要显式配对和选择模型；删除、批量操作等会请求确认。但权限管理细节（如最小权限原则）未在源码中体现，依赖安全（如依赖漏洞扫描）未提及，回滚机制未说明。扣分：依赖安全、回滚、最小权限证据不足。

可靠稳定6 / 14 · 2.1/5

README 描述了一致的架构和功能，但未提供测试结果或执行证据。依赖可用性方面，模型下载依赖 Hugging Face 和 ModelScope，但未说明镜像可用性。失败消息方面，FAQ 提供了一些故障排除，但未系统化。扣分：依赖可用性和失败消息证据不足。

适用触发10 / 18 · 2.8/5

README 明确了目标受众（iOS 开发者、普通用户）和使用场景（本地 AI 助手、健康数据、日历等），并说明了能力边界（如设备型号限制、内存限制）。触发精度方面，技能系统有触发词，但未说明如何避免误触发。环境适配方面，说明了 iOS 版本、Xcode 版本等要求。扣分：触发精度证据不足。

规范维护10 / 18 · 2.8/5

README 提供了清晰的信息架构（目录、功能、快速开始等），安装说明详细（TestFlight、源码构建、模型下载），命名稳定（版本号、模型名称），示例和 FAQ 丰富，许可证为 Apache-2.0，有更新日志和版本历史。但已知限制未明确列出，维护责任未明确（未提及贡献指南或维护者）。扣分：已知限制和维护责任证据不足。

有效结果7 / 13 · 2.7/5

输出可用性方面，README 展示了实际使用示例和演示视频，但未提供输出质量评估。边际价值方面，本地 AI 代理框架具有创新性，但未与现有方案对比。成本效益方面，未提供性能基准或资源消耗数据。扣分：成本效益证据不足。

证据核验2 / 8 · 1.3/5

README 中的声明（如性能提升、功能）未提供可验证的测试数据或引用。跨来源验证不足，因为只有 README 和少量文件。事实与推断分离方面，README 区分了功能描述和推测（如“可能”），但未明确标注。扣分：声明可追溯性和跨来源验证不足。

风险与缓解建议

源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
依赖安全未提及，需检查第三方库的漏洞。
回滚机制未说明，模型或技能更新可能无法回退。
权限管理细节未在源码中体现，需审查实际权限请求。
声明（如性能提升）缺乏可验证数据。

证据充分度：低评估于 2026年8月9日审查版本 31bf61d3219f

评估证据 README.md LICENSE workflows/pages.yml fuzzing/build.sh tests/__main__.py tests/cuda_skip.py

查看完整评分方法 →

常见问题

它是否必须联网或使用云端推理？

不必须。README 将本地推理和本机 Skill 调用描述为默认路径；联网搜索、网页读取与 Mac 远程推理都需要用户显式触发。

本地模式是否有按次收费或 Token 限制？

README 明确说明 LiveLand 基于本地模型运行，默认不需云端推理，且没有按次计费或 Token 限制；其他安装、模型下载或第三方 provider 的成本未在材料中说明。

为什么安装后没有出现权限请求？

对应 Skill 需要实际执行到系统 API 才会触发请求；若此前已拒绝，需要在 iOS 系统设置中手动重新开启。

为什么切换模型后加载失败？

需要确认模型文件名与 LLM/Models/PredefinedModels.swift 中的 allModels 一致，空壳安装的模型已下载完成或内置模型已加入 App 包，并确保设备内存足够。

Mac Gateway 为什么搜不到？

确认 PhoneClawGateway.app 正在运行、macOS 已允许本地网络权限、两台设备在同一 Wi-Fi，并检查系统防火墙是否允许该 App 接收局域网连接。

PhoneClaw 移动端本地运行时

30 秒速览

这个 Agent 能做什么，适合哪些场景？

如何安装或部署这个 Agent？

如何使用这个 Agent？

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

FollowAgents 如何评估这个 Agent？

最近版本

常见问题

相关 Agents

Conduit

Grux for Mac

DeepChat

Row-Bot