PhoneClaw

把手机变成离线 AI 智能体，隐私安全跑本地模型

PhoneClaw 是一个将手机转变为本地 AI 智能体运行时的开源框架，基于 Swift 开发，支持在 iOS 设备上直接运行 Gemma 等端侧模型，无需云端依赖。它解决了移动端 AI 应用开发中隐私、延迟和离线场景的痛点，提供了原生移动技能（Skills）、LiveLand 交互环境以及可选的 Mac Gateway 推理加速。核心能力包括：端侧模型推理（基于 LiteRT）、本地技能编排、跨设备协同（手机与 Mac 联动）以及轻量级智能体框架。开发者可以利用 PhoneClaw 快速构建隐私安全的移动 AI 助手，实现语音交互、任务自动化等场景，同时降低云端成本。项目处于成长阶段，社区活跃，适合探索端侧智能体的开发者。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1262

维护状态维护中

是否开源是

定价模式 free

项目数据

分类智能体

开发团队kellyvv

所属国家

官网地址https://kellyvv.github.io/PhoneClaw

GitHubhttps://github.com/kellyvv/PhoneClaw

定价模式free

价格说明开源项目，Apache-2.0 许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Swift

技术栈/模型agent-framework,ai-agent,gemma,ios,litert,local-agent,local-ai,mobile-agent,mobile-agent-framework,mobile-ai,mobile-ai-agent-framework,ollama,on-device-agent,on-device-ai,phone-agent-harness,phone-agent-loop,phone-ai-agent,phone-harness,phone-loop,swift

GitHub 星标★ 1262

30天Star增速

HF 下载量

上线时间2026-04-04 00:00:00

最近更新2026-09-23 00:00:00

维护状态维护中

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

iPhone 真机，系统 iOS 17+
源码构建需 macOS + Xcode 16
CocoaPods（源码构建依赖）
一个 Apple ID 用于签名
推荐直接通过 TestFlight 安装，无需 Xcode

安装与启动步骤

1安装 TestFlight 版

README 推荐方式：打开 https://testflight.apple.com/join/YuUSwq78 加入 TestFlight 并安装 PhoneClaw，本步骤无需 Xcode。
2下载端侧模型

首次打开 App 后进入 Model Settings，下载 Gemma 4 E2B/E4B 或 MiniCPM-V 等模型，模型在设备本地运行。
3启用需要的技能

在 App 中开启所需 Skills，如日历、提醒事项、通讯录、剪贴板、健康数据、图像理解、语音与 LiveLand。
4克隆源码

仅源码构建时执行：从 GitHub 拉取 PhoneClaw 仓库到本地，之后用 Xcode 打开工程。
```
git clone https://github.com/kellyvv/PhoneClaw.git
```
5安装依赖

在项目根目录执行 CocoaPods 安装依赖，README 中对应第 2 步，需已安装 CocoaPods。
```
pod install
```
6配置签名并运行

Xcode 中选择 PhoneClaw target → Signing & Capabilities，设置 Team、改成唯一 Bundle Identifier，连接 iPhone 按 ⌘R 运行。

关键配置

配置项	必填	说明	示例
`Team`	是	Xcode 签名所需，用你的 Apple 开发者账号 Team	`Your Apple ID Team`
`Bundle Identifier`	是	改成你自己唯一的包名，否则无法签名安装	`com.yourname.PhoneClaw`
`Model Settings`	是	在 App 内下载端侧模型，未下载模型无法推理	`Gemma 4 E2B`
`Skills`	否	按需开启日历、提醒、通讯录、语音等移动端技能	`Calendar、Clipboard、Voice`

如何确认成功

iPhone 上 App 正常启动，模型已下载完成，技能开关生效并可完成一次对话或任务执行。

常见问题

Q：必须自己编译 Xcode 工程吗？

A：不必。README 推荐用 TestFlight 安装：加入 TestFlight 后下载模型、开启技能即可使用；源码构建属于可选路径。

Q：可以用模拟器运行吗？

A：README 明确要求使用真机（real device），并需要 macOS + Xcode 16、iOS 17+ 与 CocoaPods。

Q：首次安装后提示不受信任怎么办？

A：按照 README：进入设置 → 通用 → VPN 与设备管理 → 信任对应开发者证书即可。

Q：模型在哪里下载？

A：在 App 内的 Model Settings 中下载，模型通过 LiteRT 在设备本地推理，不依赖云端。

Q：需要联网吗？

A：端侧推理离线可用；Web 搜索、网页阅读或 Mac Gateway 局域网推理需你显式选择启用。

注意事项

本项目与 Android 自动化仓库 rohanarun/phoneclaw 及同名 GitHub 组织无关，应用商店搜索结果可能是另一个同名 App。
源码构建需要真实 iPhone 设备和 Apple ID 签名，模拟器不可用。
模型需先在 Model Settings 中下载完成，才可进行端侧推理。
Mac Gateway 推理为可选的局域网加速方案，仅在需要时启用。

核心亮点

端侧推理，数据不出设备，隐私保护强
支持 Gemma 等主流小模型，离线可用
提供 LiveLand 交互环境，开发体验友好

不足之处

仅支持 iOS，Android 用户无法使用
端侧模型能力有限，复杂任务需依赖 Mac Gateway

适用场景

隐私敏感的移动端 AI 助手开发
离线环境下的智能体应用（如旅行、户外）
低成本 AI 应用原型验证与教学

替代项目

LlamaCpp、MLC LLM、MediaPipe LLM Inference

项目介绍

PhoneClaw 是智能体领域的开源项目，由 kellyvv 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,262）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,211 增加到 1,262，净增 51。

项目仍在小幅维护中，最近一次代码更新于 2026-09-23。Apache-2.0 许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：隐私敏感的移动端AI助手开发。同类可对比的替代方案包括 LlamaCpp、MLC LLM、MediaPipe LLM Inference。

上一篇：OpenRoom

下一篇：LightAgent