OpenClaw 一键配置安装教程

公共 openclaw.sh 支持 macOS、Linux 和 Windows WSL。缺少 OpenClaw 时，它会调用官方 https://openclaw.ai/install.sh；随后通过 OpenClaw 官方配置命令合并 provider、模型和 file-backed SecretRef。Windows 原生 PowerShell 暂无对应资产，推荐使用 WSL；已有完整 POSIX 工具链的 Git Bash 可尝试 Bash 命令，但上游安装器兼容性以 WSL 为准。

运行前准备

在 aitongdao.com 创建令牌并确认余额可用：GPT 使用 codex 分组， Claude 使用 claude 或 ccmax 分组。先从站内可用模型列表确认要使用的精确模型 ID。

GPT / OpenAI 协议

curl -fsSL https://gh.auranaiss-dev.com/ding-rs/ai-cli-installers/releases/latest/download/openclaw.sh \
  | bash -s -- --provider openai --endpoint https://ai.aitongdao.com/v1 --model gpt-5.5

OpenAI 兼容 endpoint 必须带 /v1。如需其他 GPT 模型，把 gpt-5.5 换成站内显示的模型 ID。

Claude / Anthropic 协议

curl -fsSL https://gh.auranaiss-dev.com/ding-rs/ai-cli-installers/releases/latest/download/openclaw.sh \
  | bash -s -- --provider anthropic --endpoint https://ai.aitongdao.com --model claude-opus-4-8

Anthropic endpoint 不带 /v1。如需 Sonnet 等其他模型，替换 --model 的值。

两条命令都省略了 Key，installer 会从终端安全读取且不回显。如果已安装 OpenClaw，脚本会 询问是否重装或更新；选择否只跳过官方安装步骤，配置仍会更新。

脚本会修改什么

• 缺少 OpenClaw 时运行官方安装器；已有安装可选择保留或重装。
• 先用 openclaw config file 与 openclaw config validate --json 确认活动配置可安全修改。
• 合并 models.providers.<provider> 与选定模型，并设置 agents.defaults.model.primary。
• 把 Key 写入权限受限的私有文件，通过 file-backed SecretRef 引用，不把明文 Key 嵌进主配置。
• 修改前创建带编号的 .ai-cli-installers.bak 备份；失败时尝试恢复原配置。

installer 不会拉取模型列表或展示品牌菜单；--provider、--endpoint 和 --model 都是明确 输入，交互模式只在省略时逐项询问。

验证

openclaw config validate --json
openclaw gateway restart
openclaw status
openclaw doctor

如果网关已经运行，重启后才会加载新 provider 和默认模型。

自动化调用

无人值守环境通过 secret store 注入 Key，不要把 Key 放进进程参数或脚本文件：

installer=$(mktemp)
trap 'rm -f "$installer"' EXIT
curl -fsSL https://gh.auranaiss-dev.com/ding-rs/ai-cli-installers/releases/latest/download/openclaw.sh -o "$installer"
AI_ENDPOINT=https://ai.aitongdao.com/v1 AI_API_KEY="$AI_API_KEY" \
AI_MODEL=gpt-5.5 AI_PROVIDER=openai AI_INSTALL_YES=1 bash "$installer"

无人值守模式缺少 provider、endpoint、Key 或 model 时会直接失败，不会卡在交互提示。