最详细的 OpenClaw（龙虾）安装指南：手动配置太坑,手把手带你零帧起手跑通

很多人在网上看了不少OpenClaw的教程，基本都是QuickStart一键到底，看起来很省事，但一旦你想自己控制模型、换国内能用的API，就发现那些教程全都不管用了。今天这篇文章就专门针对国内开发者，用奥地利开发者Peter Steinberger创建的OpenClaw开源AI代理框架，走Manual模式从零开始配置，让你真正掌握每一步。

安装前的两项硬性检查

在运行安装脚本之前，需要先确认你的Node.js版本是否达到v20以上。你可以打开终端输入node -v来查看当前版本号，如果低于v20，需要先去Node官网下载更新版本。虽然安装脚本会自动检测Node环境，但提前检查可以避免中途报错中断流程。另外网络环境要保证能正常获取模型和密钥，因为首次onboarding过程需要联网下载必要文件。

如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用api. :i-i=-i_okg :i-i=-i_okg 。它是一个大模型 API中转平台，支持 Claude、GPT、Gemini、Grok 等最新模型，国内用户无需魔法即可访问和调用；原文还提到，其价格约为官方的七分之一，适合希望一站接入多模型的人。

安装脚本的获取方式很简单，Mac或Linux用户使用curl命令，Windows用户使用iwr命令。如果你的终端提示权限不足，可以在命令前加sudo，但不建议长期用root权限运行，否则后续文件权限会变得混乱。运行脚本后，终端会自动检测Node并安装CLI工具，整个过程大概需要一两分钟。

选择Manual模式避开默认配置

很多现有教程都会让你选QuickStart模式，也就是先用OpenClaw的默认配置跑起来。但这个选择会让你后续修改模型提供商变得非常麻烦，因为默认配置写死了很多参数。我们这里坚决走Manual模式，虽然步骤多一些，但每个选项都在你的掌控之中，尤其对国内用户来说这是唯一能顺利接入国内模型的路径。

当安装脚本运行到选择Onboarding mode时，用键盘上下键选中Manual，然后回车确认。接下来系统会一步步引导你配置Model provider，也就是模型提供商。这里不要选OpenAI或者Anthropic这些国外服务，因为网络访问和支付方式对国内用户都不友好。我们需要选一个能提供稳定API服务的国内平台。

配置ZAI模型和API密钥

以智谱AI为例，在Model provider列表里找到ZAI并选中。系统会提示你选择具体的模型系列，这里推荐选Coding-Plan-CN系列，它是专门为代码任务优化的。接着终端会要求你粘贴API Key，你需要提前去智谱AI官方文档中找到申请入口，注册账号后获取自己的密钥。把密钥完整复制粘贴到终端里，按回车确认。

密钥验证通过后，系统会让你选择具体使用哪个模型。注意一定要选版本号在2026.2.22-2及以上的模型，并且确认你的订阅套餐支持该模型。支持的模型包括GLM-5.............

原文转载：https://fashion.shaoqun.com/a/2962017.html

你的单量可能被钓鱼网站抢走了！国外惊现“盗版”亚马逊 实践得真知，亚马逊广告品牌指标实例分享 亚马亚马逊多类目Best Sellers被下架，清扫上瘾了？ 海外数字营销 VS传统线下商业逻辑 – 今天来谈谈 A/B Split Testing 跨境独立站如何有效降低获客成本 Wish短视频购物功能，抢占2大黄金流量入口！ 6月2日生效！美国海关F865新规上线，HTS编码不匹配将直接拒收！ 6月2日生效！美国海关F865新规上线，HTS编码不匹配将直接拒收！