OC
OpenClaw 中文解释版

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

简要总结

Fly.io

这页说明书是教你如何在一个叫 Fly.io 的“云积木”平台上，搭建一个叫 OpenClaw 的智能小助手。就像在乐高底座上搭一个会说话的机器人一样！你需要准备一些“钥匙”（比如账号和密码），然后跟着步骤，一步步把机器人放上去，接上电源，它就能在 Discord 里和你聊天啦。如果你想让你的机器人更安全，藏在云里不让别人发现，后面也讲了“隐身”的方法。

五岁小孩版解释

我们要在 Fly.io 这个平台上，搭一个 OpenClaw 智能网关。你可以把它想成一个会说话的机器人总部，它需要一块能永久记住事情的“大脑”（持久存储），还要能自动上锁（HTTPS），并且能连接到 Discord 这样的聊天室。

你需要先准备好这些“工具和材料”：

  1. 一个叫 flyctl 的命令行工具，就像遥控器。
  2. 一个 Fly.io 的账号（免费的就够用啦）。
  3. 给机器人“大脑”用的钥匙：比如 Anthropic 或 OpenAI 的 API Key。
  4. 连接聊天室的密码：比如 Discord 机器人的 Token。

现在，我们开始搭积木吧！

第一步：创建 Fly 应用和“记忆大脑” 这一步就像申请一块地皮，并放上一个保险箱。

  1. 先把 OpenClaw 的“图纸”（代码仓库）下载到你的电脑上。用命令 git clone ... 和 cd openclaw。
  2. 在 Fly.io 上创建一个新应用，给它起个名字，比如 my-openclaw。命令是 fly apps create my-openclaw。
  3. 创建一个“记忆大脑”（持久卷），用来存放机器人的记忆和设置。1GB 大小通常就够用了。命令是 fly volumes create openclaw_data --size 1 --region iad。记得选一个离你近的“区域”，比如 iad（美国弗吉尼亚）。

第二步：调整配置文件 (fly.toml) 这一步是告诉平台，我们的机器人要怎么运行。 你需要打开 fly.toml 文件，把里面的 app = “my-openclaw” 改成你刚才起的名字。这个文件里有很多重要设置：

  • --bind lan：告诉机器人要在“家里”（局域网）接电话，这样平台才能找到它。
  • --allow-unconfigured：允许机器人先不穿“衣服”（配置文件）就启动，我们稍后再给它穿。
  • internal_port = 3000：机器人会在 3000 号“房间”里工作，这个号码必须和后面命令里的 --port 3000 一样。
  • memory = “2048mb”：给机器人 2GB 的“力气”（内存），512MB 太小了，它会累趴下的。
  • OPENCLAW_STATE_DIR = “/data”：告诉机器人，把它的记忆都存到我们第一步创建的“记忆大脑”（/data 目录）里。

第三步：设置秘密“钥匙” 这一步是把各种密码和钥匙偷偷交给机器人，不能让别人看见。 我们要用 fly secrets set 命令来设置，就像说悄悄话一样。一定要设置的钥匙是 OPENCLAW_GATEWAY_TOKEN，这是一把保护机器人的总钥匙。其他钥匙比如 ANTHROPIC_API_KEY（给机器人“大脑”供电的钥匙）、DISCORD_BOT_TOKEN（连接 Discord 的钥匙）也都要这样设置。记住： 这些钥匙要像你的密码一样保护好，最好都用这种“悄悄话”方式设置，不要写在普通的配置文件里。

第四步：发布机器人 一切准备好后，就用 fly deploy 这个命令，把我们的机器人“发射”到云上去！第一次会慢一点（2-3分钟），因为它要“造身体”（构建 Docker 镜像）。发布后，可以用 fly status 和 fly logs 看看机器人是不是健康、有没有在说话。

第五步：给机器人穿上“衣服”（配置文件） 机器人现在光着身子呢，我们要进去告诉它具体怎么工作。

  1. 用 fly ssh console 命令，“钻进”云上的机器人身体里。
  2. 在里面，创建一个配置文件：cat > /data/openclaw.json，然后把一大段配置“衣服”的代码贴进去。这段代码告诉机器人用哪个“大脑”（模型）、连接哪个 Discord 服务器和频道。注意： 如果你已经在第三步用“悄悄话”设置了 DISCORD_BOT_TOKEN，这里就不用再写了。
  3. 做完后，输入 exit 退出来，然后用 fly machine restart 重启一下机器人，让它穿上新衣服。

第六步：和你的机器人见面 机器人启动后，你可以：

  • 在浏览器里用 fly open 打开控制面板，输入第三步设置的总钥匙 (OPENCLAW_GATEWAY_TOKEN) 就能进去管理它。
  • 用 fly logs 看它正在说什么悄悄话。
  • 用 fly ssh console 再次“钻进”它的身体里看看。

如果机器人出问题了怎么办？（故障排除）

  • 机器人不接电话？ 可能是它把自己锁在 127.0.0.1 这个小房间里了。去 fly.toml 文件里，确保启动命令有 --bind lan。
  • 机器人没力气，老重启？ 可能是“力气”（内存）不够。去 fly.toml 里把 memory 改成 “2048mb”（2GB）。
  • 机器人说“已经有一个我在跑了”？ 可能是上次的“锁文件”没解开。用 fly ssh console 进去，执行 rm -f /data/gateway.*.lock 命令删除锁，再重启。
  • 机器人不读新“衣服”？ 用 fly ssh console 进去，用 cat /data/openclaw.json 看看“衣服”在不在。记得重启哦。

想让机器人“隐身”吗？（私有部署） 默认情况下，你的机器人有个公开地址，谁都能试着敲门。如果你只想自己用，可以：

  1. 用 fly.private.toml 这个“隐身”配置文件来发布：fly deploy -c fly.private.toml。
  2. 发布后，就没有公开网址了。你想见它，需要在电脑上开一个“秘密通道”：fly proxy 3000:3000，然后在浏览器访问 http://localhost:3000。

最后的小提醒：

  • Fly.io 用的是 x86 的“心脏”（架构），不是苹果电脑用的那种 ARM。
  • 机器人所有的记忆都放在 /data 这个“记忆大脑”里。
  • 按照推荐配置（2GB 内存），一个月大概花费 10-15 美元，免费额度也有一些哦。