为什么值得关注

它展示了在仅 32MB 内存和 4MB 闪存的设备上运行完整自主循环的能力，这通常被认为不适合 AI 负载，体现了极致的资源优化。

适合谁使用

OpenWrt 爱好者与家庭网络高级用户
为嵌入式系统开发 AI 代理的开发者
尝试自主家庭自动化的爱好者
研究基于代理的路由器控制的安全研究人员

典型使用场景

通过 Telegram 自动化网络任务并监控设备状态
在路由器上直接读取 Gmail 和管理 Google 日历
使用 Wake-on-LAN 远程唤醒局域网电脑
抓取网站或搜索互联网获取实时信息

项目优势

自主代理循环，支持工具链式调用完成复杂多步骤任务
针对 MIPS 软浮点编译，内存与存储占用极低
单个二进制集成 Telegram、Google Workspace、网页浏览与 shell 执行
跨交互的持久对话记忆能力

使用前须知

对于 4MB 闪存路由器，需要定制精简版 OpenWrt 固件并通过 UART 串口刷写
任意 shell 执行能力可能对生产网络带来安全风险
仅支持 MIPS 架构且不带硬件浮点单元的路由器（如 TP-Link WR740N）

README 快速开始

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

项目描述

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.

routerclaw