快速设置

这页只讲一个原则：先把大模型 API Key 配好，让 OpenClaw 跑起来；其他配置随后再追加。目标是先跑通核心链路，避免一上来就卡在渠道/高级网络等细节上。另一个常见情况：若在 onboard 里急着把渠道等进阶项一次配齐，向导会显得繁琐，且渠道众多、难以在文档里面面俱到，反而容易卡住。因此本页只强调「先把大模型 API Key 配好」，其余以后再补。

重要提醒（必须看）

不要通过手动编辑 ~/.openclaw/openclaw.json 来“硬改配置”。 onboard 不只会改一个 json，还会联动其他状态与关联文件。只手改 json 很容易把环境改坏，导致后续启动或渠道配置异常。

结论：配置请走 openclaw onboard / openclaw configure / Control UI，不要走手改 json。

什么时候需要手动执行 onboard

如果你是通过 curl -fsSL https://openclaw.ai/install.sh | bash 安装的，安装流程通常会在最后直接进入一次 onboard 的快速设置。

你已经完成过一次快速设置：一般不需要再执行 openclaw onboard
你当时跳过了/中途退出了：再手动跑一次 openclaw onboard 即可

Docker 用户不会进入容器的先看这里

特别提醒

不建议通过 NAS 的 Web Shell 进入容器。特别是飞牛等国产 NAS 场景，Web Shell 常见分辨率或终端兼容问题，可能导致二维码无法正常显示。而 QQ / 飞书当前很多快速设置依赖扫码授权，如果二维码显示异常，就会卡在初始化阶段。

建议使用 Windows/macOS/Linux 原生终端，通过 SSH 连接 NAS 后再执行 Docker 命令。

展开查看 Docker 容器定位与命令（按需）

与 OpenClaw 官方 Docker 流程一致时，服务名为：

openclaw-gateway：常驻网关
openclaw-cli：一次性 CLI 任务（docker compose run --rm）

以下命令请在 克隆的 openclaw 仓库根目录 执行（若使用 docker-compose.extra.yml，为 docker compose 加上 -f docker-compose.yml -f docker-compose.extra.yml）。

先确认容器与状态：

docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}" | grep -E "openclaw-gateway|openclaw-cli"
docker compose ps

进入网关容器调试：

docker compose exec openclaw-gateway sh

一次性跑 CLI（例如补做 onboard；若首次已通过 ./docker-setup.sh 完成可跳过）：

docker compose run --rm openclaw-cli onboard

设置大模型 API Key

OpenClaw 跑起来需要一个 API Key，从下面 4 家任选一家即可。每家都提供 Anthropic 兼容接口，龙虾都能直接用。

服务商	特点	计费方式	订阅入口
MiniMax	按 prompt 计费（长指令友好）、有 AI 歌曲创作福利	包月套餐（多档）	订阅入口
火山引擎	模型选择多（豆包 / DeepSeek / Kimi 等任选）、100 万 context	包月套餐（多档）	订阅入口
智谱 GLM	国产编程模型头部、GLM-5 系列专为 coding 优化	多档位套餐	订阅入口
DeepSeek	100 万 context、轻度使用最划算	按 token 计费	充值入口

怎么选计费方式

各家套餐价格和档位会调整，点订阅入口看实时价。按用量选计费方式：

包月套餐（MiniMax / 火山 / GLM）：固定月费 + 调用次数配额，用量越大越划算。每天用、团队多人用——直接走包月。
按 token 计费：用多少付多少。只有 DeepSeek 这家按 token 是划算的，因为 DeepSeek 本身定价就低。其他几家也提供按量计费，但不要选——单价会比包月贵很多，是给"偶尔用一次"的轻度用户准备的兜底选项，不适合 OpenClaw 这种持续高频场景。

简单记：重度用 → 包月；只在 DeepSeek 上才考虑按 token。

在 onboard 向导里，重点只盯住"API Key"这一段，其它能跳过就先跳过。

你会依次看到类似下面这些选择（不同版本文字可能略有差异）：

同意个人默认配置提示
选择模式：QuickStart(快速设置)
选择模型/认证提供商（你用哪家就选哪家）
认证方式：选择 API Key
粘贴 API Key（这一步最关键）
选择默认模型（不确定就先用默认推荐）

以下为首次快速设置时的典型流程示意（不同版本终端文案可能略有差异）：

首次 onboard 设置

拿到 API Key 后，回到 onboard 向导粘贴即可。

进入向导后按这个策略选：

模型与认证：先把大模型 API Key 配好
其他项（渠道、高级网络、额外技能、复杂参数）：能跳过就全部跳过

选择技能（普通用户建议）

如果向导里出现“选择技能”，普通用户只选clawhub就好：去官网搜索安装技能的命令。

理由很简单：你真正需要的技能往往是后面用着用着才知道缺什么；而“会安装技能”是所有扩展能力的入口。把这一个先选上，后面你只要能把命令复制出来跑通，技能体系就能随用随装。

为什么这样做

新手阶段最容易卡死在“想一次配完所有东西”
先保证核心链路可用，再逐步补配置，成功率更高
后续细化配置统一用：

openclaw configure
openclaw dashboard

重启

重启网关

非 Docker

openclaw gateway restart

Docker

docker exec -it openclaw-cli gateway restart