Ansible

这页说明书教你用“Ansible”这个自动安装工具来安装OpenClaw。你可以把它想成一个会自己搭积木的机器人，你只要告诉它“开始吧”，它就会帮你把软件安全地装好。

你需要准备什么？ 就像画画需要纸和笔一样，安装前你的电脑需要满足几个条件：

1. 电脑系统：需要是Debian 11或者Ubuntu 20.04以上的版本。
2. 管理员权限：你需要有“root”或者“sudo”权限，就像拿到打开所有房间的钥匙。
3. 网络：电脑要能连上互联网，这样机器人才能去拿需要的积木块。
4. Ansible版本：需要2.14或更高版本，不过用快速安装方法的话，它会自己装好。

怎么快速安装？ 最快的方法就是告诉电脑一句话。你打开电脑的“终端”（一个可以打字下命令的窗口），把下面这行字完整地打进去，然后按回车： curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash 电脑就会自动开始工作啦！这行命令就像念一句咒语，让电脑从网上把安装机器人请下来。

安装时会发生什么？ 机器人会帮你做很多事，它会安装和设置：

1. Tailscale：这是一个安全的秘密通道，只有你自己能通过它访问软件，别人从外面看不到。
2. UFW防火墙：像一个守门员，只让SSH（管理通道）和Tailscale进来，把其他人都挡在外面。
3. Docker：像很多个透明的小盒子，把软件里不同的小工具隔开放，这样更安全。
4. Node.js和pnpm：这是软件运行需要的一些小帮手。
5. OpenClaw软件本身：它会直接装在电脑上，而不是小盒子里。
6. Systemd服务：让软件在电脑开机时能自己启动。

安装完后要做什么？ 安装成功后，你需要“变成”专门运行这个软件的用户。在终端里输入： sudo -i -u openclaw 然后按回车。这就像你戴上了一顶“openclaw”的魔法帽子。戴上帽子后，电脑会带你完成几个简单的设置步骤，比如连接你的聊天软件（像WhatsApp、Telegram）和设置好那个秘密通道（Tailscale）。

一些有用的魔法口令 安装好后，你可以用这些口令来查看或管理软件：

• 看看软件是不是在好好工作：sudo systemctl status openclaw
• 看看软件最近在“说”什么（日志）：sudo journalctl -u openclaw -f
• 让软件重新启动一下：sudo systemctl restart openclaw
• 要连接聊天软件时，记得先戴上“openclaw”帽子（用上面的sudo -i -u openclaw命令），然后再用：openclaw channels login

要小心的事情和限制

• 这个安装方法是为了让软件非常安全。所以装好后，从外面只能通过SSH（端口22）管理电脑，而OpenClaw软件本身只能通过Tailscale这个秘密通道访问。如果你从外面连不上，这是正常的，不是坏了。
• 软件的主程序是直接装在电脑上的，但里面那些小工具（Agents）是放在Docker小盒子里的。
• 如果你想更仔细地控制安装每一步，说明书后面也讲了“手动安装”的方法，但步骤会多一些。

如果遇到问题怎么办？ 说明书最后列出了一些常见问题和解决办法。比如，如果软件启动不了，可以按它教你的方法去检查“日志”，就像看看软件的“日记本”里写了什么错误。记得，很多操作（比如连接聊天软件）都需要你先戴上“openclaw”那顶帽子才能做哦。