whatisgithub

What is routerclaw?

root643/routerclaw — explained in plain English

Analysis updated 2026-05-18

49GoAudience · developerComplexity · 5/5Setup · hard

In one sentence

Turn an old 2010-era OpenWrt router with 32MB RAM into an always-on smart home agent that reads Gmail, manages Google Calendar, runs shell commands, and talks to you through Telegram.

Mindmap

mindmap
  root((repo))
    What it does
      Smart home controller
      Telegram chatbot
      Gmail and Calendar
      Shell commands on router
    Hardware
      Old OpenWrt routers
      32MB RAM 4MB flash
      TP-Link WR740N
    Setup
      Build custom OpenWrt
      Solder serial pins
      Cross-compile for MIPS
    Use cases
      Automate network tasks
      Monitor connected devices
      Power on computers
      Web scraping and search
    Warnings
      Runs shell commands
      Not for production
      Experimental project

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a cheap old router into a smart home controller that responds to Telegram messages.

USE CASE 2

Automate network tasks like monitoring connected devices and running shell scripts from chat.

USE CASE 3

Power on computers on your local network with a Wake-on-LAN command sent via Telegram.

USE CASE 4

Check and manage Gmail and Google Calendar through a conversation with the bot.

What is it built with?

GoOpenWrtTelegram Bot APIMIPSUART

How does it compare?

root643/routerclawdeeix-ai/deeix-chatopen-gitagent/langship.sh
Stars495048
LanguageGoGoGo
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperops devopsops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires soldering serial pins to the router motherboard, interrupting boot over UART, and building a custom stripped-down OpenWrt image.

No license information is provided in the repository explanation, so default copyright terms apply and reuse may be restricted.

So what is it?

RouterClaw is an autonomous AI agent written in Go, built to run on old OpenWrt routers with as little as 32MB of RAM and 4MB of flash storage. The target hardware is something like a TP-Link WR740N, a consumer router from around 2010. The idea is to turn a cheap, obsolete piece of networking equipment into an always-on smart home controller that sits on your network and responds to commands. You talk to RouterClaw through a Telegram bot. It can read and send Gmail, check Google Calendar, create and delete calendar events, scrape websites, submit web forms, and run web searches. It can also execute shell commands directly on the router itself, which lets it automate network tasks, monitor connected devices, and write its own scripts. A Wake-on-LAN feature lets it power on computers on your local network. It keeps conversational memory across interactions, and it can break complex requests into sub-tasks, chaining multiple tools together to reach a goal without human intervention. The technical setup is demanding. Because the router has only 4MB of storage, the standard OpenWrt firmware is too bloated to leave room for the agent. You have to build a stripped-down OpenWrt image that excludes the web interface and IPv6 support, then flash it by soldering serial pins to the router's motherboard and interrupting the boot process over a UART connection. The Go binary is cross-compiled for the MIPS architecture with software floating-point emulation, then copied into the router's RAM-disk filesystem at /tmp. A Windows batch script is included to automate recompilation and redeployment after power loss. The README is frank about the risks. RouterClaw can run arbitrary shell commands on its host, and while protections exist to stop it from accidentally rebooting the router, the author warns against using it on production networks. The project is experimental, and the README notes that new updates are coming.

Copy-paste prompts

Prompt 1
I have an old OpenWrt router with 32MB RAM. Help me plan a stripped-down OpenWrt image build that removes the web interface and IPv6 so I can fit a Go binary on it.
Prompt 2
Write a Go program that listens for Telegram messages and runs predefined shell commands on a Linux device, with a safeguard that blocks any command containing 'reboot'.
Prompt 3
I need to cross-compile a Go binary for a MIPS architecture router with software floating-point emulation. Give me the exact GOARCH and GOFLAGS environment variables to use.
Prompt 4
Create a Telegram bot in Go that can chain multiple tool calls together, for example, searching the web, scraping a URL, then emailing a summary via Gmail, based on a single user request.

Frequently asked questions

What is routerclaw?

Turn an old 2010-era OpenWrt router with 32MB RAM into an always-on smart home agent that reads Gmail, manages Google Calendar, runs shell commands, and talks to you through Telegram.

What language is routerclaw written in?

Mainly Go. The stack also includes Go, OpenWrt, Telegram Bot API.

What license does routerclaw use?

No license information is provided in the repository explanation, so default copyright terms apply and reuse may be restricted.

How hard is routerclaw to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is routerclaw for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.