开发者社区 问答 正文

OpenClaw在Mac电脑上安装教程?

OpenClaw在Mac电脑上安装教程?OpenClaw部署教程:https://t.aliyun.com/U/oLEIFP

展开
收起
云小帮 2026-03-09 19:47:33 33 分享 版权
1 条回答
写回答
取消 提交回答
  • Mac 上安装 OpenClaw 有两种主流方式:一键脚本(最省事)手动安装(更可控),阿小云整理可直接复制的OpenClaw在Mac电脑上的安装方法:


    一、系统要求

    • macOS 12+(Monterey 及以上)
    • Node.js 22+(LTS 推荐)
    • 内存 ≥ 4GB(推荐 8GB+)
    • 磁盘 ≥ 500MB 空闲

    二、方式一:官方一键脚本(推荐,5分钟)

    1. 打开终端

    • 快捷键:Command + 空格 → 输入「终端」→ 回车

    2. 执行一键安装

    # 官方脚本(推荐)
    curl -fsSL https://openclaw.ai/install.sh | bash
    
    # 国内加速版(网络慢时用)
    # curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
    
    • 脚本会自动:检测系统、安装 Node.js、下载 OpenClaw、配置环境变量。

    3. 加载环境变量(必做)

    # Zsh(默认)
    source ~/.zshrc
    
    # Bash(老系统)
    # source ~/.bash_profile
    

    4. 验证安装

    openclaw --version
    # 输出版本号(如 2026.x.x)即成功
    

    三、方式二:手动安装(适合自定义/开发)

    1. 安装 Node.js(如已装可跳过)

    # 用 Homebrew 安装(推荐)
    brew install node@22
    
    # 验证
    node -v  # ≥22.0.0
    npm -v
    

    2. 全局安装 OpenClaw

    # 安装最新版
    npm install -g openclaw@latest
    
    # M 芯片 Mac 常见 sharp 报错修复
    # SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
    

    3. 验证

    openclaw --version
    

    四、首次配置(必做)

    1. 运行初始化向导

    openclaw onboard
    
    • 按提示选择:QuickStart → 配置 AI API Key(如 OpenAI)→ 完成。

    2. 启动 OpenClaw Gateway

    openclaw gateway run
    # 访问 http://localhost:8000 管理面板
    

    五、常见问题

    1. command not found
      • 原因:npm 全局路径未加入环境变量
      • 解决:
        echo 'export PATH=$(npm prefix -g)/bin:$PATH' >> ~/.zshrc
        source ~/.zshrc
        
    2. M 芯片安装失败
      • SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest 重试。
    3. 端口占用(默认 8000)
      openclaw gateway run --port 8080
      

    六、推荐选择

    • 普通用户:一键脚本(最快)
    • 开发者/自定义:手动安装

    云端部署OpenClaw可以参考阿里云官方教程:OpenClaw部署教程:https://t.aliyun.com/U/oLEIFP

    阿里云OpenClaw部署教程.jpg

    2026-03-10 10:14:26
    赞同 16 展开评论
问答分类:
问答地址: