1
先完成自动识别
第一次打开小龙虾启动器时，先到设置页确认 OpenClaw 启动入口和默认数据目录。上游仓库把这一步作为启动和切换 profile 的前提。
新手教程
小龙虾启动器使用教程
这份教程按当前上游仓库能力整理，重点不是教你“点哪个按钮”，而是帮你先理解小龙虾启动器怎么识别 OpenClaw、怎么管理 profile、怎么安全导入导出 `.claw`，以及分享前应该检查什么。
2
分清两类 profile
默认本地 profile 对应你机器当前的 OpenClaw 数据目录；导入 profile 则是从 `.claw` 包导入到启动器管理目录中的独立副本。先理解这个区别，后面的导入导出才不容易混淆。
3
把导入导出当成迁移流程
`.claw` 更适合做迁移、备份和分发，不建议把它当成无脑复制按钮。分享前最好在干净位置复导一次，确认没有残留敏感信息。
第一次使用，按这个顺序最稳
先把识别和运行环境确认好，再做 profile 导入导出，后面会少很多误判。
- 1进入“设置”页，先使用自动识别确认 OpenClaw 启动入口和默认数据目录。
- 2如果自动识别结果不对，再手动选择实际可用的可执行文件和数据目录。
- 3保存设置后，回到首页启动当前 profile，并确认运行状态已经正常。
- 4需要切换 profile 时，先分清你要启动的是默认本地 profile 还是导入 profile。
- 5启动成功后，再去聊天、通知、文档和 profile 检查相关页面继续操作。
- 6如果你准备导入别人分享的 `.claw` 包，先确认来源，再让启动器完成完整性校验。
各区域分别适合做什么
下面按上游 README 已确认的能力整理，避免把教程写成某个版本特有的界面说明。
首页 / 启动
用于启动当前选中的 profile，并观察最近启动与运行状态。
- 启动当前 profile 并维持运行时状态
- 切换到另一个已管理的 profile 后再启动
- 快速打开当前 profile 的控制页或命令行入口
- 查看最近启动记录，方便确认自己到底跑的是哪一个 profile
Profile 管理
用于统一管理默认本地 profile 和导入 profile。
- 识别默认本地 profile，并与导入 profile 放在同一处管理
- 导入 `.claw` 包到启动器管理目录
- 重命名或删除导入 profile
- 导出 profile，并按需决定是否包含记忆、历史会话或账号相关数据
聊天与运行时
给当前 profile 提供轻量聊天入口，并反映运行时健康状态。
- 确认当前聊天连接的是哪个 profile
- 查看本地 gateway / runtime 状态是否健康
- 在不手动翻目录的情况下继续和当前 profile 对话
- 出现连接异常时先回到设置与运行状态排查
通知与会话
用于检查当前 profile 的通知和历史对话线索。
- 查看通知内容和最近状态变化
- 检查会话记录，确认导入后的 profile 是否包含预期数据
- 辅助判断某个 profile 最近是否真的被运行过
- 帮助你在分享前确认是否留下不该外发的历史内容
文档与内容检查
用于浏览 profile 内的重要文件，而不是盲目打开文件夹。
- 查看 `README.md` 与 workspace 文件
- 检查 `workspace/skills/*/SKILL.md` 中的技能内容
- 查看 `cron/jobs.json` 中的定时任务定义
- 在导出前先确认文档、技能和任务里没有敏感信息
设置
决定启动器能不能正确识别、启动和维护本地 OpenClaw 运行环境。
- 自动识别或手动指定 OpenClaw 启动入口
- 确认默认数据目录与导入存储目录
- 检查健康探针、连接地址和运行时相关配置
- 需要时设置退出启动器后是否一并停止已启动的 profile
`.claw` 导入导出怎么做
`.claw` 适合迁移、备份和分享，但前提是把校验和复查流程做完整。
导入流程
- 1进入 profile 管理页，选择导入 `.claw` 包。
- 2挑选来源可信的 `.claw` 文件，并等待启动器完成校验。
- 3确认根目录 `manifest.json`、文件列表、大小和 SHA-256 都通过检查。
- 4为导入后的 profile 设定一个清楚的名称，避免和默认本地 profile 混淆。
- 5导入完成后先浏览文档、技能、任务和会话，再决定是否真正启动它。
导出流程
- 1在 profile 管理页选中要导出的 profile。
- 2根据用途决定是否包含记忆、历史会话、账号或设备相关数据。
- 3如果只是分享配置思路，优先保持导出选项保守，不要默认全带。
- 4导出后把包重新导入到干净位置，复查内容无误后再对外发布。
- 5给最终分发版本写清说明，告诉下载者适用场景、依赖和注意事项。
导入导出时要注意
这部分最容易踩到安全和隐私问题。
- `.claw` 是带根目录 `manifest.json` 的 ZIP 包，导入失败或完整性异常时，不要跳过检查继续使用。
- 导出默认值之所以保守，是为了减少记忆、账号、历史会话和设备痕迹的意外泄露。
- 即使关闭了敏感选项，自定义技能、脚本、文档或第三方工具仍可能留下秘密信息，所以分享前必须人工复查。
- 最稳妥的发布流程是“导出一次、干净导入复查一次、再重新导出分发版”。
常见排查
先按这些点检查，通常能快速定位问题是在包、目录还是运行时。
无法启动 profile
先检查设置里的 OpenClaw 启动入口和默认数据目录是否正确，再确认当前选中的 profile 目录仍然存在。默认本地 profile 与导入 profile 的目录来源不同，排查时不要混为一谈。
聊天或运行状态显示异常
上游仓库明确提到启动器会轮询健康端点并反映运行状态。先确认当前 profile 已启动，再检查连接地址、健康检查配置，以及本地 runtime 是否真的被拉起。
导入 `.claw` 失败
常见原因是 `manifest.json` 缺失、格式版本不受支持、文件列表不一致、文件大小不匹配，或 SHA-256 校验失败。这类报错优先判断包本身是否被改动或损坏。
为什么明明能导出，还是不建议直接分享？
因为导出功能只能按已知规则排除一部分敏感数据，无法替你理解 profile 里所有自定义文件的含义。只要打算公开分发，就应该先在干净位置重新导入并检查一遍。