在 Mac 上配置 OpenClaw：完整安装指南

发表于 分类于 阅读次数：

OpenClaw 是一个强大的 AI 助手平台，可以帮助你自动化日常任务、管理文件、编写代码等。本文将详细介绍如何在 Mac 上从零开始配置 OpenClaw。

什么是 OpenClaw？

OpenClaw 是一个开源的 AI 助手框架，它可以：

  • 🤖 与多个 AI 模型交互（Claude、GPT、MiniMax 等）
  • 📁 管理本地文件和项目
  • 🌐 控制浏览器自动化任务
  • 💬 连接多个消息平台（Telegram、WhatsApp、Discord 等）
  • 🔧 执行 Shell 命令和脚本
  • 🧠 拥有持久化记忆系统

系统要求

  • macOS 10.15 或更高版本
  • Node.js 18+ (推荐使用 nvm 管理)
  • 终端基础知识

安装步骤

1. 安装 Node.js

如果你还没有安装 Node.js，推荐使用 nvm（Node Version Manager）：

1
2
3
4
5
6
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# 重启终端后安装 Node.js
nvm install 22
nvm use 22

验证安装：

1
2
node --version  # 应该显示 v22.x.x
npm --version

2. 安装 OpenClaw

使用 npm 全局安装 OpenClaw：

1
npm install -g openclaw

安装完成后验证：

1
openclaw --version

3. 初始化配置

首次运行 OpenClaw：

1
openclaw

这会自动创建配置目录：

  • ~/.openclaw/ - 主配置目录
  • ~/.openclaw/workspace/ - 工作空间
  • ~/.agents/skills/ - 技能目录

4. 配置 AI 模型

OpenClaw 支持多个 AI 提供商。你需要至少配置一个：

配置 Claude (Anthropic)

1
openclaw config set anthropic.apiKey YOUR_API_KEY

配置 OpenAI

1
openclaw config set openai.apiKey YOUR_API_KEY

配置 MiniMax

1
openclaw config set minimax.apiKey YOUR_API_KEY

5. 启动 Gateway

OpenClaw 使用 Gateway 服务来管理会话：

1
2
3
4
5
# 启动 Gateway
openclaw gateway start

# 检查状态
openclaw gateway status

6. 访问 Web 界面

启动后，在浏览器中访问：

1
http://localhost:3000

你会看到 OpenClaw 的 Web 聊天界面。

工作空间配置

OpenClaw 的工作空间位于 ~/.openclaw/workspace/，包含以下重要文件：

AGENTS.md

定义 AI 助手的行为规则和工作流程。

SOUL.md

定义 AI 助手的个性和价值观。

USER.md

记录用户信息和偏好。

MEMORY.md

长期记忆存储，记录重要的上下文和决策。

TOOLS.md

本地工具和环境配置（SSH、相机、TTS 等）。

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 启动/停止 Gateway
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 查看状态
openclaw status

# 查看配置
openclaw config list

# 查看日志
openclaw logs

# 更新 OpenClaw
npm update -g openclaw

技能系统

OpenClaw 使用技能（Skills）来扩展功能。技能存储在 ~/.agents/skills/ 目录。

安装技能

你可以从 ClawhHub 发现和安装技能：

1
2
# 示例：安装天气技能
openclaw skills install weather

创建自定义技能

在 ~/.agents/skills/ 创建新目录，添加 SKILL.md 文件：

1
2
3
# My Custom Skill

技能描述和使用说明...

连接消息平台

Telegram

  1. 与 @BotFather 创建机器人
  2. 获取 API Token
  3. 配置 OpenClaw：
1
openclaw config set telegram.botToken YOUR_BOT_TOKEN

WhatsApp

使用二维码连接：

1
openclaw whatsapp link

扫描显示的二维码即可连接。

高级配置

自定义模型

编辑 ~/.openclaw/config.json：

1
2
3
4
5
6
7
8
{
  "agents": {
    "defaults": {
      "model": "minimax/MiniMax-M2.5",
      "thinking": "low"
    }
  }
}

设置代理

如果需要通过代理访问 API：

1
2
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

常见问题

Q: 如何切换模型？

在聊天中直接说：”切换到 Claude” 或 “切换到 MiniMax”。

Q: 如何查看 API 使用情况？

发送 /status 命令查看当前会话的使用统计。

Q: 如何备份配置？

1
cp -r ~/.openclaw ~/.openclaw.backup

Q: Gateway 启动失败怎么办？

检查端口是否被占用：

1
lsof -i :3000

如果被占用，可以修改端口：

1
openclaw config set gateway.port 3001

最佳实践

  1. 定期更新：保持 OpenClaw 和 Node.js 版本最新
  2. 备份工作空间：定期备份 ~/.openclaw/workspace/
  3. 使用 Git：将工作空间纳入版本控制
  4. 保护 API Key：不要将配置文件提交到公开仓库
  5. 探索技能：访问 ClawhHub 发现更多有用的技能

资源链接

  • 官方文档：https://docs.openclaw.ai
  • GitHub：https://github.com/openclaw/openclaw
  • Discord 社区：https://discord.com/invite/clawd
  • 技能市场：https://clawhub.com

总结

OpenClaw 是一个功能强大且灵活的 AI 助手平台。通过本文的配置，你已经可以开始使用它来提升工作效率了。随着使用的深入，你会发现更多有趣的功能和用法。

祝你使用愉快！🎉