DP

DepthPilot AI

System-Level Learning

Guided Build

OpenClaw 实操课:跑通、排错、固化成 SOP

这不是泛泛介绍,而是一节按真实脚本、真实命令、真实社区踩坑整理出来的跟做课。目标不是“看懂”,而是把 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

Commands

最快启动

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 搜索词、工作流词和最终项目链路串起来。

Sources

OpenClaw 教程:Live 配置、排错、Skills 与 SOP | DepthPilot AI