前置条件
- 1已安装 Node.js 22.x 环境
- 2已注册 Google 账号（用于访问 Google AI Studio）
- 3电脑能联网（国内访问 Gemini 需梯子/可直连）
常见问题
Q我连终端是什么都不懂，能用吗？
能用。选方式 A，全程跟着 OpenClaw 的引导向导一步步输入，不用手写任何配置代码。
Q方式 A 的 onboard 向导在哪？
安装 OpenClaw 后，在终端输入 openclaw onboard 即可启动引导向导。如果命令不存在，说明版本太旧，用 npm install -g openclaw-cli@latest 升级。
QAPI Key 填了但还是报 401 错误？
请检查 Key 是否有多余空格或换行符（Gemini Key 以 AIza 开头）。建议方式 B 用环境变量 apiKeyEnv 而非直接填写 apiKey。确认 Key 未在 Google AI Studio 被撤销，且项目已启用 Generative Language API。
Q调用时出现 404 Not Found？
OpenAI 兼容端点必须包含 /v1beta/openai 后缀，正确格式为 https://generativelanguage.googleapis.com/v1beta/openai，遗漏 openai 路径或写错版本号是最常见的新手错误。
Q响应很慢或者超时怎么办？
先将 maxTokens 降低到 2048 测试网络连通性；国内访问必须挂梯子，且代理节点不稳定会导致间歇超时；高峰期可切换到 gemini-2.5-flash 等更快的模型。