Why it is worth attention

It demonstrates a fully autonomous agentic loop capable of chaining tools and running persistently on routers with only 32MB RAM and 4MB Flash, a class of devices typically considered too weak for AI workloads.

Who it is for

OpenWrt enthusiasts and home network power users
Developers building AI agents for embedded systems
Hobbyists experimenting with autonomous home automation
Security researchers exploring agent-based router control

Use cases

Automate network tasks and monitor device status via Telegram
Read Gmail and manage Google Calendar directly from the router
Wake up local computers on demand using Wake-on-LAN
Scrape websites or search the web for real-time information

Strengths

Autonomous agentic loop with tool chaining for complex multi-step tasks
Extremely low memory and storage footprint compiled for MIPS soft-float
Integrates Telegram, Google Workspace, web browsing, and shell execution in one binary
Persistent conversational memory across interactions

Considerations

Requires custom stripped-down OpenWrt firmware and UART serial flashing for 4MB Flash routers
Arbitrary shell execution capability may pose security risks on production networks
Limited to routers with MIPS architecture and soft-float support (e.g., TP-Link WR740N)

README quick start

RouterClaw - OpenWrt Router AI Agent

RouterClaw is a fully autonomous AI agent written in Go, specifically designed to run on resource-constrained embedded systems like OpenWrt routers (e.g., TP-Link WR740N with 32MB RAM / 4MB Flash). It acts as an always-on, intelligent "brain" for your home network.

Features

Autonomous Agentic Loop: Capable of breaking down complex tasks into sub-tasks, chaining multiple tools, and executing them autonomously until the goal is achieved.
Telegram Bot Interface: Communicate directly with your router via a Telegram bot interface.
Google Workspace Integration: Reads your Gmail, sends emails, checks your Google Calendar, creates events, and deletes events.
Web Browsing & Searching: Can scrape websites, submit web forms, and search the web for real-time information.
OpenWrt Shell Execution: Has direct access to the router's underlying Linux shell (ash/bash), allowing it to automate network tasks, monitor devices, and write its own scripts.
Wake-on-LAN (WoL): Can magically wake up computers on your local network on command.
Memory & Context: Maintains conversational memory and state across interactions.

Screenshots in Action

Chat Example 1	Chat Example 2	Chat Example 3

Architecture

Go Binary: Compiled with GOOS=linux GOARCH=mips GOMIPS=softfloat specifically for MIPS architecture routers without hardware floating-point units.
Low Footprint: Designed to run entirely in RAM (/tmp/tmpfs) on 32MB systems where flash storage is limited to 4MB.

Repository Contents

*.go: The core RouterClaw engine (Orchestrator, Telegram Bot, Google Integration, Web, LLM integration, etc.).
config.json: Configuration file storing API keys (DeepSeek, Telegram, Google) and worker node MAC addresses.
scripts_pc/: Helper scripts used on the host PC during deployment:
- Arrancar_RouterClaw.bat: A Windows batch script that automatically cross-compiles the Go binary and SCPs it to the router's RAM (/tmp) to restart the agent after a power loss.
- restore_net.py: A Python script to restore the router's network configuration via UART over a Raspberry Pi Pico bridge (useful if the router loses its switch configuration upon reboot).
- list_events.py: A Python debug script to check Google Calendar event

Description

An autonomous AI agent written in Go, designed to run entirely on the 32MB RAM of an obsolete OpenWrt router. It acts as an always-on smart home orchestrator with Wake-on-LAN, Telegram, and Google Workspace integration.

Related repositories

Similar projects matched by category, topics, and programming language.

nethical6

Featured

conversation-steganography

A tool that hides encrypted secret messages inside innocent-looking AI-generated chat text for private communication over any messaging platform.

1,149

programmersd21

Featured

flow

flow is a minimalist terminal dashboard that displays real-time network throughput with smooth animations, multiple responsive modes, and zero configuration.

Developer ToolsCLI & Terminal

277

MobAI-App

simslim

simslim reduces iOS simulator memory usage by 4x by disabling unnecessary background daemons, allowing many more simulators to run on a single Mac.

248