P0 教程
龙虾安装教程
先把龙虾安装起来，再决定后面接什么。
龙虾安装是大多数中文用户进入 OpenClaw 之后的第一道真正门槛。很多资料默认你已经知道环境依赖、下载入口和首次启动逻辑，但实际最常见的情况是：用户只知道“我想先装起来试试”，却不知道该准备哪些条件，也不知道装完之后怎么判断是不是成功。
这份安装教程会按中文用户常见的理解顺序来写：先准备条件，再下载与安装，然后完成首次启动与验证，最后把最常见的报错单独列出来。你不需要先读完所有生态介绍，只要一步一步跟着做，就能知道自己是卡在环境、权限、网络，还是版本兼容上。
适合人群
第一次安装
完成目标
首次启动 + 验证
后续页面
部署 / 飞书 / 中文
这页只负责从下载到最小验证，不讨论长期部署和高级接入。
开始前先确认四件事
确认你的操作系统版本和基础依赖满足要求，不要在完全未知的环境里盲装。
有些环境下安装需要管理员权限或额外授权，先确认能否写入配置和日志目录。
首次下载、依赖拉取或启动验证可能受网络环境影响，失败时先排这个前提。
如果你后面要接飞书或本地模型，建议现在就记下配置目录与日志位置。
开始前先确认四件事
龙虾安装四步走
只要能完成这四步，你就已经跑通了第一轮可用路径。
找到正确的下载入口
优先从资源导航页核对官网、GitHub 或文档入口，再进行下载，减少装到过期镜像或非官方打包版本的风险。
完成安装
按照系统提示执行安装流程，并确认文件是否写入正确位置、是否需要补齐权限，以及是否生成了必要的初始配置。
首次启动
第一次启动时先观察是否有报错窗口、日志输出或长时间无响应。如果这一步失败，说明问题还在基础层。
验证安装是否成功
至少做一次最小验证：确认程序能打开、基础界面可用、配置目录可访问、日志能正常写入。
安装完成后建议先记下这些信息
安装来源
避免第三方未知打包
优先使用官方入口或已验证仓库，后续排障时先确保来源可信。
配置目录
后续教程都会引用
确认目录可读、可写、易定位，后面设置中文和接模型都会用到它。
日志位置
排障核心
先确认能找到并查看日志，这会直接决定你排障时能不能快速定位问题。
启动方式
方便部署复盘
记录第一次成功启动的方式，后面转到部署页时更容易复现。
版本信息
兼容排查
安装后立即记录版本，后面遇到兼容问题时能更快判断是否与版本有关。