最终结果
你应拿到一个 live 模式前端、一个可访问的本地 bridge,以及一套可复用的日常运维 SOP。
Guided Build
这不是泛泛介绍,而是一节按真实脚本、真实命令、真实社区踩坑整理出来的跟做课。目标不是“看懂”,而是把 OpenClaw 跑起来,把排错顺序固化下来,再把重复动作写成 skills。
你应拿到一个 live 模式前端、一个可访问的本地 bridge,以及一套可复用的日常运维 SOP。
`.env.local` 必须切到 live,bridge `/health` 要通,前端要能跑,而且你能解释当前连接的是哪种模式。
本页基于本机 OpenClaw 脚本、官方文档和近期社区高频问题整理,不是凭空编步骤。
确认你有真实 OpenClaw 项目副本,并能运行 `npm install` 与 `npm run dev`。
如果要走 SSH attach,先确认本机有 Python 3,因为脚本会用它建立 tunnel。
如果只做本地 attach,先确认 `openclaw` CLI 在 PATH 中可用。
首选 `npm run dev:live` 跑通整条链路。
如果要排错,拆成 `npm run openclaw:attach` 和 `npm run dev` 分步执行。
先确认 `.env.local` 被 attach 改写,再谈插件和远程网关。
先跑 `openclaw doctor`,再跑 `openclaw onboard` 或 `openclaw configure`。
配置完成后立刻做 `channels status --probe`,不要只看 UI。
每次安装插件后都重启 Gateway,再验证 pairing 和 channel readiness。
刚起步时先不要装一堆社区插件,先把核心链路跑通。
需要搜索时优先补 `web_search`,很多“不会查资料”的问题其实是 provider 没配。
需要长期记忆时再考虑 memory 插件,不要一开始就把复杂度拉满。
`openclaw` CLI 不在 PATH,attach 一开始就会失败。
SSH attach 但本机没有 Python 3,tunnel 建立阶段直接挂掉。
bridge 端口被占用或 `.env.local` 没切到 live,看起来像前端坏了,实际上是配置没落地。
`plugin not available` 常见原因是插件装了但 Gateway 没重启。
`pairing required` 先查 pairing 存储和 allowlist,不要先怀疑模型。
Quick Start
最快启动
npm run dev:live一条命令串起 attach、bridge 和前端开发服务器,适合第一次跑通。
分步排错
npm run openclaw:attach
npm run dev先确认环境变量被写入,再单独起前端,更容易定位问题。
远程 Gateway
npm run dev:live -- --url wss://YOUR_GATEWAY/ws --token YOUR_TOKEN --name "Prod Gateway" --id gw-prod适合网关跑在其他机器上时使用。
这节课要交什么
1 张前端成功运行截图
1 次 `bridge /health` 验证记录
1 份最小排错复盘
1 个可复用的 skill 或 SOP 草稿
学完之后你应该掌握什么
你不只是会打一遍命令,而是知道 attach 改了什么、bridge 在做什么、为什么会出现 pairing required、插件该什么时候装,以及哪些重复动作应该被沉淀成 skill。
Search Cluster
这节课不是孤立教程,它应该和 OpenClaw 搜索词、工作流词和最终项目链路串起来。
OpenClaw Tutorial
这个入口页直接对齐 OpenClaw tutorial 搜索意图,帮用户先理解自己会拿到什么,再进入正式跟做课、skills 页和项目路径。
打开路径AI Workflow Automation Course
用户搜 AI workflow automation course,很多时候想找的是能真正跑起来的自动化路径,而不是一堆零散工具演示。DepthPilot 把它接到系统设计、权限和项目交付上。
打开路径AI Workflow Course
如果用户搜的是“AI workflow course”,他真正需要的不是再看一次模型介绍,而是学会把 AI 接进真实工作流、工具链、权限和交付标准。
打开路径