前置环境
在开始之前,请确保你的 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
程序会进入交互式向导,主要涉及以下几个关键步骤:
- 安全确认:OpenClaw 是一个仍在开发中的项目,具备读取文件和运行操作的能力。向导会提示安全风险,建议阅读文档后确认继续。
- 模型选择:这里可以指定使用的模型提供商。例如配置 Ollama 时,需填写 API Base URL(默认为
http://127.0.0.1:11434/v1)以及具体的 Model ID(如qwen3:14b)。 - 通道设置:可以选择是否连接即时通讯渠道(如 Telegram、Discord 等)。初次使用建议先跳过,后续再按需启用。
- 钩子(Hooks):用于自动化任务,默认会启用一些基础钩子如
boot-md和session-memory。 - 网关服务:安装完成后会自动启动 Gateway 服务,并在浏览器中打开 Web UI 控制面板。
配置过程中可能会遇到健康检查失败的提示(如 gateway closed),这通常是因为服务正在启动或端口占用,稍作等待或重启服务即可解决。
配置文件说明
安装成功后,配置文件位于当前用户的主目录下:
~/.openclaw/
该目录下的核心文件包括:
openclaw.json:主配置文件,存储模型、密钥及网关设置。workspace/:工作区目录,存放会话历史和临时数据。agents/:代理实例的配置与状态信息。
你可以通过修改 openclaw.json 来调整全局参数,或者使用 openclaw config set 命令进行动态更新。





