OpenClaw 一体机配置教程
难度 ⭐ 新手友好 · 预计耗时 30 分钟 · Mac mini 篇
# 🖥️ OpenClaw 一体机配置教程（Mac mini 篇）
> **难度**：⭐ 新手友好 | **预计耗时**：30 分钟 | **费用**：免费/按需
本教程将手把手教你如何在 Mac mini 上从零开始配置 OpenClaw，让你的微信、飞书、QQ、Discord 等消息应用连接到 AI 助手。
---
## 📋 目录
1. [什么是 OpenClaw？](#什么是-openclaw)
2. [准备工作](#准备工作)
3. [安装 Node.js](#第一步安装-nodejs)
4. [安装 OpenClaw](#第二步安装-openclaw)
5. [初始化配置](#第三步初始化配置)
6. [连接消息频道](#第四步连接消息频道)
- [飞书配置](#41-飞书配置)
- [QQ 配置](#42-qq-配置)
7. [启动 OpenClaw](#第五步启动-openclaw)
8. [内网穿透：随时随地访问](#第六步内网穿透随时随地访问)
- [为什么需要内网穿透？](#为什么需要内网穿透)
- [使用鲸奇互联（WhaliX）内网穿透](#使用鲸奇互联whalix内网穿透)
9. [配置开机自启](#第七步配置开机自启可选)
10. [常见问题](#常见问题)
---
## 什么是 OpenClaw？
OpenClaw 是一个**自托管的 AI 网关**，可以将你的多个聊天应用（微信、飞书、QQ、WhatsApp、Telegram、Discord 等）连接到 AI 助手。你只需要一台 Mac mini（或其他 Mac 电脑），就能拥有一个 **24/7 在线 AI 助手**。
### OpenClaw 能做什么？
- 📱 **多平台接入**：同时连接微信、飞书、QQ、Discord 等多个平台
- 🤖 **AI 对话**：通过聊天应用与 AI 助手对话
- 🛠️ **自动化任务**：让 AI 帮你处理消息、生成内容、回答问题
- 🔒 **数据自主**：所有数据存储在你的设备上，安全可控
---
## 准备工作
### 所需设备
- Mac mini（任何搭载 Apple Silicon 或 Intel 芯片的机型均可）
- 稳定的网络连接（建议使用宽带）
- 一个用于接收验证码的微信/飞书/QQ 账号
### 推荐配置
| 配置 | 最低要求 | 推荐配置 |
|------|----------|----------|
| 芯片 | Apple M1 / Intel i5 | Apple M2 及以上 |
| 内存 | 8GB | 16GB |
| 存储 | 256GB | 512GB SSD |
### 账号准备
在开始之前，你需要准备好以下账号：
- **AI 模型 API**：推荐 [MiniMax](https://platform.minimax.io/)、[OpenAI](https://platform.openai.com/) 或阿里云百炼
- **消息平台账号**：飞书企业号 / QQ 号 / Discord 账号等
---
## 第一步：安装 Node.js
OpenClaw 需要 Node.js 22 或更高版本才能运行。
### 1.1 下载 Node.js
打开浏览器，访问 Node.js 官网：
> https://nodejs.org/
点击页面上的 **20.x LTS** 按钮（推荐安装长期支持版本），开始下载。
> 📌 **截图**：打开 https://nodejs.org/ 页面截图
### 1.2 安装 Node.js
1. 双击下载的 `.pkg` 安装包
2. 在安装向导中点击「继续」
3. 阅读并同意许可协议
4. 选择安装位置（默认即可）
5. 输入你的 Mac 密码确认安装
6. 等待安装完成，点击「关闭」
### 1.3 验证安装
打开「终端」应用（Terminal），输入以下命令并回车：
```bash
node --version
```
如果显示类似 `v22.x.x` 的版本号，说明安装成功。
> 📌 **截图**：终端输入 `node --version` 截图
---
## 第二步：安装 OpenClaw
### 2.1 打开终端
在「应用程序」→「实用工具」中找到「终端」，或使用 Spotlight 搜索（按 `⌘ + 空格`，输入 terminal）。
### 2.2 安装 OpenClaw
在终端中输入以下命令：
```bash
npm install -g openclaw
```
等待安装完成（可能需要几分钟）。
> 📌 **截图**：终端安装 openclaw 过程截图
### 2.3 验证安装
安装完成后，输入：
```bash
openclaw --version
```
如果显示版本号，说明安装成功。
---
## 第三步：初始化配置
### 3.1 运行初始化向导
在终端中输入：
```bash
openclaw setup
```
这个命令会引导你完成基本配置。
### 3.2 配置步骤
根据提示完成以下配置：
1. **选择 AI 模型**：推荐选择 MiniMax 或 OpenAI（需要 API Key）
2. **设置工作目录**：默认 `~/.openclaw/workspace`
3. **配置个人偏好**：根据需要选择
> 📌 **截图**：openclaw setup 运行界面截图
---
## 第四步：连接消息频道
OpenClaw 支持多种消息平台。下面分别介绍飞书和 QQ 的配置方法。
### 4.1 飞书配置
#### 第一步：创建飞书应用
1. 访问 [飞书开放平台](https://open.feishu.cn/)
2. 点击「创建企业自建应用」
3. 填写应用名称（如「OpenClaw AI 助手」）
4. 创建完成后，在应用详情页获取 **App ID** 和 **App Secret**
#### 第二步：配置应用权限
1. 进入「权限管理」页面
2. 添加以下权限：
- `im:message:send_as_bot` - 发送消息
- `im:message:receive` - 接收消息
- `im:user.base:get` - 获取用户基本信息
#### 第三步：发布应用
1. 点击「版本管理与发布」
2. 创建新版本
3. 提交审核（企业内部应用可选择「全员可见」）
#### 第四步：在 OpenClaw 中配置
在终端中运行：
```bash
openclaw channels login feishu
```
按照提示输入 App ID 和 App Secret，完成授权。
> 📌 **截图**：openclaw channels login feishu 界面
---
### 4.2 QQ 配置
> 📌 **参考文档**：https://help.aliyun.com/zh/simple-application-server/use-cases/openclaw-qq-integration
#### 第一步：创建 QQ 机器人
1. 前往 [QQ 开放平台](https://q.qq.com/#/) 官网
2. 在下方找到「龙虾专用入口」，点击「去使用」
3. 使用手机 QQ 扫描二维码登录
4. 点击「创建机器人」
5. 填写机器人信息，保存好 **AppID** 和 **AppSecret**
> ⚠️ **注意**：请妥善保管 AppSecret，这是机器人密钥，一旦丢失需要重新生成。
#### 第二步：在 OpenClaw 中集成 QQ
在终端中运行：
```bash
openclaw channels login qq
```
按照提示输入：
- AppID
- AppSecret
完成授权后，你的 QQ 机器人就可以接收消息了。
> 📌 **截图**：QQ 机器人创建页面和 openclaw channels login qq 界面
---
## 第五步：启动 OpenClaw
### 5.1 启动 Gateway
在终端中输入：
```bash
openclaw gateway
```
看到类似以下输出说明启动成功：
```
Gateway started on http://127.0.0.1:18789
```
### 5.2 打开控制面板
打开浏览器，访问：
> http://127.0.0.1:18789/
你将看到 OpenClaw 的控制界面。
> 📌 **截图**：OpenClaw Web 控制面板
---
## 第六步：内网穿透：随时随地访问 🔥
### 为什么需要内网穿透？
当你完成了上面的配置后，OpenClaw 已经可以在 Mac mini 上正常运行了。但是，有一个关键问题：
**OpenClaw 运行在你的本地网络中，只能在局域网内访问。**
这意味着：
- ❌ 在公司无法访问家里的 OpenClaw
- ❌ 在外面无法通过微信/QQ/飞书调用 AI
- ❌ 无法实现「随时随地」使用 AI 助手
**这时候，你需要内网穿透服务。**
### 内网穿透的作用
| 场景 | 无内网穿透 | 有内网穿透 |
|------|------------|------------|
| 家里部署 | ✅ 正常使用 | ✅ 正常使用 |
| 外出使用 | ❌ 无法访问 | ✅ 随时可用 |
| 微信/QQ 消息 | ❌ 无法接收 | ✅ 实时响应 |
| 远程管理 | ❌ 无法访问 | ✅ 完全控制 |
---
### 使用鲸奇互联内网穿透
**鲸奇互联** 是鲸奇云联提供的内网穿透与远程访问平台，可以将你的本地服务暴露到公网，实现随时随地访问。
#### 产品功能特点
- 🔒 **安全加密传输**：支持多种协议（TCP、UDP、HTTP、HTTPS、WS、WSS等）
- 🌐 **全平台兼容**：支持 Linux、Windows、macOS 等主流操作系统
- ⚡ **高性能代理**：支持 P2P 直连和中继模式
- 🎯 **丰富隧道类型**：满足各种内网穿透需求
- 🎨 **Web 管理界面**：简洁且功能强大
#### 套餐类型
| 套餐 | 免费 | 普通 VIP | SVIP |
|------|------|----------|------|
| 价格 | **免费** | ¥9.9/月 | ¥19.9/月 |
| 隧道上限 | 1 条 | 6 条 | 15 条 |
| 最大连接 | 10 个 | 100 个 | 500 个 |
| 峰值带宽 | 3 Mbps | 60 Mbps | 150 Mbps |
| 月度流量 | 1 GB | 100 GB | 500 GB |
| 适用人群 | 个人体验 | 小型团队/轻量业务 | 中大型团队/关键业务 |
#### 配置步骤
**第一步：登录控制台**
访问鲸奇互联控制台：https://jqhl.jqcloudnet.cn/
> 📌 **截图**：控制台登录页面
**第二步：注册账号**
点击注册，填写账号信息完成注册。
**第三步：创建客户端**
在控制台中创建一个客户端，记录好连接信息。
> 📌 **截图**：创建客户端界面
**第四步：创建隧道**
1. 在控制台创建新隧道
2. 隧道类型选择：**TCP**
3. 填写本地端口：**18789**（OpenClaw 默认端口）
4. 填写内网地址：**127.0.0.1**
5. 保存后获取公网地址
> 📌 **截图**：创建 TCP 隧道界面
**第五步：下载客户端**
下载并安装桌面客户端（支持 Windows、macOS、Linux）。
**第六步：连接验证**
1. 在客户端中粘贴连接信息
2. 确认客户端状态为「在线」
3. 通过公网地址访问 OpenClaw
> 📌 **截图**：客户端连接成功界面
---
#### 配套服务
现在订阅鲸奇互联内网穿透服务，**免费赠送 OpenClaw 部署指导**，手把手帮你完成配置！
有任何问题请联系客服或运维负责人。
---
## 第七步：配置开机自启（可选）
为了让 OpenClaw 在 Mac 重启后自动运行，需要配置开机自启。
### 7.1 创建 LaunchAgent
1. 在终端中创建配置目录：
```bash
mkdir -p ~/Library/LaunchAgents
```
2. 创建启动配置文件：
```bash
nano ~/Library/LaunchAgents/com.openclaw.gateway.plist
```
3. 粘贴以下内容：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.openclaw.gateway</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/openclaw</string>
<string>gateway</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>
```
4. 保存并退出（按 `Ctrl + X`，输入 `Y` 保存）
5. 加载配置：
```bash
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
```
---
## 常见问题
### Q1: 启动时报错 "Port already in use"
> 可能是 18789 端口被其他程序占用。可以修改端口：`openclaw gateway --port 18889`
### Q2: 微信/飞书/QQ 无法接收消息
> 检查消息平台的配置权限，确保已开启接收消息权限。如果是 QQ，需要在 QQ 开放平台确认机器人已启用。
### Q3: 如何更新 OpenClaw？
> 运行 `npm update -g openclaw` 即可更新到最新版本。
### Q4: 如何查看日志？
> 日志文件位于 `/tmp/openclaw/` 目录下。
### Q5: 内网穿透后还是无法访问？
> 1. 确认 OpenClaw 正在运行
> 2. 检查防火墙是否放行 18789 端口
> 3. 确认内网隧道状态为「在线」
> 4. 联系鲸奇互联技术支持
### Q6: OpenClaw 需要付费吗？
> OpenClaw 本身是开源免费的，但你需要：
> - 支付服务器费用（Mac mini 电费）
> - 支付 AI 模型 API 调用费用（按调用量或订阅）
> - 如需远程访问，支付内网穿透费用
---
## 总结
按照以上步骤，你应该已经成功在 Mac mini 上配置好了 OpenClaw。现在你可以：
- ✅ 通过微信/飞书/QQ 与 AI 对话
- ✅ 让 AI 自动帮你处理消息
- ✅ 搭建自己的 AI 助手服务
- ✅ 随时随地通过内网穿透远程使用
**想要实现真正的随时随地使用？** 现在就加入鲸奇互联内网穿透服务，还有专业团队帮你完成部署！
---
> **🐋 鲸奇互联（WhaliX）** - 专注 AI 自动化解决方案
>
> 🌐 官网：/docs/whalix-quickstart/
> 💬 联系：添加客服微信咨询
>
> 感谢开源项目 [OpenClaw](https://github.com/openclaw/openclaw) 提供的 AI 网关方案。