#本地开发环境搭建

官方文档说了什么，以及没说什么。

#官方步骤（来自 CONTRIBUTING.md）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

带自动重载的开发循环：

pnpm gateway:watch

#环境要求

• Node.js 22+（必须，不是可选）
• pnpm（从源码构建时推荐使用；npm 仅适用于全局安装）

#非官方笔记

本节会随着我遇到的实际问题而增长。空白小节意味着"目前还没碰到问题"。

#操作系统特有的坑

#常见 pnpm install 问题

#构建失败

#开发工作流技巧

#PR 惯例（观察到的，非文档化的）

• PR 应针对单个 issue 或主题
• 超过 5,000 行变更的 PR 仅在特殊情况下才会被 review
• AI/vibe-coded PR 明确欢迎（README 中有说明）

#新手友好的模块

#CI 流水线笔记