开始前先做这一步：先到 Key 管理 创建通用积分 Key，复制
sk- 开头的 Key 备用。1 下载脚本安装
点击下面按钮下载脚本，然后按“运行方式”执行。
脚本文件：openclaw-setup.sh
脚本会按 1 → 2 → 3 自动执行；环境检测或任一步失败都会停止。请先修复提示问题后重新运行，不要跳过失败步骤继续下一步。
2 运行方式
运行方式
下载
openclaw-setup.sh 后，打开终端输入 bash，后面空一格，再拖入脚本文件或粘贴脚本绝对路径。环境要求
需要先安装
Node.js 18+。macOS 可到 nodejs.org/zh-cn/download 下载；Linux 可执行：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs。完整说明
安装前确认
- 需要先安装
Node.js 18+。macOS 可到 nodejs.org/zh-cn/download 下载；Linux 可执行：curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - && sudo apt-get install -y nodejs。 - 先到 Key 管理 创建通用积分 Key。
- 通用积分 Key 可用于 Codex、Claude Code、Gemini 全部工具。
脚本会做什么
- 检查 Node.js / npm 是否可用。
- 调用 OpenClaw 官方安装脚本。
- 提示你粘贴通用积分 Key，粘贴后继续即可。
- 校验 Key 必须以
sk-开头，避免把占位符写入配置。 - 写入配置前会备份旧配置。
配置写入位置
配置文件
~/.openclaw/openclaw.json写入规则
自动写入 Codex、Claude Code、Gemini provider，共用同一把通用积分 Key。
可用模型参考
- Codex：
gpt-5.4/gpt-5.4-mini/gpt-5.3-codex-spark/gpt-5.3-codex - Claude Code：
claude-sonnet-4-6/claude-opus-4-6/claude-opus-4-7/claude-opus-4-8 - Gemini：
gemini-2.5-flash/gemini-2.5-pro
安装完成后
完全退出 OpenClaw 后重新打开。
常见问题
- 提示未安装 Node.js：先安装 Node.js 18+，再重新运行脚本。
- 提示 Key 格式不对：确认填写的是本站创建的真实
sk-Key。 - 写入后不生效：完全退出 OpenClaw 和相关终端/编辑器后重新打开。