Open Source • MIT License

Control your AI agents
from anywhere, via Telegram

ClicLaw is a bridge that connects your CLI agents to Telegram. You don't need to install a heavy terminal app to give your PC or VPS superpowers — just carry them in your pocket.

⭐ View on GitHub📦 npm package
$npm install -g cliclawcopy
👤
list all running processes and show memory usage05:10 ✓✓
Telegram
cliclaw • VPS05:10
🦀
cliclaw — your PC / VPS

Why ClicLaw?

Real CLI power in your pocket

🤖

Real CLI, not API

Drives actual binaries on your server — no HTTP APIs, no token billing, just your subscription.

📱

Mobile-first control

Control your VPS from anywhere via Telegram. Works on phone, tablet, or desktop.

🧵

Per-session Forum Topics

Each thread = one AI session with full conversation memory. Organized, parallel, persistent.

🔐

Permission modes

Choose auto (fast), session (confirm once), or ask (confirm every action). Full control.

💾

Persistent sessions

Session IDs saved to disk. Context survives bot restarts and VPS reboots.

🌐

Multi-agent support

🟣 Claude Code + 🟢 Codex today. More agents coming — OpenCode, Gemini CLI, and beyond.

Get started in minutes

Self-hosted on your VPS or local machine

bash — install
# Install ClicLaw globally
npm install -g cliclaw

📱 Telegram Group Setup

  1. Create a Telegram group (or use an existing one)
  2. Enable Topics: Edit group → Topics → Enable
  3. Add your bot as admin with Manage Topics permission
  4. Send /id in the group — copy the Chat ID
  5. Paste it as FORUM_GROUP_ID in your .env

See it in action

A real conversation with Claude Code on a VPS

◀
🟣
🟣 Claude — Session #1
cliclaw-vps • Forum Topic
🔍📞⋮
📌Forum Topic • /new → creates a new thread per AI session
Starting simulation...
📎
😊
➤

// interactive simulation — you can type too

Bot commands

Available in any Forum Topic

/new
Open a new Claude session in a fresh topic
/new codex
Open a Codex session instead
/sessions
List all active sessions
/clear
Clear current session history
/status
Show bot status and detected CLIs
/id
Show the current group/chat ID
/help
Show available commands
// how it works internally
Message in forum topic
  ↓ Resolve session by thread_id
  ↓ Lock session (prevent concurrent calls)
  ↓ Send "⚙️ Processing..." + typing loop
  ↓ Spawn CLI:
      claude --resume <id> -p "msg"
      codex exec resume <thread> --json "msg"
  ↓ Process runs to completion
  ↓ Delete "Processing..." → send HTML response
🦀

Ready to take control?

Self-hosted, open source, MIT licensed.

⭐ Clone on GitHub📦 View on npm
Built by @luizfeer•MIT License•npm