OpenClaw 四步从零到跑通：在自家机器上开一个个人 AI 助手
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
仓库克隆下来装了一堆依赖却启动不了，不知道卡在哪一步。这篇按 OpenClaw 的真实工程结构，带你从零装到跑通：它是一个跑在你自己机器上的个人 AI 助手，Gateway 在本地，助手住进你常用的聊天渠道。
一句话定位
- OpenClaw 是个人 AI 助手：模型、工具、消息渠道都通过本地 Gateway 连起来，数据在自己设备上。
- 适合想在自有环境里跑助手的人，CLI、浏览器面板、手机节点共用同一个 Gateway。
- 核心价值：渠道、模型、技能插件全部可换，不绑定单一入口。
快速上手：四步跑通
前提只有一个：Node 22.22.3+、24.15+ 或 25.9+。
1. 检查环境
node --version pnpm --version会看到当前 Node 与 pnpm 版本。没有 pnpm 时先执行npm install -g pnpm@11.15.1。
2. 获取代码并装依赖
git clone https://gitcode.com/GitHub_Trending/cl/clawdbot cd clawdbot pnpm install装完生成node_modules。注意：仓库是 pnpm workspace，根目录直接跑npm install不受支持。
3. 构建 CLI 与面板
pnpm build pnpm ui:build两条命令都走完后，dist/下出现运行时产物，第二条产出 Control UI 网页面板资源。
4. 首次启动与引导
node openclaw.mjs onboard --install-daemon向导会引导你选模型提供方、填 API key，并注册常驻服务。完成后验证：
node openclaw.mjs gateway status应看到 Gateway 正监听 18789 端口。
分平台差异：桌面和移动各差在哪
| 平台 | 与主线的不同 |
|---|---|
| macOS / Linux | 主线原样可用；Linux 常驻服务是 systemd 用户服务，见下方踩坑 |
| Windows | 在 WSL2 里照主线跑即可；另有官方 Windows Hub 应用可走图形化安装，文档在docs/platforms/windows.md |
| iOS | 设备不跑 Gateway，App 是伴随节点：装好后扫码配对你的 Gateway |
| Android | 同 iOS，属于伴随节点；可从官方 Release 下载 APK 侧载，流程见docs/platforms/android.md |
移动节点配对入口：node openclaw.mjs dashboard打开面板后，进 Nodes → Devices → Pair device，生成 setup code，在 App 的 Settings → Gateway 里扫码连接。
上手后的第一件事 🦞
打开面板，发第一条消息
node openclaw.mjs dashboard浏览器自动打开 Control UI，在聊天框输入一句话，几秒后收到 AI 回复，说明模型链路已通。
把助手接进消息渠道
用node openclaw.mjs configure选一个渠道（Telegram 只需一个 bot token，最省事），按 docs/channels/ 的说明填凭据。之后在聊天软件里直接 @ 助手即可。命令行一侧，node openclaw.mjs gateway status、node openclaw.mjs configure等子命令覆盖了日常操作。
踩坑清单
- 现象：
npm install后缺依赖或启动报错 → 原因：仓库只支持 pnpm workspace → 解法：改用pnpm install重装。 - 现象：启动即报 Node 版本不满足 → 原因：版本低于 22.22.3 → 解法：升级 Node 24 LTS 后重跑第 3 步。
- 现象：手机 App 连不上 Gateway → 原因：默认只监听回环地址，手机不可达 → 解法：局域网内用
--bind lan启动，或走 Tailscale Serve。 - 现象：Linux 登出后 Gateway 被杀 → 原因：systemd 用户服务默认不 lingering → 解法：
sudo loginctl enable-linger $USER。 - 现象：onboarding 卡在模型配置 → 原因：API key 未填 → 解法：拿好 key 重跑
node openclaw.mjs configure。
收尾
渠道与模型的完整配置从 docs/start/getting-started.md 往下读；要改代码或加插件，先看 CONTRIBUTING.md 再提 PR。
【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
