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

前言最近在 macOS 上体验了 OpenClaw“小龙虾”这个开源 AI 助手框架配合本地运行的 Ollama实现了完全离线、免费的 AI 对话。本文将详细记录从零开始的配置过程包括每一个选项的选择和背后的原因希望能帮助遇到同样需求的朋友。环境macOS (Apple Silicon)已安装 Ollama并下载了模型gpt-oss:120b-cloud目标让 OpenClaw 通过 Web UI 调用本地 Ollama 模型第一步安装 Node.js 和 OpenClawOpenClaw 需要 Node.js 22 环境。bash# 使用 Homebrew 安装 Node.js 22或从官网下载 pkg brew install node22 # 设置 npm 国内镜像加速可选 npm config set registry https://registry.npmmirror.com # 全局安装 OpenClaw npm install -g openclaw如果遇到权限错误使用sudo npm install -g openclaw。第二步运行配置向导在终端执行bashopenclaw onboard接下来会进入交互式配置以下是每个问题的回答记录。1. Onboarding modetext● 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 URLtexthttp://127.0.0.1:11434/v1█直接回车确认Ollama 默认 API 地址就是http://127.0.0.1:11434/v1OpenClaw 已自动填入。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或其他任意字符如123Ollama 不验证但不能留空。7. Endpoint compatibilitytext● OpenAI-compatible (Uses /chat/completions) ○ Anthropic-compatible ○ Unknown (detect automatically)选择OpenAI-compatible理由Ollama 的 API 端点兼容 OpenAI 格式。8. Model ID根据ollama list查看已安装的模型我本地是textgpt-oss:120b-cloud 569662207105 - 22 minutes ago输入gpt-oss:120b-cloud必须与ollama list显示的完全一致。9. Endpoint IDtextcustom-127-0-0-1-11434█直接回车确认默认 ID 足够标识这个自定义端点。10. Model alias (optional)texte.g. local, ollama输入local或直接回车跳过别名方便在 Web UI 中识别我输入了local。此时提示textConfigured custom provider: custom-127-0-0-1-11434/gpt-oss:120b-cloud11. Gateway porttext18789█直接回车确认默认端口后续通过http://localhost:18789访问。12. Gateway bindtext● 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 authtext● Token (Recommended default (local remote)) ○ Password选择Token使用令牌认证OpenClaw 会生成随机 token。14. Tailscale exposuretext● 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 providertext● 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 runtimetext● Node (recommended) (Required for WhatsApp Telegram. Bun can corrupt memory on reconnect.)选择Node官方推荐 Node 运行时。23. Gateway service already installedtext● 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启用命令补全方便后续使用。第三步完成并登录配置完成后终端会显示类似信息textGateway service restarted successfully. Access URL: http://localhost:18789浏览器自动打开该地址但需要输入 Token。在终端执行bashopenclaw token generate复制输出的令牌粘贴到网页中即可开始对话。常见问题无法连接 Ollama检查 Ollama 是否在运行任务栏图标或ps aux | grep ollama以及设置中是否开启了网络暴露Ollama → Settings → Allow other programs to connect。模型不响应确认 Model ID 与ollama list完全一致包括标签如:latest。