PhoneClaw

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

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

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 173 🐛 待处理 3 👀 关注 6

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1289

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类智能体

开发团队kellyvv

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

GitHubhttps://github.com/kellyvv/PhoneClaw

定价模式🏷️完全免费

价格说明开源项目，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 星标★ 1289

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

代码更新2026-08-06

仓库体积129.4 MB

本站数据更新2026-11-08

维护状态低维护

收录时间2026-08-09

浏览次数5

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1289

技术标签

agent-framework ai-agent gemma ios local-ai

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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`