Mac 系统安装与配置 OpenClaw 指南

前置环境

在开始之前，请确保你的 Mac 已经安装了以下基础工具：

• Homebrew：macOS 的包管理器
• Node.js：运行网关服务所需
• Git：版本控制工具

如果你打算使用本地大模型（如 Ollama），还需要提前安装好 Ollama 并拉取相应的模型文件。

安装 CLI 工具

通过 Homebrew 可以快速安装 OpenClaw 的命令行客户端。打开终端执行：

brew install openclaw-cli

执行后，Homebrew 会自动下载依赖项并进行编译。这个过程可能需要几分钟，取决于网络状况和机器性能。当终端输出包含 🍺 /opt/homebrew/Cellar/openclaw-cli/... 字样时，说明安装成功。

此时，你就可以在终端直接使用 openclaw 命令了。

初始化配置

首次运行需要引导完成基础设置。以配置本地 Ollama 大模型为例，输入：

openclaw onboard

程序会进入交互式向导，主要涉及以下几个关键步骤：

1. 安全确认：OpenClaw 是一个仍在开发中的项目，具备读取文件和运行操作的能力。向导会提示安全风险，建议阅读文档后确认继续。
2. 模型选择：这里可以指定使用的模型提供商。例如配置 Ollama 时，需填写 API Base URL（默认为 http://127.0.0.1:11434/v1）以及具体的 Model ID（如 qwen3:14b）。
3. 通道设置：可以选择是否连接即时通讯渠道（如 Telegram、Discord 等）。初次使用建议先跳过，后续再按需启用。
4. 钩子（Hooks）：用于自动化任务，默认会启用一些基础钩子如 boot-md 和 session-memory。
5. 网关服务：安装完成后会自动启动 Gateway 服务，并在浏览器中打开 Web UI 控制面板。

配置过程中可能会遇到健康检查失败的提示（如 gateway closed），这通常是因为服务正在启动或端口占用，稍作等待或重启服务即可解决。

配置文件说明

安装成功后，配置文件位于当前用户的主目录下：

~/.openclaw/

该目录下的核心文件包括：

• openclaw.json：主配置文件，存储模型、密钥及网关设置。
• workspace/：工作区目录，存放会话历史和临时数据。
• agents/：代理实例的配置与状态信息。

你可以通过修改 openclaw.json 来调整全局参数，或者使用 openclaw config set 命令进行动态更新。