当前位置：首页 > news >正文

Mac电脑安装使用OpenClaw完全指南：从零搭建你的专属AI智能体

news 2026/3/27 1:47:15

## 前言：什么是OpenClaw？

OpenClaw（曾用名Clawdbot、Moltbot）是一款近期爆火的开源AI智能体平台，因其图标形似龙虾，被用户亲切地称为“养龙虾”。与传统聊天式AI不同，OpenClaw不仅“能说会道”，更能“能干会做”——它能够通过自然语言指令直接操作你的电脑系统，自动完成文件处理、浏览器控制、代码生成、定时任务等一系列复杂操作。

本文将详细介绍在Mac电脑上安装和使用OpenClaw的全流程，帮助你在30分钟内完成部署，开始“养龙虾”之旅。

## 一、环境准备

### 1.1 系统要求

- **操作系统**：macOS Ventura 13.0 或更高版本（推荐Sonoma 14.0+）
- **硬件配置**：
- 最低：Apple Silicon M1 或 Intel Core i5（2018+），8GB内存，5GB可用存储空间
- 推荐：Apple Silicon M2/M3/M4，16GB以上内存

### 1.2 软件依赖

OpenClaw基于Node.js运行，首先需要安装Node.js环境。

**检查是否已安装Node.js：**
```bash
node --version
```

如果输出版本号且为v22.0.0或更高，可直接进入下一步。否则，按以下方式安装：

**方式一：Homebrew安装（推荐）**
```bash
# 如果未安装Homebrew，先执行此命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Node.js
brew install node
```

**方式二：官方安装包**
访问 nodejs.org，下载LTS版本安装包，双击安装即可。

安装完成后验证：
```bash
node --version
npm --version
```

### 1.3 国内用户加速配置（可选）

由于npm官方源在国内访问较慢，建议配置国内镜像源：
```bash
npm config set registry https://registry.npmmirror.com
```

## 二、安装OpenClaw

### 2.1 方式一：使用官方脚本安装（最简单）

在终端中执行以下命令：
```bash
curl -fsSL https://openclaw.ai/install.sh | bash
```

首次安装时间较长，请耐心等待。

### 2.2 方式二：使用npm全局安装

```bash
npm install -g openclaw
```

安装完成后验证：
```bash
openclaw --version
```

如果提示`command not found`，需要将npm全局bin目录添加到PATH中：
```bash
echo 'export PATH="$PATH:$(npm config get prefix)/bin"' >> ~/.zshrc
source ~/.zshrc
```

### 2.3 方式三：DMG安装包（适合不熟悉命令行的用户）

访问OpenClaw官网下载页，选择macOS版本下载，将应用拖入Applications文件夹即可。

## 三、初始化配置

### 3.1 运行配置向导

```bash
openclaw onboard --install-daemon
```

向导会引导你完成以下配置：

**步骤1：确认风险提示**
首次安装会出现风险提示，选择`yes`继续。

**步骤2：选择配置方式**
选择`QuickStart`快速开始。

**步骤3：选择LLM模型服务商**
可选选项包括：
- Anthropic (Claude) - 推荐，效果最佳
- OpenAI (GPT-4) - 需要API密钥
- 阿里云百炼（千问模型）- 国内用户推荐，免费额度充足
- Local Model (Ollama) - 本地运行，隐私性最强

选择后按提示输入对应的API密钥。

**步骤4：选择消息平台**
- WhatsApp（推荐）
- Telegram
- Discord
- 钉钉/飞书
- 暂时跳过（后续可配置）

**步骤5：配置存储路径**
建议使用默认路径`~/.openclaw`。

**步骤6：启用工具权限**
根据需要选择，建议至少开启read、write、web_search和memory。

### 3.2 连接消息平台

如果选择使用WhatsApp，向导完成后终端会显示二维码：
1. 打开手机WhatsApp
2. 点击右上角菜单 → “已关联设备”
3. 点击“关联设备”
4. 扫描终端中的二维码

连接成功后会显示`✓ WhatsApp connected successfully`。

### 3.3 使用钉钉通道（国内用户推荐）

由于国内网络环境，钉钉是更稳定的选择。安装钉钉插件：
```bash
openclaw plugins install @openclaw/dingtalk
```

然后在配置文件`~/.openclaw/openclaw.json`中添加钉钉配置：

```json
{
"channels": {
"dingtalk": {
"clientId": "你的钉钉应用Client ID",
"clientSecret": "你的钉钉应用Client Secret"
}
}
}
```

## 四、启动与验证

### 4.1 启动Gateway服务

```bash
openclaw gateway start
```

成功启动后会显示类似输出：
```
🦞 OpenClaw Gateway is running
📱 Connected to WhatsApp
🤖 Using Claude Sonnet 4.6
💾 Data stored in ~/.openclaw
```

### 4.2 查看服务状态

```bash
openclaw gateway status
```

### 4.3 访问Web控制面板

在浏览器中打开：http://127.0.0.1:18789/

首次访问需要获取访问令牌：
```bash
openclaw dashboard
```
复制终端输出的URL到浏览器即可。

### 4.4 发送第一条消息

在WhatsApp或钉钉中找到OpenClaw聊天窗口，发送：
```
你好，请介绍一下你自己
```

如果收到回复，说明安装配置成功！

## 五、核心功能介绍

### 5.1 基础对话与任务执行

OpenClaw能够理解自然语言并执行实际操作。尝试以下指令：

```
帮我创建一个名为test.txt的文件，内容为"Hello OpenClaw"
```

```
搜索今天的科技新闻，总结成3条要点
```

### 5.2 Skills技能系统

Skills是OpenClaw的功能扩展模块，类似“插件”。安装技能管理工具：
```bash
npm install -g clawhub
```

常用技能安装示例：
```bash
# 联网搜索增强
clawhub install tavily-search

# 浏览器自动化
clawhub install agent-browser

# 文本摘要
clawhub install summarize
```

查看已安装技能：
```bash
openclaw skill list
```

### 5.3 多智能体协同

OpenClaw支持同时运行多个智能体，处理不同任务：
```bash
# 创建不同用途的智能体
openclaw agent create work-assistant --workspace ~/work
openclaw agent create personal-assistant --workspace ~/personal
```

## 六、配置优化

### 6.1 配置文件位置

主配置文件：`~/.openclaw/openclaw.json`

### 6.2 常用配置项

```json
{
// 模型配置
"model": {
"provider": "anthropic",
"model": "claude-sonnet-4-6",
"temperature": 0.7,
"max_tokens": 2048
},

// 工作区配置
"workspace": {
"defaultPath": "/Users/你的用户名/projects"
},

// 安全配置
"channels": {
"whatsapp": {
"allowFrom": ["+861234567890"], // 仅允许特定用户
"groups": {
"*": { "requireMention": true }
}
}
}
}
```