Built on the official Claude Code Agent SDK

Your Own AI Agent,
Running Tonight

A personal AI assistant that runs 24/7 on your machine. Talk to it through Telegram or a web browser. It remembers your conversations, handles voice, and runs tasks while you sleep. No extra costs beyond your Claude Code plan.

$47 one-time · Guide + full source code · Instant download

your-agent -- zsh
$ npm run setup
Telegram bot token: ***configured***
Chat ID: ***detected***
Voice (whisper-cpp): enabled
Service installed: com.agent.app
 
$ npm run dev
Agent online. Listening for messages...
[telegram] Message: "check my calendar for tomorrow"
[agent] Running... session resumed
[memory] Injected 3 relevant memories
Response sent. // 2.3s, no API tokens used

Other setups are complicated,
expensive, or both.

Popular frameworks like OpenClaw have 3,400+ open issues, require separate API keys, and charge $50-200/mo in token costs. The blueprint is plug-and-play.

The old way

$
$50-200+/mo in API costs Pay per token on top of your existing Claude subscription. Costs scale with every message, even background calls.
!
Complex setup, constant maintenance Docker issues, dependency failures, gateway errors. Run "openclaw doctor" after every upgrade to catch config drift. 3,400+ open issues and counting.
×
Burns tokens in the background Autonomous loop architecture makes continuous API calls to maintain context -- even when you're not using it. Your bill grows while you sleep.
~
Subscription access revoked Anthropic shut down third-party OAuth access in Jan 2026. Tools that piggybacked on your Claude subscription stopped working overnight.

The blueprint way

$0 extra per month Runs through your existing Claude Code subscription. No separate API key, no per-token billing. You're already paying for it.
Plug and play One setup wizard handles everything. No Docker, no gateway, no dependency debugging. Answer a few questions and your agent is running.
Only runs when you need it No background token drain. The agent wakes up when you send a message and goes quiet when it's done. You stay in control of costs.
Actually remembers you Your agent learns what matters and naturally forgets what doesn't. Ask it something from last week and it pulls up the right context instantly.

Ready out of the box.
Customize if you want to.

Everything is built, tested, and documented. Run the setup wizard and your agent is live. Tweak the personality, add skills, or use it as-is.

Cost

Your subscription.
Zero extra.

If you have a Claude Code subscription, you already have everything you need. No extra API key to create. No separate billing account. No surprise charges. Your agent runs on what you're already paying for.

× Third-party frameworks now require separate API keys at $0.10-1.00 per turn
config.ts
// No API key needed.
// Uses your Claude Code CLI auth.

import { Agent } from '@anthropic-ai/claude-agent-sdk'

const agent = new Agent({
  model: 'claude-sonnet-4-6',
  tools: ['bash', 'file', 'web'],
  // That's it. No API key field.
})
Memory

It remembers what matters.
Forgets what doesn't.

Tell your agent something once and it sticks. "I'm allergic to peanuts." "My Wi-Fi password is..." "Never schedule meetings before 10am." Important facts persist. Casual chit-chat fades naturally over time, just like real memory.

× Other frameworks forget everything between sessions or dump context into flat files
memory system
remembers | "Allergic to peanuts"          importance: high
remembers | "Meeting with Sarah on Fri"    importance: high
remembers | "Prefers window seats"         importance: medium
fading    | "Asked about the weather"      importance: low (fading)
fading    | "Talked about lunch spots"    importance: low (fading)

-- Important facts stick around forever
-- Small talk fades naturally over time
Access

Telegram. Web. Both.

Text, voice messages, photos, and documents through Telegram. A full web dashboard on port 3141 with multiple conversations, image paste, and admin pages. Same memory pool, same agent, two interfaces.

Voice transcription runs locally via whisper-cpp. No cloud API, no costs, no rate limits. Scheduled tasks run via cron while you sleep.

channels
Telegram
  | text, voice, photos, documents
  | persistent sessions across restarts
  | /schedule create "..." "0 9 * * *"

Web Dashboard (:3141)
  | multi-conversation chat UI
  | shared memory pool
  | admin + monitoring pages

Voice
  | local whisper-cpp transcription
  | $0 cost  // no cloud API
Setup

Five minutes.
No experience required.

The setup wizard asks you a few simple questions and does the rest. It checks your system, creates your config, connects your Telegram bot, and installs the agent as a background service. It starts when your computer starts and restarts itself if anything goes wrong.

× OpenClaw: Docker issues, dependency failures, gateway config, "openclaw doctor" after every upgrade
terminal
$ npm run setup

Checking environment...
   Node.js 22.1.0
   Claude Code CLI authenticated
   whisper-cpp found

Telegram bot token: ***pasted***
Your chat ID: ***detected***

Install as background service? yes
   com.agent.app installed
   Starts on login, restarts on crash

Done. Run npm run dev to start.
$0
Extra API costs per month
3,500
Lines of TypeScript
30
Page PDF guide
5 min
Setup to first message

Everything you need in one download.

A step-by-step PDF guide that walks you through the whole system, plus the complete working codebase. Download, set up, done.

  • 30-page PDF guide Architecture decisions, setup walkthrough, customization. With diagrams.
  • Complete working codebase The entire agent, ready to run. Not a starter template -- a finished product you can use immediately.
  • Interactive setup wizard Answers a few questions and configures everything for you. No manual editing of config files.
  • Reddit monitor (bonus) Standalone RSS keyword monitor. Get Telegram alerts when your keywords appear in subreddits.
  • Background service config Auto-generates launchd (macOS) or systemd (Linux) config. Runs 24/7, restarts on crash.
ai-agent-blueprint/
src/
  index.ts        Entry point
  bot.ts          Telegram bot (grammY)
  agent.ts        Claude Agent SDK wrapper
  dashboard.ts    Web UI (Express)
  db.ts           SQLite + FTS5 search
  memory.ts       Dual-sector memory
  scheduler.ts    Cron task runner
  voice.ts        Local whisper-cpp
  media.ts        Photo/document handling
  config.ts       Environment config

scripts/
  setup.ts        Interactive setup wizard
  status.ts       Health check
  notify.sh       CLI Telegram messenger

workspace/
  reddit-monitor/ Bonus: RSS keyword monitor

Common questions

Do I need to be a developer?

You need to be comfortable running a couple commands in your terminal. The setup wizard does the heavy lifting. If you can install an app and follow a guide, you can get this running.

Will this cost me extra every month?

No. It runs on your existing Claude Code subscription. No separate API key, no per-token charges, no surprise bills. You pay $47 once and that's it.

How is this different from OpenClaw?

OpenClaw requires a separate API key ($50-200+/mo in token costs), has 3,400+ open issues, and needs ongoing maintenance after updates. This blueprint uses the official Agent SDK, costs nothing extra, and sets up in 5 minutes with zero configuration headaches.

What if I don't use Telegram?

The web dashboard works on its own -- just open a browser. Telegram is optional. You can also connect Discord, Slack, or other platforms.

Mac only?

Works on Mac and Linux. The setup wizard detects your system and configures everything automatically.

Can I customize it?

Everything about your agent -- name, personality, rules, what it can do -- lives in one file you can edit in plain English. No code changes needed. Make it professional, casual, funny, strict -- whatever fits you.

Further reading

Essay

You're Already Building Robots. They Just Don't Have Legs.

The four systems every robot has -- sensors, brain, memory, actuators -- and how they map 1:1 to an AI agent.

Guide

How to Run an AI Agent on Your Claude Code Subscription

No separate API key. No per-token billing. How the Agent SDK uses your existing CLI auth.

Comparison

OpenClaw vs Claude Code Agent SDK: What Changed in 2026

The OAuth shutdown, the cost difference, and when each framework makes sense.

$47
One-time payment. No subscription. Yours forever.

Your AI agent. Tonight.

No extra monthly costs. No complicated setup. No Docker, no gateway, no debugging dependency errors. One download, one wizard, and your personal AI agent is running on your machine.

30-page PDF guide Boilerplate repo No extra monthly costs Lifetime access
Get Instant Access - $47

Instant delivery via Gumroad. PDF + repo access. No recurring fees.