[{"data":1,"prerenderedAt":799},["ShallowReactive",2],{"navigation":3,"/models-and-skills/local-models":261,"/models-and-skills/local-models-surround":794},[4,22,50,83,125,161,194,205,231],{"title":5,"path":6,"stem":7,"children":8,"icon":16},"Getting Started","/getting-started","1.getting-started/1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-ph-house",{"title":13,"path":14,"stem":15,"icon":16},"Quickstart","/getting-started/quickstart","1.getting-started/2.quickstart","i-ph-rocket",{"title":18,"path":19,"stem":20,"icon":21},"Plans","/getting-started/plans","1.getting-started/3.plans","i-ph-credit-card",{"title":23,"path":24,"stem":25,"children":26,"icon":29},"Agents","/agents","2.agents/1.index",[27,30,35,40,45],{"title":28,"path":24,"stem":25,"icon":29},"Overview","i-ph-robot",{"title":31,"path":32,"stem":33,"icon":34},"Creating an agent","/agents/creating-an-agent","2.agents/2.creating-an-agent","i-ph-plus",{"title":36,"path":37,"stem":38,"icon":39},"Agent settings","/agents/settings","2.agents/3.settings","i-ph-gear",{"title":41,"path":42,"stem":43,"icon":44},"Memory","/agents/memory","2.agents/4.memory","i-ph-database",{"title":46,"path":47,"stem":48,"icon":49},"Residential proxy","/agents/proxy","2.agents/5.proxy","i-ph-globe-hemisphere-west",{"title":51,"path":52,"stem":53,"children":54,"icon":57},"Chats & Tasks","/chats-and-tasks","3.chats-and-tasks/1.index",[55,58,63,68,73,78],{"title":56,"path":52,"stem":53,"icon":57},"Chats","i-ph-chats-circle",{"title":59,"path":60,"stem":61,"icon":62},"Sharing chats","/chats-and-tasks/sharing-chats","3.chats-and-tasks/2.sharing-chats","i-ph-share-network",{"title":64,"path":65,"stem":66,"icon":67},"Tasks","/chats-and-tasks/tasks","3.chats-and-tasks/3.tasks","i-ph-list-checks",{"title":69,"path":70,"stem":71,"icon":72},"Recurring tasks","/chats-and-tasks/recurring-tasks","3.chats-and-tasks/4.recurring-tasks","i-ph-repeat",{"title":74,"path":75,"stem":76,"icon":77},"Results & deliverables","/chats-and-tasks/results-and-deliverables","3.chats-and-tasks/5.results-and-deliverables","i-ph-package",{"title":79,"path":80,"stem":81,"icon":82},"Save a chat as a skill","/chats-and-tasks/save-chat-as-skill","3.chats-and-tasks/6.save-chat-as-skill","i-ph-sparkle",{"title":84,"path":85,"stem":86,"children":87,"icon":90},"Models & Skills","/models-and-skills","4.models-and-skills/1.index",[88,91,96,101,105,110,115,120],{"title":89,"path":85,"stem":86,"icon":90},"LLM configuration","i-ph-cpu",{"title":92,"path":93,"stem":94,"icon":95},"Providers & models","/models-and-skills/providers","4.models-and-skills/2.providers","i-ph-stack",{"title":97,"path":98,"stem":99,"icon":100},"Bring your own key","/models-and-skills/byok","4.models-and-skills/3.byok","i-ph-key",{"title":102,"path":103,"stem":104,"icon":29},"ChatGPT subscription","/models-and-skills/chatgpt-subscription","4.models-and-skills/4.chatgpt-subscription",{"title":106,"path":107,"stem":108,"icon":109},"Skills","/models-and-skills/skills","4.models-and-skills/5.skills","i-ph-puzzle-piece",{"title":111,"path":112,"stem":113,"icon":114},"Installing skills","/models-and-skills/installing-skills","4.models-and-skills/6.installing-skills","i-ph-download-simple",{"title":116,"path":117,"stem":118,"icon":119},"Custom skills","/models-and-skills/custom-skills","4.models-and-skills/7.custom-skills","i-ph-code",{"title":121,"path":122,"stem":123,"icon":124},"Local models","/models-and-skills/local-models","4.models-and-skills/8.local-models","i-ph-desktop-tower",{"title":126,"path":127,"stem":128,"children":129,"icon":131},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[130,132,137,142,147,152,156],{"title":28,"path":127,"stem":128,"icon":131},"i-ph-plug",{"title":133,"path":134,"stem":135,"icon":136},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":138,"path":139,"stem":140,"icon":141},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":143,"path":144,"stem":145,"icon":146},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":148,"path":149,"stem":150,"icon":151},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":153,"path":154,"stem":155,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":157,"path":158,"stem":159,"icon":160},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":162,"path":163,"stem":164,"children":165,"icon":193},"Account & Team","/account-and-team","6.account-and-team/1.index",[166,169,174,179,184,188],{"title":167,"path":163,"stem":164,"icon":168},"Signing in","i-ph-sign-in",{"title":170,"path":171,"stem":172,"icon":173},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":175,"path":176,"stem":177,"icon":178},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":180,"path":181,"stem":182,"icon":183},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":185,"path":186,"stem":187,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":189,"path":190,"stem":191,"icon":192},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":195,"path":196,"stem":197,"children":198,"icon":200},"Apps","/apps","7.apps/1.index",[199,201],{"title":195,"path":196,"stem":197,"icon":200},"i-ph-squares-four",{"title":202,"path":203,"stem":204,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"title":206,"path":207,"stem":208,"children":209,"icon":211},"Workflows","/workflows","8.workflows/1.index",[210,212,216,221,226],{"title":28,"path":207,"stem":208,"icon":211},"i-ph-flow-arrow",{"title":213,"path":214,"stem":215,"icon":82},"Create a workflow","/workflows/creating-a-workflow","8.workflows/2.creating-a-workflow",{"title":217,"path":218,"stem":219,"icon":220},"Edit sections","/workflows/editing-sections","8.workflows/3.editing-sections","i-ph-pencil-simple",{"title":222,"path":223,"stem":224,"icon":225},"Run and schedule","/workflows/running-and-scheduling","8.workflows/4.running-and-scheduling","i-ph-clock",{"title":227,"path":228,"stem":229,"icon":230},"Workflow directory","/workflows/directory","8.workflows/5.directory","i-ph-compass",{"title":232,"path":233,"stem":234,"children":235,"icon":119},"Agent API","/agent-api","9.agent-api/1.index",[236,237,241,246,251,256],{"title":28,"path":233,"stem":234,"icon":119},{"title":13,"path":238,"stem":239,"icon":240},"/agent-api/quickstart","9.agent-api/2.quickstart","i-ph-rocket-launch",{"title":242,"path":243,"stem":244,"icon":245},"Authentication","/agent-api/authentication","9.agent-api/3.authentication","i-ph-lock-key",{"title":247,"path":248,"stem":249,"icon":250},"Endpoints","/agent-api/endpoints","9.agent-api/4.endpoints","i-ph-list-bullets",{"title":252,"path":253,"stem":254,"icon":255},"Streaming","/agent-api/streaming","9.agent-api/5.streaming","i-ph-broadcast",{"title":257,"path":258,"stem":259,"icon":260},"Errors","/agent-api/errors","9.agent-api/6.errors","i-ph-warning-circle",{"id":262,"title":121,"body":263,"description":787,"extension":788,"links":789,"meta":790,"navigation":791,"path":122,"seo":792,"stem":123,"__hash__":793},"docs/4.models-and-skills/8.local-models.md",{"type":264,"value":265,"toc":773},"minimark",[266,270,294,297,303,308,359,363,390,405,409,412,476,490,494,529,542,545,549,556,559,563,582,585,589,634,637,641,647,666,673,677],[267,268,121],"h1",{"id":269},"local-models",[271,272,273,277,278,281,282,285,286,289,290,293],"p",{},[274,275,276],"strong",{},"BetterClaw Desktop"," connects your computer to BetterClaw as a ",[274,279,280],{},"device"," and shares models from\na local AI engine — ",[274,283,284],{},"Ollama",", ",[274,287,288],{},"LM Studio",", or ",[274,291,292],{},"llama.cpp"," — with your agents. The agent keeps\nrunning in BetterClaw as usual; only its model calls are answered by your computer.",[271,295,296],{},"The app dials out to BetterClaw — it never opens a port to the internet, so there are no tunnels,\npublic addresses, or API keys to set up.",[298,299,300],"note",{},[271,301,302],{},"Prompts and answers pass through BetterClaw on their way to and from your computer, but they are\nnot stored — not on your computer, in the app's logs, or by BetterClaw. Only request details\n(model, result, tokens, and duration) are kept.",[304,305,307],"h2",{"id":306},"what-you-need","What you need",[309,310,311,333,349,352],"ul",{},[312,313,314,316,317,320,321,324,325,328,329,332],"li",{},[274,315,276],{}," on the computer that will serve the model. It's currently built for\n",[274,318,319],{},"Macs with Apple silicon",". Find the download from the ",[274,322,323],{},"Download BetterClaw Desktop"," link in\nthe ",[274,326,327],{},"Local LLM Models"," card on an agent's ",[274,330,331],{},"Model"," tab.",[312,334,335,336,285,338,340,341,343,344,348],{},"A local engine, installed and running: ",[274,337,284],{},[274,339,288],{}," (with its local server turned\non), or ",[274,342,292],{}," (",[345,346,347],"code",{},"llama-server","). Any other OpenAI-compatible server on the same computer\nalso works as a custom engine address. BetterClaw Desktop finds engines but never installs or\nupdates them.",[312,350,351],{},"At least one model downloaded in that engine.",[312,353,354,355,358],{},"The computer must be ",[274,356,357],{},"awake, online, and running BetterClaw Desktop"," whenever the agent works.",[304,360,362],{"id":361},"connect-your-computer","Connect your computer",[364,365,366,373,383],"ol",{},[312,367,368,369,372],{},"Open BetterClaw Desktop and click ",[274,370,371],{},"Sign in with BetterClaw",".",[312,374,375,376,379,380,372],{},"Your browser opens the ",[274,377,378],{},"Connect BetterClaw Desktop"," page. Check the computer's name and click\n",[274,381,382],{},"Connect this computer",[312,384,385,386,389],{},"The app picks up the sign-in on its own. If it doesn't, copy the code shown on the page, paste\nit into the app, and click ",[274,387,388],{},"Continue"," — the code works once and expires in two minutes.",[271,391,392,393,396,397,400,401,404],{},"Once connected, the app's sidebar shows ",[274,394,395],{},"Connected",", and the computer appears under\n",[274,398,399],{},"Your computers"," on your profile (open the menu under your name at the bottom of the left rail\nand choose ",[274,402,403],{},"Your profile",").",[304,406,408],{"id":407},"choose-an-engine-and-share-models","Choose an engine and share models",[271,410,411],{},"In BetterClaw Desktop:",[364,413,414,450,465],{},[312,415,416,417,420,421,285,424,289,427,430,431,434,435,438,439,442,443,446,447,404],{},"Open ",[274,418,419],{},"Engines",". Each engine shows ",[274,422,423],{},"Running",[274,425,426],{},"Installed · not running",[274,428,429],{},"Not\ninstalled"," (with a ",[274,432,433],{},"Download"," button). Start your engine and click ",[274,436,437],{},"Check again"," — no\nrestart needed. If more than one is running, click ",[274,440,441],{},"Use"," on the one you want. For another\nOpenAI-compatible server, open ",[274,444,445],{},"Advanced: custom engine address"," and enter its address (for\nexample ",[345,448,449],{},"http://127.0.0.1:8000",[312,451,416,452,455,456,285,459,289,462,372],{},[274,453,454],{},"Models"," and turn on the models your agents may use. Only models you share are visible\nto BetterClaw. Each model shows its context window and how well it's likely to handle tools —\n",[274,457,458],{},"Good at tools",[274,460,461],{},"Weak at tools",[274,463,464],{},"Tool use unknown",[312,466,467,468,471,472,475],{},"Make sure ",[274,469,470],{},"Local Inference"," is on under ",[274,473,474],{},"Capabilities"," (it is by default).",[477,478,479],"tip",{},[271,480,481,482,485,486,489],{},"Agents rely on tool calling and a large prompt. Prefer a ",[274,483,484],{},"7B+ model with tool support"," and a\ncontext window of ",[274,487,488],{},"about 16k tokens or more"," — the app warns you when a model falls short of\neither. With Ollama, the app requests a 32k context for every call; with LM Studio, load the model\nwith a larger context if it shows only a few thousand tokens.",[304,491,493],{"id":492},"use-a-local-model-for-an-agent","Use a local model for an agent",[364,495,496,504,522],{},[312,497,416,498,501,502,332],{},[274,499,500],{},"Settings ▸ Agents",", select the agent, and open its ",[274,503,331],{},[312,505,506,507,509,510,513,514,517,518,521],{},"In the ",[274,508,327],{}," card, open ",[274,511,512],{},"Local model"," and pick a computer and model — each\nentry shows whether the computer is ",[274,515,516],{},"Online"," or ",[274,519,520],{},"Offline",", its context size, and a warning\nif the model may be weak at tool use.",[312,523,524,525,528],{},"Click ",[274,526,527],{},"Use this model",". The agent restarts and runs on the model on your computer.",[271,530,531,532,535,536,539,540,372],{},"The card then shows the computer and model as ",[274,533,534],{},"Active",". On a paid plan the local model also\nappears as the ",[274,537,538],{},"Primary"," in your connected models, labelled ",[274,541,512],{},[271,543,544],{},"To go back to a cloud model, choose or connect one in the model settings above the card — a local\nmodel isn't kept as a backup when you switch away from it.",[304,546,548],{"id":547},"who-can-use-it","Who can use it",[271,550,551,552,555],{},"A computer belongs to the person who signed in on it. Only ",[274,553,554],{},"you"," can point an agent at your own\ncomputer, and you only see your own computers in the picker — teammates can't use yours. If an\nagent is on a computer that was removed or belongs to a teammate, the card says so and asks you to\nchoose another model.",[271,557,558],{},"On workspaces that require you to bring your own LLM, a local model counts as your own.",[304,560,562],{"id":561},"when-your-computer-is-offline","When your computer is offline",[309,564,565,576],{},[312,566,567,570,571,372],{},[274,568,569],{},"With backup models"," (paid plans) — the agent switches to its backup models while the computer\nis offline. Add one under ",[572,573,575],"a",{"href":574},"/models-and-skills#paid-plans-connected-models","connected models",[312,577,578,581],{},[274,579,580],{},"Without a backup"," — chats with the agent fail until the computer reconnects.",[271,583,584],{},"When a local model can't answer, the chat shows why — for example \"The computer serving this local\nmodel is offline. Open BetterClaw Desktop on it to reconnect.\" or \"The computer serving this local\nmodel is busy with another request.\"",[304,586,588],{"id":587},"settings-in-betterclaw-desktop","Settings in BetterClaw Desktop",[309,590,591,600,606,612,618,624],{},[312,592,593,596,597,599],{},[274,594,595],{},"Requests at once"," (under ",[274,598,474],{},") — how many requests the computer handles in\nparallel, from 1 (the default) to 8. Extra requests get a \"busy\" answer.",[312,601,602,605],{},[274,603,604],{},"Keep awake while serving"," — stops the computer from sleeping while a request is running (on\nby default).",[312,607,608,611],{},[274,609,610],{},"Open at login"," — starts the app in the menu bar when you log in.",[312,613,614,617],{},[274,615,616],{},"Device name"," — how the computer appears in BetterClaw.",[312,619,620,623],{},[274,621,622],{},"Activity"," — a list of events (sign-ins, connections, requests started, completed, or refused).\nWhat was asked and answered is never shown.",[312,625,626,629,630,633],{},[274,627,628],{},"Local API (advanced)"," — off by default. Turn it on to use your shared models from other\nOpenAI-compatible tools on the same computer, at ",[345,631,632],{},"http://127.0.0.1:\u003Cport>/v1",". Every request\nneeds a key you create there; a new key is shown only once, and you can revoke it anytime. It's\nreachable only from that computer.",[271,635,636],{},"Closing the window leaves the app running in the menu bar; your agents can use the computer until\nyou quit the app.",[304,638,640],{"id":639},"manage-or-remove-a-computer","Manage or remove a computer",[271,642,643,644,646],{},"Under ",[274,645,399],{}," on your profile, each computer shows whether it's online, its app\nversion, when it was last seen, and the models it shares. From there you can:",[309,648,649,654,660],{},[312,650,651,653],{},[274,652,622],{}," — recent requests with model, result, tokens, and time.",[312,655,656,659],{},[274,657,658],{},"Rename"," the computer.",[312,661,662,665],{},[274,663,664],{},"Remove"," it from your account.",[271,667,668,669,672],{},"Signing out in BetterClaw Desktop (",[274,670,671],{},"Settings ▸ Sign out",") also removes the computer. Agents using\nits models switch to their backup models.",[304,674,676],{"id":675},"troubleshooting","Troubleshooting",[678,679,680,693],"table",{},[681,682,683],"thead",{},[684,685,686,690],"tr",{},[687,688,689],"th",{},"What you see",[687,691,692],{},"What to do",[694,695,696,705,716,733,744,757,765],"tbody",{},[684,697,698,702],{},[699,700,701],"td",{},"\"Install BetterClaw Desktop on your computer and sign in to use its models here.\"",[699,703,704],{},"No computer is connected to your account yet — install the app and sign in.",[684,706,707,710],{},[699,708,709],{},"\"Your computers aren't sharing any models yet.\"",[699,711,712,713,715],{},"In BetterClaw Desktop, open ",[274,714,454],{}," and turn on at least one model.",[684,717,718,725],{},[699,719,720,721,724],{},"\"No engine is running\" / ",[274,722,723],{},"No engine found"," in the app",[699,726,727,728,730,731,372],{},"Start Ollama, LM Studio, or llama.cpp, then click ",[274,729,437],{}," on ",[274,732,419],{},[684,734,735,738],{},[699,736,737],{},"\"This model is not shared from the device.\"",[699,739,740,741,743],{},"Turn the model back on under ",[274,742,454],{}," in BetterClaw Desktop.",[684,745,746,749],{},[699,747,748],{},"\"This local model is not available…\"",[699,750,751,752,754,755,372],{},"The computer was removed, or ",[274,753,470],{}," is off — turn it on under ",[274,756,474],{},[684,758,759,762],{},[699,760,761],{},"The agent misuses tools or stops early",[699,763,764],{},"The model is likely weak at tool calling — switch to a larger model with tool support.",[684,766,767,770],{},[699,768,769],{},"Long chats get summarised often",[699,771,772],{},"The model's context window is small — load it with a larger context in your engine.",{"title":774,"searchDepth":775,"depth":776,"links":777},"",1,2,[778,779,780,781,782,783,784,785,786],{"id":306,"depth":776,"text":307},{"id":361,"depth":776,"text":362},{"id":407,"depth":776,"text":408},{"id":492,"depth":776,"text":493},{"id":547,"depth":776,"text":548},{"id":561,"depth":776,"text":562},{"id":587,"depth":776,"text":588},{"id":639,"depth":776,"text":640},{"id":675,"depth":776,"text":676},"Run an agent on a model served from your own computer with BetterClaw Desktop.","md",null,{},{"icon":124},{"title":121,"description":787},"6_nVu1lDcCJcI5NqHRPLw5AuBwMG5NzFiolpfhVrxYI",[795,797],{"title":116,"path":117,"stem":118,"description":796,"icon":119,"children":-1},"Write, edit, save from a chat, and export your own skills.",{"title":28,"path":127,"stem":128,"description":798,"icon":131,"children":-1},"Connect messaging apps, external tools, and credentials to your agents.",1791467819445]