Built on the official Claude Code Agent SDK

A Blueprint for Your Own AI Agent
Using Claude Code

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, and risky.

Popular frameworks have 3,400+ open issues, charge $50-200/mo in token costs, and have been flagged by Cisco, Kaspersky, and Palo Alto for critical security flaws. The blueprint takes a different approach.

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.
Skills

Teach it new tricks.
In plain English.

Skills are simple text files that tell your agent how to handle specific tasks. Drop a file in the skills folder and your agent can manage your email, check your calendar, research topics, organize files, or anything else you describe.

5 ready-to-use skills are included. Creating your own takes minutes -- just describe what you want in plain English. No code to write, no packages to install, no marketplace to trust.

skills/
gmail/SKILL.md
  "Check inbox, read, reply, search"

google-calendar/SKILL.md
  "View schedule, create events, find free time"

web-research/SKILL.md
  "Research any topic, compare options, cite sources"

daily-briefing/SKILL.md
  "Morning update: calendar, weather, news, tasks"

file-organizer/SKILL.md
  "Sort downloads, find duplicates, clean up folders"

+ Add your own -- just describe it in a text file
$0
Extra API costs per month
5
Ready-to-use skills included
37
Page PDF guide
5 min
Setup to first message

Your agent. Your machine.
Nobody else gets in.

Other agent frameworks have made headlines for all the wrong reasons -- remote code execution, exposed databases, malicious plugins. The blueprint was designed to keep things locked down from day one.

What's gone wrong elsewhere

!
One-click remote takeover A single malicious link could hijack your agent, disable safety controls, and run commands on your machine.
!
135,000+ instances exposed online Agents accidentally left open to the public internet. Attackers could connect and issue commands to someone else's AI.
!
820+ malicious plugins in the marketplace Community skill registries with thousands of unvetted packages. Install the wrong one and it has full access to your system.

How the blueprint handles it

Nothing exposed to the internet Your dashboard runs on localhost only. No gateway, no public-facing server, no attack surface. The only way in is through your Telegram account.
Single-user authentication Your Telegram chat ID is the only one allowed. Every other message is rejected and logged. Nobody else can talk to your agent.
Skills you can read and trust Skills are plain English files -- not code packages from strangers. You can read every word before your agent uses them. 5 starter skills included.

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.

  • 37-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.
  • 5 starter skills Gmail, Calendar, Web Research, Daily Briefing, File Organizer. Plain English files you can customize or use as templates for your own.
  • 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.

37-page PDF guide Complete codebase + 5 skills No extra monthly costs Lifetime access
Get Instant Access - $47

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