[{"data":1,"prerenderedAt":1651},["ShallowReactive",2],{"blog-post-free-ai-agent-builder":3,"related-posts-free-ai-agent-builder":566},{"id":4,"title":5,"author":6,"body":10,"category":543,"date":544,"description":545,"extension":546,"featured":547,"image":548,"imageHeight":549,"imageWidth":549,"meta":550,"navigation":551,"path":552,"readingTime":553,"seo":554,"seoTitle":555,"stem":556,"tags":557,"updatedDate":544,"__hash__":565},"blog/blog/free-ai-agent-builder.md","Free AI Agent Builder: Deploy Your First Agent for $0 Total Cost in 2026",{"name":7,"role":8,"avatar":9},"Shabnam Katoch","Growth Head","/img/avatars/shabnam-profile.jpeg",{"type":11,"value":12,"toc":521},"minimark",[13,17,20,23,26,29,32,37,40,43,46,49,52,56,59,67,73,79,82,89,93,96,113,119,203,206,209,215,218,222,225,231,244,250,256,262,268,274,277,283,287,290,293,299,305,311,317,323,326,330,338,341,345,348,354,360,366,372,375,379,387,393,399,405,411,427,430,436,440,443,446,449,452,455,459,462,465,468,471,481,485,490,493,497,500,504,507,511,514,518],[14,15,16],"p",{},"A practical, step by step playbook for solopreneurs and startup founders to ship a real AI agent without a single dollar on the table.",[14,18,19],{},"It's 11:47 PM on a Sunday. You have three browser tabs open. One shows your bank account, which is doing what bank accounts do for solo founders. The second shows a Stripe pricing page for some AI agent platform asking $97 a month before you've shipped a single thing. The third shows your competitor's homepage, where a chat bubble in the corner just answered a customer question while they presumably slept.",[14,21,22],{},"You close the laptop. You open it again. You think, there has to be a way to do this for zero dollars.",[14,24,25],{},"This article is that way.",[14,27,28],{},"Not a trial. Not a fake free tier that locks the actual useful features. Not a freemium honeypot that explodes into a credit card form the moment you connect anything real. An actual functioning AI agent. Running. Doing work. Costing you zero rupees, zero dollars, zero anything.",[14,30,31],{},"I'm going to walk you through exactly how to build it in the next 45 minutes. Then I'll tell you the part most articles skip, which is when it stops being free and what to do then.",[33,34,36],"h2",{"id":35},"why-free-ai-agent-builder-stopped-being-a-joke-in-2026","Why \"free AI agent builder\" stopped being a joke in 2026",[14,38,39],{},"Two years ago, free meant \"you can read the docs\". Today it means something genuinely useful.",[14,41,42],{},"Three things changed. First, the no-code platforms grew up. The visual builders matured to the point where you can configure an agent without writing a line of Python. Second, the LLM providers panicked. Google, Groq, OpenRouter, and others now compete on who can give you more free model access without a credit card, because they want you locked into their ecosystem before you start paying. Google AI Studio gives away more free LLM compute than any other major provider with no credit card and no expiration. Third, the agent infrastructure problem got solved by people who weren't you. Containers, secrets management, monitoring, scheduling, all the boring stuff that used to require a DevOps weekend now sits invisible inside the platform.",[14,44,45],{},"So when I say a free ai agent builder can give you a real working agent at zero cost, I don't mean it as marketing. I mean the math has actually flipped.",[14,47,48],{},"You bring two things. A platform with a real free plan. A free LLM provider key. The rest is configuration.",[14,50,51],{},"Here's the weird part. Most solopreneurs still don't believe this. They sign up for some bloated SaaS, hand over a card, get charged $79 in month two because their \"free trial\" expired, and then conclude AI agents are expensive. They're not. The tools just got really good at hiding the path.",[33,53,55],{"id":54},"what-free-actually-means-because-the-word-gets-abused","What \"free\" actually means, because the word gets abused",[14,57,58],{},"Let me define this clearly so we're not having different conversations.",[14,60,61,62,66],{},"A ",[63,64,65],"strong",{},"free plan"," is permanent. No expiration. No \"your trial ends in 14 days\" emails. It might have usage limits, but you can use it forever without paying.",[14,68,61,69,72],{},[63,70,71],{},"free trial"," is a 7 or 14 or 30 day window where you get to feel the dopamine of a paid product before the bill arrives.",[14,74,61,75,78],{},[63,76,77],{},"freemium with feature gates"," is the worst version. The free tier exists, but it's missing the three features you actually need. You can have OAuth integrations but not scheduling. Or scheduling but not memory. Or memory but not multi-channel. The whole thing is designed to push you to upgrade.",[14,80,81],{},"The only configuration of \"free\" that matters for a solo founder is the first one. Permanent free plan, every feature, no credit card. Anything else is just a sales funnel with extra steps.",[14,83,84],{},[85,86],"img",{"alt":87,"src":88},"Free plan vs free trial vs freemium with feature gates comparison","/img/blog/free-ai-agent-builder-free-tiers.jpg",[33,90,92],{"id":91},"the-0-stack-exactly-as-id-build-it-today","The $0 stack, exactly as I'd build it today",[14,94,95],{},"Here is the actual setup. No fluff. Just the components.",[14,97,98,101,102,107,108,112],{},[63,99,100],{},"Layer one. The platform."," ",[103,104,106],"a",{"href":105},"/free-plan","BetterClaw free plan",". One agent. Every feature included. No feature gates. No credit card. 100 tasks per month, which sounds low until you do the math and realize that's enough for three or four meaningful runs per day, which is most of what a personal agent does anyway. (If you want the bigger picture on no-code, see our ",[103,109,111],{"href":110},"/blog/no-code-ai-agent-builder","no-code AI agent builder guide",".)",[14,114,115,118],{},[63,116,117],{},"Layer two. The model."," This is where most people overthink. You have three solid free options in 2026. Pick one based on what you're optimizing for.",[120,121,122,144],"table",{},[123,124,125],"thead",{},[126,127,128,132,135,138,141],"tr",{},[129,130,131],"th",{},"Free LLM option",[129,133,134],{},"Best free model",[129,136,137],{},"Context window",[129,139,140],{},"Practical daily limit",[129,142,143],{},"Best for",[145,146,147,165,182],"tbody",{},[126,148,149,153,156,159,162],{},[150,151,152],"td",{},"Google AI Studio",[150,154,155],{},"Gemini 2.5 Flash",[150,157,158],{},"1 million tokens",[150,160,161],{},"~1,000 to 1,500 requests",[150,163,164],{},"Long context tasks, multimodal, free reasoning",[126,166,167,170,173,176,179],{},[150,168,169],{},"Groq",[150,171,172],{},"Llama 3.3 70B / Llama 3.1 8B",[150,174,175],{},"128K tokens",[150,177,178],{},"~1,000 requests for 70B, 14,400 for 8B",[150,180,181],{},"Speed-critical agents, real-time chat",[126,183,184,187,190,193,200],{},[150,185,186],{},"OpenRouter",[150,188,189],{},"DeepSeek V3, Llama 4 Maverick, Qwen 3",[150,191,192],{},"128K to 1M depending on model",[150,194,195,196,199],{},"~200 requests/day on most ",[197,198],"free",{}," models",[150,201,202],{},"Model variety, fallback chains",[14,204,205],{},"A few things to know before you pick. Google AI Studio's free tier currently gives Gemini 2.5 Flash 1,500 requests per day with 1 million tokens per minute, while Gemini 2.5 Pro is restricted to 50 RPD on free tier. Groq free tier provides 30,000 tokens per minute and 14,400 requests per day on models like Llama 3.1 8B with sub-second response times via Groq's custom LPU silicon. OpenRouter free models typically have a limit of 20 requests per minute and 200 requests per day, and free models may be removed or have limits adjusted without notice.",[14,207,208],{},"My honest pick for most solo founders? Google AI Studio with Gemini 2.5 Flash. Best free volume, best context window, and Flash is genuinely good enough for 90% of agent tasks. Use Groq when you need it to respond fast like a real-time assistant. Use OpenRouter when you want the option to swap models without changing platforms.",[14,210,211,214],{},[63,212,213],{},"Layer three. The channel."," Free Telegram bot. Or free Slack workspace. Both cost nothing and give your agent a place to live where you can talk to it.",[14,216,217],{},"That's it. Three layers. Three free tiers stacked. One working agent.",[33,219,221],{"id":220},"the-actual-step-by-step-doing-it-right-now","The actual step by step, doing it right now",[14,223,224],{},"Open a new tab. Follow along. The whole thing takes 30 to 45 minutes if you've never done it. Less if you have.",[14,226,227,230],{},[63,228,229],{},"Step 1. Get your free LLM key."," Go to Google AI Studio, sign in with a Google account, click \"Get API key\", create a new project, copy the key. No credit card screen anywhere. Total time: 2 minutes.",[14,232,233,236,237,239,240,112],{},[63,234,235],{},"Step 2. Sign up for the platform."," Sign up for the ",[103,238,106],{"href":105},". No credit card. You land on a dashboard. There's a button that says \"New Agent\". Click it. (Want the full step-by-step with screenshots of the configuration flow? See our ",[103,241,243],{"href":242},"/blog/how-to-build-ai-agent","how to create an AI agent guide",[14,245,246,249],{},[63,247,248],{},"Step 3. Connect the model."," In the agent setup, select Google Gemini. Paste your API key into the BYOK field. We never mark up your inference. You pay Google. Google charges you zero because you're on their free tier. Net cost: still zero.",[14,251,252,255],{},[63,253,254],{},"Step 4. Tell the agent who it is."," A text box opens. Write in plain English what you want. For a first agent, I'd start simple: \"You're my personal morning briefing assistant. Every weekday at 7 AM, check my Gmail inbox for emails received overnight that look urgent or important. Summarize them in three lines each. Skip newsletters and promotional emails. Send the briefing to my Telegram.\"",[14,257,258,261],{},[63,259,260],{},"Step 5. Add skills."," Open the verified skills library. You'll see Gmail, Google Calendar, Telegram, Notion, and a long list of others. There's a 4-layer security audit that rejects malicious skills, which matters because the skill marketplace is where most agent platforms get compromised. Click Gmail. One-tap OAuth. Click Telegram. Paste your bot token (which you get for free by talking to Telegram's BotFather, takes 90 seconds).",[14,263,264,267],{},[63,265,266],{},"Step 6. Pick the trust level."," This is the part nobody else has. Three settings. Intern (asks before every action). Specialist (asks before risky ones). Lead (acts on its own, you have a kill switch). For a first agent, start at Intern. You can move to Specialist after a week once you've watched it work.",[14,269,270,273],{},[63,271,272],{},"Step 7. Hit deploy."," Sixty seconds. Your agent is live. Isolated container. Monitored. Cost-capped. It will run your morning briefing every weekday at 7 AM until you tell it to stop.",[14,275,276],{},"Total spend: zero. Total time: about thirty minutes if you've never done this before. The hardest part is deciding what you want the agent to do.",[14,278,279],{},[85,280],{"alt":281,"src":282},"The $0 AI agent stack: BetterClaw free plan, free LLM provider, and free chat channel","/img/blog/free-ai-agent-builder-zero-dollar-stack.jpg",[33,284,286],{"id":285},"what-the-free-plan-is-genuinely-best-for","What the free plan is genuinely best for",[14,288,289],{},"Be honest with yourself. The free plan is not a production customer support system. It's not going to handle 50,000 lead lookups a month. The 100-task limit will get hit quickly if you point it at something high volume.",[14,291,292],{},"Here's what it's perfect for.",[14,294,295,298],{},[63,296,297],{},"Personal AI assistant."," Morning briefings, calendar prep, email triage, document lookups, meeting note summaries. Anything that runs a few times a day and saves you ten minutes each time.",[14,300,301,304],{},[63,302,303],{},"Email triage for solo founders."," An agent that reads your inbox at 8 AM and tells you which three emails actually need a reply today. That's two or three tasks per day. Well inside 100 a month.",[14,306,307,310],{},[63,308,309],{},"Lead qualification on inbound."," When someone fills out your contact form, an agent that enriches the lead, scores them on your ICP fit, and drops them into the right Notion table or HubSpot pipeline. If you're getting 10 leads a week, that's 40 tasks a month.",[14,312,313,316],{},[63,314,315],{},"Content monitoring."," An agent that watches a few key sources, flags new posts that match your criteria, and Slacks you a summary. Daily run, well within limits.",[14,318,319,322],{},[63,320,321],{},"Testing before scaling."," This is the underrated one. Build the agent on the free plan. Watch it work for two weeks. Once you trust it and want to add three more, that's when you upgrade. The free plan is your validation environment.",[14,324,325],{},"The pattern I'd avoid: don't try to use the free plan for anything where the agent runs more than 5 times a day. You'll bump into the task ceiling and start rationing. That's the platform telling you you've outgrown free, and that's fine. That's what Pro is for.",[33,327,329],{"id":328},"a-subtle-thing-worth-saying-here","A subtle thing worth saying here",[14,331,332,333,337],{},"If the morning briefing example sounded useful and you're sitting there thinking I could actually build that tonight, that's exactly the response we designed for. Start free, no credit card, 1 agent, every feature, BYOK. When you outgrow it, Pro is $19 per agent per month with unlimited tasks and hourly scheduling. ",[103,334,336],{"href":335},"/pricing","See the full pricing breakdown"," if you want the comparison. The first agent really does deploy in about 60 seconds once you've signed up.",[14,339,340],{},"Back to the article.",[33,342,344],{"id":343},"the-honest-part-when-to-upgrade-and-why","The honest part: when to upgrade and why",[14,346,347],{},"I'd be lying if I said the free plan is enough forever. For most solo founders it is. For some of you, it won't be. Here are the four signals.",[14,349,350,353],{},[63,351,352],{},"Signal one. You want more than one agent."," The free plan gives you one. That's deliberate. One agent is enough to validate that this works. Once you've shipped it and want to build a second one (say, a sales follow-up agent alongside your morning briefing), you've outgrown free. Pro gives you up to 25.",[14,355,356,359],{},[63,357,358],{},"Signal two. You need scheduling tighter than daily."," Free supports daily and weekly schedules. The moment you want \"every hour\" or \"every 15 minutes during business hours\", you need Pro. Common use case: a competitor monitoring agent that checks every hour for pricing changes.",[14,361,362,365],{},[63,363,364],{},"Signal three. You're hitting the task ceiling."," 100 tasks a month is roughly 3 to 4 per day. If your agent is running 10 times a day because the use case is genuinely high frequency, you're going to hit the wall by mid-month. Pro removes the cap.",[14,367,368,371],{},[63,369,370],{},"Signal four. You need memory longer than 7 days."," Free plan agents remember 7 days of context. Good enough for personal assistants and short-running workflows. Not enough for sales nurturing, long-running customer support threads, or anything where the agent needs to remember a conversation from three weeks ago.",[14,373,374],{},"If none of these apply, stay free. Genuinely. We don't make money pushing you to Pro before you need it. Solo founders who upgrade too early and churn are worse for us than ones who stay free for six months and convert when they actually need it.",[33,376,378],{"id":377},"the-competitors-i-wont-pretend-dont-exist","The competitors I won't pretend don't exist",[14,380,381,382,386],{},"This is where most articles get dishonest. They list their own product and call it the best. Let me give you the actual landscape. (For the deeper side-by-side, see our ",[103,383,385],{"href":384},"/blog/best-ai-agent-builders","7 best AI agent builder platforms"," post.)",[14,388,389,392],{},[63,390,391],{},"Lindy"," has a free tier but it's narrower. Mostly sales outbound use cases. Good if that's what you're building. Limited if it isn't.",[14,394,395,398],{},[63,396,397],{},"Gumloop"," has a free tier but it's a true freemium with feature gates. You'll hit walls. They're enterprise-focused and the free experience reflects that.",[14,400,401,404],{},[63,402,403],{},"n8n self-hosted"," is technically free. It's open-source workflow automation. But you need to host it somewhere, manage updates, handle credentials, and write some JavaScript to glue things together. If you're a technical operator, great. If you're a solopreneur who'd rather build your business than babysit a workflow engine, this is a tax on your time, not free.",[14,406,407,410],{},[63,408,409],{},"CrewAI"," is a code-first Python framework. Free if you can write Python and host the agents yourself. It's open-source and competitive at every tier. But \"open source and free\" includes paying for the VPS, the monitoring, the time to debug your YAML. For non-developers, this isn't really an option.",[14,412,413,416,417,421,422,426],{},[63,414,415],{},"Pickaxe, Vapi, Flowise"," and a few others each have free tiers with different trade-offs. None of them ship with a permanent free plan that includes every feature without a credit card. The closest comparison platform on the ",[103,418,420],{"href":419},"/","BetterClaw homepage"," lays out the full feature list. For a GCP-native enterprise alternative, see our ",[103,423,425],{"href":424},"/blog/vertex-ai-agent-builder-alternative","BetterClaw vs Vertex AI Agent Builder"," breakdown.",[14,428,429],{},"The honest summary: the free AI agent builder space has a lot of options, but very few of them are actually free in the way a solo founder needs them to be.",[14,431,432],{},[85,433],{"alt":434,"src":435},"Free tier comparison across Lindy, Gumloop, n8n, CrewAI, and BetterClaw","/img/blog/free-ai-agent-builder-competitors.jpg",[33,437,439],{"id":438},"the-mistake-that-costs-solo-founders-money","The mistake that costs solo founders money",[14,441,442],{},"I'll tell you the one trap I see solo founders fall into over and over.",[14,444,445],{},"They build the agent. It works. They get excited. They immediately try to scale it to ten times the volume on day three. The free LLM tier rate limits. The platform task limit hits. The whole thing breaks. They conclude AI agents don't work and go back to doing everything manually.",[14,447,448],{},"Don't do this.",[14,450,451],{},"The right pattern is boring. Build one agent. Let it run for two weeks. Watch what it does. Notice what it gets wrong. Tweak the instructions. Add one skill. Let it run for two more weeks. Now you actually know what this agent is good for, and you can confidently upgrade to handle more volume.",[14,453,454],{},"The free plan isn't a limitation. It's a forced patience mechanism. Use it.",[33,456,458],{"id":457},"the-closing-thought","The closing thought",[14,460,461],{},"Here's what I keep coming back to.",[14,463,464],{},"The reason most solopreneurs don't have an AI agent isn't budget. It's friction. Every blog post tells them to \"just install Docker\" or \"spin up a Python environment\" or \"configure a Kubernetes cluster\" before they've even decided what the agent should do. By the time they've worked through that setup, the original idea has died of boredom.",[14,466,467],{},"A free plan eliminates that friction completely. There's no decision to make. No card to enter. No \"is this worth it\" calculation. You just sign up and build the thing.",[14,469,470],{},"The only question left is whether you'll spend the next 45 minutes shipping a working agent or watching another YouTube tutorial about why AI agents are the future.",[14,472,473,474,480],{},"If any of this resonated, ",[103,475,479],{"href":476,"rel":477},"https://app.betterclaw.io/sign-in",[478],"nofollow","give BetterClaw a try",". Free plan with 1 agent and every feature. $19 per agent per month for Pro when you outgrow it. Your first deploy takes about 60 seconds. We handle the infrastructure. You handle the interesting part.",[33,482,484],{"id":483},"frequently-asked-questions","Frequently Asked Questions",[486,487,489],"h3",{"id":488},"what-is-a-free-ai-agent-builder","What is a free AI agent builder?",[14,491,492],{},"A free AI agent builder is a no-code platform where you can create and deploy an autonomous AI agent at zero cost, with no credit card and no trial expiration. The genuine ones offer a permanent free plan with every feature included, not a 14-day trial or a freemium with feature gates. You bring your own free LLM provider key (like Google AI Studio's Gemini free tier) and the platform handles hosting, security, and execution at no charge.",[486,494,496],{"id":495},"how-does-a-free-ai-agent-builder-compare-to-paying-for-a-platform-like-lindy-or-gumloop","How does a free AI agent builder compare to paying for a platform like Lindy or Gumloop?",[14,498,499],{},"The main difference is feature access on the free tier. A true free AI agent builder gives you every feature on the free plan, while platforms like Gumloop gate the most useful features behind paid tiers. The trade-off is that free plans typically limit you to one agent and a capped number of monthly tasks, which is enough for personal assistants and validation but not for high-volume production use. You upgrade when you outgrow it, not before.",[486,501,503],{"id":502},"how-do-i-build-an-ai-agent-for-free-in-2026","How do I build an AI agent for free in 2026?",[14,505,506],{},"Sign up for a free AI agent builder like BetterClaw, get a free LLM key from Google AI Studio or Groq, connect them via BYOK, configure the agent in plain English with the skills it needs (Gmail, Telegram, Slack), set a trust level, and deploy. Total time is about 30 to 45 minutes for your first agent, and total cost is $0 if you stay within free tier limits on both the platform (100 tasks per month) and the LLM provider (~1,500 daily requests on Gemini Flash free tier).",[486,508,510],{"id":509},"is-the-free-plan-on-an-ai-agent-builder-actually-worth-using-or-just-a-sales-funnel","Is the free plan on an AI agent builder actually worth using or just a sales funnel?",[14,512,513],{},"It depends on the platform. A real free plan has no credit card requirement, no trial expiration, and includes every feature without gates. BetterClaw's free plan gives you 1 agent, 100 tasks per month, all 200+ verified skills, all integrations, and trust levels at $0 forever. It's genuinely production-grade for personal use cases like morning briefings or email triage. Most competitor \"free\" tiers either expire, require a card, or strip out the features that matter.",[486,515,517],{"id":516},"is-a-free-ai-agent-secure-enough-for-personal-or-solo-founder-use","Is a free AI agent secure enough for personal or solo founder use?",[14,519,520],{},"Yes, if the platform takes security seriously. Look for isolated Docker containers per agent (so one agent can't affect another), encrypted credentials with auto-purge from agent memory after a short window, a verified skills marketplace that audits and rejects malicious skills, real-time monitoring with auto-pause on anomalies, and trust levels that require approval before risky actions. BetterClaw's free plan includes all of these, which is a stronger security posture than most teams could build themselves from scratch.",{"title":522,"searchDepth":523,"depth":523,"links":524},"",2,[525,526,527,528,529,530,531,532,533,534,535],{"id":35,"depth":523,"text":36},{"id":54,"depth":523,"text":55},{"id":91,"depth":523,"text":92},{"id":220,"depth":523,"text":221},{"id":285,"depth":523,"text":286},{"id":328,"depth":523,"text":329},{"id":343,"depth":523,"text":344},{"id":377,"depth":523,"text":378},{"id":438,"depth":523,"text":439},{"id":457,"depth":523,"text":458},{"id":483,"depth":523,"text":484,"children":536},[537,539,540,541,542],{"id":488,"depth":538,"text":489},3,{"id":495,"depth":538,"text":496},{"id":502,"depth":538,"text":503},{"id":509,"depth":538,"text":510},{"id":516,"depth":538,"text":517},"Guides","2026-05-20","Build a real AI agent for $0 total cost. Permanent free plan, every feature, no credit card. Step-by-step setup with free LLM options. Start free today.","md",false,"/img/blog/free-ai-agent-builder.jpg",null,{},true,"/blog/free-ai-agent-builder","11 min read",{"title":5,"description":545},"Free AI Agent Builder: Deploy Your First Agent at $0 (2026)","blog/free-ai-agent-builder",[558,559,560,561,562,563,564],"free ai agent builder","ai agent builder free","free ai agent platforms no credit card","build ai agent for free","free ai agent","ai agent free plan","deploy ai agent free","dytaScRrUMcmrvKynUqFC0DTdKzysqm65EHPRpFjDL8",[567,900,1317],{"id":568,"title":569,"author":570,"body":571,"category":543,"date":882,"description":883,"extension":546,"featured":547,"image":884,"imageHeight":549,"imageWidth":549,"meta":885,"navigation":551,"path":886,"readingTime":887,"seo":888,"seoTitle":889,"stem":890,"tags":891,"updatedDate":882,"__hash__":899},"blog/blog/free-openclaw-agent-openrouter-setup.md","How to Run a Free OpenClaw Agent in 5 Minutes Using OpenRouter",{"name":7,"role":8,"avatar":9},{"type":11,"value":572,"toc":870},[573,579,582,585,588,591,594,597,600,604,613,616,619,625,629,636,639,642,648,652,660,663,666,669,673,676,682,688,694,700,703,711,715,718,721,734,737,740,744,747,750,753,756,764,768,771,774,777,780,787,791,794,797,800,808,812,815,818,825,828,830,835,838,843,846,851,854,859,862,867],[14,574,575],{},[576,577,578],"em",{},"No API bill. No credit card. No infrastructure headaches. Here's exactly how we did it.",[14,580,581],{},"Someone dropped a comment on one of our Reddit threads last week that stopped me mid-scroll.",[14,583,584],{},"\"BYOK sounds great but what if I don't want to pay for an API key either?\"",[14,586,587],{},"Fair. Really fair.",[14,589,590],{},"We've been saying \"bring your own API keys\" like it's the generous option. But for someone who just wants to test whether an AI agent is actually useful before spending a dollar, even getting an OpenRouter key feels like one more step in a wall of friction.",[14,592,593],{},"So we tried something. We set up a completely working OpenClaw agent, on BetterClaw's free tier, using only free models from OpenRouter.",[14,595,596],{},"$0 total. Not \"$5 free credits.\" Not \"basically free.\" Zero.",[14,598,599],{},"Here's exactly what we did, what we ran into, and what you should know before you try it.",[33,601,603],{"id":602},"step-1-get-a-free-api-key-from-openrouter-2-minutes","Step 1: Get a Free API Key from OpenRouter (2 Minutes)",[14,605,606,607,612],{},"Go to ",[103,608,611],{"href":609,"rel":610},"https://openrouter.ai/",[478],"openrouter.ai",". Sign up. That's it.",[14,614,615],{},"You now have access to 30+ free models. The ones worth knowing about for agent work: Llama 3.3 70b, DeepSeek R1, and Qwen3 Coder 480b. The base limit is 50 requests per day on most free models, but some go up to 1,000 free requests per day.",[14,617,618],{},"For a daily briefing agent or a lightweight personal assistant? 1,000 requests per day is more than enough. Most real-world agent usage runs 10 to 30 requests per session.",[14,620,621],{},[85,622],{"alt":623,"src":624},"OpenRouter free tier dashboard showing Llama 3.3 70b, DeepSeek R1, and Qwen3 Coder 480b with daily request limits ranging from 50 to 1,000 free requests per day","/img/blog/free-openclaw-agent-openrouter-setup-openrouter-models.jpg",[33,626,628],{"id":627},"step-2-sign-up-for-betterclaw-free-tier-2-minutes","Step 2: Sign Up for BetterClaw Free Tier (2 Minutes)",[14,630,606,631,635],{},[103,632,634],{"href":476,"rel":633},[478],"the BetterClaw app",". No card. No trial countdown. Takes about 2 minutes.",[14,637,638],{},"When it asks for your API key, paste in the OpenRouter key you just generated. Then select one of the free models as your default.",[14,640,641],{},"Which free model should you pick? Honestly, for most agent tasks, Llama 3.3 70b or DeepSeek R1 handle daily briefings, summarization, email triage, and basic research just fine. They're not Claude Sonnet. But for a free agent doing routine tasks, they're more than good enough.",[14,643,644],{},[85,645],{"alt":646,"src":647},"BetterClaw LLM configuration screen showing OpenRouter API key field and free model dropdown with Llama 3.3 70b selected as default for the agent","/img/blog/free-openclaw-agent-openrouter-setup-llm-config.jpg",[33,649,651],{"id":650},"step-3-connect-your-channel-1-minute","Step 3: Connect Your Channel (1 Minute)",[14,653,654,655,659],{},"BetterClaw connects to 15+ platforms out of the box. For a free setup, Telegram is the cleanest option. Takes about 60 seconds to get a bot token from BotFather and paste it into the channel config. For the ",[103,656,658],{"href":657},"/guide/integrate-telegram-with-betterclaw","step-by-step Telegram walkthrough",", our setup guide covers BotFather and pairing.",[14,661,662],{},"If you want to connect to Slack, Discord, or WhatsApp instead, the process is similar. The agent starts responding on whatever channel you pick.",[14,664,665],{},"And that's it. You're done.",[14,667,668],{},"Five minutes from nothing to a working AI agent. Cost: $0.",[33,670,672],{"id":671},"whats-the-catch-with-free-models","\"What's the Catch With Free Models?\"",[14,674,675],{},"Here's where we'll be straight with you.",[14,677,678,681],{},[63,679,680],{},"Free models are slower than paid models."," You'll notice the latency. Not unbearable, but noticeable. Expect 3 to 8 seconds per response instead of under 2.",[14,683,684,687],{},[63,685,686],{},"Complex multi-step tasks get shaky."," If you need your agent to run a 10-step research chain with tool calls at each step, free models stumble. They'll misinterpret instructions, skip steps, or hallucinate a tool result. Single-step and two-step tasks? Totally fine.",[14,689,690,693],{},[63,691,692],{},"Rate limits exist."," You're on shared infrastructure. During peak hours you might get queued. Not often, but it happens.",[14,695,696,699],{},[63,697,698],{},"Quality varies by model and by day."," Some days DeepSeek R1 is sharp. Some days it rambles. You learn which model handles which task better over time. This is the honest part of \"free.\"",[14,701,702],{},"But for a \"try before you spend\" setup or a simple daily assistant use case, free models work better than most people expect. We were surprised.",[14,704,705,706,710],{},"If you're curious about how different models perform on OpenClaw tasks generally, we've done a ",[103,707,709],{"href":708},"/blog/best-llm-for-openclaw-glm-5-1-claude-sonnet-minimax","detailed LLM comparison for OpenClaw use cases"," that goes deeper into benchmarks and tradeoffs.",[33,712,714],{"id":713},"will-i-hit-the-100-task-limit","\"Will I Hit the 100 Task Limit?\"",[14,716,717],{},"With this setup? Probably not in month one.",[14,719,720],{},"Here's the rough math:",[722,723,724,728,731],"ul",{},[725,726,727],"li",{},"1 daily briefing cron: ~30 tasks per month",[725,729,730],{},"1 weekly report cron: ~4 tasks per month",[725,732,733],{},"15 to 20 ad-hoc requests per week: ~70 tasks per month",[14,735,736],{},"Total: roughly 100. Tight, but workable if you're not running 5 daily crons.",[14,738,739],{},"If you find yourself constantly hitting the limit, that's the signal the agent is useful enough to upgrade. Month one on free? You'll be fine.",[33,741,743],{"id":742},"why-we-built-this-option","Why We Built This Option",[14,745,746],{},"We've talked to a lot of people who got interested in OpenClaw after seeing it hit 230,000+ GitHub stars and land on the front page of Hacker News. They followed a setup tutorial, ran into Docker issues or YAML configs, and quietly gave up.",[14,748,749],{},"The OpenClaw maintainer himself once warned: \"if you can't understand how to run a command line, this is far too dangerous of a project for you to use safely.\"",[14,751,752],{},"That's a real barrier. Not everyone needs to cross it just to try an AI agent.",[14,754,755],{},"BetterClaw exists because we think more people should be able to experience what a well-configured autonomous agent actually feels like, without the infrastructure tax. The free tier plus OpenRouter's free models is the lowest-friction version of that we've been able to build.",[14,757,758,759,763],{},"If you've been curious about ",[103,760,762],{"href":761},"/openclaw-hosting","what managed OpenClaw hosting actually includes"," versus spinning something up on a VPS yourself, that page walks through the full comparison.",[33,765,767],{"id":766},"the-moment-it-actually-starts-feeling-useful","The Moment It Actually Starts Feeling Useful",[14,769,770],{},"Here's what we didn't expect to be true: the first time your free-tier agent quietly runs a morning briefing, summarizes your overnight Slack threads, or answers a question without you lifting a finger, something clicks.",[14,772,773],{},"It's not the technology that lands. It's the time.",[14,775,776],{},"Most people who try this setup report the same thing. The agent does something useful. They go back to their day. Then they check the output an hour later and think, \"I would have spent 20 minutes on that.\"",[14,778,779],{},"That's when the \"is this worth paying for\" question answers itself.",[14,781,782,783,786],{},"If you want your OpenClaw agent running in 60 seconds with your own API keys and no usage caps, ",[103,784,785],{"href":335},"BetterClaw's Pro plan is $19/month per agent"," (up to 25 agents, each billed at $19/month). Bring your own keys, pick any of 28+ model providers, and the infrastructure is completely managed. No Docker. No YAML. No 2 AM debugging.",[33,788,790],{"id":789},"what-happens-when-youre-ready-to-upgrade","What Happens When You're Ready to Upgrade",[14,792,793],{},"The free tier is a starting point, not a ceiling.",[14,795,796],{},"When you move to Pro at $19/month, you get persistent memory with hybrid vector and keyword search, real-time health monitoring, auto-pause on anomalies, and multi-channel support from a single agent. You can also swap in Claude Sonnet or GPT-4o the moment you want sharper reasoning on complex tasks.",[14,798,799],{},"The upgrade takes about 30 seconds inside the same dashboard.",[14,801,802,803,807],{},"If you've been running agents on a VPS or trying to self-host OpenClaw and the maintenance burden is getting old, take a look at ",[103,804,806],{"href":805},"/compare/self-hosted","how BetterClaw compares to self-hosting and managed alternatives",". The hidden costs of DIY infrastructure add up faster than most people realize.",[33,809,811],{"id":810},"give-it-a-try","Give It a Try",[14,813,814],{},"If you've been on the fence about whether AI agents are actually useful, this is the lowest-stakes test you can run.",[14,816,817],{},"No credit card. No infrastructure decision. No API bill waiting at the end of the month.",[14,819,820,824],{},[103,821,823],{"href":476,"rel":822},[478],"Sign up for BetterClaw's free tier",", grab a free OpenRouter key, and have a working agent in 5 minutes. If it's useful, you'll know. If it's not, you've lost nothing but 5 minutes.",[14,826,827],{},"We handle the infrastructure. You handle the interesting part.",[33,829,484],{"id":483},[14,831,832],{},[63,833,834],{},"What is a free OpenClaw agent and how does it work?",[14,836,837],{},"A free OpenClaw agent is a fully functional AI assistant built on OpenClaw, the open-source agent framework with 230,000+ GitHub stars, deployed on BetterClaw's free tier and powered by OpenRouter's free model tier. BetterClaw handles the hosting, security, and channel connections. OpenRouter provides access to models like Llama 3.3 70b and DeepSeek R1 at no cost. You get a working autonomous agent at $0.",[14,839,840],{},[63,841,842],{},"How does OpenRouter's free tier compare to a paid API key for OpenClaw?",[14,844,845],{},"OpenRouter's free models are slower (3 to 8 seconds per response vs. under 2 for paid) and less reliable on complex multi-step tasks. For simple daily tasks like briefings, summarization, and research lookups, the quality gap is small. For sophisticated chains with multiple tool calls, a paid model like Claude Sonnet or GPT-4o will perform significantly better. The free setup is ideal for evaluation and lightweight personal use.",[14,847,848],{},[63,849,850],{},"How long does it take to set up a free OpenClaw agent with BetterClaw?",[14,852,853],{},"About 5 minutes total. Getting a free API key from OpenRouter takes roughly 2 minutes. Signing up for BetterClaw's free tier takes another 2 minutes. Connecting your Telegram channel takes about 1 minute. The agent starts responding immediately after setup. No Docker, no YAML, no terminal required.",[14,855,856],{},[63,857,858],{},"Is BetterClaw's free tier actually free, or are there hidden costs?",[14,860,861],{},"The free tier is genuinely free. No credit card required, no trial period, no automatic upgrade. You get 1 agent slot and up to 100 tasks per month at $0. If you use OpenRouter's free models, your total monthly cost is $0. If you exceed the task limit or want persistent memory and multi-channel support, the Pro plan is $19/month per agent (up to 25 agents, each billed at $19/month) with bring-your-own API keys.",[14,863,864],{},[63,865,866],{},"Is it safe to run an OpenClaw agent on a free plan?",[14,868,869],{},"Yes. BetterClaw runs all agents in Docker-sandboxed execution environments with AES-256 encryption for credentials, regardless of which plan you're on. The security architecture is the same on free as on Pro. Your API keys are never stored in plaintext. Given that security researchers have found over 30,000 internet-exposed OpenClaw instances without authentication, using a managed platform with built-in sandboxing is significantly safer than a self-hosted setup, especially for someone new to agent infrastructure.",{"title":522,"searchDepth":523,"depth":523,"links":871},[872,873,874,875,876,877,878,879,880,881],{"id":602,"depth":523,"text":603},{"id":627,"depth":523,"text":628},{"id":650,"depth":523,"text":651},{"id":671,"depth":523,"text":672},{"id":713,"depth":523,"text":714},{"id":742,"depth":523,"text":743},{"id":766,"depth":523,"text":767},{"id":789,"depth":523,"text":790},{"id":810,"depth":523,"text":811},{"id":483,"depth":523,"text":484},"2026-04-25","Run a fully working OpenClaw agent for $0 using BetterClaw's free tier and OpenRouter's free models. No credit card. No Docker. Setup takes 5 minutes.","/img/blog/free-openclaw-agent-openrouter-setup.jpg",{},"/blog/free-openclaw-agent-openrouter-setup","7 min read",{"title":569,"description":883},"Free OpenClaw Agent Setup With OpenRouter in 5 Minutes","blog/free-openclaw-agent-openrouter-setup",[892,893,894,895,896,897,898],"free openclaw agent","openrouter free api key","openclaw free setup","betterclaw free tier","run openclaw for free","openclaw no credit card","free ai agent setup","MH1BX0hSPYHJ6IMEreHwoKBfo2S3-hR0WbT0Ys9JfSs",{"id":901,"title":902,"author":903,"body":904,"category":543,"date":1299,"description":1300,"extension":546,"featured":547,"image":1301,"imageHeight":549,"imageWidth":549,"meta":1302,"navigation":551,"path":1303,"readingTime":1304,"seo":1305,"seoTitle":1306,"stem":1307,"tags":1308,"updatedDate":1299,"__hash__":1316},"blog/blog/hermes-agent-docker-install.md","How to Install Hermes Agent with Docker: Step-by-Step Guide (2026)",{"name":7,"role":8,"avatar":9},{"type":11,"value":905,"toc":1284},[906,909,912,915,918,926,929,933,939,942,951,954,957,963,966,969,975,978,992,996,999,1005,1008,1011,1014,1022,1026,1039,1045,1048,1055,1058,1065,1072,1080,1084,1090,1093,1099,1105,1111,1118,1125,1129,1135,1138,1167,1172,1191,1198,1202,1205,1208,1211,1214,1221,1223,1227,1242,1246,1249,1253,1265,1269,1272,1276],[14,907,908],{},"Hermes Agent ships an official Docker image. Three commands to setup, one to run 24/7. But there are two Docker modes that most guides conflate, and one data persistence mistake that wipes your skills. Here's the guide that covers both.",[14,910,911],{},"A developer on MindStudio wrote: \"You will forget which container holds which agent within two weeks.\"",[14,913,914],{},"He was running four Hermes instances. Different models. Different Telegram bots. Different skill libraries. All in separate Docker containers. All with nearly identical names. And no labeling system.",[14,916,917],{},"That's the Docker experience in one sentence. It works. You just have to manage it.",[14,919,920,921,925],{},"Hermes Agent (23,000+ GitHub stars, growing fast) ships an official Docker image from Nous Research. The install is genuinely simple: three commands to setup, one to run. But the Docker deployment has two distinct modes that most guides conflate, and one data persistence mistake that silently wipes your accumulated skills on the next ",[922,923,924],"code",{},"docker pull",".",[14,927,928],{},"Here's the complete guide.",[33,930,932],{"id":931},"the-setup-three-commands-five-minutes","The setup (three commands, five minutes)",[14,934,935],{},[85,936],{"alt":937,"src":938},"nousresearch/hermes-agent installation flow: create data directory, run setup wizard, start gateway daemon","/img/blog/hermes-docker-install-flow.jpg",[14,940,941],{},"Step 1: Create the data directory.",[943,944,949],"pre",{"className":945,"code":947,"language":948},[946],"language-text","mkdir -p ~/.hermes\n","text",[922,950,947],{"__ignoreMap":522},[14,952,953],{},"This is where your config, API keys, sessions, skills, and memories live on the host machine.",[14,955,956],{},"Step 2: Run the setup wizard.",[943,958,961],{"className":959,"code":960,"language":948},[946],"docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup\n",[922,962,960],{"__ignoreMap":522},[14,964,965],{},"This drops you into the interactive wizard. It asks for your LLM provider (Anthropic, OpenAI, DeepSeek, OpenRouter, etc.), your API key, and which messaging channels to connect (Telegram, Discord, Slack, WhatsApp).",[14,967,968],{},"Step 3: Run the gateway in the background.",[943,970,973],{"className":971,"code":972,"language":948},[946],"docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data -p 8642:8642 nousresearch/hermes-agent gateway run\n",[922,974,972],{"__ignoreMap":522},[14,976,977],{},"Your agent is now running 24/7. Port 8642 exposes the gateway's OpenAI-compatible API server and health endpoint. It's optional if you only use messaging platforms but required for the dashboard and external tools.",[14,979,980,981,984,985,987,988,991],{},"The critical detail: The ",[922,982,983],{},"-v ~/.hermes:/opt/data"," volume mount is what keeps your data safe. Without it, your config, skills, and memories live inside the container and vanish on the next ",[922,986,924],{},". Always mount ",[922,989,990],{},"/opt/data"," to a host directory.",[33,993,995],{"id":994},"the-two-docker-modes-this-is-where-most-guides-get-confusing","The two Docker modes (this is where most guides get confusing)",[14,997,998],{},"Here's what nobody tells you about Hermes and Docker.",[14,1000,1001],{},[85,1002],{"alt":1003,"src":1004},"Hermes Docker Mode 1 (Hermes inside Docker for VPS deployment) vs Mode 2 (Docker as a sandboxed terminal backend for local development)","/img/blog/hermes-docker-mode-1-vs-mode-2.jpg",[14,1006,1007],{},"Mode 1: Hermes running inside Docker. This is the standard deployment. The entire agent (gateway, skills, memory, messaging) runs inside the container. You interact through Telegram, Discord, or other channels. The container is your server. This is what the setup above configures.",[14,1009,1010],{},"Mode 2: Docker as a terminal backend. Hermes runs on your host machine (not in Docker). But every command the agent executes runs inside a Docker sandbox container. The sandbox survives across tool calls, new sessions, and subagents. This is for developers who want the agent on their machine but want command execution isolated.",[14,1012,1013],{},"The confusion: Most guides mix these two modes. \"Install Hermes with Docker\" could mean either. If you want a 24/7 agent on a VPS, you want Mode 1. If you want safe local development with isolated execution, you want Mode 2.",[14,1015,1016,1017,1021],{},"For the ",[103,1018,1020],{"href":1019},"/blog/openclaw-security-risks","detailed comparison of Hermes features in v0.13",", our security analysis covers how both Docker modes handle credential isolation.",[33,1023,1025],{"id":1024},"the-production-checklist-what-breaks-after-day-one","The production checklist (what breaks after day one)",[14,1027,1028,1029,1032,1033,1035,1036,1038],{},"Problem 1: Volume mount missing. You ran ",[922,1030,1031],{},"docker run"," without ",[922,1034,983],{},". The agent works. Skills accumulate. Memory grows. Then you update with ",[922,1037,924],{}," and restart. Everything is gone. The container was the only copy.",[14,1040,1041,1042,925],{},"The fix: Always use the volume mount. Always verify with ",[922,1043,1044],{},"docker inspect hermes | grep Mounts",[14,1046,1047],{},"Problem 2: Node version mismatch inside the container. Docker users hit issues when the container's Node.js version conflicts with skills that expect a specific version. The official image pins Node, but community images vary.",[14,1049,1050,1051,1054],{},"The fix: Use only the official ",[922,1052,1053],{},"nousresearch/hermes-agent"," image. Community images may lag behind or use incompatible base images.",[14,1056,1057],{},"Problem 3: .venv permission issues. On some host configurations, the Python virtual environment inside the container has permission conflicts with the mounted volume. Skills fail to install with cryptic permission errors.",[14,1059,1060,1061,1064],{},"The fix: Ensure the container user has write permissions to the mounted directory. ",[922,1062,1063],{},"chown -R 1000:1000 ~/.hermes"," on the host before starting the container.",[14,1066,1067,1068,1071],{},"Problem 4: Port 8642 conflicts. If you're running multiple Hermes instances (different agents, different bots), each needs a different host port mapping. ",[922,1069,1070],{},"docker run -p 8643:8642"," for the second instance, etc.",[14,1073,1074,1075,1079],{},"If managing Docker volumes, port mappings, Node version conflicts, permission issues, and multi-container orchestration for an AI agent sounds like more DevOps than agent building, ",[103,1076,1078],{"href":1077},"/openclaw-alternative","BetterClaw eliminates the Docker layer entirely",". No containers. No volume mounts. No port mapping. Deploy in 60 seconds from a browser. Free tier with 1 agent and BYOK. $19/month per agent for Pro.",[33,1081,1083],{"id":1082},"updating-the-part-that-catches-people","Updating (the part that catches people)",[14,1085,1086],{},[85,1087],{"alt":1088,"src":1089},"Hermes Docker update steps: docker pull, docker stop, docker rm, docker run — data in ~/.hermes survives because it lives on the host","/img/blog/hermes-docker-update-steps.jpg",[14,1091,1092],{},"The update process:",[14,1094,1095,1096],{},"Pull the new image: ",[922,1097,1098],{},"docker pull nousresearch/hermes-agent:latest",[14,1100,1101,1102],{},"Stop and remove the old container: ",[922,1103,1104],{},"docker stop hermes && docker rm hermes",[14,1106,1107,1108],{},"Start a new container with the same volume mount: ",[922,1109,1110],{},"docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data -p 8642:8642 nousresearch/hermes-agent gateway run",[14,1112,1113,1114,1117],{},"Your data survives because it lives in ",[922,1115,1116],{},"~/.hermes"," on the host. The container is disposable. The data directory is permanent. This is the correct Docker pattern for stateful applications.",[14,1119,1120,1121,1124],{},"The mistake to avoid: Using ",[922,1122,1123],{},"docker compose up -d"," with a build step instead of pull. If your compose file builds from source instead of pulling the official image, updates require rebuilding, which takes longer and can introduce build failures.",[33,1126,1128],{"id":1127},"docker-compose-for-the-organized","Docker Compose (for the organized)",[14,1130,1131],{},[85,1132],{"alt":1133,"src":1134},"docker-compose.yml with multiple Hermes agents: hermes-work on port 8642 and hermes-personal on port 8643, with separate data directories and Telegram bots","/img/blog/hermes-docker-compose-multi-agent.jpg",[14,1136,1137],{},"If you prefer declarative configuration, here's the pattern:",[14,1139,1140,1141,1144,1145,1148,1149,1151,1152,1155,1156,1159,1160,1163,1164,925],{},"Create a ",[922,1142,1143],{},"docker-compose.yml"," with the service name ",[922,1146,1147],{},"hermes",", using the official image ",[922,1150,1053],{},", restart policy ",[922,1153,1154],{},"unless-stopped",", port ",[922,1157,1158],{},"8642:8642",", volume ",[922,1161,1162],{},"~/.hermes:/opt/data",", and command ",[922,1165,1166],{},"gateway run",[14,1168,1169,1170],{},"Then: ",[922,1171,1123],{},[14,1173,1174,1175,1178,1179,1182,1183,1186,1187,1190],{},"For multiple agents: Duplicate the service block with different names, ports, and data directories. ",[922,1176,1177],{},"hermes-work"," on port 8642 with ",[922,1180,1181],{},"~/.hermes-work:/opt/data",". ",[922,1184,1185],{},"hermes-personal"," on port 8643 with ",[922,1188,1189],{},"~/.hermes-personal:/opt/data",". Each agent has isolated skills, memory, and messaging channels.",[14,1192,1016,1193,1197],{},[103,1194,1196],{"href":1195},"/compare","comparison between managed and self-hosted agent deployment",", our comparison covers what you manage yourself versus what a platform handles.",[33,1199,1201],{"id":1200},"the-honest-assessment-docker-for-hermes-vs-managed-alternatives","The honest assessment (Docker for Hermes vs managed alternatives)",[14,1203,1204],{},"Here's the take.",[14,1206,1207],{},"Docker is the right choice for Hermes if you want full control, you're comfortable with container management, and you're running on a VPS you already have. The official image is well-maintained. The volume mount pattern is clean. Updates are pull-stop-remove-restart.",[14,1209,1210],{},"Docker is the wrong choice if you don't want to manage containers, you're not comfortable with port mapping and volume permissions, or you need the agent running without thinking about infrastructure.",[14,1212,1213],{},"AlphaSignal's recommendation for Hermes v0.13 was \"Tenacity, not Production.\" The Docker setup is stable. The agent inside it is still maturing. Known issues: macOS Python 3.13 conflicts, .venv permissions, and /goal's judge model can complete goals prematurely.",[14,1215,1216,1217,1220],{},"If you want an always-on agent without Docker, volume mounts, port mapping, and container lifecycle management, ",[103,1218,479],{"href":476,"rel":1219},[478],". Free tier with 1 agent and BYOK. $19/month per agent for Pro. 15+ messaging channels. Persistent memory. No Docker required. The agent runs. The infrastructure is ours.",[33,1222,484],{"id":483},[486,1224,1226],{"id":1225},"how-do-i-install-hermes-agent-with-docker","How do I install Hermes Agent with Docker?",[14,1228,1229,1230,1233,1234,1237,1238,1241],{},"Three commands: create a data directory (",[922,1231,1232],{},"mkdir -p ~/.hermes","), run the setup wizard (",[922,1235,1236],{},"docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup","), then start the gateway (",[922,1239,1240],{},"docker run -d --restart unless-stopped -v ~/.hermes:/opt/data -p 8642:8642 nousresearch/hermes-agent gateway run","). Total time: about 5 minutes. The setup wizard asks for your API provider and messaging channels.",[486,1243,1245],{"id":1244},"whats-the-difference-between-hermes-docker-mode-1-and-mode-2","What's the difference between Hermes Docker Mode 1 and Mode 2?",[14,1247,1248],{},"Mode 1 runs the entire Hermes agent inside a Docker container (standard VPS deployment). Mode 2 runs Hermes on your host but uses Docker as a sandboxed terminal backend for command execution. Mode 1 is for always-on agents. Mode 2 is for local development with isolated execution. Most VPS deployments use Mode 1.",[486,1250,1252],{"id":1251},"how-do-i-update-hermes-agent-in-docker-without-losing-data","How do I update Hermes Agent in Docker without losing data?",[14,1254,1255,1256,1258,1259,1261,1262,1264],{},"Pull the new image (",[922,1257,1098],{},"), stop and remove the old container (",[922,1260,1104],{},"), then start a new container with the same volume mount. Your data in ",[922,1263,1116],{}," survives because it's on the host, not inside the container. The image is stateless by design.",[486,1266,1268],{"id":1267},"how-much-does-it-cost-to-run-hermes-agent-with-docker","How much does it cost to run Hermes Agent with Docker?",[14,1270,1271],{},"The Docker image and Hermes software are free (MIT license). You need a VPS ($5-10/month for Hetzner, DigitalOcean, or Contabo with 2+ CPU cores and 8GB RAM) plus your AI model API costs (varies by provider and usage). Total: $5-50/month depending on model choice and usage volume. BetterClaw offers managed deployment at $0 (free tier) or $19/month (Pro) without Docker.",[486,1273,1275],{"id":1274},"is-hermes-agent-stable-enough-for-production-docker-deployment","Is Hermes Agent stable enough for production Docker deployment?",[14,1277,1278,1279,1281,1282,991],{},"For testing and personal use: yes, the Docker setup is reliable. For production business use: proceed with caution. AlphaSignal assessed v0.13 as \"Tenacity, not Production.\" Known issues include Python 3.13 conflicts, .venv permission bugs in Docker, and the /goal judge model making premature completion decisions. Use the official ",[922,1280,1053],{}," image and always mount ",[922,1283,990],{},{"title":522,"searchDepth":523,"depth":523,"links":1285},[1286,1287,1288,1289,1290,1291,1292],{"id":931,"depth":523,"text":932},{"id":994,"depth":523,"text":995},{"id":1024,"depth":523,"text":1025},{"id":1082,"depth":523,"text":1083},{"id":1127,"depth":523,"text":1128},{"id":1200,"depth":523,"text":1201},{"id":483,"depth":523,"text":484,"children":1293},[1294,1295,1296,1297,1298],{"id":1225,"depth":538,"text":1226},{"id":1244,"depth":538,"text":1245},{"id":1251,"depth":538,"text":1252},{"id":1267,"depth":538,"text":1268},{"id":1274,"depth":538,"text":1275},"2026-05-15","Install Hermes Agent with Docker in 5 minutes. Official image, setup wizard, gateway mode, two Docker modes explained, and the data persistence mistake to avoid.","/img/blog/hermes-agent-docker-install.jpg",{},"/blog/hermes-agent-docker-install","10 min read",{"title":902,"description":1300},"Hermes Agent Docker Install: Step-by-Step (2026)","blog/hermes-agent-docker-install",[1309,1310,1311,1312,1313,1314,1315],"Hermes Agent Docker","install Hermes Docker","Hermes Agent Docker setup","Hermes Docker guide","Hermes Agent container","Hermes Docker compose","Hermes VPS Docker","srncRXC1lvz8E0AwKv6eh-efi_eGAJqDnluR05yXwnM",{"id":1318,"title":1319,"author":1320,"body":1321,"category":543,"date":1634,"description":1635,"extension":546,"featured":547,"image":1636,"imageHeight":549,"imageWidth":549,"meta":1637,"navigation":551,"path":1638,"readingTime":1304,"seo":1639,"seoTitle":1640,"stem":1641,"tags":1642,"updatedDate":1634,"__hash__":1650},"blog/blog/hermes-agent-error-400.md","Hermes Agent Error 400: 6 Causes and How to Fix Each One (2026)",{"name":7,"role":8,"avatar":9},{"type":11,"value":1322,"toc":1618},[1323,1326,1332,1335,1338,1341,1345,1351,1354,1357,1363,1369,1375,1386,1395,1399,1402,1405,1408,1411,1417,1421,1427,1430,1441,1460,1464,1467,1474,1481,1488,1492,1498,1501,1508,1512,1515,1518,1522,1528,1534,1540,1543,1549,1552,1555,1562,1564,1568,1571,1575,1588,1592,1595,1599,1611,1615],[14,1324,1325],{},"\"Non-retryable client error (HTTP 400). Aborting.\" Six words that tell you nothing about what's wrong. Here are the six real causes from GitHub issues, ranked by how often they're the problem.",[14,1327,1328,1329,925],{},"A user filed GitHub issue #26161 three days ago. Hermes v0.13.0. Gemini provider. First message: \"hello.\" Response: ",[922,1330,1331],{},"GeminiAPIError [HTTP 400] Bad Request",[14,1333,1334],{},"The model existed. The API key worked. Curl to the endpoint returned a valid response. But Hermes returned 400 on every attempt.",[14,1336,1337],{},"The error message gave zero diagnostic information. Just \"HTTP 400\" and \"Bad Request.\" The user had to upload debug logs, agent logs, and gateway logs before anyone could help.",[14,1339,1340],{},"This is the most common runtime error in Hermes Agent. The official FAQ confirms it: \"Setup completes fine, but the first chat attempt fails with HTTP 400.\" Here are the six causes, sourced from real GitHub issues, with the exact fix for each.",[33,1342,1344],{"id":1343},"cause-1-model-name-mismatch-the-most-common-by-far","Cause 1: Model name mismatch (the most common, by far)",[14,1346,1347],{},[85,1348],{"alt":1349,"src":1350},"hermes config show output highlighting how a single wrong character in the model field — google/gemini-2-flash-preview versus google/gemini-2.5-flash-preview — causes an HTTP 400 because the model ID must match exactly what the provider expects","/img/blog/hermes-400-model-name-mismatch.jpg",[14,1352,1353],{},"From the official Hermes FAQ: \"Usually a model name mismatch. The configured model doesn't exist on your provider, or the API key doesn't have access to it.\"",[14,1355,1356],{},"The fix:",[14,1358,1359,1362],{},[922,1360,1361],{},"hermes config show | head -20"," ... Check your provider and model ID.",[14,1364,1365,1368],{},[922,1366,1367],{},"hermes model"," ... Re-run model selection to pick from the provider's valid list.",[14,1370,1371,1374],{},[922,1372,1373],{},"hermes chat -q \"hello\" --model anthropic/claude-opus-4"," ... Test with a known-good model to isolate whether the issue is model-specific.",[14,1376,1377,1378,1381,1382,1385],{},"The OpenRouter trap: Model IDs on OpenRouter look right but must match exactly. ",[922,1379,1380],{},"google/gemini-2-flash-preview"," is different from ",[922,1383,1384],{},"google/gemini-2.5-flash-preview",". One character off = 400 error. And OpenRouter returns 400 (not 404) for invalid model IDs, which is confusing.",[14,1387,1388,1389,1391,1392,1394],{},"The diagnostic shortcut: If ",[922,1390,1373],{}," works but your configured model doesn't, the problem is 100% the model ID. Fix: ",[922,1393,1367],{}," and select from the list.",[33,1396,1398],{"id":1397},"cause-2-tool-schema-incompatibility-with-provider-p1-bug","Cause 2: Tool schema incompatibility with provider (P1 bug)",[14,1400,1401],{},"GitHub issue #13927: \"When running Hermes Agent v0.10.0 with OpenRouter as the provider, all API calls return HTTP 400 regardless of the model selected.\"",[14,1403,1404],{},"What happens: Hermes sends 28 tool definitions by default. Some providers reject the tool schema format. Every model on that provider fails. The error looks like a model problem but it's a tool compatibility problem.",[14,1406,1407],{},"How to diagnose: If every model on the same provider returns 400, but the same model works on a different provider (e.g., Anthropic direct works but Anthropic via OpenRouter doesn't), the tool schema is the issue.",[14,1409,1410],{},"The fix: Update to the latest Hermes version (v0.13.0+ fixed most schema issues). If updating isn't an option, reduce tool count: temporarily disable non-essential tools in your config to narrow down which tool schema the provider rejects.",[14,1412,1016,1413,1416],{},[103,1414,1415],{"href":1195},"broader comparison of how different agent frameworks handle provider compatibility",", our comparison covers the provider integration differences.",[33,1418,1420],{"id":1419},"cause-3-dual-authentication-headers-on-gemini-a-real-bug","Cause 3: Dual authentication headers on Gemini (a real bug)",[14,1422,1423],{},[85,1424],{"alt":1425,"src":1426},"Diagram of the Gemini dual auth header bug: Hermes injects x-goog-api-key while the OpenAI SDK auto-injects Authorization Bearer, Google rejects the request with HTTP 400 \"Multiple authentication credentials received\" — fix is to use a standard Google Cloud API key starting with AIza","/img/blog/hermes-400-gemini-dual-auth-headers.jpg",[14,1428,1429],{},"GitHub issue #7893: \"HTTP 400 'Multiple authentication credentials received' when using native gemini provider.\"",[14,1431,1432,1433,1436,1437,1440],{},"What happens: Hermes's gemini provider injects an ",[922,1434,1435],{},"x-goog-api-key"," header. Simultaneously, the underlying OpenAI Python SDK injects an ",[922,1438,1439],{},"Authorization: Bearer"," header. Google's API rejects requests with both headers as ambiguous credentials.",[14,1442,1443,1444,1447,1448,1451,1452,1455,1456,1459],{},"The fix: Generate a standard Google Cloud API key (starts with ",[922,1445,1446],{},"AIza...","). Add ",[922,1449,1450],{},"GEMINI_API_KEY=your_key"," to ",[922,1453,1454],{},"~/.hermes/.env",". If using a Vertex AI key (starts with ",[922,1457,1458],{},"AQ.Ab8...","), switch to the standard key format. The Vertex key format triggers the dual-header bug.",[33,1461,1463],{"id":1462},"cause-4-missing-reasoning_content-for-kimi-models","Cause 4: Missing reasoning_content for Kimi models",[14,1465,1466],{},"GitHub issue #13848: \"When using kimi-for-coding with Hermes Agent, any session that triggers tool calls becomes permanently broken.\"",[14,1468,1469,1470,1473],{},"What happens: Kimi models with thinking enabled require a ",[922,1471,1472],{},"reasoning_content"," field in assistant messages containing tool calls. Hermes doesn't include this field. The first tool call succeeds. The corrupted message stays in conversation history. Every subsequent turn replays it and gets 400.",[14,1475,1476,1477,1480],{},"The fix: Start a new session (",[922,1478,1479],{},"hermes chat --new","). The corrupted history is session-specific. For a permanent fix, switch to a different model for Kimi tool calls, or wait for the upstream fix (the issue is tagged P1).",[14,1482,1483,1484,1487],{},"If debugging provider-specific auth headers, tool schema incompatibilities, model name formats, and session corruption from missing fields sounds like more API troubleshooting than agent building, ",[103,1485,1486],{"href":1077},"BetterClaw handles provider compatibility at the platform level",". 28+ providers. Model switching from a dropdown. No schema debugging. No auth header conflicts. Free tier with 1 agent and BYOK. $19/month per agent for Pro.",[33,1489,1491],{"id":1490},"cause-5-openrouter-model-requires-paid-plan-or-credits","Cause 5: OpenRouter model requires paid plan or credits",[14,1493,1494],{},[85,1495],{"alt":1496,"src":1497},"OpenRouter returns HTTP 400 (not 402 or 403) when your account has $0.00 credits or the model requires a paid plan — the error code is misleading, check your OpenRouter dashboard credit balance","/img/blog/hermes-400-openrouter-credits.jpg",[14,1499,1500],{},"From the official FAQ: \"A 400 from OpenRouter often means the model requires a paid plan or the model ID has a typo.\"",[14,1502,1503,1504,1507],{},"The fix: Log into your OpenRouter dashboard. Check your credit balance. Some models (Opus, GPT-5.5) require a minimum credit balance. Free-tier OpenRouter accounts can't access all models. Add credits or switch to a free model (",[922,1505,1506],{},"google/gemini-2.5-flash"," is free on OpenRouter).",[33,1509,1511],{"id":1510},"cause-6-oversized-request-payload","Cause 6: Oversized request payload",[14,1513,1514],{},"What happens: Your conversation history + system prompt + 28 tool definitions exceeds the provider's maximum request size. The provider returns 400 instead of a context-length error.",[14,1516,1517],{},"The fix: Start a new session to clear accumulated history. Or reduce tool count. Or switch to a model with a larger context window. The Deploy Hermes guide recommends: \"shrink the payload if needed, and rerun a minimal request before restoring complexity.\"",[33,1519,1521],{"id":1520},"the-diagnostic-checklist-run-this-before-anything-else","The diagnostic checklist (run this before anything else)",[14,1523,1524],{},[85,1525],{"alt":1526,"src":1527},"Five-step HTTP 400 diagnostic flow: hermes config show, test a known-good model, see whether all models fail, hermes chat --new for session corruption, and check the provider dashboard for credits and access — identifies which of the six causes you're dealing with in under 60 seconds","/img/blog/hermes-400-diagnostic-checklist.jpg",[14,1529,1530,1531,1533],{},"Step 1: ",[922,1532,1361],{}," ... What provider and model are configured?",[14,1535,1536,1537,1539],{},"Step 2: ",[922,1538,1373],{}," ... Does a known-good model work?",[14,1541,1542],{},"Step 3: Does the error happen on all models or just one? All models = provider/tool issue (Causes 2, 3, 5). One model = model-specific (Causes 1, 4, 6).",[14,1544,1545,1546,1548],{},"Step 4: ",[922,1547,1479],{}," ... Does a fresh session fix it? Yes = corrupted history (Cause 4). No = configuration issue.",[14,1550,1551],{},"Step 5: Check provider dashboard for credits, billing, and model access.",[14,1553,1554],{},"The 400 error is Hermes's most common runtime failure. The error message is always the same: \"Non-retryable client error (HTTP 400). Aborting.\" But the cause is one of six different things, and the fix depends entirely on which one you're dealing with. Diagnose first. Fix second. Don't guess.",[14,1556,1557,1558,1561],{},"If you want an agent platform where provider errors are handled at the platform level and you never see raw HTTP status codes, ",[103,1559,479],{"href":476,"rel":1560},[478],". Free tier with 1 agent and BYOK. $19/month per agent for Pro. 28+ providers. Smart error handling. The provider compatibility is ours. The agent conversations are yours.",[33,1563,484],{"id":483},[486,1565,1567],{"id":1566},"what-does-hermes-agent-error-400-mean","What does Hermes Agent Error 400 mean?",[14,1569,1570],{},"HTTP 400 in Hermes means the API provider rejected the request as malformed. The six most common causes: model name mismatch (most frequent), tool schema incompatibility, dual authentication headers on Gemini, missing reasoning_content for Kimi models, insufficient OpenRouter credits, or oversized request payload. The error message is always the same regardless of cause, so diagnosis requires checking which cause applies.",[486,1572,1574],{"id":1573},"how-do-i-fix-non-retryable-client-error-http-400-in-hermes","How do I fix \"Non-retryable client error (HTTP 400)\" in Hermes?",[14,1576,1577,1578,1581,1582,1584,1585,1587],{},"Start with ",[922,1579,1580],{},"hermes config show"," to verify your provider and model ID. Test with a known-good model: ",[922,1583,1373],{},". If the known model works, your configured model ID is wrong. Run ",[922,1586,1367],{}," to select from the valid list. If all models fail, the issue is provider-level (tool schemas, auth headers, or credits).",[486,1589,1591],{"id":1590},"why-does-hermes-return-400-on-every-model-with-openrouter","Why does Hermes return 400 on every model with OpenRouter?",[14,1593,1594],{},"Two possible causes. GitHub issue #13927 documents a tool schema incompatibility where Hermes's 28 default tools use a format OpenRouter rejects. Fix: update to v0.13.0+. Second possibility: your OpenRouter account lacks credits. OpenRouter returns 400 (not 402/403) for billing issues. Check your OpenRouter dashboard for credit balance.",[486,1596,1598],{"id":1597},"why-does-gemini-return-multiple-authentication-credentials-received-in-hermes","Why does Gemini return \"Multiple authentication credentials received\" in Hermes?",[14,1600,1601,1602,1604,1605,1607,1608,1610],{},"GitHub issue #7893. Hermes's gemini provider injects an ",[922,1603,1435],{}," header while the OpenAI SDK also injects a Bearer token. Google rejects the dual credentials. Fix: use a standard Google Cloud API key (starts with ",[922,1606,1446],{},") instead of a Vertex AI key (starts with ",[922,1609,1458],{},"). This was fixed in later versions but persists for some key types.",[486,1612,1614],{"id":1613},"does-betterclaw-have-the-same-400-error-issues","Does BetterClaw have the same 400 error issues?",[14,1616,1617],{},"No. BetterClaw handles provider compatibility at the platform level. Model switching is a dropdown selection. Provider authentication is managed. Tool schema compatibility is tested before deployment. You don't see raw HTTP status codes or debug API-level errors. Free tier with 1 agent and BYOK. $19/month per agent for Pro.",{"title":522,"searchDepth":523,"depth":523,"links":1619},[1620,1621,1622,1623,1624,1625,1626,1627],{"id":1343,"depth":523,"text":1344},{"id":1397,"depth":523,"text":1398},{"id":1419,"depth":523,"text":1420},{"id":1462,"depth":523,"text":1463},{"id":1490,"depth":523,"text":1491},{"id":1510,"depth":523,"text":1511},{"id":1520,"depth":523,"text":1521},{"id":483,"depth":523,"text":484,"children":1628},[1629,1630,1631,1632,1633],{"id":1566,"depth":538,"text":1567},{"id":1573,"depth":538,"text":1574},{"id":1590,"depth":538,"text":1591},{"id":1597,"depth":538,"text":1598},{"id":1613,"depth":538,"text":1614},"2026-05-18","Hermes Agent HTTP 400 has six different causes. Model name mismatch, tool schema, dual Gemini auth, Kimi reasoning_content, OpenRouter credits, or payload size.","/img/blog/hermes-agent-error-400.jpg",{},"/blog/hermes-agent-error-400",{"title":1319,"description":1635},"Hermes Agent Error 400: 6 Causes Fixed (2026)","blog/hermes-agent-error-400",[1643,1644,1645,1646,1647,1648,1649],"Hermes Agent error 400","Hermes 400 fix","Hermes HTTP 400 bad request","Hermes Agent troubleshooting","Hermes model mismatch","Hermes OpenRouter 400","Hermes Gemini 400","YC0oLdsWK22714JSXlpgDatqad29db3k8PY40preafo",1779278332413]