MacOS 上部署 OpenClaw 的全界面操作方案

MacOS 部署 OpenClaw：免命令行全图形界面教程

想在 Mac 电脑上轻松体验 OpenClaw 并连接本地大语言模型吗？本文提供两种无需命令行的纯图形界面部署方案，全程通过点击和配置完成。即使是新手也能快速上手，打通从界面到本地模型推理的全流程。

准备工作与环境：本教程基于 MacOS 系统，需要提前安装好 Docker Desktop 和 Ollama 桌面应用（Ollama.app）。

为简化演示流程，我们将选用一个轻量高效的本地模型 qwen3:4b 为例进行配置。

方案一：通过 1Panel 面板部署 OpenClaw

此方案采用“可视化套娃”策略：首先在 Docker 中部署一个功能强大的服务器管理面板——1Panel，然后通过该面板的应用商店一键安装和管理 OpenClaw。思路清晰，操作可视。

1) 设置 Docker Desktop 文件共享权限

首先，需要配置 Docker 使其能够访问 Mac 主机上的指定目录。启动 Docker Desktop，依次进入：
Settings（设置） → Resources（资源） → File sharing（文件共享）
点击“添加路径”（Add Path）按钮，输入路径：/opt。此步骤至关重要，它为后续容器与主机间的目录挂载提供了桥梁。

2) 创建并运行 1Panel 容器

返回 Docker Desktop 的容器（Containers）界面，点击“Add Container”（添加容器）按钮来新建容器。

• 容器名称（Name）: 输入 1panel
• 端口映射（Ports）: 添加一条规则，将容器内部的 80 端口映射到 Mac 主机的 10086 端口（或任意未被占用的端口）。
• 卷/挂载（Volumes）: 此处需要添加两个挂载点：
  1. /var/run/docker.sock:/var/run/docker.sock （赋予1Panel管理宿主机Docker的权限）
  2. /opt:/opt （挂载我们上一步共享的目录）

镜像（Image）使用官方默认的 1panel/1panel:latest，点击运行（Run）启动容器。

3) 获取 1Panel 管理员账号信息

容器运行后，点击其日志（Logs）或终端（Terminal）标签页。在终端内执行以下命令：
1pctl user-info
执行后，系统会显示默认的登录用户名和密码，请妥善记录。
打开您的浏览器，访问地址：http://127.0.0.1:10086，使用获取的账号登录，即可进入功能全面的 1Panel 管理后台。

4) 在 OpenClaw 中配置模型供应商（Model Account）

在 1Panel 的“应用商店”找到并安装 OpenClaw。安装完成后，进入 OpenClaw 的配置界面，找到添加模型供应商（Model Providers）的选项。
点击新建一个供应商账号：

• 供应商名称（Name）: ollama
• 供应商类型（Model Provider）: 选择 Ollama
• API 密钥（API Key）: 可随意填写任意字符串（因为本地 Ollama 服务通常不需要鉴权）。
• 基础地址（Base URL）: 这是核心配置！请务必填入 http://host.docker.internal:11434。host.docker.internal 是一个 Docker 内部特殊域名，用于让容器访问宿主机的服务。

5) 创建 AI 智能体（Agent）

接下来，在 OpenClaw 内创建一个新的 AI 智能体。

• 智能体名称（Name）: 例如 openclaw-assistant
• 模型供应商（Model Provider）: 选择上一步创建的 ollama
• 模型选择: 可能需要勾选“手动指定模型”，然后在模型（Model）字段中填入 ollama/qwen3:4b
• 关联的模型账号（Model Account）: 选择对应的 ollama 账号

创建成功后，系统会生成一个访问令牌（Token），请立即复制并保存，下一步配置需要用到。

6) OpenClaw 控制台配置与连通性测试

OpenClaw 通常提供一个独立的控制台（Console）网页，默认访问地址可能是 http://127.0.0.1:18789（实际端口请根据安装情况确认）。
在控制台界面，依次按照以下路径进行配置：

1. 进入 Control → Overview → Gateway Access → Gateway Token，粘贴并保存上一步获取的 Token。
2. 进入 Config → Models → Providers，找到名为 ollama 的供应商，确保其 Api 配置项选择了正确的账户（即 ollama），保存设置。
3. 最后，前往 Chat → Chat 页面，尝试输入一个问题。如果能正常收到来自本地模型的智能回复，恭喜您，这意味着从图形界面到本地大模型推理的完整链路已经成功连通。

方案二：直接使用 Docker 镜像部署 OpenClaw

如果您希望部署过程更直接，无需额外管理面板，此方案更为简洁。我们将直接拉取并运行 OpenClaw 的官方 Docker 镜像。

1) 拉取并运行 OpenClaw 容器

在 Docker Desktop 中创建新容器：

• 镜像名称（Image）: fourplayer/openclaw （可使用最新版本标签）
• 端口映射（Ports）: 根据官方文档说明，通常需要映射以下端口：18788, 18789, 22。请以实际镜像要求为准。

创建并运行容器。

2) 访问 Web 界面进行关键配置

容器启动后，在浏览器中访问其 Web 管理界面（通常是 http://127.0.0.1:18789），开始进行核心设置。

A. 配置默认智能体参数

导航至：Config → Agents → Defaults
此处设置所有智能体的基础参数：

• 远程嵌入 API 密钥（Remote Embedding API Key）: 如果需要使用远程嵌入服务则填入真实密钥，否则可填写 API_KEY 作为占位符。
• 主模型（Primary Model）: 输入 ollama/qwen3:4b，将其设置为默认的推理模型。

B. 添加模型供应商（Provider）

这是连接本地 Ollama 服务的关键步骤。进入：
Config → Models → Providers → Add Entry
填写新的供应商信息：

• 名称（Name）: ollama
• 接口类型（Api）: 选择或手动输入 ollama
• API 密钥（Api Key）: 可填写如 API_KEY 的占位字符串。
• 基础地址（Base Url）: 核心配置，必须填入 http://host.docker.internal:11434。

C. 在供应商下添加具体模型

添加完供应商后，还需要为其关联具体的模型文件。进入：
Config → Models → Providers → ollama → Models → Add
添加一个新模型条目，配置如下：

• 接口（Api）: ollama（关联到刚创建的供应商）
• 模型 ID（Id）: qwen3:4b
• 显示名称（Name）: qwen3:4b
• 启用推理（Reasoning）: 设置为 true，以激活模型的推理能力。

保存所有配置后，切换到聊天界面进行测试，此时应该可以正常与本地部署的 Qwen 模型进行对话了。

以上就是在 macOS 系统上，无需输入任何命令行，仅通过图形界面完成 OpenClaw 部署并成功对接本地 Ollama 大模型的两种详细方法。两种方案如何选择？方案一（通过1Panel）适合需要集中管理多个 Docker 服务和应用的用户，提供了更完善的可视化管理功能；方案二（直接部署）则更加轻量直接，适合追求简洁架构的用户。无论选择哪一种，理解并正确配置 host.docker.internal:11434 这个连接地址都是成功的关键，它架起了容器内应用与宿主机上 Ollama 服务之间的通信桥梁。现在就开始动手尝试吧，整个过程如同拼接可视化积木一样直观明了。