🎬 LiClaw — Short Drama AI Agents

LiClaw is a short-drama industry AI assistant you run on your own devices.

It answers you on the channels you already use (WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage, Microsoft Teams, Matrix, Feishu, and more). It can speak and listen on macOS/iOS/Android, and can render a live Canvas you control.

Website · Docs · Getting Started

Install

Runtime: Node 24 (recommended) or Node 22.16+.

npm install -g liclaw@latest

liclaw onboard --install-daemon

Quick Start

# Start the gateway
liclaw gateway --port 18789 --verbose

# Send a message
liclaw message send --to +1234567890 --message "Hello from LiClaw"

# Talk to the assistant
liclaw agent --message "Ship checklist" --thinking high

Configuration

Minimal ~/.liclaw/liclaw.json:

{
  agent: {
    model: "anthropic/claude-opus-4-6",
  },
}

Full configuration reference

Architecture

Channels (WhatsApp/Telegram/Slack/Discord/...)
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (control plane)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi agent (RPC)
               ├─ CLI (liclaw ...)
               ├─ WebChat UI
               └─ iOS / Android nodes

Security

• Default: tools run on the host for the main session
• Group safety: set agents.defaults.sandbox.mode: "non-main" to run non-main sessions in Docker sandboxes

Security guide

Development

git clone https://github.com/0xnicholas/liclaw
cd liclaw

pnpm install
pnpm ui:build
pnpm build

pnpm liclaw onboard --install-daemon

Docs

• Getting Started
• Configuration
• Security
• Channels
• Troubleshooting

License

MIT License

Built for Molty, a space lobster AI assistant. 🦞 by Peter Steinberger and the community.