OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

Setup

这页说明书是教你怎么把 OpenClaw 这个聪明的助手安装和启动起来的。就像你要先给新玩具装上电池才能玩一样，我们需要先把它“搭建”好。这里会告诉你两种方法：一种是像用普通软件一样，直接安装一个稳定的版本；另一种是给喜欢自己动手的小朋友准备的，可以自己启动它的“大脑”部分，这样更新起来更快。

五岁小孩版解释

在开始之前，你需要知道，OpenClaw 会把你的个人设置和记忆放在一个叫 ~/.openclaw/ 的文件夹里，这样你更新软件时，它们就不会被弄丢啦。

首先，我们要做一些准备工作。就像搭积木前要准备好积木块一样，你需要先安装一些东西：

  1. 安装 Node.js：这是一个让很多软件能运行的工具，版本号要大于等于 22。
  2. 安装 pnpm：这是一个帮你管理软件“零件”的小工具。
  3. 安装 Docker：这个是可选的，就像你可以选择用乐高盒子来装积木，但不是必须的。

接下来，我们有两种主要的玩法。

第一种：稳定的玩法（先安装 macOS 软件） 这种方法最简单，就像打开一个普通的游戏 App。

  1. 安装并打开：下载并安装 OpenClaw.app，然后打开它。
  2. 完成设置向导：跟着屏幕上的提示，一步步完成设置，并同意它需要的权限。
  3. 确保“大脑”在运行：在软件里，确保连接模式是 Local，这样软件就会自己启动和管理它的“大脑”（我们叫它 Gateway）。
  4. 连接聊天工具：打开一个叫“终端”的窗口，输入 openclaw channels login，然后按照提示登录你想连接的聊天软件，比如 WhatsApp。
  5. 检查一下：再输入 openclaw health，看看一切是不是都正常工作了。

第二种：前沿的玩法（自己在终端里运行“大脑”） 这种方法适合想自己动手、并且想第一时间用上新功能的小朋友。它的目标是让你可以修改“大脑”的代码，并且一修改就能立刻生效，同时还能使用 macOS 的软件界面。

  1. 启动开发版的“大脑”：在终端里，先进入软件的文件夹，然后依次输入 pnpm install 和 pnpm gateway:watch。gateway:watch 会让“大脑”一直运行，并且当你修改代码后，它会自动重启。
  2. 让 macOS 软件连接上：打开 OpenClaw.app，把连接模式设置成 Local。这样软件就会找到并连接上你刚刚启动的“大脑”了。
  3. 验证一下：看看软件里的 Gateway 状态是不是显示 “Using existing gateway …”，或者在终端里输入 openclaw health 检查。

要小心这些容易出错的地方哦：

  • 端口不对：“大脑”默认在 ws://127.0.0.1:18789 这个地址工作，要确保软件和命令都连到同一个地址。
  • 东西存在哪里：你的账号密码在 ~/.openclaw/credentials/ 文件夹；聊天记录在 ~/.openclaw/agents/<agentId>/sessions/；运行日志在 /tmp/openclaw/。

关于更新： 想更新到新版本时，记住你的个人设置都在 ~/.openclaw/workspace 和 ~/.openclaw/ 文件夹里，不要把它们放到软件的源代码文件夹里。更新时，通常只需要在源代码文件夹里运行 git pull 和 pnpm install 就可以了。

给用 Linux 电脑的小朋友： 在 Linux 上，OpenClaw 会把自己安装成一个“用户服务”。但如果你退出登录，这个服务可能会被关掉。设置向导会尝试帮你解决这个问题（可能会问你要密码）。如果还是不行，可以试试在终端里输入 sudo loginctl enable-linger $USER 这个命令。