Mac mini 搭配 OpenClaw 完全指南 - 打造你的私人 AI 助手

# Mac mini 搭配 OpenClaw 完全指南 - 打造你的私人 AI 助手

> 用一台 Mac mini + OpenClaw，24 小时在线的 AI 助手就此诞生。本文从零开始，带你完整搭建属于自己的 AI 自动化系统。

## 📋 目录

1. [为什么选择 Mac mini + OpenClaw](#为什么选择 mac-mini--openclaw)
2. [准备工作](#准备工作)
3. [安装 Node.js](#安装 nodejs)
4. [安装 OpenClaw](#安装 openclaw)
5. [配置 AI 模型](#配置 ai 模型)
6. [配置消息渠道](#配置消息渠道)
7. [高级功能配置](#高级功能配置)
8. [日常使用技巧](#日常使用技巧)
9. [常见问题解答](#常见问题解答)

---

## 为什么选择 Mac mini + OpenClaw

### Mac mini 的优势

- **低功耗**：M 系列芯片待机功耗极低，7x24 小时运行电费几乎可以忽略
- **静音**：几乎听不到风扇声音，放在桌面或角落都不打扰
- **性能足够**：M1/M2/M3 芯片运行 AI 助手绰绰有余
- **macOS 生态**：与 Apple 设备无缝集成，支持 Apple Script、快捷指令等

### OpenClaw 是什么

OpenClaw 是一个开源的 AI 助手框架，特点包括：

- **多模型支持**：支持阿里云百炼、Ollama、OpenAI 等多种 AI 模型
- **多渠道消息**：支持飞书、Telegram、WhatsApp、Discord 等
- **本地优先**：数据本地存储，隐私可控
- **可扩展**：支持自定义技能、工具集成
- **记忆系统**：支持长期记忆和短期记忆，助手能记住你的偏好

### 这个组合能做什么

- 📧 自动处理邮件、日历提醒
- 💬 多平台消息统一回复
- 📝 自动写博客、整理笔记
- 🔍 信息搜集和整理
- 🏠 智能家居控制（需额外配置）
- 💻 代码辅助和自动化任务

---

## 准备工作

### 硬件要求

| 配置项 | 最低要求 | 推荐配置 |
|--------|----------|----------|
| Mac mini | M1 芯片 | M2/M3 芯片 |
| 内存 | 8GB | 16GB 或以上 |
| 存储 | 64GB 可用空间 | 128GB 或以上 |
| 网络 | 稳定互联网连接 | 有线连接更佳 |

### 软件要求

- macOS 12.0 (Monterey) 或更高版本
- 已注册的阿里云账号（用于 AI 模型）
- 飞书/Telegram 等账号（用于消息接收）

### 需要准备的账号信息

1. **阿里云百炼账号**：访问 https://bailian.console.aliyun.com 注册
2. **API Key**：在百炼控制台创建并获取
3. **飞书开放平台账号**（可选）：如需飞书消息集成

---

## 安装 Node.js

OpenClaw 基于 Node.js 开发，首先需要安装 Node.js。

### 方法一：使用 Homebrew（推荐）

如果你还没有安装 Homebrew，先安装它：

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

然后安装 Node.js：

```bash
brew install node
```

验证安装：

```bash
node -v
# 输出示例：v23.11.0

npm -v
# 输出示例：10.9.2
```

### 方法二：从官网下载

访问 https://nodejs.org 下载 macOS 安装包，按提示安装即可。

---

## 安装 OpenClaw

### 步骤 1：全局安装 OpenClaw

打开终端（Terminal），执行：

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

安装完成后验证：

```bash
openclaw -v
# 输出示例：OpenClaw 2026.2.26
```

### 步骤 2：初始化工作区

OpenClaw 会在你的用户目录下创建工作区：

```bash
# 工作区默认位置
~/.openclaw/workspace
```

首次运行时，OpenClaw 会自动创建以下文件：

- `SOUL.md` - 助手的人格设定
- `USER.md` - 用户信息
- `IDENTITY.md` - 助手身份
- `MEMORY.md` - 长期记忆
- `TOOLS.md` - 工具配置
- `HEARTBEAT.md` - 定时任务配置

### 步骤 3：启动 Gateway

Gateway 是 OpenClaw 的核心服务，负责消息收发和任务调度：

```bash
openclaw gateway start
```

查看状态：

```bash
openclaw gateway status
```

成功启动后，你会看到类似输出：

```
🦞 OpenClaw 2026.2.26
🟢 Gateway is running
📍 PID: 12345
🌐 Port: 18800
```

---

## 配置 AI 模型

### 配置阿里云百炼

1. **获取 API Key**
   - 登录 https://bailian.console.aliyun.com
   - 进入「API-KEY 管理」
   - 创建新的 API Key
   - 复制保存（只显示一次）

2. **编辑配置文件**

找到或创建配置文件 `~/.openclaw/models.json`：

```json
{
  "default": "bailian/qwen3.5-plus",
  "models": {
    "bailian/qwen3.5-plus": {
      "provider": "bailian",
      "apiKey": "sk-sp-你的 API Key",
      "model": "qwen-plus"
    }
  }
}
```

3. **测试模型连接**

```bash
openclaw chat "你好，测试一下连接"
```

### 可选：配置本地模型（Ollama）

如果你想要完全本地运行，可以安装 Ollama：

```bash
brew install ollama
ollama serve
ollama pull qwen2.5:7b
```

然后在 `models.json` 中添加：

```json
{
  "ollama/qwen2.5": {
    "provider": "ollama",
    "baseUrl": "http://localhost:11434",
    "model": "qwen2.5:7b"
  }
}
```

---

## 配置消息渠道

### 配置飞书（推荐国内用户）

1. **创建飞书应用**
   - 访问 https://open.feishu.cn/app
   - 点击「创建企业自建应用」
   - 填写应用名称（如：OpenClaw Assistant）
   - 在「凭证与基础信息」中获取 App ID 和 App Secret

2. **配置权限**
   - 在「权限管理」中添加以下权限：
     - `im:message` - 发送消息
     - `im:chat` - 读取聊天信息
     - `contact:user.base:readonly` - 读取用户信息

3. **发布应用**
   - 点击「发布」→「创建版本」
   - 等待审核通过（通常很快）

4. **编辑 OpenClaw 配置**

创建或编辑 `~/.openclaw/channels/feishu.json`：

```json
{
  "provider": "feishu",
  "appId": "cli_xxxxxxxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxx",
  "verificationToken": "xxxxxxxxxxxxx"
}
```

5. **配置回调地址**

在飞书应用后台的「事件订阅」中：
- 启用事件订阅
- 填写回调地址：`http://你的 Mac IP:18800/feishu/callback`
- 订阅消息接收事件

### 配置 Telegram（可选）

1. **创建 Bot**
   - 在 Telegram 中搜索 @BotFather
   - 发送 `/newbot` 创建新机器人
   - 按提示设置名称和用户名
   - 获取 Bot Token

2. **编辑配置**

创建 `~/.openclaw/channels/telegram.json`：

```json
{
  "provider": "telegram",
  "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
}
```

3. **获取 Chat ID**
   - 给你的 Bot 发送任意消息
   - 访问 `https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates`
   - 找到你的 chat id

---

## 高级功能配置

### 配置记忆系统

OpenClaw 的记忆系统分为：

- **短期记忆**：会话上下文，自动管理
- **长期记忆**：存储在 `MEMORY.md` 中

编辑 `~/.openclaw/workspace/MEMORY.md` 可以手动添加重要信息：

```markdown
# 长期记忆

## 用户偏好
- 喜欢简洁的回复风格
- 工作时间：9:00-18:00
- 常用技术栈：Node.js, Python, Go

## 重要事项
- 项目 A 的截止日期：2026-03-15
- 每周一下午团队会议
```

### 配置定时任务（Heartbeat）

编辑 `~/.openclaw/workspace/HEARTBEAT.md`：

```markdown
# 定时检查任务

- [ ] 每天早上 9:00 检查日历
- [ ] 每小时检查一次邮件
- [ ] 每天下午 6:00 生成日报
```

### 自定义技能

在 `~/.openclaw/skills/` 目录下可以添加自定义技能：

```bash
mkdir -p ~/.openclaw/skills/my-skill
touch ~/.openclaw/skills/my-skill/SKILL.md
```

编辑 `SKILL.md`：

```markdown
# my-skill

## 触发条件
当用户提到「xxx」时激活

## 执行内容
1. 执行具体任务
2. 返回结果
```

---

## 日常使用技巧

### 常用命令

```bash
# 查看状态
openclaw status

# 查看会话列表
openclaw sessions list

# 查看日志
openclaw logs

# 重启 Gateway
openclaw gateway restart

# 停止 Gateway
openclaw gateway stop
```

### 与助手交互

通过配置的消息渠道（如飞书）直接发送消息即可：

- 「你好」- 打招呼
- 「帮我查一下天气」- 查询天气
- 「提醒我明天开会」- 创建提醒
- 「总结一下这篇文章」- 发送链接让助手总结

### 查看助手状态

在飞书中发送 `/status` 可以查看：

- 当前使用的模型
- Token 使用情况
- 会话上下文大小

---

## 常见问题解答

### Q1: Gateway 启动失败

**可能原因**：
- 端口被占用
- 配置文件格式错误

**解决方法**：
```bash
# 检查端口占用
lsof -i :18800

# 检查配置
openclaw config check

# 查看详细日志
openclaw logs --follow
```

### Q2: 消息发送失败

**检查项**：
1. 确认渠道配置正确
2. 确认 API Key/Token 有效
3. 确认网络连通性
4. 查看 Gateway 日志

### Q3: 模型响应慢

**优化建议**：
1. 检查网络连接
2. 尝试切换模型（如从 qwen-max 切换到 qwen-plus）
3. 如果使用本地模型，增加内存分配
4. 减少上下文长度

### Q4: 如何备份配置

```bash
# 备份整个工作区
cp -r ~/.openclaw ~/Documents/openclaw-backup-$(date +%Y%m%d)

# 只备份配置
cp ~/.openclaw/models.json ~/Documents/
cp -r ~/.openclaw/channels ~/Documents/
```

### Q5: 如何更新 OpenClaw

```bash
# 更新到最新版本
npm update -g openclaw

# 查看版本
openclaw -v
```

---

## 结语

至此，你已经完成了 Mac mini + OpenClaw 的完整搭建。这个组合可以成为你工作和生活中的得力助手。

### 下一步建议

1. **熟悉助手的性格**：编辑 `SOUL.md` 调整助手的行为风格
2. **配置更多渠道**：添加 WhatsApp、Discord 等
3. **探索技能系统**：查看内置技能和创建自定义技能
4. **加入社区**：访问 https://discord.com/invite/clawd 交流经验

### 参考资源

- OpenClaw 官方文档：https://docs.openclaw.ai
- GitHub 仓库：https://github.com/openclaw/openclaw
- 阿里云百炼文档：https://help.aliyun.com/product/42154.html

---

_如果本文对你有帮助，欢迎在我的博客留言交流！_