Skip to content

pinclaw-ai/pinclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pinclaw

A tiny clip-on AI that listens, thinks, and acts.
Not another assistant on your phone — a full agent you wear.

Website · App Store · Docs · Discord · Twitter

MIT License npm Discord


Pinclaw

Clip it on, press the button, speak naturally. Your AI agent schedules meetings, drafts emails, sets reminders, books reservations — all in the background. You move on with your life.

You speak → Pinclaw Clip (BLE) → iPhone App (STT) → Cloud → AI Agent
                                                                 ↓
You hear  ← Pinclaw Clip (TTS) ← iPhone App ← ── ── AI Response

3 seconds to assign a task. 5x faster than pulling out your phone.

What Makes Pinclaw Different

Acts, not answers Schedules, drafts, books — autonomously. Not just Q&A.
Hears you cleanly 99.2% recognition accuracy in noisy environments.
Holds your context Remembers people, conversations, and threads for weeks.
Deep iPhone integration Calendar, Reminders, Contacts, Health, HomeKit — all by voice.
Open ecosystem Use our managed cloud, or bring your own AI.

Quick Start — OpenClaw Plugin

Pinclaw is the first hardware product built for OpenClaw. Install the plugin, link your account, and your clip talks to your own AI agent.

1. Install

openclaw plugins install pinclaw

2. Start the gateway

openclaw gateway

3. Link your account

In the OpenClaw chat:

/pinclaw login

This opens a browser to sign in at pinclaw.ai. Once authenticated, the relay is auto-configured — your iPhone reaches your local OpenClaw from anywhere.

4. Connect the app

Open the Pinclaw iOS app, sign in with the same account — done.

Verify

/pinclaw status

See the full plugin documentation in plugin/README.md for configuration, API endpoints, server tools, and architecture details.

Three Ways to Use It

Mode What It Is Cost
Pinclaw AI Managed AI agent in the cloud. Latest models (Claude, GPT-4o, Gemini), zero setup. $29/mo or $279/yr
MyOpenClaw Run your own OpenClaw instance. We handle the relay. Free
MyHermes Local AI via Hermes, Ollama, or any OpenAI-compatible backend. No cloud required. Free

Buy the hardware once. Choose your AI.

Hermes / Local AI Setup

# install pinclaw-bridge
npm install -g pinclaw-bridge

# connect to your local AI
pinclaw-bridge login \
    --endpoint http://localhost:8642 \
    --model hermes-agent

# start
pinclaw-bridge start

Hardware

Purpose-built for voice-first interaction. No screen — by design.

Spec Detail
MCU Seeed XIAO nRF52840 Sense (ARM Cortex-M4 @ 64MHz)
Microphone PDM MEMS (built into XIAO Sense)
Audio Opus codec over BLE 5.0, I2S speaker (MAX98357A)
Feedback RGB LED + speaker (no screen)
Battery 3.7V LiPo, USB-C charging (onboard BQ25101)
Firmware Zephyr RTOS v2.2.0 (source + UF2)
Interaction Single-button push-to-talk

The hardware/ directory contains 3D-printable enclosure STL files. The firmware/ directory contains the full Zephyr source code and a pre-built UF2 binary — flash via drag-and-drop, no programmer needed.

iPhone Integration

Your phone isn't just a pipe — it's the bridge between you and your AI. The Pinclaw app registers native iOS capabilities as skills your agent can call:

  • Calendar — Read and create events
  • Reminders — Manage tasks and to-do lists
  • Contacts — Look up people
  • Health — Access HealthKit data
  • HomeKit — Control smart home devices
  • Location — Context-aware responses
  • Timer — Set and manage timers

Say "schedule a meeting tomorrow at 3pm" — the agent calls your iPhone's calendar directly.

All data stays on your iPhone. You control every permission.

Repository Structure

pinclaw/
├── firmware/
│   └── pinclaw_zephyr/  # Zephyr RTOS firmware (source + UF2 binary)
├── hardware/
│   └── enclosure/       # 3D-printable enclosure (STL files)
├── plugin/              # OpenClaw channel plugin (npm package)
└── public/              # Product assets

Privacy

  • Raw audio is discarded immediately after transcription — never stored
  • Voice streams over encrypted WebSocket (WSS)
  • Self-hosted modes keep all data on your own infrastructure
  • No always-on listening — recording only while button is held

Links

Website pinclaw.ai
iOS App App Store
Docs pinclaw.ai/doc
Discord Join community
Twitter @EricShang98
Buy Pinclaw pinclaw.ai/reserve

Contributing

Pinclaw is fully open source. Fork, build, and open a PR.

Join our Discord to discuss ideas.

License

MIT


Talk. Act. Move on.
Get yours →

About

The first hardware product built for OpenClaw. A wearable AI clip ecosystem — hardware, firmware, and plugin.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors