KNOWLEDGE BASE · OpenClaw教程

Mac M2本地部署OpenClaw+Ollama实战：六个坑我都替你踩过了

对于追求隐私和数据安全的用户来说，在Mac设备上本地部署AI是一个极具吸引力的选择。然而，实际操作中却充满挑战。本文将详细记录在MacBook Air M2（24GB内存）上部署OpenClaw与Ollama的完整过程，并分享过程中遇到的六个关键问题和解决方案。

部署目标是在完全离线环境下运行一个私密的AI助手，使用Qwen 3 8B作为语言模型。尽管目标明确，但实际操作中遇到了各种意想不到的问题，从依赖项安装到配置文件调整，每个环节都可能成为阻碍。

第一个坑出现在安装Ollama阶段。使用Homebrew安装时，系统报错提示Cask定义无效。尝试更换镜像源和执行reset、force upgrade等操作均未解决问题。最终，我们选择绕过Homebrew，直接从官网（ollama.com/download）下载macOS安装包，并手动拖入应用程序文件夹。安装完成后，菜单栏出现羊驼图标，表明Ollama已成功运行。

第二个坑是OpenClaw Gateway启动失败。运行status命令显示Gateway端口18789未在监听状态，错误提示需要设置gateway.mode=local。通过手动编辑~/.openclaw/openclaw.json配置文件，添加"mode": "local"，并执行stop和start命令后，Gateway成功启动。然而，在排查过程中，我们发现按照网络教程添加host和port配置后，系统报错配置无效。原因是OpenClaw会自动绑定默认地址和端口，手动指定反而导致解析失败。删除这两个字段后，问题解决。这提醒我们不要随意添加未明确说明的配置项。

第四个坑出现在Agent配置层面。系统报错提示找不到Anthropic的API key，但实际使用的是本地Ollama模型。检查配置发现agent的model部分仍残留着authProvider配置。解决方案是重新运行onboard向导，选择Custom Provider并正确配置Ollama的连接地址。这一步骤确保Agent能正确识别并连接本地模型。

第五个坑涉及Telegram通道配置。尽管在设置过程中跳过了Telegram，但系统仍在尝试连接并报错。排查后发现需要在agent配置中手动删除或清空channels字段。这一步骤消除了不必要的连接尝试，避免了潜在错误。

最后一个坑是连接被拒绝的错误。排查发现Ollama进程在不知何时被退出了，导致OpenClaw无法连接。解决方法是在应用程序中重新打开Ollama.app，或使用brew services start ollama命令确保其开机自启动。这一步骤确保AI助手能持续稳定运行。

📖 原文链接：https://studyopenclaw.cn/?p=2578

OpenClaw 知识库 · OpenClaw教程