[{"data":1,"prerenderedAt":862},["ShallowReactive",2],{"post-2026-06-01-openclawinstall":3},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"tags":11,"body":14,"_type":856,"_id":857,"_source":858,"_file":859,"_stem":860,"_extension":861},"\u002Fblog\u002F2026-06-01-openclawinstall","blog",false,"","OpenClaw 安装教程","OpenClaw 安装与配置教程，包含 OpenAI 授权、DeepSeek 接入、常见问题排查及常用命令。","2026-06-01",[12,13],"工具","AI",{"type":15,"children":16,"toc":847},"root",[17,25,31,52,65,74,80,85,93,99,221,228,254,262,270,278,284,296,304,308,313,319,332,340,359,373,386,394,399,404,418,426,432,445,450,458,468,471,477,482,496,501,628,633,656,664,672,680,686,697,705,713,718,731,745,766,774,777,782,787,801,813,833,841],{"type":18,"tag":19,"props":20,"children":22},"element","h3",{"id":21},"一键安装",[23],{"type":24,"value":21},"text",{"type":18,"tag":26,"props":27,"children":28},"p",{},[29],{"type":24,"value":30},"执行官网的安装指令（Windows）：",{"type":18,"tag":32,"props":33,"children":37},"pre",{"className":34,"code":35,"language":36,"meta":7,"style":7},"language-powershell shiki shiki-themes github-dark","powershell -c \"irm https:\u002F\u002Fopenclaw.ai\u002Finstall.ps1 | iex\"\n","powershell",[38],{"type":18,"tag":39,"props":40,"children":41},"code",{"__ignoreMap":7},[42],{"type":18,"tag":43,"props":44,"children":47},"span",{"class":45,"line":46},"line",1,[48],{"type":18,"tag":43,"props":49,"children":50},{},[51],{"type":24,"value":35},{"type":18,"tag":26,"props":53,"children":54},{},[55,57,63],{"type":24,"value":56},"系统会自动配置 ",{"type":18,"tag":39,"props":58,"children":60},{"className":59},[],[61],{"type":24,"value":62},"node.js",{"type":24,"value":64}," 环境。",{"type":18,"tag":26,"props":66,"children":67},{},[68],{"type":18,"tag":69,"props":70,"children":73},"img",{"alt":71,"src":72},"1780134869377","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780134869377.png",[],{"type":18,"tag":19,"props":75,"children":77},{"id":76},"安装向导setup-wizard",[78],{"type":24,"value":79},"安装向导（Setup Wizard）",{"type":18,"tag":26,"props":81,"children":82},{},[83],{"type":24,"value":84},"OpenClaw 主程序安装成功后，会启动安装向导（Setup Wizard）。",{"type":18,"tag":26,"props":86,"children":87},{},[88],{"type":18,"tag":69,"props":89,"children":92},{"alt":90,"src":91},"1780143609184","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780143609184.png",[],{"type":18,"tag":94,"props":95,"children":97},"h4",{"id":96},"问答配置过程",[98],{"type":24,"value":96},{"type":18,"tag":100,"props":101,"children":102},"table",{},[103,128],{"type":18,"tag":104,"props":105,"children":106},"thead",{},[107],{"type":18,"tag":108,"props":109,"children":110},"tr",{},[111,118,123],{"type":18,"tag":112,"props":113,"children":115},"th",{"align":114},"center",[116],{"type":24,"value":117},"问题",{"type":18,"tag":112,"props":119,"children":120},{},[121],{"type":24,"value":122},"选项",{"type":18,"tag":112,"props":124,"children":125},{},[126],{"type":24,"value":127},"说明",{"type":18,"tag":129,"props":130,"children":131},"tbody",{},[132,155,177,199],{"type":18,"tag":108,"props":133,"children":134},{},[135,141,150],{"type":18,"tag":136,"props":137,"children":138},"td",{"align":114},[139],{"type":24,"value":140},"Q1",{"type":18,"tag":136,"props":142,"children":143},{},[144],{"type":18,"tag":39,"props":145,"children":147},{"className":146},[],[148],{"type":24,"value":149},"YES",{"type":18,"tag":136,"props":151,"children":152},{},[153],{"type":24,"value":154},"同意协议，开始配置",{"type":18,"tag":108,"props":156,"children":157},{},[158,163,172],{"type":18,"tag":136,"props":159,"children":160},{"align":114},[161],{"type":24,"value":162},"Q2",{"type":18,"tag":136,"props":164,"children":165},{},[166],{"type":18,"tag":39,"props":167,"children":169},{"className":168},[],[170],{"type":24,"value":171},"QuickStart（recommended）",{"type":18,"tag":136,"props":173,"children":174},{},[175],{"type":24,"value":176},"快速启动模式",{"type":18,"tag":108,"props":178,"children":179},{},[180,185,194],{"type":18,"tag":136,"props":181,"children":182},{"align":114},[183],{"type":24,"value":184},"Q3",{"type":18,"tag":136,"props":186,"children":187},{},[188],{"type":18,"tag":39,"props":189,"children":191},{"className":190},[],[192],{"type":24,"value":193},"OpenAI",{"type":18,"tag":136,"props":195,"children":196},{},[197],{"type":24,"value":198},"选择模型供应商",{"type":18,"tag":108,"props":200,"children":201},{},[202,207,216],{"type":18,"tag":136,"props":203,"children":204},{"align":114},[205],{"type":24,"value":206},"Q4",{"type":18,"tag":136,"props":208,"children":209},{},[210],{"type":18,"tag":39,"props":211,"children":213},{"className":212},[],[214],{"type":24,"value":215},"ChatGPT\u002FCodex Browser Login",{"type":18,"tag":136,"props":217,"children":218},{},[219],{"type":24,"value":220},"浏览器登录授权",{"type":18,"tag":222,"props":223,"children":225},"h5",{"id":224},"q1-q3-配置",[226],{"type":24,"value":227},"Q1-Q3 配置",{"type":18,"tag":26,"props":229,"children":230},{},[231,233,238,240,246,247,252],{"type":24,"value":232},"依次选择 ",{"type":18,"tag":39,"props":234,"children":236},{"className":235},[],[237],{"type":24,"value":149},{"type":24,"value":239}," → ",{"type":18,"tag":39,"props":241,"children":243},{"className":242},[],[244],{"type":24,"value":245},"QuickStart",{"type":24,"value":239},{"type":18,"tag":39,"props":248,"children":250},{"className":249},[],[251],{"type":24,"value":193},{"type":24,"value":253},"：",{"type":18,"tag":26,"props":255,"children":256},{},[257],{"type":18,"tag":69,"props":258,"children":261},{"alt":259,"src":260},"1780143787897","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780143787897.png",[],{"type":18,"tag":26,"props":263,"children":264},{},[265],{"type":18,"tag":69,"props":266,"children":269},{"alt":267,"src":268},"1780143962234","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780143962234.png",[],{"type":18,"tag":26,"props":271,"children":272},{},[273],{"type":18,"tag":69,"props":274,"children":277},{"alt":275,"src":276},"1780144124929","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780144124929.png",[],{"type":18,"tag":222,"props":279,"children":281},{"id":280},"q4-浏览器登录授权",[282],{"type":24,"value":283},"Q4 浏览器登录授权",{"type":18,"tag":26,"props":285,"children":286},{},[287,289,294],{"type":24,"value":288},"选择 ",{"type":18,"tag":39,"props":290,"children":292},{"className":291},[],[293],{"type":24,"value":215},{"type":24,"value":295},"，弹出浏览器进行 OpenAI 登录。",{"type":18,"tag":26,"props":297,"children":298},{},[299],{"type":18,"tag":69,"props":300,"children":303},{"alt":301,"src":302},"1780144268219","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780144268219.png",[],{"type":18,"tag":305,"props":306,"children":307},"hr",{},[],{"type":18,"tag":19,"props":309,"children":311},{"id":310},"问题排查",[312],{"type":24,"value":310},{"type":18,"tag":94,"props":314,"children":316},{"id":315},"问题一地区限制",[317],{"type":24,"value":318},"问题一：地区限制",{"type":18,"tag":26,"props":320,"children":321},{},[322,324,330],{"type":24,"value":323},"浏览器显示 ",{"type":18,"tag":39,"props":325,"children":327},{"className":326},[],[328],{"type":24,"value":329},"Authentication successful",{"type":24,"value":331},"，登录成功了。但 OpenClaw 本地进程向 OpenAI 换取访问令牌时，被 OpenAI 判断为来自不支持的地区或网络线路。",{"type":18,"tag":26,"props":333,"children":334},{},[335],{"type":18,"tag":69,"props":336,"children":339},{"alt":337,"src":338},"1780145568920","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780145568920.png",[],{"type":18,"tag":26,"props":341,"children":342},{},[343,349,351,357],{"type":18,"tag":344,"props":345,"children":346},"strong",{},[347],{"type":24,"value":348},"解决方法",{"type":24,"value":350},"：修改代理为 ",{"type":18,"tag":39,"props":352,"children":354},{"className":353},[],[355],{"type":24,"value":356},"Tun",{"type":24,"value":358}," 模式（全局代理），重新执行登录命令：",{"type":18,"tag":32,"props":360,"children":362},{"className":34,"code":361,"language":36,"meta":7,"style":7},"openclaw models auth login --provider openai-codex\n",[363],{"type":18,"tag":39,"props":364,"children":365},{"__ignoreMap":7},[366],{"type":18,"tag":43,"props":367,"children":368},{"class":45,"line":46},[369],{"type":18,"tag":43,"props":370,"children":371},{},[372],{"type":24,"value":361},{"type":18,"tag":26,"props":374,"children":375},{},[376,378,384],{"type":24,"value":377},"登录成功，但 Codex 插件安装失败。直接 ",{"type":18,"tag":39,"props":379,"children":381},{"className":380},[],[382],{"type":24,"value":383},"Ctrl+C",{"type":24,"value":385}," 中断进程即可。",{"type":18,"tag":26,"props":387,"children":388},{},[389],{"type":18,"tag":69,"props":390,"children":393},{"alt":391,"src":392},"1780149412580","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780149412580.png",[],{"type":18,"tag":94,"props":395,"children":397},{"id":396},"验证模型列表",[398],{"type":24,"value":396},{"type":18,"tag":26,"props":400,"children":401},{},[402],{"type":24,"value":403},"执行以下命令确认是否成功获取到 OpenAI 的大模型：",{"type":18,"tag":32,"props":405,"children":407},{"className":34,"code":406,"language":36,"meta":7,"style":7},"openclaw models list\n",[408],{"type":18,"tag":39,"props":409,"children":410},{"__ignoreMap":7},[411],{"type":18,"tag":43,"props":412,"children":413},{"class":45,"line":46},[414],{"type":18,"tag":43,"props":415,"children":416},{},[417],{"type":24,"value":406},{"type":18,"tag":26,"props":419,"children":420},{},[421],{"type":18,"tag":69,"props":422,"children":425},{"alt":423,"src":424},"1780146499753","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780146499753.png",[],{"type":18,"tag":94,"props":427,"children":429},{"id":428},"问题二对话请求被拒绝",[430],{"type":24,"value":431},"问题二：对话请求被拒绝",{"type":18,"tag":26,"props":433,"children":434},{},[435,437,443],{"type":24,"value":436},"输入 ",{"type":18,"tag":39,"props":438,"children":440},{"className":439},[],[441],{"type":24,"value":442},"openclaw chat",{"type":24,"value":444}," 打开对话，调用模型后反馈推理调用失败。",{"type":18,"tag":26,"props":446,"children":447},{},[448],{"type":24,"value":449},"OpenClaw 能看到 OpenAI 账号，也能拉取模型列表，但真正发起 GPT-5.5 对话请求时，被 OpenAI 拒绝了。",{"type":18,"tag":26,"props":451,"children":452},{},[453],{"type":18,"tag":69,"props":454,"children":457},{"alt":455,"src":456},"1780146724389","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780146724389.png",[],{"type":18,"tag":26,"props":459,"children":460},{},[461,466],{"type":18,"tag":344,"props":462,"children":463},{},[464],{"type":24,"value":465},"解决思路",{"type":24,"value":467},"：OpenAI 有地区限制，改用 DeepSeek。",{"type":18,"tag":305,"props":469,"children":470},{},[],{"type":18,"tag":19,"props":472,"children":474},{"id":473},"接入-deepseek",[475],{"type":24,"value":476},"接入 DeepSeek",{"type":18,"tag":94,"props":478,"children":480},{"id":479},"打开配置项",[481],{"type":24,"value":479},{"type":18,"tag":32,"props":483,"children":485},{"className":34,"code":484,"language":36,"meta":7,"style":7},"openclaw configure\n",[486],{"type":18,"tag":39,"props":487,"children":488},{"__ignoreMap":7},[489],{"type":18,"tag":43,"props":490,"children":491},{"class":45,"line":46},[492],{"type":18,"tag":43,"props":493,"children":494},{},[495],{"type":24,"value":484},{"type":18,"tag":94,"props":497,"children":499},{"id":498},"配置流程",[500],{"type":24,"value":498},{"type":18,"tag":100,"props":502,"children":503},{},[504,523],{"type":18,"tag":104,"props":505,"children":506},{},[507],{"type":18,"tag":108,"props":508,"children":509},{},[510,514,519],{"type":18,"tag":112,"props":511,"children":512},{"align":114},[513],{"type":24,"value":117},{"type":18,"tag":112,"props":515,"children":516},{},[517],{"type":24,"value":518},"选择",{"type":18,"tag":112,"props":520,"children":521},{},[522],{"type":24,"value":127},{"type":18,"tag":129,"props":524,"children":525},{},[526,547,568,589,610],{"type":18,"tag":108,"props":527,"children":528},{},[529,533,542],{"type":18,"tag":136,"props":530,"children":531},{"align":114},[532],{"type":24,"value":140},{"type":18,"tag":136,"props":534,"children":535},{},[536],{"type":18,"tag":39,"props":537,"children":539},{"className":538},[],[540],{"type":24,"value":541},"Local（this machine）",{"type":18,"tag":136,"props":543,"children":544},{},[545],{"type":24,"value":546},"本地运行",{"type":18,"tag":108,"props":548,"children":549},{},[550,554,563],{"type":18,"tag":136,"props":551,"children":552},{"align":114},[553],{"type":24,"value":162},{"type":18,"tag":136,"props":555,"children":556},{},[557],{"type":18,"tag":39,"props":558,"children":560},{"className":559},[],[561],{"type":24,"value":562},"Model",{"type":18,"tag":136,"props":564,"children":565},{},[566],{"type":24,"value":567},"修改模型配置",{"type":18,"tag":108,"props":569,"children":570},{},[571,575,584],{"type":18,"tag":136,"props":572,"children":573},{"align":114},[574],{"type":24,"value":184},{"type":18,"tag":136,"props":576,"children":577},{},[578],{"type":18,"tag":39,"props":579,"children":581},{"className":580},[],[582],{"type":24,"value":583},"More",{"type":18,"tag":136,"props":585,"children":586},{},[587],{"type":24,"value":588},"更多选项",{"type":18,"tag":108,"props":590,"children":591},{},[592,596,605],{"type":18,"tag":136,"props":593,"children":594},{"align":114},[595],{"type":24,"value":206},{"type":18,"tag":136,"props":597,"children":598},{},[599],{"type":18,"tag":39,"props":600,"children":602},{"className":601},[],[603],{"type":24,"value":604},"deepseek",{"type":18,"tag":136,"props":606,"children":607},{},[608],{"type":24,"value":609},"选择 DeepSeek，输入 API Key",{"type":18,"tag":108,"props":611,"children":612},{},[613,618,623],{"type":18,"tag":136,"props":614,"children":615},{"align":114},[616],{"type":24,"value":617},"Q5",{"type":18,"tag":136,"props":619,"children":620},{},[621],{"type":24,"value":622},"空格键选中模型",{"type":18,"tag":136,"props":624,"children":625},{},[626],{"type":24,"value":627},"方向键选择需要的模型",{"type":18,"tag":222,"props":629,"children":631},{"id":630},"q1-q3-配置-1",[632],{"type":24,"value":227},{"type":18,"tag":26,"props":634,"children":635},{},[636,637,643,644,649,650,655],{"type":24,"value":288},{"type":18,"tag":39,"props":638,"children":640},{"className":639},[],[641],{"type":24,"value":642},"Local",{"type":24,"value":239},{"type":18,"tag":39,"props":645,"children":647},{"className":646},[],[648],{"type":24,"value":562},{"type":24,"value":239},{"type":18,"tag":39,"props":651,"children":653},{"className":652},[],[654],{"type":24,"value":583},{"type":24,"value":253},{"type":18,"tag":26,"props":657,"children":658},{},[659],{"type":18,"tag":69,"props":660,"children":663},{"alt":661,"src":662},"1780146947657","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780146947657.png",[],{"type":18,"tag":26,"props":665,"children":666},{},[667],{"type":18,"tag":69,"props":668,"children":671},{"alt":669,"src":670},"1780147129514","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780147129514.png",[],{"type":18,"tag":26,"props":673,"children":674},{},[675],{"type":18,"tag":69,"props":676,"children":679},{"alt":677,"src":678},"1780147166005","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780147166005.png",[],{"type":18,"tag":222,"props":681,"children":683},{"id":682},"q4-q5-配置",[684],{"type":24,"value":685},"Q4-Q5 配置",{"type":18,"tag":26,"props":687,"children":688},{},[689,690,695],{"type":24,"value":288},{"type":18,"tag":39,"props":691,"children":693},{"className":692},[],[694],{"type":24,"value":604},{"type":24,"value":696},"，输入自己的 API，然后选择需要的大模型（方向键选择，空格键选中）：",{"type":18,"tag":26,"props":698,"children":699},{},[700],{"type":18,"tag":69,"props":701,"children":704},{"alt":702,"src":703},"1780147332623","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780147332623.png",[],{"type":18,"tag":26,"props":706,"children":707},{},[708],{"type":18,"tag":69,"props":709,"children":712},{"alt":710,"src":711},"1780147436886","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780147436886.png",[],{"type":18,"tag":94,"props":714,"children":716},{"id":715},"首次成功对话",[717],{"type":24,"value":715},{"type":18,"tag":26,"props":719,"children":720},{},[721,723,729],{"type":24,"value":722},"配置完成后选择 ",{"type":18,"tag":39,"props":724,"children":726},{"className":725},[],[727],{"type":24,"value":728},"None",{"type":24,"value":730}," 退出，重新执行：",{"type":18,"tag":32,"props":732,"children":734},{"className":34,"code":733,"language":36,"meta":7,"style":7},"openclaw chat\n",[735],{"type":18,"tag":39,"props":736,"children":737},{"__ignoreMap":7},[738],{"type":18,"tag":43,"props":739,"children":740},{"class":45,"line":46},[741],{"type":18,"tag":43,"props":742,"children":743},{},[744],{"type":24,"value":733},{"type":18,"tag":26,"props":746,"children":747},{},[748,750,756,758,764],{"type":24,"value":749},"打开后会自动恢复上一次的会话记录。输入 ",{"type":18,"tag":39,"props":751,"children":753},{"className":752},[],[754],{"type":24,"value":755},"\u002Fmodel",{"type":24,"value":757}," 修改大模型为 ",{"type":18,"tag":39,"props":759,"children":761},{"className":760},[],[762],{"type":24,"value":763},"deepseek-v4-flash",{"type":24,"value":765},"，重新发送问题——成功！",{"type":18,"tag":26,"props":767,"children":768},{},[769],{"type":18,"tag":69,"props":770,"children":773},{"alt":771,"src":772},"1780147719463","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780147719463.png",[],{"type":18,"tag":305,"props":775,"children":776},{},[],{"type":18,"tag":19,"props":778,"children":780},{"id":779},"常用命令",[781],{"type":24,"value":779},{"type":18,"tag":94,"props":783,"children":785},{"id":784},"查看认证状态",[786],{"type":24,"value":784},{"type":18,"tag":32,"props":788,"children":790},{"className":34,"code":789,"language":36,"meta":7,"style":7},"openclaw models auth status\n",[791],{"type":18,"tag":39,"props":792,"children":793},{"__ignoreMap":7},[794],{"type":18,"tag":43,"props":795,"children":796},{"class":45,"line":46},[797],{"type":18,"tag":43,"props":798,"children":799},{},[800],{"type":24,"value":789},{"type":18,"tag":26,"props":802,"children":803},{},[804,806,811],{"type":24,"value":805},"该命令用于",{"type":18,"tag":344,"props":807,"children":808},{},[809],{"type":24,"value":810},"认证状态检查",{"type":24,"value":812},"，不会调用模型聊天，而是查看：",{"type":18,"tag":814,"props":815,"children":816},"ul",{},[817,823,828],{"type":18,"tag":818,"props":819,"children":820},"li",{},[821],{"type":24,"value":822},"当前有哪些模型可用",{"type":18,"tag":818,"props":824,"children":825},{},[826],{"type":24,"value":827},"哪些 Provider 已认证",{"type":18,"tag":818,"props":829,"children":830},{},[831],{"type":24,"value":832},"哪些认证过期了",{"type":18,"tag":26,"props":834,"children":835},{},[836],{"type":18,"tag":69,"props":837,"children":840},{"alt":838,"src":839},"1780149065699","\u002Fimages\u002Fblog\u002Fopenclaw-install\u002F1780149065699.png",[],{"type":18,"tag":842,"props":843,"children":844},"style",{},[845],{"type":24,"value":846},"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);}",{"title":7,"searchDepth":848,"depth":848,"links":849},2,[850,852,853,854,855],{"id":21,"depth":851,"text":21},3,{"id":76,"depth":851,"text":79},{"id":310,"depth":851,"text":310},{"id":473,"depth":851,"text":476},{"id":779,"depth":851,"text":779},"markdown","content:blog:2026-06-01-OpenclawInstall.md","content","blog\u002F2026-06-01-OpenclawInstall.md","blog\u002F2026-06-01-OpenclawInstall","md",1780801017576]