Setup

先讲这一页到底在解决什么

第一次用 OpenClaw？先跑这条命令

`openclaw setup` 会初始化配置文件 `~/.openclaw/openclaw.json` 和 agent 工作目录。不加任何选项只是初始化，带上 `--wizard` 才会进入完整的引导流程。最易错的是以为直接运行就能完成所有配置——实际上引导需要显式指定 `--wizard` 或 `--non-interactive` 等选项。

原文共 6 节，先看 Start Here 路径：/cli/setup 查看官方原文

第一站

🏠 先看它会做的两件事：放好配置，再摆好工作区

官方第一句就把重点说了：它会初始化配置文件和 agent workspace。翻成人话就是，先把房子和院子都搭出来。

1

`~/.openclaw/openclaw.json`

像家里的总账本。以后很多规则都从这里读。

2

agent workspace

像给小工人们安排好的工作间。桌子、抽屉、工具都要先有地方放。

3

先打底再干活

如果地基没打好，后面再厉害的功能也容易站不稳。

📌

一句话先记住

setup 是先把家安好，不是直接开派对。

第二站

🚀 两个最常见的命令，其实就是“先默认铺好”，和“把院子放到别处”

官方给的例子很短，但很实用。

openclaw setup

像按默认方案把新家收拾好。门、桌子、账本都按标准来。

openclaw setup --workspace ~/.openclaw/workspace

像告诉它：“院子别摆在默认位置，搬到这块地上。”

默认路径

没特别说明时，它会按习惯把东西放到标准位置，方便后续命令接着用。

🎈 一句话

一个是按默认装修，一个是自己指定院子在哪。

第三站

🪄 `--wizard` 像“把施工队喊来，边问边搭”

官方把 `setup --wizard` 单独提出来，因为有些人不想自己脑补每一步，想要一位会带路的向导。

🧙

`openclaw setup --wizard`

像请一位领路人，一边问你，一边把配置和工作区搭出来。

🚶

比自己硬记更稳

向导会带着你走，不用你一上来就背所有门牌号。

🧪

更像第一次入住

它适合第一次上手时，顺手把关键选项都问一遍。

📌

一句话

wizard 就是把 setup 变成有向导的入住流程。

第四站

🧳 为什么这一步重要？因为后面的好几个页面都默认你已经把家安好了

你如果跳过 setup，后面 `status`、`gateway`、`tui` 这些命令会像在没铺地板的屋子里走路，容易踩空。

配置先落地

后面所有命令才能知道去哪找家当。

工作区先有

agent 的抽屉和工作台才有地方安放。

后续更顺

很多排障、登录、浏览器、Gateway 的操作都能接着往下走。

🎈 一句话

setup 做的是地基，后面的命令才是家具和日常生活。

第五站

🔗 这页和 `getting started` / `onboard` 的关系，像“先备材料，再正式入宅”

官方把 related docs 写得很清楚。`setup` 不是唯一入口，但它是最底层的那一步。

📚

`Getting started`

像带你看一整张入门地图。

🧭

`onboard`

像正式带你走一遍入住流程，问你要不要装服务、要不要继续下一步。

🧱

`setup`

像先搬砖铺地基，把最基础的东西摆稳。

📌

关系很简单

getting started 讲方向，onboard 讲流程，setup 讲打底。

最后总结

🎈 把 `openclaw setup` 压成一句话

openclaw setup 就是先把 OpenClaw 的新家收拾好：配置文件放稳，工作区摆好，再决定要不要让向导陪你一步一步入住。

如果你下一页只想继续看一页，我建议看 /cli/onboard。因为 setup 把地基铺好以后，onboard 就是正式带你进门的那一步。