stars forks license

Your personal AI assistant that lives in Telegram. Not just a chatbot—a capable agent that thinks, uses tools, and actually gets things done.

Apexclaw is powered by GLM and comes with 100+ built-in tools covering everything from file management and web automation to email, calendar, WhatsApp, and beyond. Ask it anything, and it will figure out how to help.

• 🖼️ Analyze images — Send photos and get detailed descriptions
• 🎙️ Transcribe voice — Reply with voice notes and it transcribes + acts
• 📱 WhatsApp integration — Read and send WhatsApp messages directly
• 🌐 Browse the web — Use a real headless browser to navigate, click, and read
• 📧 Email & Calendar — Read Gmail, send emails, manage Google Calendar events
• 🧠 Long-term memory — Save facts, notes, and a searchable knowledge base
• 🎬 Media tools — Search IMDB, fetch movie details, download YouTube videos
• 🐍 Run code — Execute Python scripts, shell commands, system operations
• 🗺️ Travel & navigation — Flight searches, geocoding, directions, timezone conversion
• 📊 Data & finance — Live stock prices, currency conversion, weather, news
• 💬 Interactive buttons — Send messages with inline buttons for quick actions
• 🎯 Task automation — Schedule tasks, Pomodoro timers, daily digests

curl -fsSL https://claw.gogram.fun | bash
apexclaw

This automatically:

1. Downloads the latest binary for your OS
2. Installs to /usr/local/bin or ~/.local/bin
3. Launches an interactive setup wizard
4. Prompts for Telegram credentials
5. Starts the agent

# Requirements: Go 1.22+, ffmpeg (for voice)
git clone https://github.com/amarnathcjd/apexclaw
cd apexclaw
go build -o apexclaw .
./apexclaw

On first run, you'll be prompted for:

• Telegram API ID (from my.telegram.org)
• Telegram API Hash (from my.telegram.org)
• Bot Token (from @BotFather)
• Owner ID (your Telegram Chat ID)

For best email experience, use the new Maton API integration:

1. Get an API key from maton.ai/settings
2. Add to .env:

MATON_API_KEY=your_api_key_here

3. Done! The following tools are now available:
   • gmail_list_messages — List/search emails with filters (unread, starred, from, subject, date range, attachments)
   • gmail_get_message — Get full message details by ID
   • gmail_send_message — Send emails (supports CC, BCC)
   • gmail_modify_labels — Add/remove labels (starred, unread, trash, important, etc.)

Legacy email (IMAP/SMTP):

EMAIL_ADDRESS=your.email@gmail.com
EMAIL_PASSWORD=your-16-char-app-password
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_IMAP_PORT=993
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587

Same Maton API key unlocks calendar tools:

• calendar_list_events — List upcoming events (with date ranges, max 250)
• calendar_create_event — Create events with attendees, location, description
• calendar_delete_event — Delete events by ID
• calendar_update_event — Update existing events

Times use RFC 3339 format: 2024年01月15日T10:00:00Z

WhatsApp support via official reverse engineering:

1. Start apexclaw and trigger WhatsApp connection
2. Scan the QR code with your WhatsApp phone
3. Connection saved to ~/.apexclaw/whatsapp/store.db
4. Available tools:
   • Send/receive WhatsApp messages
   • Integrated with AI responses (replies in WhatsApp)

Apexclaw includes a web interface for settings and monitoring:

• Default login code: 123456 (shown on first startup)
• JWT authentication: 1-hour sessions with refresh tokens
• Change code anytime: Via web UI or Telegram /webcode command
• Telegram integration: Use /webcode show/set/random to manage codes

To access the dashboard:

1. Start apexclaw
2. Open http://localhost:8080
3. Enter the 6-digit login code
4. Manage settings, view logs, and monitor activity

Create a new ToolDef in any file under tools/ directory and register it in tools/tools.go:

var MyTool = &core.ToolDef{
	Name: "my_tool",
	Description: "What your tool does",
	Args: []core.ToolArg{
		{Name: "input", Description: "Input parameter", Required: true},
	},
	Execute: func(args map[string]string) string {
		// Your implementation here
		return result
	},
}

Apexclaw automatically picks it up—no restart needed (in debug mode).

Apexclaw logs to ~/.apexclaw/logs/ with rotating files. Log levels: DEBUG, INFO, WARN, ERROR.

Use the execution profiler to trace tool calls:

• debug_trace tool — Track timing, results, and context for each tool execution
• Helps identify slow operations or failures

• Go 1.22+
• ffmpeg (for voice transcription)
• Built-in support for:
  • Telegram Bot API
  • Chrome/Chromium (for browser automation)

• Web plugin system for third-party tools
• Persistent refresh token storage
• Vector embeddings for smarter memory recall
• Mobile app companion
• Multi-language interface

MIT License — See LICENSE file for details

Found a bug or have a feature request? Open an issue or pull request on GitHub.

Questions? Contact @amarnathcjd on Telegram.

Apexclaw — An AI assistant that actually gets things done.