OpenClaw 保姆级安装教程：从 0 到 1 搭建自己的 “大龙虾”

OpenClaw 保姆级安装教程从 0 到 1 搭建自己的“大龙虾”这篇文章写给第一次接触 OpenClaw 的用户。目标很简单不用你先懂一堆底层原理先把 OpenClaw 跑起来再进入控制台最后完成基础可用状态。一、先说人话OpenClaw 到底适合谁如果你正好有下面这些想法这篇教程就适合你想用 Claude Sonnet 4.5 一类的模型做日常开发想要一个 24 小时在线的 AI 助手想通过 Telegram、Discord 这类渠道和 AI 对话不想自己从零研究一整套网关、接入、容器和后台配置很多人不是不会用 AI而是卡在第一步不知道怎么装不知道先装 Docker 还是先装 Node不知道控制台从哪进不知道装完后如何确认自己是不是装成功了这篇文章就只解决一件事把 OpenClaw 先装起来并确认它真的能跑。二、这篇教程采用哪种安装方式OpenClaw 官方有多种安装方式但如果你是第一次安装我建议你优先走Docker 官方安装脚本原因很简单更适合新手环境更隔离后续迁移、备份、重建更方便官方文档对这条路径写得更完整这篇文章默认采用的就是这条路线。上面这张图就是官方 Docker 安装文档页面第一次安装建议优先跟着这条路径走。三、准备工作在开始之前你至少需要准备下面这些东西1. 一台能跑 Docker 的机器推荐Linux 服务器本地 LinuxWSL2macOS如果你是 Windows 用户官方更推荐你通过WSL2来运行。2. 安装 Docker 和 Docker Compose v2你需要确保下面两个东西可用Docker Engine 或 Docker Desktopdocker compose命令你可以先执行docker--versiondockercompose version如果这两个命令都能正常返回版本号说明 Docker 这一层基本就绪。3. 至少 2GB 可用内存官方 Docker 文档提到镜像构建阶段至少建议有2 GB RAM否则某些依赖安装阶段可能因为内存不足直接失败。如果你机器配置太低建议优先用预构建镜像少走弯路。四、正式开始安装第一步拉取 OpenClaw 仓库先执行gitclone https://github.com/openclaw/openclaw.gitcdopenclaw进入项目目录后再执行下一步。如果你不确定仓库有没有找对可以先对照一下官方 GitHub 仓库首页。第二步运行官方 Docker 安装脚本在仓库根目录执行./scripts/docker/setup.sh这一步会做几件关键事情构建或拉取 OpenClaw 镜像引导你完成 onboarding生成网关 token写入.env启动 Docker Compose 服务如果你不想本地构建镜像也可以直接指定官方预构建镜像exportOPENCLAW_IMAGEghcr.io/openclaw/openclaw:latest./scripts/docker/setup.sh对于新手来说如果你只是想先快速跑通我更建议你优先试这个预构建镜像方案。这张图对应的是官方文档里最核心的一段安装流程包括setup.sh、onboarding、控制台入口和渠道配置。五、安装过程中会让你做什么官方脚本运行后通常会进入 onboarding 流程。它会引导你完成一些基础设置比如模型提供商相关配置网关基础配置生成控制台访问 token你可以把它理解成安装脚本不仅是在装程序也是在帮你完成第一次初始化。所以当你看到它开始问配置问题时不要以为报错了那通常是正常流程。六、安装完成后控制台从哪进安装完成后默认可以通过下面地址打开控制台http://127.0.0.1:18789/打开后把安装过程中生成的 token 粘进去即可。如果你忘了控制台地址或者想重新打印一次可以执行dockercompose run--rmopenclaw-cli dashboard --no-open这个命令会输出控制台地址而不是强制帮你打开浏览器。七、怎么确认自己真的装成功了这是很多新手最容易忽略的一步。不要看到“脚本跑完了”就以为一定成功最好自己再做一次验证。方法 1看容器状态dockercomposeps如果核心容器状态正常没有持续重启没有Exited说明大概率已经跑起来了。方法 2看健康检查curl-fsShttp://127.0.0.1:18789/healthzcurl-fsShttp://127.0.0.1:18789/readyz这两个接口是官方文档里给出的健康检查方式healthz看存活readyz看是否准备就绪如果这两个接口都能正常返回说明 OpenClaw 网关基本可用。八、如果你后面还想接 Telegram 或 Discord装好 OpenClaw 只是第一步。如果你后面想真正把它用起来通常还要继续接渠道。官方 Docker 文档里给出的典型命令是Telegramdockercompose run--rmopenclaw-cli channelsadd--channeltelegram--token你的 Telegram Bot TokenDiscorddockercompose run--rmopenclaw-cli channelsadd--channeldiscord--token你的 Discord Bot Token也就是说安装成功 ! 渠道已经接好。安装完成后你还需要根据自己的使用方式继续做渠道绑定。这部分我建议后面单独再写一篇讲得会更清楚。九、新手最常见的几个坑1. Docker 没装好表现docker命令不存在docker compose不能执行权限不够解决思路先别急着怪 OpenClaw先把 Docker 层跑通确保docker --version和docker compose version正常2. 内存太小构建失败表现安装卡住构建中断依赖安装阶段被系统杀掉解决思路换大一点的机器或者直接使用官方预构建镜像3. 控制台打不开常见原因服务没起来端口没有监听你不是在安装机器本机访问排查顺序建议docker compose pscurl http://127.0.0.1:18789/healthz再看端口和网络暴露问题4. VPS 直接暴露控制台到公网这个风险比较高。官方文档明确提到如果你在 VPS 或公网主机上跑应该认真看网络暴露和安全加固说明不要把未经限制的控制面板直接裸奔到公网。这一点很多人会忽略但实际上很关键。十、给第一次安装的人一个建议如果你是第一次接触 OpenClaw我建议你按下面顺序来先把 Docker 安装好先把 OpenClaw 跑起来先确认控制台能打开先确认健康检查通过再去接 Telegram / Discord最后再考虑 Skill、自动化和高阶玩法不要一上来就想着全部一起装完。先跑通再优化。这是最快的路。十一、如果你觉得本地安装太麻烦说实话OpenClaw 自己部署并不算离谱但对于很多人来说麻烦的从来不是“能不能装”而是要不要准备服务器要不要准备域名要不要自己管部署要不要自己处理渠道接入要不要自己承担 token 和后续运维成本如果你只是想快速开始用直接拿到自己的 AI 助手省掉安装、部署、配对、维护这些步骤也可以直接看我这边做的云端版入口购买地址https://opensale.chunlin.lat/如果你想要教程、或者懒得自己折腾安装也可以直接联系我邮箱17671460675163.com微信17671460675十二、下一篇准备写什么如果这篇你觉得有用后面我会继续把这个系列补全至少包括这几个方向OpenClaw 如何对接飞书OpenClaw 的 Skill 怎么安装和使用OpenClaw 的高阶玩法和避坑点如果你想要我把后面几篇也一起整理成可直接发 CSDN 的 Markdown我可以继续往下写。参考资料OpenClaw Docker 官方文档https://docs.openclaw.ai/install/dockerOpenClaw 官方仓库https://github.com/openclaw/openclawOpenClaw 安装说明整理页https://aboutclaw.com/