2026年mac上安装openclaw从入门到删除

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

# Mac 平台 OpenClaw 完整安装指南

一、系统环境检查

1.1 检查当前系统状态

# 检查 macOS 版本 sw_vers # 输出示例： # ProductName: macOS # ProductVersion: 14.0 # BuildVersion: 23A344 # 检查可用磁盘空间 df -h / # 检查内存情况 sysctl hw.memsize

最低系统要求：

macOS 12.0 (Monterey) 或更高版本
至少 8GB 内存
至少 10GB 可用磁盘空间

二、依赖环境安装

2.1 安装 Homebrew（包管理器）

# 安装 Homebrew（国内镜像源） /bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)" # 配置 Homebrew 环境变量 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc source ~/.zshrc # 验证安装 brew --version

2.2 安装必备工具

# 安装 Git brew install git # 安装 Node.js（LTS 版本） brew install node # 安装 pnpm（更快的包管理器） npm install -g pnpm # 验证安装 node --version # 应为 v18.x.x 或更高 git --version pnpm --version

2.3 安装 Xcode Command Line Tools

# 检查是否已安装 xcode-select -p # 如果未安装，执行： xcode-select --install # 如果安装失败，可尝试： sudo xcode-select --reset

三、OpenClaw 安装配置

3.1 下载 OpenClaw

# 创建项目目录 mkdir -p ~/Projects/openclaw cd ~/Projects/openclaw # 克隆仓库（使用国内镜像） git clone https://gitee.com/openclaw/openclaw-cn.git cd openclaw-cn

3.2 配置国内镜像加速

# 配置 npm 淘宝镜像 npm config set registry https://registry.npmmirror.com/ npm config set disturl https://npmmirror.com/dist # 配置 pnpm 镜像 pnpm config set registry https://registry.npmmirror.com/ # 可选：配置 Electron 镜像（如果项目使用） export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

3.3 安装依赖和构建

# 安装项目依赖 pnpm install # 如果遇到 node-gyp 编译问题 npm install -g node-gyp # 构建项目 pnpm build # 链接全局命令 pnpm link --global

四、服务启动与验证

4.1 初始化配置

# 初始化 OpenClaw openclaw init # 交互式配置过程会提示： # ✅ 选择模型提供商（通义千问、OpenAI 等） # ✅ 配置 API Keys # ✅ 设置服务端口（默认 18789）

4.2 启动服务

# 启动网关服务 openclaw gateway start # 或以后台服务方式启动 openclaw gateway start --daemon # 检查服务状态 openclaw status

4.3 验证安装

# 运行健康检查 openclaw doctor # 预期输出： # ✅ Node.js 版本检查通过 # ✅ 依赖包检查通过 # ✅ 服务端口可用 # ✅ 模型连接正常

五、模型配置（以通义千问为例）

5.1 获取 API Key

访问阿里云百炼
注册/登录阿里云账号
进入控制台创建 API Key

5.2 配置模型

# 编辑配置文件 openclaw config edit

在配置文件中添加：

# ~/.openclaw/config.yaml models: - name: "qwen-turbo" provider: "custom" config: apiKey: "sk-your-qwen-api-key-here" baseURL: "https://dashscope.aliyuncs.com/api/v1" context_window: 8192 max_tokens: 2000

六、平台集成配置

6.1 飞书集成配置

# 启用飞书插件 openclaw plugin enable feishu

配置飞书应用：

访问飞书开放平台
创建企业自建应用
获取以下信息：
- app_id
- app_secret
- encrypt_key
- verification_token

# 添加到配置文件 feishu: app_id: "your_app_id" app_secret: "your_app_secret" encrypt_key: "your_encrypt_key" verification_token: "your_verification_token"

七、创建启动服务（可选）

7.1 创建 LaunchAgent（开机自启）

# 创建 plist 文件 nano ~/Library/LaunchAgents/com.openclaw.plist

内容如下：

 
  
    
     
  
    
     
      
      
        Label 
       
      
        com. 
       openclaw 
       
      
        ProgramArguments 
       
       
       
         /opt/homebrew/bin/pnpm 
        
       
         start 
        
       
      
        WorkingDirectory 
       
      
        /Users/你的用户名/Projects/ 
       openclaw/ 
       openclaw-cn 
       
      
        RunAtLoad 
       
       
      
        KeepAlive 
       
       
      
        StandardOutPath 
       
      
        /tmp/ 
       openclaw.log 
       
      
        StandardErrorPath 
       
      
        /tmp/ 
       openclaw.error.log

加载服务：

# 加载服务 launchctl load ~/Library/LaunchAgents/com.openclaw.plist # 立即启动 launchctl start com.openclaw # 检查状态 launchctl list | grep openclaw

八、常见问题解决

8.1 端口被占用

# 检查端口占用 lsof -i :18789 # 如果被占用，杀掉进程 kill -9 
  
    
    
      # 或者更改 
     OpenClaw 端口 
     openclaw config set port 18790

8.2 权限问题

# 如果遇到权限错误 chmod +x ~/Projects/openclaw/openclaw-cn/bin/* # 修复 npm 全局安装权限 mkdir ~/.npm-global npm config set prefix '~/.npm-global'

8.3 网络连接问题

# 检查防火墙 sudo /usr/libexec/ApplicationFirewall/socketfilterfw --getglobalstate # 如果防火墙开启，添加例外 sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/node

8.4 依赖安装失败

# 清理缓存重新安装 pnpm store prune rm -rf node_modules pnpm install # 如果特定包安装失败，尝试： npm install --force

九、验证安装成功

9.1 基本功能测试

# 测试服务响应 curl http://localhost:18789/health # 测试模型连接 openclaw test --model qwen-turbo # 预期输出： # ✅ 服务运行正常 # ✅ 模型响应正常 # ✅ 所有检查通过

9.2 访问 Web 界面

打开浏览器访问：

http://localhost:18789

应该看到 OpenClaw 的管理界面。

总结

按照以上步骤，您应该能在 Mac 平台上顺利完成 OpenClaw 的安装。如果在任何步骤遇到问题，可以：

检查对应步骤的常见问题解决方案
查看日志文件：/tmp/openclaw.log
运行诊断命令：openclaw doctor --verbose

安装完成后，您就可以开始配置和使用 OpenClaw 的各类 AI 功能了！