当前位置： 首页 > news >正文

在 macOS 上配置 OpenClaw 连接本地 Ollama 完整指南

news 2026/3/27 3:50:05

前言

最近在 macOS 上体验了 OpenClaw（“小龙虾”）这个开源 AI 助手框架，配合本地运行的 Ollama，实现了完全离线、免费的 AI 对话。本文将详细记录从零开始的配置过程，包括每一个选项的选择和背后的原因，希望能帮助遇到同样需求的朋友。

环境：

  • macOS (Apple Silicon)

  • 已安装 Ollama，并下载了模型gpt-oss:120b-cloud

  • 目标：让 OpenClaw 通过 Web UI 调用本地 Ollama 模型

第一步：安装 Node.js 和 OpenClaw

OpenClaw 需要 Node.js 22+ 环境。

bash

# 使用 Homebrew 安装 Node.js 22（或从官网下载 pkg） brew install node@22 # 设置 npm 国内镜像加速（可选） npm config set registry https://registry.npmmirror.com # 全局安装 OpenClaw npm install -g openclaw

如果遇到权限错误，使用sudo npm install -g openclaw。

第二步：运行配置向导

在终端执行：

bash

openclaw onboard

接下来会进入交互式配置，以下是每个问题的回答记录。

1. Onboarding mode

text

● QuickStart (Configure details later via openclaw configure.) ○ Manual

选择：Manual
理由：QuickStart 只会配置基本项，后续还需要手动调整；Manual 可以一次性完成所有自定义设置，包括连接本地 Ollama。

2. What do you want to set up?

text

● Local gateway (this machine) (No gateway detected (ws://127.0.0.1:18789)) ○ Remote gateway (info-only)

选择：Local gateway
理由：Ollama 在本机运行，需要在本机部署 OpenClaw 网关。

3. Model/auth provider

列表很长，需要向下滚动找到Custom Provider（通常在列表最底部）。
选择：Custom Provider
理由：Ollama 不属于列表中的任何商业服务，需要手动指定 API 地址。

4. API Base URL

text

http://127.0.0.1:11434/v1█

直接回车确认
Ollama 默认 API 地址就是http://127.0.0.1:11434/v1，OpenClaw 已自动填入。

5. How do you want to provide this API key?

text

● Paste API key now (Stores the key directly in OpenClaw config) ○ Use external secret provider

选择：Paste API key now
理由：Ollama 不需要真实 API Key，我们只需随便填一个占位符。

6. API Key (leave blank if not required)

输入：ollama（或其他任意字符，如123）
Ollama 不验证，但不能留空。

7. Endpoint compatibility

text

● OpenAI-compatible (Uses /chat/completions) ○ Anthropic-compatible ○ Unknown (detect automatically)

选择：OpenAI-compatible
理由：Ollama 的 API 端点兼容 OpenAI 格式。

8. Model ID

根据ollama list查看已安装的模型，我本地是：

text

gpt-oss:120b-cloud 569662207105 - 22 minutes ago

输入：gpt-oss:120b-cloud
必须与ollama list显示的完全一致。

9. Endpoint ID

text

custom-127-0-0-1-11434█

直接回车确认
默认 ID 足够标识这个自定义端点。

10. Model alias (optional)

text

e.g. local, ollama

输入：local（或直接回车跳过）
别名方便在 Web UI 中识别，我输入了local。

此时提示：

text

Configured custom provider: custom-127-0-0-1-11434/gpt-oss:120b-cloud

11. Gateway port

text

18789█

直接回车确认
默认端口，后续通过http://localhost:18789访问。

12. Gateway bind

text

● Loopback (127.0.0.1) ○ LAN (0.0.0.0) ○ Tailnet (Tailscale IP) ○ Auto (Loopback → LAN) ○ Custom IP

选择：Loopback (127.0.0.1)
只在本机监听，最安全，适合个人使用。

13. Gateway auth

text

● Token (Recommended default (local + remote)) ○ Password

选择：Token
使用令牌认证，OpenClaw 会生成随机 token。

14. Tailscale exposure

text

● Off (No Tailscale exposure) ○ Serve ○ Funnel

选择：Off
不需要通过 Tailscale 暴露服务。

15. How do you want to provide the gateway token?

text

● Generate/store plaintext token (Default) ○ Use SecretRef

选择：Generate/store plaintext token
让 OpenClaw 自动生成并存储 token。

16. Gateway token (blank to generate)

直接回车留空
OpenClaw 会自动生成随机 token。

17. Configure chat channels now?

text

● Yes / ○ No

选择：No
聊天渠道（如 Discord、Telegram）暂不需要，跳过。

18. Search provider

text

● Brave Search (Structured results · country/language/time filters) ○ Gemini (Google Search) ○ Grok (xAI) ○ Kimi (Moonshot) ○ Perplexity Search ○ Skip for now

选择：Skip for now
暂不需要联网搜索，以后可随时配置。

19. Configure skills now? (recommended)

text

● Yes / ○ No

选择：No
跳过技能（计算器、天气等），先体验基础对话。

20. Enable hooks?

text

◻ Skip for now ◻ 🚀 boot-md ◻ 📎 bootstrap-extra-files ◻ 📝 command-logger ◻ 💾 session-memory

操作：只选中Skip for now
用空格取消其他选项，仅保留Skip for now，然后回车。

21. Install Gateway service (recommended)

text

● Yes / ○ No

选择：Yes
安装为系统服务，实现开机自启和后台运行。

22. Gateway service runtime

text

● Node (recommended) (Required for WhatsApp + Telegram. Bun can corrupt memory on reconnect.)

选择：Node
官方推荐 Node 运行时。

23. Gateway service already installed

text

● Restart ○ Reinstall ○ Skip

选择：Restart
之前可能安装过，重启使新配置生效。

24. How do you want to hatch your bot?

text

● Hatch in TUI (recommended) ○ Open the Web UI ○ Do this later

选择：Open the Web UI
自动打开浏览器进入 Web 界面，更直观。

25. Enable bash shell completion for openclaw?

text

● Yes / ○ No

选择：Yes
启用命令补全，方便后续使用。

第三步：完成并登录

配置完成后，终端会显示类似信息：

text

Gateway service restarted successfully. Access URL: http://localhost:18789

浏览器自动打开该地址，但需要输入 Token。在终端执行：

bash

openclaw token generate

复制输出的令牌，粘贴到网页中，即可开始对话。

常见问题

  • 无法连接 Ollama：检查 Ollama 是否在运行（任务栏图标或ps aux | grep ollama），以及设置中是否开启了网络暴露（Ollama → Settings → Allow other programs to connect）。

  • 模型不响应：确认 Model ID 与ollama list完全一致，包括标签（如:latest）。

http://www.jsqmd.com/news/485373/

相关文章：

  • 计算机毕业设计springboot考察检测系统 基于SpringBoot的在线考试与成绩分析平台 基于SpringBoot的智能化教学测评管理系统
  • [MySQL] Package ‘libtirpc‘, required by ‘virtual:world‘, not found
  • 大模型为什么总“忘记”中间信息？Lost in the Middle的注意力陷阱
  • IAnnotation ​IDisplayDimension IDimension这三个类的职责 c# solidworks
  • 【LeetCode | 第六篇】算法笔记
  • COMSOL 数值模拟助力 N₂ 和 CO₂ 混合气体增强瓦斯抽采
  • 每日一题Day6(递归专栏---FBI数)
  • 情绪记录分析程序，记录每日情绪与触发事件，找出影响最大因素，给出调节建议。
  • 探索最优广义回归神经网络数据预测模型：DBO优化算法加持
  • OpenClaw 虚拟机保姆级部署指南
  • 大模型Agent技术全面升级
  • OpenClaw配置
  • 从CPU低延迟、GPU高带宽到大规模GPU集群
  • 用北方苍鹰优化算法优化随机配置网络SCN参数
  • 扣子（Coze）零基础入门全攻略｜扣子（Coze）核心功能详解，含长期记忆、快捷指令、音视频处理及私有化部署指南
  • 揭秘CAIE认证：证书含金量、对就业的实际帮助及项目实战模块
  • 金融平台如何扩展KindEditor的PPT动态内容自动填充？
  • WangEditor在Vue2中如何处理Word文档中的特殊格式粘贴？
  • Claude上下文再大，也绕不开agent开发的“分治”艺术
  • 为什么说杨建允团队是GEO优化的顶级服务商？ - 博客万
  • 理性评估：对比主流AI证书，赛一认证对应届生求职的实际加成
  • windows10本地安全隔离配置openclaw
  • 国产化控件如何实现KindEditor的PDF自动格式转换？
  • 解锁论文写作新姿势：书匠策AI，你的期刊论文智能导航员
  • 2026年佛山推荐售后好的木纹砖生产厂，哪家更值得选全揭秘 - 工业品网
  • 【爬虫】使用 Scrapy 框架爬取豆瓣电影 Top 250 数据的完整教程
  • 海洋主题文本聚类研究与可视化分析
  • 2026年上海靠谱中央空调排名，实力强的厂家推荐 - mypinpai
  • 为什么积分运算电路在反馈电容上要并联电阻
  • 教程分享：Vue2如何结合百度WebUploader插件实现大文件上传的进度可视化？