[{"data":1,"prerenderedAt":714},["ShallowReactive",2],{"navigation":3,"/getting-started/installation":94,"/getting-started/installation-surround":709},[4,22,39,68,81],{"title":5,"path":6,"stem":7,"children":8,"page":21},"Getting Started","/getting-started","1.getting-started",[9,13,17],{"title":10,"path":11,"stem":12},"Introduction","/getting-started/introduction","1.getting-started/1.introduction",{"title":14,"path":15,"stem":16},"Installation","/getting-started/installation","1.getting-started/2.installation",{"title":18,"path":19,"stem":20},"Workspace","/getting-started/workspace","1.getting-started/3.workspace",false,{"title":23,"path":24,"stem":25,"children":26,"page":21},"Configuration","/configuration","2.configuration",[27,31,35],{"title":28,"path":29,"stem":30},"Overview","/configuration/overview","2.configuration/1.overview",{"title":32,"path":33,"stem":34},"AI Providers","/configuration/ai-providers","2.configuration/2.ai-providers",{"title":36,"path":37,"stem":38},"Configuration Reference","/configuration/reference","2.configuration/3.reference",{"title":40,"path":41,"stem":42,"children":43,"page":21},"Features","/features","3.features",[44,48,52,56,60,64],{"title":45,"path":46,"stem":47},"Telegram","/features/telegram","3.features/1.telegram",{"title":49,"path":50,"stem":51},"Tools","/features/tools","3.features/2.tools",{"title":53,"path":54,"stem":55},"Scheduling","/features/scheduling","3.features/3.scheduling",{"title":57,"path":58,"stem":59},"Heartbeat","/features/heartbeat","3.features/4.heartbeat",{"title":61,"path":62,"stem":63},"Memory","/features/memory","3.features/5.memory",{"title":65,"path":66,"stem":67},"Skills","/features/skills","3.features/6.skills",{"title":69,"path":70,"stem":71,"children":72,"page":21},"Cli","/cli","4.cli",[73,77],{"title":74,"path":75,"stem":76},"CLI Commands","/cli/commands","4.cli/1.commands",{"title":78,"path":79,"stem":80},"Running as a Service","/cli/service-management","4.cli/2.service-management",{"title":82,"path":83,"stem":84,"children":85,"page":21},"Reference","/reference","5.reference",[86,90],{"title":87,"path":88,"stem":89},"Sessions","/reference/sessions","5.reference/1.sessions",{"title":91,"path":92,"stem":93},"Troubleshooting","/reference/troubleshooting","5.reference/3.troubleshooting",{"id":95,"title":14,"body":96,"description":702,"extension":703,"links":704,"meta":705,"navigation":706,"path":15,"seo":707,"stem":16,"__hash__":708},"docs/1.getting-started/2.installation.md",{"type":97,"value":98,"toc":689},"minimark",[99,103,107,112,115,148,151,171,180,184,187,192,214,218,237,240,281,285,311,314,318,336,343,360,363,592,598,602,619,622,635,639,642,646,660,663,667,685],[100,101,14],"h1",{"id":102},"installation",[104,105,106],"p",{},"This guide takes you from zero to a running BabyClaw instance with a working Telegram bot.",[108,109,111],"h2",{"id":110},"quick-install-recommended","Quick install (recommended)",[104,113,114],{},"The fastest way to get started — a single command that checks your environment, installs BabyClaw, and walks you through the setup wizard:",[116,117,122],"pre",{"className":118,"code":119,"language":120,"meta":121,"style":121},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -fsSL https://babyclaw.org/install.sh | bash\n","bash","",[123,124,125],"code",{"__ignoreMap":121},[126,127,130,134,138,141,145],"span",{"class":128,"line":129},"line",1,[126,131,133],{"class":132},"sBMFI","curl",[126,135,137],{"class":136},"sfazB"," -fsSL",[126,139,140],{"class":136}," https://babyclaw.org/install.sh",[126,142,144],{"class":143},"sMK4o"," |",[126,146,147],{"class":132}," bash\n",[104,149,150],{},"The installer will:",[152,153,154,158,165,168],"ul",{},[155,156,157],"li",{},"Verify Node.js >= 20 is present (and help you install it if not)",[155,159,160,161,164],{},"Install the ",[123,162,163],{},"babyclaw"," CLI globally via npm",[155,166,167],{},"Launch the interactive setup wizard",[155,169,170],{},"Run diagnostics to confirm everything works",[104,172,173,174,179],{},"Once it finishes you can skip ahead to ",[175,176,178],"a",{"href":177},"#5-send-your-first-message","Send your first message",".",[108,181,183],{"id":182},"manual-install","Manual install",[104,185,186],{},"If you prefer to install manually, or want to develop on BabyClaw itself, follow the steps below.",[188,189,191],"h3",{"id":190},"prerequisites","Prerequisites",[152,193,194,204],{},[155,195,196,200,201],{},[197,198,199],"strong",{},"Node.js 20"," or newer -- check with ",[123,202,203],{},"node --version",[155,205,206,209,210,213],{},[197,207,208],{},"pnpm"," -- install with ",[123,211,212],{},"npm install -g pnpm"," if you don't have it",[188,215,217],{"id":216},"_1-install-via-npm","1. Install via npm",[116,219,221],{"className":118,"code":220,"language":120,"meta":121,"style":121},"npm install -g babyclaw\n",[123,222,223],{"__ignoreMap":121},[126,224,225,228,231,234],{"class":128,"line":129},[126,226,227],{"class":132},"npm",[126,229,230],{"class":136}," install",[126,232,233],{"class":136}," -g",[126,235,236],{"class":136}," babyclaw\n",[104,238,239],{},"Or, to build from source:",[116,241,243],{"className":118,"code":242,"language":120,"meta":121,"style":121},"git clone https://github.com/babyclaw/babyclaw.git\ncd babyclaw\npnpm install\npnpm build\n",[123,244,245,256,265,273],{"__ignoreMap":121},[126,246,247,250,253],{"class":128,"line":129},[126,248,249],{"class":132},"git",[126,251,252],{"class":136}," clone",[126,254,255],{"class":136}," https://github.com/babyclaw/babyclaw.git\n",[126,257,259,263],{"class":128,"line":258},2,[126,260,262],{"class":261},"s2Zo4","cd",[126,264,236],{"class":136},[126,266,268,270],{"class":128,"line":267},3,[126,269,208],{"class":132},[126,271,272],{"class":136}," install\n",[126,274,276,278],{"class":128,"line":275},4,[126,277,208],{"class":132},[126,279,280],{"class":136}," build\n",[108,282,284],{"id":283},"_2-create-a-telegram-bot","2. Create a Telegram bot",[286,287,288,297,304],"ol",{},[155,289,290,291],{},"Open Telegram and message ",[175,292,296],{"href":293,"rel":294},"https://t.me/BotFather",[295],"nofollow","@BotFather",[155,298,299,300,303],{},"Send ",[123,301,302],{},"/newbot"," and follow the prompts",[155,305,306,307,310],{},"Copy the bot token (looks like ",[123,308,309],{},"123456789:ABCdefGHIjklMNOpqrsTUVwxyz",")",[104,312,313],{},"You'll need this token in the next step.",[108,315,317],{"id":316},"_3-run-the-setup-wizard","3. Run the setup wizard",[116,319,321],{"className":118,"code":320,"language":120,"meta":121,"style":121},"pnpm babyclaw config init\n",[123,322,323],{"__ignoreMap":121},[126,324,325,327,330,333],{"class":128,"line":129},[126,326,208],{"class":132},[126,328,329],{"class":136}," babyclaw",[126,331,332],{"class":136}," config",[126,334,335],{"class":136}," init\n",[104,337,338,339,342],{},"This creates a config file at ",[123,340,341],{},"~/.config/babyclaw/config.json"," with placeholder values. Next, configure your AI provider interactively:",[116,344,346],{"className":118,"code":345,"language":120,"meta":121,"style":121},"pnpm babyclaw model configure\n",[123,347,348],{"__ignoreMap":121},[126,349,350,352,354,357],{"class":128,"line":129},[126,351,208],{"class":132},[126,353,329],{"class":136},[126,355,356],{"class":136}," model",[126,358,359],{"class":136}," configure\n",[104,361,362],{},"Or edit the config file directly -- the minimum you need is a Telegram bot token and one AI provider:",[116,364,368],{"className":365,"code":366,"language":367,"meta":121,"style":121},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"version\": 1,\n  \"channels\": {\n    \"telegram\": {\n      \"botToken\": \"123456789:ABCdefGHIjklMNOpqrsTUVwxyz\"\n    }\n  },\n  \"ai\": {\n    \"providers\": {\n      \"anthropic\": { \"apiKey\": \"sk-ant-...\" }\n    },\n    \"models\": {\n      \"chat\": \"anthropic:claude-sonnet-4-20250514\"\n    },\n    \"aliases\": {}\n  }\n}\n","json",[123,369,370,375,397,411,425,446,452,458,472,486,521,527,541,560,565,580,586],{"__ignoreMap":121},[126,371,372],{"class":128,"line":129},[126,373,374],{"class":143},"{\n",[126,376,377,380,384,387,390,394],{"class":128,"line":258},[126,378,379],{"class":143},"  \"",[126,381,383],{"class":382},"spNyl","version",[126,385,386],{"class":143},"\"",[126,388,389],{"class":143},":",[126,391,393],{"class":392},"sbssI"," 1",[126,395,396],{"class":143},",\n",[126,398,399,401,404,406,408],{"class":128,"line":267},[126,400,379],{"class":143},[126,402,403],{"class":382},"channels",[126,405,386],{"class":143},[126,407,389],{"class":143},[126,409,410],{"class":143}," {\n",[126,412,413,416,419,421,423],{"class":128,"line":275},[126,414,415],{"class":143},"    \"",[126,417,418],{"class":132},"telegram",[126,420,386],{"class":143},[126,422,389],{"class":143},[126,424,410],{"class":143},[126,426,428,431,434,436,438,441,443],{"class":128,"line":427},5,[126,429,430],{"class":143},"      \"",[126,432,433],{"class":392},"botToken",[126,435,386],{"class":143},[126,437,389],{"class":143},[126,439,440],{"class":143}," \"",[126,442,309],{"class":136},[126,444,445],{"class":143},"\"\n",[126,447,449],{"class":128,"line":448},6,[126,450,451],{"class":143},"    }\n",[126,453,455],{"class":128,"line":454},7,[126,456,457],{"class":143},"  },\n",[126,459,461,463,466,468,470],{"class":128,"line":460},8,[126,462,379],{"class":143},[126,464,465],{"class":382},"ai",[126,467,386],{"class":143},[126,469,389],{"class":143},[126,471,410],{"class":143},[126,473,475,477,480,482,484],{"class":128,"line":474},9,[126,476,415],{"class":143},[126,478,479],{"class":132},"providers",[126,481,386],{"class":143},[126,483,389],{"class":143},[126,485,410],{"class":143},[126,487,489,491,494,496,498,501,503,507,509,511,513,516,518],{"class":128,"line":488},10,[126,490,430],{"class":143},[126,492,493],{"class":392},"anthropic",[126,495,386],{"class":143},[126,497,389],{"class":143},[126,499,500],{"class":143}," {",[126,502,440],{"class":143},[126,504,506],{"class":505},"swJcz","apiKey",[126,508,386],{"class":143},[126,510,389],{"class":143},[126,512,440],{"class":143},[126,514,515],{"class":136},"sk-ant-...",[126,517,386],{"class":143},[126,519,520],{"class":143}," }\n",[126,522,524],{"class":128,"line":523},11,[126,525,526],{"class":143},"    },\n",[126,528,530,532,535,537,539],{"class":128,"line":529},12,[126,531,415],{"class":143},[126,533,534],{"class":132},"models",[126,536,386],{"class":143},[126,538,389],{"class":143},[126,540,410],{"class":143},[126,542,544,546,549,551,553,555,558],{"class":128,"line":543},13,[126,545,430],{"class":143},[126,547,548],{"class":392},"chat",[126,550,386],{"class":143},[126,552,389],{"class":143},[126,554,440],{"class":143},[126,556,557],{"class":136},"anthropic:claude-sonnet-4-20250514",[126,559,445],{"class":143},[126,561,563],{"class":128,"line":562},14,[126,564,526],{"class":143},[126,566,568,570,573,575,577],{"class":128,"line":567},15,[126,569,415],{"class":143},[126,571,572],{"class":132},"aliases",[126,574,386],{"class":143},[126,576,389],{"class":143},[126,578,579],{"class":143}," {}\n",[126,581,583],{"class":128,"line":582},16,[126,584,585],{"class":143},"  }\n",[126,587,589],{"class":128,"line":588},17,[126,590,591],{"class":143},"}\n",[104,593,594,595,597],{},"See ",[175,596,32],{"href":33}," for how to configure other providers.",[108,599,601],{"id":600},"_4-start-the-gateway","4. Start the gateway",[116,603,605],{"className":118,"code":604,"language":120,"meta":121,"style":121},"pnpm babyclaw service start\n",[123,606,607],{"__ignoreMap":121},[126,608,609,611,613,616],{"class":128,"line":129},[126,610,208],{"class":132},[126,612,329],{"class":136},[126,614,615],{"class":136}," service",[126,617,618],{"class":136}," start\n",[104,620,621],{},"Or run it directly in the foreground:",[116,623,625],{"className":118,"code":624,"language":120,"meta":121,"style":121},"node packages/gateway/dist/main.js\n",[123,626,627],{"__ignoreMap":121},[126,628,629,632],{"class":128,"line":129},[126,630,631],{"class":132},"node",[126,633,634],{"class":136}," packages/gateway/dist/main.js\n",[108,636,638],{"id":637},"_5-send-your-first-message","5. Send your first message",[104,640,641],{},"Open Telegram and message your bot. On the first conversation, the agent will go through a bootstrap process -- it'll ask your name, pick its own identity, and set up the workspace files. This is normal and only happens once.",[108,643,645],{"id":644},"_6-verify-everything-works","6. Verify everything works",[116,647,649],{"className":118,"code":648,"language":120,"meta":121,"style":121},"pnpm babyclaw doctor\n",[123,650,651],{"__ignoreMap":121},[126,652,653,655,657],{"class":128,"line":129},[126,654,208],{"class":132},[126,656,329],{"class":136},[126,658,659],{"class":136}," doctor\n",[104,661,662],{},"This runs diagnostics and checks that your config, database, and Telegram connection are healthy.",[108,664,666],{"id":665},"next-steps","Next steps",[152,668,669,674,680],{},[155,670,671,673],{},[175,672,18],{"href":19}," -- learn about the workspace files and how to customize your agent",[155,675,676,679],{},[175,677,678],{"href":29},"Configuration overview"," -- understand the full config file",[155,681,682,684],{},[175,683,45],{"href":46}," -- more on how the Telegram integration works",[686,687,688],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":121,"searchDepth":129,"depth":258,"links":690},[691,692,696,697,698,699,700,701],{"id":110,"depth":258,"text":111},{"id":182,"depth":258,"text":183,"children":693},[694,695],{"id":190,"depth":267,"text":191},{"id":216,"depth":267,"text":217},{"id":283,"depth":258,"text":284},{"id":316,"depth":258,"text":317},{"id":600,"depth":258,"text":601},{"id":637,"depth":258,"text":638},{"id":644,"depth":258,"text":645},{"id":665,"depth":258,"text":666},"Install BabyClaw and send your first message.","md",null,{},true,{"title":14,"description":702},"nL7sbtylIaK28CNW8-hsrdJTtCCFdLrSSfp3_wCZ1YM",[710,712],{"title":10,"path":11,"stem":12,"description":711,"children":-1},"What BabyClaw is, why it exists, and what you need to get started.",{"title":18,"path":19,"stem":20,"description":713,"children":-1},"The workspace is your agent's home -- personality files, memory, and skills all live here.",1771846894210]