乐于分享
好东西不私藏

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

从下载源码到启动服务:手把手教你“养”出第一只可调试的 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.右边填写配置详情:
  1. 名称(N) : `OpenClaw Gateway`
  2. Node 运行时(R) : `node (C:\Program Files\nodejs\node.exe) 22.20.0` ← 保留默认
  3. TypeScript 加载程序(I) : `无` ← 保留默认
  4. 节点参数(O) : *(留空)* 或 `--inspect-brk`(如需调试)
  5. 工作目录(W): `$ProjectFileDir$`
  6. 文件(E) :`$ProjectFileDir$/scripts/run-node.mjs`
  7. 应用程序形参(C) : `gateway`
  8. 环境变量(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