
PalmClaw
手机本地跑智能体,离线也能自动干活
PalmClaw 是一个面向手机端的原生端侧智能体框架,使用 Kotlin 编写,定位为 EMNLP 2026 Demo 项目。它要解决的问题是:现有智能体大多依赖云端大模型和远程 API,存在延迟高、隐私泄露风险、离线不可用等痛点。PalmClaw 把智能体运行能力直接放到手机本地,让模型推理、任务规划与设备操作在端侧闭环完成。核心能力包括端侧模型调度、对手机系统能力(如应用、通知、文件等)的调用封装,以及面向移动场景的智能体任务编排,使开发者可以用 Kotlin 快速构建可离线运行、数据不出设备的手机智能体应用。项目当前处于成长阶段,星标约 1.1k,适合关注端侧 AI 与移动智能体方向的研究者和开发者参考与二次开发。
项目数据
使用教程
环境要求
- 一台 Android 手机,端侧运行,无需电脑配合
- 自备可用的 LLM API 及密钥,模型推理来自用户配置的 API
- 网络可访问 GitHub Releases 以及所接入的渠道服务
- 可选:接入 Telegram/Discord/Slack/飞书/邮件/企微前,需先在对应平台创建机器人获取凭据
安装与启动步骤
-
1下载安装包
从官方 Releases 下载最新 Android 安装包 app-release.apk,需保持网络能访问 GitHub。
curl -L -o PalmClaw.apk https://github.com/ModalityDance/PalmClaw/releases/latest/download/app-release.apk -
2安装到手机
用 adb 安装,或把 APK 传到手机后直接点击安装,并按系统提示允许安装来源。
adb install PalmClaw.apk -
3配置模型 API
在应用内填入自备的 LLM API;README 未列出具体字段,按应用界面提示填写并保存。
-
4打开目标会话
在 PalmClaw 中新建或打开一个会话,后续渠道绑定都作用在这个会话上。
-
5进入渠道配置
在会话中进入 Session Settings -> Channels & Configuration,选择要接入的渠道类型。
-
6填写并保存凭据
按渠道要求填写 Token、频道 ID、IMAP/SMTP 等并保存;飞书、Slack 需先在平台侧开启权限。
-
7检测并绑定会话
先向机器人/邮箱发送一条消息,再点 Detect Chats 或 Detect Senders,选中目标后再次保存。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
Telegram Bot Token | 否 | 接入 Telegram 时必填,机器人令牌,保存后点击 Detect Chats | 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ |
Discord Bot Token | 否 | 接入 Discord 时必填,机器人令牌 | MTIzNDU2Nzg5MDEyMzQ1Njc4.ABCDEF.abcdefghijklmnopqrstuvwxyz |
Discord Channel ID | 否 | 接入 Discord 时必填,目标频道 ID | 123456789012345678 |
Slack App Token | 否 | 接入 Slack 时必填,需 connections:write 权限并开启 Socket Mode | xapp-1-A01B2C3D4E5-1234567890123-abcdef1234567890 |
Slack Bot Token | 否 | 接入 Slack 时必填,需具备所需消息与回复权限 | xoxb-123456789012-1234567890123-AbCdEfGhIjKlMnOpQrStUvWx |
Feishu App Secret | 否 | 接入飞书时与 App ID 一起填写,需开启机器人能力与长连接 | a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6 |
如何确认成功
应用可正常打开并创建会话;渠道保存后向机器人或邮箱发一条消息,能检测到会话并收到回复即成功。
常见问题
Q:飞书能发出消息但收不到?
A:通常是接收权限、事件订阅 im.message.receive_v1、应用发布或长连接确认未完成;补齐后保持 PalmClaw 运行再确认。
Q:Discord 机器人不回复消息?
A:先把机器人邀请进目标服务器或频道;若使用 mention 模式,需要在频道里 @ 一次机器人才能触发回复。
Q:Slack 绑定失败怎么办?
A:需启用 Socket Mode、App token 具备 connections:write、Bot token 具备所需消息收发权限。
Q:Telegram 检测不到会话?
A:先在 Telegram 中给机器人发送一条消息,再回到应用点击 Detect Chats 进行检测。
注意事项
- 模型推理由用户自行配置的 LLM API 提供,端侧负责会话、上下文、记忆、技能与工具调用。
- 会话、上下文、记忆与设备工具调用全部保存在手机本地,数据不出设备,无需电脑。
- 配置任意渠道的推荐顺序:打开目标会话 → Session Settings → Channels & Configuration。
核心亮点
- 纯端侧运行,数据不出手机,隐私与离线可用性优于云端方案
- 用 Kotlin 原生开发,与 Android 生态贴合,便于调用系统级能力
- 有 EMNLP 2026 Demo 学术背景,任务编排与端侧调度设计有研究参考价值
不足之处
- 项目较新,文档与示例完善度有待观察
- 端侧模型能力受手机算力限制,复杂任务表现可能弱于云端方案
适用场景
- 在无网络或弱网环境下让手机助手自动完成本地任务
- 对隐私敏感的用户在本地处理通知、文件与日程信息
- 开发者基于框架快速搭建 Android 端侧智能体原型
替代项目
Mobile-Agent、AppAgent
项目介绍
同类项目推荐
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
agent-manager
开源
一站式管理企业 AI 代理,部署治理全搞定
WSO2 AI Agent Manager is an open control plane designed for enterprises to deploy, m···