在ubuntu24.04上安装openclaw

🦞 在 Ubuntu 24.04 上安装 OpenClaw

第一步：安装 Node.js (≥ 22)

OpenClaw 要求 Node.js 版本 22 或更高。Ubuntu 24.04 默认仓库中的 Node.js 版本可能较旧，因此推荐使用官方 NodeSource 仓库安装。

更新系统包列表：
```
sudo apt update
```

安装必要的依赖：

sudo apt install -y ca-certificates curl gnupg

添加 NodeSource GPG 密钥和仓库（以 Node.js 22.x 为例）：

# 创建目录并授予权限
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

# 添加仓库
NODE_MAJOR=22
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

再次更新包列表并安装 Node.js：

sudo apt update
sudo apt install -y nodejs

验证安装：
```
node --version
npm --version
```
你应该能看到 v22.x.x 或更高的版本号。

第二步：安装 OpenClaw

现在你已经有了合适的 Node.js 环境，可以正式安装 OpenClaw 了。

使用 npm 全局安装 OpenClaw：
```
sudo npm install -g openclaw@latest
```
注意：使用 sudo 是为了全局安装。如果你想避免使用 sudo，可以配置 npm 以在用户目录下全局安装，但这超出了本教程的范围。
验证 OpenClaw 是否安装成功：
```
openclaw --version
```
如果看到版本号，说明安装成功。

第三步：运行 OpenClaw 向导进行初始化

OpenClaw 强烈推荐使用其内置的向导 (onboard) 来完成初始设置，这会引导你配置网关、工作区、通信渠道（如 Telegram, WhatsApp 等）和技能。

启动向导：
```
openclaw onboard --install-daemon
```
- --install-daemon 参数会将 OpenClaw 网关作为 systemd 用户服务安装，确保它能在后台持续运行。
按照向导提示操作：
- 向导会一步步引导你。
- 它会首先让你选择一个 AI 模型提供方（如 OpenAI, Anthropic 等），你需要准备好相应的 API Key。
- 接着会询问你要连接哪些聊天渠道（Channels），例如 Telegram、Discord 等，并指导你如何获取所需的 Bot Token 或进行登录。
- 最后，它会为你创建一个工作区（workspace）并完成所有基础配置。

第四步：启动和使用

启动网关（如果向导没有自动启动）：
```
openclaw gateway --port 18789 --verbose
```
这个命令会启动核心的“网关”服务，它是 OpenClaw 的控制中心。
与你的助手对话：
一旦你通过向导配置好了至少一个渠道（比如 Telegram），你就可以直接在那个应用里给你的机器人发消息了。

你也可以直接通过命令行与助手交互：
```
openclaw agent --message "Hello, what can you do?"
```

发送消息到指定渠道（可选）：

# 例如，发送消息到一个电话号码（需要已配置 WhatsApp）
openclaw message send --to +1234567890 --message "Hello from OpenClaw!"

附加建议

查阅官方文档：向导是最佳起点，但遇到问题时，请务必参考官方文档：https://docs.openclaw.ai
安全检查：配置完成后，运行 openclaw doctor 命令来检查你的配置是否存在安全风险或错误。
更新：未来要更新 OpenClaw，只需重新运行安装命令 sudo npm install -g openclaw@latest，然后运行 openclaw update 和 openclaw doctor。