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. 执行安装命令
在终端中运行以下命令进行一键安装:
bash
curl -fsSL https://openclaw.ai/install.sh | bash
该命令会:
- 下载最新安装脚本
- 检查系统环境
- 自动安装必要依赖
- 配置基础环境

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

安装后管理命令
-
新手引导:重新运行配置向导
bashopenclaw onboard --install-daemon -
系统检查:验证安装完整性
bashopenclaw doctor -
服务状态:
bashopenclaw status # 查看运行状态 openclaw health # 检查健康状态 -
仪表板:打开Web管理界面
bashopenclaw dashboard
补充模型配置
1. 运行配置向导
bash
openclaw onboard --install-daemon
2. 选择AI供应商
支持主流AI服务提供商:
- OpenAI
- Anthropic
- 阿里云千问
- 百度文心等

3. 模型授权
根据提示完成:
- 访问供应商授权页面
- 获取API Key
- 设置请求限额
- 测试连接
4. Web访问
配置完成后,通过浏览器访问Web界面:
http://localhost:8080