从下载源码到启动服务:手把手教你“养”出第一只可调试的 OpenClaw

2026 年初，GitHub 上横空出世了一只“大龙虾”——OpenClaw。

短短几个月，它成了现象级的开源项目。大家都在说：“这是真正能干活儿的 AI，不是只会聊天的嘴炮。”

很多人已经跟着教程，用 Docker 或者命令行把它跑起来了，体验了一把“让 AI 帮我写代码、整理文件”的快感。

但是，作为一个开发者，你是否想过：

如果我想改改它的逻辑，让它更懂我的习惯，怎么办？

如果我想给它加个新技能（Skill），该怎么下手？

难道每次改代码都要重新打包、重启容器吗？

NO！不要！不要！不要！

真正的玩客，应该把源码拉下来，放进 IDE 里，一边调试，一边魔改。

今天，我就带大家迈出改造大龙虾的第一步：

如何在 WebStorm 中配置并启动 OpenClaw Gateway，实现本地实时调试。

准备好了吗？咱们开始“解剖”这只龙虾！

OpenClaw_IDE配置；(一)环境准备在开始之前，确保你的环境满足以下条件：操作系统：MacOS/Windows11/Ubuntu

Node.js：v22+包管理器：pnpm（必须）Python：3.11+（用于可选Skills，建议创建venv）GitHub源码：https://github.com/openclaw/openclaw

(二)OpenClaw源代码导入WebStorm IDE中，Ide会自动分析OpenClaw的源代码并自动下载各种依赖；(宇宙第一IDE不是吹的！！！)

(三)配置IDE启动服务：1.打开配置界面：点击WebStorm右上角的运行配置下拉框（编辑配置/Add Configuration）；2.新建Node.js配置：点击左上角的+号，选择Node.js。3.右边填写配置详情：

名称(N) : `OpenClaw Gateway`
Node 运行时(R) : `node (C:\Program Files\nodejs\node.exe) 22.20.0` ← 保留默认
TypeScript 加载程序(I) : `无` ← 保留默认
节点参数(O) : *(留空)* 或 `--inspect-brk`（如需调试）
工作目录(W): `$ProjectFileDir$`
文件(E) :`$ProjectFileDir$/scripts/run-node.mjs`
应用程序形参(C) : `gateway`
环境变量(E) : *(点击按钮查看，无需修改)*

4.点击“应用”>"确定",就完成配置了。(四)启动OpenClaw的服务项；1.本地主机调试地址：http://localhost:18789（http://127.0.0.1:18789/）2.打开页面后，需要在终端openclaw>目录下执行“pnpm openclaw dashboard --no-open”命令来获取Token

例如：Dashboard URL: http://127.0.0.1:18789/#token=d57950d6cf306840b7af46b278d3396950bd8394aabf3e62

Copied to clipboard.

Browser launch disabled (--no-open). Use the URL above.

以上的token也可以直接配置到redact-snapshot.test.ts文件中的raw: '{ "gateway": { "auth": { "token": "leaky-secret" } } }', (但作为开发者你怎么可用搞魔法值呢？)。完成以上步骤就可用开始“调试/魔改”大龙虾了。

打个广告（以下的项目作品都是大龙虾完成的！！！）：

极简养车

极简音乐：https://onecar2.cn/music