[{"data":1,"prerenderedAt":563},["ShallowReactive",2],{"navigation":3,"/reference/troubleshooting":94,"/reference/troubleshooting-surround":560},[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":91,"body":96,"description":553,"extension":554,"links":555,"meta":556,"navigation":557,"path":92,"seo":558,"stem":93,"__hash__":559},"docs/5.reference/3.troubleshooting.md",{"type":97,"value":98,"toc":538},"minimark",[99,103,108,112,135,138,142,147,150,185,192,196,199,238,242,251,255,258,279,283,289,292,304,308,326,330,359,363,366,432,439,443,446,509,513,523,534],[100,101,91],"h1",{"id":102},"troubleshooting",[104,105,107],"h2",{"id":106},"run-diagnostics-first","Run diagnostics first",[109,110,111],"p",{},"When something isn't working, start here:",[113,114,119],"pre",{"className":115,"code":116,"language":117,"meta":118,"style":118},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","babyclaw doctor\n","bash","",[120,121,122],"code",{"__ignoreMap":118},[123,124,127,131],"span",{"class":125,"line":126},"line",1,[123,128,130],{"class":129},"sBMFI","babyclaw",[123,132,134],{"class":133},"sfazB"," doctor\n",[109,136,137],{},"This checks your config, database, Telegram connection, and AI provider setup. It'll tell you what's wrong.",[104,139,141],{"id":140},"common-issues","Common issues",[143,144,146],"h3",{"id":145},"config-validation-failed","\"Config validation failed\"",[109,148,149],{},"The gateway won't start if the config file has errors. Common causes:",[151,152,153,161,167],"ul",{},[154,155,156,160],"li",{},[157,158,159],"strong",{},"Unknown keys"," -- BabyClaw uses strict validation. Typos in key names will be rejected.",[154,162,163,166],{},[157,164,165],{},"Wrong types"," -- e.g., a string where a number is expected.",[154,168,169,172,173,176,177,180,181,184],{},[157,170,171],{},"Missing required fields"," -- ",[120,174,175],{},"version",", ",[120,178,179],{},"ai.providers",", and ",[120,182,183],{},"ai.models.chat"," are all required.",[109,186,187,188,191],{},"Run ",[120,189,190],{},"babyclaw config validate"," to see the exact errors.",[143,193,195],{"id":194},"bot-not-responding-on-telegram","Bot not responding on Telegram",[109,197,198],{},"Check these in order:",[200,201,202,216,226,232],"ol",{},[154,203,204,207,208,211,212,215],{},[157,205,206],{},"Is the gateway running?"," Run ",[120,209,210],{},"babyclaw service status"," or ",[120,213,214],{},"babyclaw gateway status",".",[154,217,218,221,222,225],{},[157,219,220],{},"Is the bot token correct?"," Make sure ",[120,223,224],{},"channels.telegram.botToken"," matches what BotFather gave you.",[154,227,228,231],{},[157,229,230],{},"Did you message the right bot?"," Search for your bot's username in Telegram.",[154,233,234,237],{},[157,235,236],{},"Check the logs."," If the gateway is running but the bot isn't responding, look at the log output for errors. The default log output is stdout.",[143,239,241],{"id":240},"at-least-one-provider-must-be-configured","\"At least one provider must be configured\"",[109,243,244,245,247,248,215],{},"You need at least one entry in ",[120,246,179],{}," with a valid API key. See ",[249,250,32],"a",{"href":33},[143,252,254],{"id":253},"model-errors-api-key-issues","Model errors / API key issues",[109,256,257],{},"If the agent starts but fails on the first message:",[151,259,260,271,276],{},[154,261,262,263,266,267,270],{},"Check that the model string matches the format ",[120,264,265],{},"provider:modelId"," (e.g., ",[120,268,269],{},"anthropic:claude-sonnet-4-20250514",")",[154,272,273,274],{},"Check that the provider name in the model string matches a key in ",[120,275,179],{},[154,277,278],{},"Verify your API key is valid and has credit/quota",[143,280,282],{"id":281},"database-errors","Database errors",[109,284,285,286,215],{},"BabyClaw uses SQLite with Drizzle. The database file is created automatically at ",[120,287,288],{},"\u003CworkspaceRoot>/.data/babyclaw.db",[109,290,291],{},"If you see database errors:",[151,293,294,297],{},[154,295,296],{},"Make sure the directory exists and is writable",[154,298,299,300,303],{},"If the database is corrupted, you can delete the ",[120,301,302],{},".db"," file and let BabyClaw recreate it (you'll lose session history and schedule data)",[143,305,307],{"id":306},"schedules-not-firing","Schedules not firing",[151,309,310,313,320],{},[154,311,312],{},"Check that the gateway is running continuously (schedules only fire while the gateway is up)",[154,314,315,316,319],{},"Verify the timezone in ",[120,317,318],{},"scheduler.timezone"," is correct",[154,321,322,323,325],{},"Check ",[120,324,214],{}," to see if the scheduler is active",[143,327,329],{"id":328},"heartbeat-not-running","Heartbeat not running",[151,331,332,343,349,352],{},[154,333,334,335,338,339,342],{},"Make sure ",[120,336,337],{},"heartbeat.enabled"," is ",[120,340,341],{},"true"," in the config",[154,344,322,345,348],{},[120,346,347],{},"activeHours"," -- heartbeats are skipped outside the active window",[154,350,351],{},"The minimum interval is 5 minutes",[154,353,354,355,358],{},"Use ",[120,356,357],{},"/heartbeat"," in Telegram to check the status",[104,360,362],{"id":361},"debug-logging","Debug logging",[109,364,365],{},"For more detail on what's happening, set the log level to debug:",[113,367,371],{"className":368,"code":369,"language":370,"meta":118,"style":118},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"logging\": {\n    \"level\": \"debug\"\n  }\n}\n","json",[120,372,373,379,398,420,426],{"__ignoreMap":118},[123,374,375],{"class":125,"line":126},[123,376,378],{"class":377},"sMK4o","{\n",[123,380,382,385,389,392,395],{"class":125,"line":381},2,[123,383,384],{"class":377},"  \"",[123,386,388],{"class":387},"spNyl","logging",[123,390,391],{"class":377},"\"",[123,393,394],{"class":377},":",[123,396,397],{"class":377}," {\n",[123,399,401,404,407,409,411,414,417],{"class":125,"line":400},3,[123,402,403],{"class":377},"    \"",[123,405,406],{"class":129},"level",[123,408,391],{"class":377},[123,410,394],{"class":377},[123,412,413],{"class":377}," \"",[123,415,416],{"class":133},"debug",[123,418,419],{"class":377},"\"\n",[123,421,423],{"class":125,"line":422},4,[123,424,425],{"class":377},"  }\n",[123,427,429],{"class":125,"line":428},5,[123,430,431],{"class":377},"}\n",[109,433,434,435,438],{},"This produces a lot of output but can help track down issues. Set it back to ",[120,436,437],{},"\"info\""," when you're done.",[104,440,442],{"id":441},"redacting-sensitive-data-from-logs","Redacting sensitive data from logs",[109,444,445],{},"If you're sharing logs for debugging, you can redact specific fields:",[113,447,449],{"className":368,"code":448,"language":370,"meta":118,"style":118},"{\n  \"logging\": {\n    \"redact\": [\"apiKey\", \"botToken\"]\n  }\n}\n",[120,450,451,455,467,501,505],{"__ignoreMap":118},[123,452,453],{"class":125,"line":126},[123,454,378],{"class":377},[123,456,457,459,461,463,465],{"class":125,"line":381},[123,458,384],{"class":377},[123,460,388],{"class":387},[123,462,391],{"class":377},[123,464,394],{"class":377},[123,466,397],{"class":377},[123,468,469,471,474,476,478,481,483,486,488,491,493,496,498],{"class":125,"line":400},[123,470,403],{"class":377},[123,472,473],{"class":129},"redact",[123,475,391],{"class":377},[123,477,394],{"class":377},[123,479,480],{"class":377}," [",[123,482,391],{"class":377},[123,484,485],{"class":133},"apiKey",[123,487,391],{"class":377},[123,489,490],{"class":377},",",[123,492,413],{"class":377},[123,494,495],{"class":133},"botToken",[123,497,391],{"class":377},[123,499,500],{"class":377},"]\n",[123,502,503],{"class":125,"line":422},[123,504,425],{"class":377},[123,506,507],{"class":125,"line":428},[123,508,431],{"class":377},[104,510,512],{"id":511},"getting-help","Getting help",[109,514,515,516,522],{},"BabyClaw is a small project. If you're stuck, check the ",[249,517,521],{"href":518,"rel":519},"https://github.com/babyclaw/babyclaw/issues",[520],"nofollow","GitHub issues"," or open a new one with:",[151,524,525,528,531],{},[154,526,527],{},"Your config (with API keys removed)",[154,529,530],{},"The error message or log output",[154,532,533],{},"What you expected to happen",[535,536,537],"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 .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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":118,"searchDepth":126,"depth":381,"links":539},[540,541,550,551,552],{"id":106,"depth":381,"text":107},{"id":140,"depth":381,"text":141,"children":542},[543,544,545,546,547,548,549],{"id":145,"depth":400,"text":146},{"id":194,"depth":400,"text":195},{"id":240,"depth":400,"text":241},{"id":253,"depth":400,"text":254},{"id":281,"depth":400,"text":282},{"id":306,"depth":400,"text":307},{"id":328,"depth":400,"text":329},{"id":361,"depth":381,"text":362},{"id":441,"depth":381,"text":442},{"id":511,"depth":381,"text":512},"Common issues and how to fix them.","md",null,{},true,{"title":91,"description":553},"Kw0eK0wvVf78swJp4Z8qi0Ckp0iAWyL9UVKLg-UNiTA",[561,555],{"title":87,"path":88,"stem":89,"description":562,"children":-1},"How sessions work -- identity, history, reply chains, and configuration.",1771846894211]