简体中文

⬇️ Just want to download? Jump to Quick Start

PalmClaw is a personal assistant on your phone inspired by OpenClaw, but designed for direct mobile deployment: run your AI agent on your phone without a PC.

• 📱 Deploy and operate directly on Android.
• 🔒 Local-first runtime for a safer and more private workflow.
• ⚡ Simpler setup and daily use, while still supporting channels, tools, and automation.

• 📱 Mobile-native deployment
  Deploy and run directly on Android, with built-in access to local hardware and files.

• ✨ Simple workflow
  All operations are done directly in the app UI, making setup and usage easier.

• 🔐 Stronger safety
  Android App sandbox isolation provides a naturally safer runtime boundary.

• 🧠 Full agent stack included
  Memory, skills, tools, and channels are all available in one mobile runtime.

Initial Setup	Core Features	Tool Usage	Channels Setup

• 🌏 [2026.03.21] v0.1.1 Chinese Docs & UX Update: Added a Chinese README, improved Chinese error messages, and fixed the MiniMax API endpoint.
• 🚀 [2026.03.16] Initial Release: PalmClaw v0.1.0 is now live! 🎉

• Integrate SkillHub.
  • Build a conversion skill: desktop skill -> mobile-ready skill.
• More channel integrations.
• Better tool support.
  • Stronger web search tools, like brave or tavily.
• Expand Android-native capabilities.
  • Local app integration.
  • Screen reading and interaction.
• Multimodal input and output.

• 📌 Overview
• ✨ Key Features
• 🎬 Demos
• 📰 News
  • 🛣️ Roadmap
• 📑 Table of Contents
• 🚀 Quick Start
  • 👤 For Normal Users
  • 🛠️ For Developers
• 🔌 Channels Configuration
• ⚙️ How PalmClaw Works
• 🗂️ Repository Structure
• 🤝 Community
• ⚖️ License

1. Download the latest APK from the Releases page.
2. Install the APK on your Android phone.
3. Open PalmClaw and follow the in-app onboarding guide.
4. Finish provider setup, then start chatting in the local session!

_{Scan to download the latest APK}

1. Install Android Studio and JDK 17.
2. Clone the repository:

git clone https://github.com/ModalityDance/PalmClaw.git
cd PalmClaw

3. Open the project in Android Studio and wait for Gradle sync.
4. Ensure local.properties points to your Android SDK path.
5. Run the app on a physical device or emulator.

PalmClaw currently supports these channels:

• 📩 Message in: input comes from local chat or connected channels.
• 🤖 Agent loop: LLM decides, calls tools when needed, then generates response.
• 🧠 Context: memory + skills guide every turn.
• 📤 Response out: result is written to the session and sent back to the channels.

PalmClaw/
├─ app/
│  ├─ src/main/java/com/palmclaw/
│  │  ├─ ui/                # Compose UI, settings, chat, onboarding
│  │  ├─ runtime/           # agent runtime, always-on, routing
│  │  ├─ channels/          # Telegram / Discord / Slack / Feishu / Email / WeCom
│  │  ├─ config/            # config store and storage paths
│  │  ├─ cron/              # scheduled jobs
│  │  ├─ heartbeat/         # heartbeat runtime
│  │  ├─ tools/             # mobile tools exposed to the agent
│  │  └─ skills/            # skill loading and matching
│  └─ src/main/assets/
│     ├─ templates/         # AGENT / USER / TOOLS / MEMORY / HEARTBEAT
│     └─ skills/            # bundled skills and guidance
├─ docs/assets/             # docs site branding/media/fonts/icons assets
├─ gradle/                  # Gradle wrapper files
└─ README.md

We welcome researchers, builders, and mobile AI practitioners to join the PalmClaw community. 🌍

Thanks to all contributors.

This project is offered under a dual licensing model:

• Open Source License: See LICENSE
  This is the default license for the project. It ensures that any modifications made to the code, when used to provide a service over a network, must also be released under the AGPLv3.

• Commercial License: See LICENSE-COMMERCIAL
  For organizations or individuals who wish to integrate this software into proprietary products or services without being bound by the AGPLv3's copyleft requirements (e.g., keeping modifications private), a commercial license is available.