PhoneClaw

Source#

• Repository: kellyvv/PhoneClaw
• Last source update: 2026-07-04
• Last verified: 2026-07-05

Tags#

Integration notes#

Framework-level abstraction; derive bounded worker contracts from concrete tasks and APIs in docs/examples.

worker.md example#

Starter worker.md contract mapped from this registry entry. Copy this file and adapt schemas, constraints, and statuses for your task.

---
id: phoneclaw-repo-derived-worker
name: PhoneClaw Repo-Derived Worker
version: 1.0.0
source_registry_url: https://worker.md/registry/phoneclaw/
source_repository: https://github.com/kellyvv/PhoneClaw
repository_default_branch: main
repository_language: Swift
repository_license: NOASSERTION
repository_updated_at: 2026-07-04
worker_mode: agent-orchestration-worker
derivation_method: github_repository_metadata_plus_raw_readme
derivation_confidence: 0.9
derived_on: 2026-07-05
tags:
  - agent-framework
  - ai-agent
  - gemma
  - healthkit
  - ios
  - ios-agent
---

# PhoneClaw Repo-Derived Worker

## Repo-derived summary
- Registry summary: Mobile-native local AI Agent framework for phones and edge devices, with an iOS runtime, fully offline local path, on-device models, native iOS Skills, and optional Mac Gateway inference
- Repository description: Mobile-native local AI Agent framework for phones and edge devices, with an iOS runtime, fully offline local path, on-device models, native iOS Skills, and optional Mac Gateway inference
- Stars (snapshot): 1,130
- Primary language: Swift
- Worker mode classification: agent-orchestration-worker

## Extracted from
- https://github.com/kellyvv/PhoneClaw
- https://github.com/kellyvv/PhoneClaw/blob/main/README.md
- https://kellyvv.github.io/PhoneClaw/zh/
- https://github.com/kellyvv/phoneclaw/issues
- https://github.com/kellyvv/PhoneClaw/releases/download/mac-gateway-v0.1.1/PhoneClawGateway-macOS-v0.1.1.zip

## Evidence notes (from repository text)
- README summary paragraph: https://kellyvv.github.io/PhoneClaw/zh/ · https://testflight.apple.com/join/YuUSwq78 · [English](README_EN.md) · https://github.com/kellyvv/phoneclaw/issues · https://github.com/kellyvv/phoneclaw/issues
- PhoneClaw 是面向手机和端侧设备的移动端本地 AI Agent 框架。iOS runtime 内置 Gemma 4 E2B / E4B（LiteRT）和 MiniCPM-V 4.6 多个本地模型，支持完全离线的端侧推理和 Skill 调用，联网搜索、网页读取和 Mac 远程推理由用户显式触发。
- PhoneClaw 是面向手机的移动端本地 AI Agent 框架，提供 iOS runtime，基于 Gemma 4 E2B / E4B（LiteRT）和 MiniCPM-V 4.6，在端侧完成推理和 iOS 原生 Skill 调用，支持完全离线使用。
- PhoneClaw 是面向手机、移动端和端侧设备设计的 Agent 框架，围绕移动端的真实约束做了端侧优化：本地模型推理、移动端内存预算、模型下载与断点续传、Skill 路由、多轮工具调用、权限边界、Live / LiveLand 交互，以及可选的 Mac 局域网远程推理。它的核心价值是把本地模型、原生移动端能力和手机交互入口组织成一个移动端 Agent 运行时。
- - 重构整体 Agent 框架：优化 Skill 结果语义、技能路由、工具调用链、上下文续问和多步骤任务处理，让模型更稳定地判断该直接回答、调用工具，还是延续上一轮结果，减少误触发工具、重复调用和追问跑偏
- - 本地私人 Agent：运行在 iPhone 上，端侧完成推理和 Skill 调用，支持完全离线的本地路径

## Installation hints found in README
- No explicit package installation command detected in README text.

## worker.md contract (derived starter)
Purpose: Execute one orchestrated agent task as a bounded worker step.

### Input schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "task",
    "context"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "task": {
      "type": "string"
    },
    "context": {
      "type": "object"
    }
  }
}
```

### Output schema
```json
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "run_id",
    "status",
    "result"
  ],
  "properties": {
    "run_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "ok",
        "retryable_error",
        "invalid_request",
        "invalid_output"
      ]
    },
    "result": {
      "type": "object"
    }
  }
}
```

### Constraints
- timeout_seconds: 30
- max_attempts: 2
- idempotency_key: run_id
- status_enum: [ok, retryable_error, invalid_request, invalid_output]
- notes: adapt to concrete APIs/classes documented in this repository before production use

## How this should be used
1. Treat this file as a repo-derived starter profile, not a claim of an official repository API contract.
2. Replace schemas with exact interfaces from code/docs you adopt.
3. Keep execution bounded and auditable using worker protocol constraints.

How to use#

• Save this as a worker spec file (for example: phoneclaw-my-task.worker.md).
• Replace the input/output schemas and purpose with your real bounded task.
• Enforce schema validation + timeout + retry policy in your runtime before production use.

Citation#

Reference URL: https://worker.md/registry/phoneclaw/

Source URL: https://github.com/kellyvv/PhoneClaw