OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Nix

这页说明书在教你用“Nix”这个神奇的工具来安装和运行OpenClaw。Nix就像一个超级有条理的玩具管理员,能帮你把OpenClaw和它所有的小伙伴(比如语音、音乐工具)都整整齐齐地装好,而且电脑重启了它们也不会乱跑。如果你有一台Mac电脑,并且想让一个叫“Telegram”的聊天机器人一直工作,就可以看看这页。

五岁小孩版解释

这页主要讲怎么用一个叫 nix-openclaw 的特别工具包来安装OpenClaw。这个工具包就像一个大礼盒,里面把OpenClaw和它需要的所有东西都打包好了。

怎么开始呢? 你可以把页面里那段长长的话(就是给Claude或Cursor这些AI助手看的指令)直接复制给你的AI助手,让它帮你一步一步做。这段话里包含了所有要做的事情。

具体要做哪些事呢?

  1. 检查并安装“管理员”:首先,要检查你的电脑里有没有装一个叫“Determinate Nix”的工具。如果没有,AI助手会帮你装上它。你可以把Nix想成一位超级负责的玩具管理员。
  2. 创建一个“配方单”:然后,AI助手会帮你创建一个叫“flake.nix”的文件。这个文件就像一个做蛋糕的配方单,告诉Nix管理员需要准备哪些材料(软件)以及怎么组合它们。这个文件会放在 ~/code/openclaw-local 这个文件夹里。
  3. 准备你的聊天机器人:接下来,你需要去“Telegram”这个聊天软件里,找一个叫 @BotFather 的机器人,让它帮你创建一个属于你自己的新机器人,并拿到一个秘密的“令牌”。还要找另一个叫 @userinfobot 的机器人,问问它你的聊天ID是多少。这就像给你的新玩具起名字、拿钥匙和身份卡。
  4. 保管好秘密:把你刚刚拿到的机器人令牌,还有你用来调用AI模型的API密钥,像藏宝贝一样存到 ~/.secrets/ 文件夹下的普通文件里。记住要保护好它们哦!
  5. 填写配方并开始制作:打开刚才创建的“配方单”(flake.nix文件),把里面需要你填写的地方(比如机器人的令牌、API密钥放哪里了)都填好。然后,运行 home-manager switch 这个命令。这就像把填好的订单交给Nix管理员,它就会按照配方开始安装和设置一切了。
  6. 检查是否成功:最后,检查一下:电脑重启后服务是否还在运行?给你的Telegram机器人发条消息,看它会不会回复你。

完成之后你会得到什么?

  • 一个完整的OpenClaw,连同它的语音、音乐等小工具都装好了。
  • 一个“开机自启动”的服务,电脑重启了它也会自己醒来工作。
  • 一个可以用“配方单”来管理插件和设置的系统。
  • 一个“后悔药”功能:如果新安装的东西有问题,只需运行 home-manager switch --rollback 就能立刻回到之前好好的样子。

一个特别的“Nix模式” 当OpenClaw在Nix管理下运行时,它会自动进入“Nix模式”。这个模式会让所有设置都固定不变,并且不会自己偷偷安装新东西。 如果你在Mac的图形界面软件里使用,可能还需要额外设置一下,告诉软件也进入这个模式。

东西都放在哪里? OpenClaw会从 OPENCLAW_CONFIG_PATH 这个路径读取设置文件,并把运行时产生的一些数据(比如聊天记录)存放在 OPENCLAW_STATE_DIR 这个路径。在Nix模式下,我们最好明确告诉它把这些东西放在Nix管理的地方,这样它们就不会和那些“不可更改”的安装文件混在一起了。

给Mac电脑的特别提醒 在Mac上打包成App时,有一个叫 Info.plist 的文件模板很重要。打包脚本会复制这个模板并修改一些信息,这样即使不用完整的Xcode工具也能完成打包,适合Nix来构建。

最后,要小心和记住

  • 最完整、最准确的安装指南在 nix-openclaw 的GitHub页面,这里只是一个快速介绍。
  • 如果你不想用Nix,也可以去看看“Wizard”或“Docker”的安装方式。