Linux/Mac安装OpenClaw

前置条件：系统要求

• Node.js >=22 (推荐使用nvm或fnm管理Node版本)
• 支持的操作系统：
  • macOS (10.15 Catalina及以上)
  • Linux主流发行版(Ubuntu 20.04+, CentOS 8+, Debian 10+等)
  • Windows需通过WSL2(Windows Subsystem for Linux 2)运行
• 可选依赖：
  • pnpm (仅在从源代码构建时需要，可通过npm install -g pnpm安装)

详细安装步骤

1. 执行安装命令

在终端中运行以下命令进行一键安装：

curl -fsSL https://openclaw.ai/install.sh | bash

该命令会：

1. 下载最新安装脚本
2. 检查系统环境
3. 自动安装必要依赖
4. 配置基础环境

2. 选择安装模式

系统提供两种安装方式：

• 快速安装(推荐)：自动配置默认选项
• 自定义安装：手动选择各个组件和配置

3. 模型配置

可选择跳过初始模型配置，后续通过onboard命令补充：

• 支持的AI模型：GPT-4、Claude、千问等
• 需要提供对应API Key
• 可配置多个模型备用

4. 供应商选择

支持主流云服务提供商：

• AWS
• Azure
• 阿里云
• 腾讯云等

5. 默认模型设置

可设置默认使用的AI模型，后续可随时修改：

• 推荐选择响应速度快、稳定性高的模型
• 不同模型适用于不同场景

6. 使用信息配置

配置基础使用偏好：

• 日志级别(debug/info/warn/error)
• 数据存储位置
• 自动更新设置

7. 完成安装

根据提示完成剩余配置步骤，包括：

• 端口设置(默认8080)
• 防火墙配置
• 开机自启动设置

安装完成

成功安装后，终端会显示Web UI访问地址，通常为：

http://localhost:8080

安装后管理命令

• 新手引导：重新运行配置向导

  openclaw onboard --install-daemon
  

• 系统检查：验证安装完整性

  openclaw doctor
  

• 服务状态：

  openclaw status  # 查看运行状态
  openclaw health  # 检查健康状态
  

• 仪表板：打开Web管理界面

  openclaw dashboard
  

补充模型配置

1. 运行配置向导

openclaw onboard --install-daemon

2. 选择AI供应商

支持主流AI服务提供商：

• OpenAI
• Anthropic
• 阿里云千问
• 百度文心等

3. 模型授权

根据提示完成：

1. 访问供应商授权页面
2. 获取API Key
3. 设置请求限额
4. 测试连接

4. Web访问

配置完成后，通过浏览器访问Web界面：

http://localhost:8080