macOS安装OpenClaw详细教程：手把手教你搭建个人AI助手网关

# macOS安装OpenClaw详细教程：手把手教你搭建个人AI助手网关

## 前言

OpenClaw（小龙虾）是一个跨平台的AI代理网关，支持WhatsApp、Telegram、Discord、iMessage等多种通信平台。本教程将详细指导macOS用户从零开始安装和配置OpenClaw，让你轻松拥有个人AI助手。

## 系统要求

### 硬件要求
- macOS 10.15 (Catalina) 或更高版本
- 至少4GB RAM（推荐8GB+）
- 至少2GB可用磁盘空间
- 稳定的网络连接

### 软件要求
- Homebrew（macOS包管理器）
- Node.js 18.0.0 或更高版本
- Python 3.8+（macOS自带）
- Git

## 第一步：安装必备工具

### 1.1 安装Homebrew

打开终端（Terminal），执行以下命令：

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

安装完成后，将Homebrew添加到环境变量：

```bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
```

验证安装：
```bash
brew --version
```

### 1.2 安装Node.js和npm

使用Homebrew安装Node.js：

```bash
brew install node
```

验证安装：
```bash
node --version
npm --version
```

### 1.3 安装Git

如果尚未安装Git：

```bash
brew install git
```

验证安装：
```bash
git --version
```

## 第二步：安装OpenClaw

### 2.1 使用npm全局安装OpenClaw

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

或者使用pnpm（推荐，速度更快）：

```bash
npm install -g pnpm
pnpm add -g openclaw
```

### 2.2 验证安装

```bash
openclaw --version
```

如果看到版本号（如2026.3.7），说明安装成功。

## 第三步：初始化OpenClaw

### 3.1 创建工作目录

```bash
mkdir ~/openclaw-workspace
cd ~/openclaw-workspace
```

### 3.2 初始化配置

```bash
openclaw init
```

这个命令会：
1. 创建必要的配置文件
2. 设置默认工作空间
3. 生成初始项目结构

### 3.3 配置环境变量

编辑`~/.zshrc`文件：

```bash
nano ~/.zshrc
```

添加以下内容：
```bash
export OPENCLAW_HOME=~/openclaw-workspace
export PATH=$PATH:$OPENCLAW_HOME/bin
```

保存并生效：
```bash
source ~/.zshrc
```

## 第四步：配置通信平台

### 4.1 选择通信平台

OpenClaw支持多种平台，我们以Telegram为例：

1. 打开Telegram，搜索`@BotFather`
2. 发送`/newbot`创建新机器人
3. 按照提示设置机器人名称和用户名
4. 获取API Token

### 4.2 配置Telegram插件

创建配置文件：

```bash
cd ~/openclaw-workspace
nano config/telegram.json
```

添加以下内容（替换`YOUR_BOT_TOKEN`为实际token）：
```json
{
"telegram": {
"botToken": "YOUR_BOT_TOKEN",
"polling": true,
"webhook": false
}
}
```

### 4.3 启用插件

编辑主配置文件：

```bash
nano config/default.json
```

确保包含：
```json
{
"plugins": ["telegram"],
"gateway": {
"port": 3000,
"host": "localhost"
}
}
```

## 第五步：启动OpenClaw网关

### 5.1 启动网关服务

```bash
openclaw gateway start
```

### 5.2 验证服务状态

```bash
openclaw gateway status
```

应该看到类似输出：
```
🦞 OpenClaw Gateway
✅ Status: Running
📡 Port: 3000
🕒 Uptime: 1m 30s
```

### 5.3 测试连接

在浏览器中打开：
```
http://localhost:3000/status
```

应该看到网关状态页面。

## 第六步：配置AI模型

### 6.1 选择AI模型

OpenClaw支持多种AI模型：
- OpenAI GPT系列
- Anthropic Claude
- 本地模型（如Llama）
- 其他兼容OpenAI API的模型

### 6.2 配置OpenAI（示例）

创建模型配置文件：

```bash
nano config/models.json
```

添加内容：
```json
{
"default": "gpt-4",
"models": {
"gpt-4": {
"provider": "openai",
"apiKey": "YOUR_OPENAI_API_KEY",
"endpoint": "https://api.openai.com/v1"
},
"claude-3": {
"provider": "anthropic",
"apiKey": "YOUR_ANTHROPIC_API_KEY"
}
}
}
```

## 第七步：测试完整流程

### 7.1 在Telegram中测试

1. 在Telegram中找到你的机器人
2. 发送`/start`命令
3. 发送任意消息测试

### 7.2 查看日志

```bash
tail -f ~/openclaw-workspace/logs/gateway.log
```

应该能看到消息处理日志。

## 第八步：高级配置

### 8.1 设置开机自启动

创建LaunchAgent plist文件：

```bash
nano ~/Library/LaunchAgents/com.openclaw.gateway.plist
```

添加内容：
```xml




Label
com.openclaw.gateway
ProgramArguments

/opt/homebrew/bin/openclaw
gateway
start

RunAtLoad

KeepAlive

WorkingDirectory
~/openclaw-workspace
StandardOutPath
~/openclaw-workspace/logs/stdout.log
StandardErrorPath
~/openclaw-workspace/logs/stderr.log


```

加载服务：
```bash
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
```

### 8.2 配置多个平台

可以同时配置多个通信平台：

```json
{
"plugins": ["telegram", "discord", "whatsapp"],
"telegram": {
"botToken": "YOUR_TELEGRAM_TOKEN"
},
"discord": {
"botToken": "YOUR_DISCORD_TOKEN"
},
"whatsapp": {
"sessionPath": "./whatsapp-session"
}
}
```

## 第九步：故障排除

### 常见问题1：端口被占用

```bash
lsof -i :3000
kill -9
openclaw gateway restart
```

### 常见问题2：权限问题

```bash
chmod +x ~/openclaw-workspace/bin/*
sudo chown -R $(whoami) ~/openclaw-workspace
```

### 常见问题3：网络连接

检查防火墙设置：
```bash
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --getglobalstate
```

如果需要，添加例外：
```bash
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /opt/homebrew/bin/node
```

## 第十步：安全建议

### 10.1 保护API密钥

- 不要将API密钥提交到Git
- 使用环境变量存储敏感信息
- 定期轮换API密钥

### 10.2 限制访问

```json
{
"security": {
"allowedIPs": ["127.0.0.1", "192.168.1.0/24"],
"rateLimit": {
"windowMs": 60000,
"max": 100
}
}
}
```

### 10.3 启用HTTPS

使用nginx反向代理：

```nginx
server {
listen 443 ssl;
server_name your-domain.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
proxy_pass http://localhost:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```

## 总结

通过本教程，你已经成功在macOS上安装并配置了OpenClaw。现在你可以：

1. **与AI助手聊天**：通过Telegram等平台与你的AI助手对话
2. **扩展功能**：安装更多技能和插件
3. **自定义配置**：根据需求调整模型和设置
4. **监控状态**：通过日志和状态页面了解系统运行情况

### 下一步建议

1. **探索技能市场**：访问 https://clawhub.com 发现更多技能
2. **加入社区**：参与Discord社区 https://discord.com/invite/clawd
3. **阅读文档**：查看官方文档 https://docs.openclaw.ai
4. **贡献代码**：访问GitHub仓库 https://github.com/openclaw/openclaw

### 获取帮助

- 官方文档：https://docs.openclaw.ai
- GitHub Issues：https://github.com/openclaw/openclaw/issues
- Discord社区：https://discord.com/invite/clawd

祝你在OpenClaw的世界里玩得开心！🦞