[{"data":1,"prerenderedAt":359},["ShallowReactive",2],{"navigation":3,"/models-and-skills/byok":200,"/models-and-skills/byok-surround":354},[4,22,50,83,120,156,189],{"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],{"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,"children":124,"icon":126},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[125,127,132,137,142,147,151],{"title":28,"path":122,"stem":123,"icon":126},"i-ph-plug",{"title":128,"path":129,"stem":130,"icon":131},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":133,"path":134,"stem":135,"icon":136},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":138,"path":139,"stem":140,"icon":141},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":143,"path":144,"stem":145,"icon":146},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":148,"path":149,"stem":150,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":152,"path":153,"stem":154,"icon":155},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":157,"path":158,"stem":159,"children":160,"icon":188},"Account & Team","/account-and-team","6.account-and-team/1.index",[161,164,169,174,179,183],{"title":162,"path":158,"stem":159,"icon":163},"Signing in","i-ph-sign-in",{"title":165,"path":166,"stem":167,"icon":168},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":170,"path":171,"stem":172,"icon":173},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":175,"path":176,"stem":177,"icon":178},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":180,"path":181,"stem":182,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":184,"path":185,"stem":186,"icon":187},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":190,"path":191,"stem":192,"children":193,"icon":195},"Apps","/apps","7.apps/1.index",[194,196],{"title":190,"path":191,"stem":192,"icon":195},"i-ph-squares-four",{"title":197,"path":198,"stem":199,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"id":201,"title":97,"body":202,"description":347,"extension":348,"links":349,"meta":350,"navigation":351,"path":98,"seo":352,"stem":99,"__hash__":353},"docs/4.models-and-skills/3.byok.md",{"type":203,"value":204,"toc":339},"minimark",[205,210,219,224,277,280,287,291,306,310,329],[206,207,209],"h1",{"id":208},"bring-your-own-key-byok","Bring your own key (BYOK)",[211,212,213,214,218],"p",{},"On the ",[215,216,217],"strong",{},"Free"," plan, agents run on an API key you provide. BYOK is also available on Pro if\nyou'd rather use your own provider account than managed credits.",[220,221,223],"h2",{"id":222},"add-a-key","Add a key",[225,226,227,239,246,253,260,272],"ol",{},[228,229,230,231,234,235,238],"li",{},"Open ",[215,232,233],{},"Settings"," and select the ",[215,236,237],{},"LLM"," tab.",[228,240,241,242,245],{},"Pick the ",[215,243,244],{},"agent"," to configure from the agent selector.",[228,247,248,249,252],{},"Choose your ",[215,250,251],{},"provider",".",[228,254,255,256,259],{},"Choose a ",[215,257,258],{},"model"," (or, for a single-model provider, the default model is shown).",[228,261,262,263,266,267,271],{},"Paste your provider ",[215,264,265],{},"API key"," — the field shows the expected key prefix as a hint\n(for example ",[268,269,270],"code",{},"sk-ant-..."," for Anthropic).",[228,273,274,252],{},[215,275,276],{},"Save & Redeploy",[211,278,279],{},"Your key is stored encrypted and used only to run that agent's model.",[211,281,282],{},[283,284],"img",{"alt":285,"src":286},"the LLM tab with provider, model, and API key fields filled in","/screenshots/settings-byok.png",[220,288,290],{"id":289},"replacing-or-changing-the-key","Replacing or changing the key",[211,292,293,294,297,298,301,302,305],{},"Once a key is saved, the LLM tab shows it masked. Click ",[215,295,296],{},"Replace"," to enter a new one.\nYou can switch to a different ",[215,299,300],{},"model from the same provider without re-entering your key"," —\nonly the model selection changes. Switching to a ",[215,303,304],{},"different provider"," always requires a\nfresh key, since a key for one provider won't authenticate against another.",[220,307,309],{"id":308},"custom-provider-env-var","Custom provider env var",[211,311,312,313,316,317,320,321,324,325,252],{},"For a ",[215,314,315],{},"Custom"," provider (self-hosted or an endpoint not in the list), you also set the\n",[215,318,319],{},"API key env var"," name your model client reads the key from — uppercase letters, digits,\nand underscores, e.g. ",[268,322,323],{},"MY_PROVIDER_API_KEY",". See\n",[326,327,92],"a",{"href":328},"/models-and-skills/providers#custom-provider",[330,331,332],"warning",{},[211,333,334,335,338],{},"Treat API keys like passwords. Anyone with workspace access that can edit LLM settings can\nchange the model and key; keep your ",[326,336,337],{"href":166},"team"," limited to people you\ntrust.",{"title":340,"searchDepth":341,"depth":342,"links":343},"",1,2,[344,345,346],{"id":222,"depth":342,"text":223},{"id":289,"depth":342,"text":290},{"id":308,"depth":342,"text":309},"Power an agent with your own provider API key.","md",null,{},{"icon":100},{"title":97,"description":347},"9XtpdpIn-hVl15NVQ5vxV-J6O1DqxvpQUDoc4p1rz2k",[355,357],{"title":92,"path":93,"stem":94,"description":356,"icon":95,"children":-1},"The model providers and models BetterClaw supports.",{"title":102,"path":103,"stem":104,"description":358,"icon":29,"children":-1},"Use your existing ChatGPT subscription instead of an API key.",1787397459500]