新手教程

OpenClaw 启动器使用教程

这份教程写给第一次使用启动器的人。你只需要先完成基础设置,再按页面用途去操作,就可以完成启动、导入、导出、聊天和日常管理。

1

打开“设置”

第一次使用时,先不要急着点启动。先进入设置页面,把启动入口和本地目录确认好。

2

确认两个关键路径

重点检查 `OpenClaw 启动入口` 和 `默认本地龙虾目录`。如果你不确定路径在哪里,先点“自动识别”。

3

保存设置后再启动

只有这两个路径是正确的,启动器才能正常启动龙虾、打开聊天和控制网页。

第一次使用,照着这几步做

如果你刚安装好启动器,先按这个顺序操作,最省事。

  1. 1进入“设置”页,点击“自动识别”。
  2. 2确认识别出来的启动入口和默认本地龙虾目录是否正确。
  3. 3如果自动识别不对,再手动选择可执行文件和本地目录。
  4. 4点击“保存设置”。
  5. 5回到“首页”,点击“启动龙虾”。
  6. 6启动成功后,再去“聊天”“通知”“文档”等页面继续使用。

每个页面是干什么的

左侧导航一共有 6 个页面,下面按用途快速介绍。

首页

适合日常快速启动。

  • 启动当前选中的龙虾
  • 切换到另一只龙虾
  • 打开当前龙虾的控制网页
  • 查看最近一次启动时间

龙虾

这是整个启动器的管理中心。

  • 查看默认本地龙虾和所有已导入龙虾
  • 按名称或路径搜索龙虾
  • 查看目录、来源、创建时间和最近启动时间
  • 导入 `.claw` 包或导出当前龙虾
  • 浏览设定文档、技能、定时任务、记忆和账号信息

聊天

用来继续和当前龙虾对话。

  • 查看当前使用的是哪只龙虾
  • 确认连接服务状态是否正常
  • 新建、重命名或删除对话
  • 继续发送消息并查看历史记录

通知

看龙虾主动发来的消息。

  • 查看定时任务通知
  • 查看 Heartbeat 提醒和状态更新
  • 页面最多保留最新 100 条通知

文档

查看和编辑当前龙虾目录下的 `README.md`。

  • 刷新文档内容
  • 直接编辑和保存 README
  • 如果没有 README,保存时会自动创建

设置

决定启动器能不能正常工作。

  • 确认启动入口和默认本地龙虾目录
  • 配置导入龙虾的保存位置
  • 检查连接地址和健康检查路径
  • 只有默认配置不工作时,再调整高级设置

导入和导出 `.claw` 怎么做

导入适合迁移或安装别人分享的龙虾,导出适合备份或发给别人。

导入步骤

  1. 1进入“龙虾”页,点击“导入龙虾包”。
  2. 2选择一个 `.claw` 文件。
  3. 3等待启动器完成完整性校验。
  4. 4输入导入后的龙虾名称。
  5. 5导入完成后,在列表里选中它并启动。

导出步骤

  1. 1进入“龙虾”页,选中要导出的龙虾。
  2. 2点击“导出龙虾包”。
  3. 3设置包名和导出位置。
  4. 4如果不是很确定,保持“导出记忆和历史会话”“导出账号和设备信息”这两个选项关闭。
  5. 5确认导出后,启动器会生成一个 `.claw` 文件。

导入导出时要注意

这部分最容易碰到安全和隐私问题。

  • 导入 `.claw` 包时,如果启动器提示包可能被篡改,默认不要继续导入。
  • 导出时,除非你明确知道自己在做什么,否则不要开启记忆、历史会话、账号和设备信息导出。
  • 删除导入的龙虾后无法恢复,删除前先确认不再需要。
  • 默认本地龙虾代表你本机正在使用的数据目录,不建议随意修改。

常见问题

遇到问题时,先看这几个排查点。

无法启动龙虾

先检查设置里的启动入口是否正确、入口文件是否还存在,以及默认本地龙虾目录或导入龙虾目录是否存在。

聊天页显示“未连上”

先确认这只龙虾是否已经成功启动,再检查设置里的连接地址和健康检查路径;必要时到高级设置里手动启动连接服务。

导入失败

先确认文件是不是 `.claw`,压缩包有没有损坏,或者是不是没有通过完整性校验。

文档页看不到 README

这通常表示当前龙虾目录下还没有 `README.md`。你可以直接在文档页点击“编辑”并保存,启动器会创建它。