在 Mac 上用 OpenClaw 调用大模型:本地隐私与云端算力的自由切换

OpenClaw 是一个跑在你自己机器上的开源 AI Agent 框架:它不只是“聊天框”,而是能连 Telegram/WhatsApp、读文件、跑命令、搜网页、管日历的个人助手。模型层完全可插拔——本地 Ollama 跑开源模型,或接 OpenAI/Claude/DeepSeek/Qwen 的云端 API,都在同一个配置里完成。

下面按“装得顺、调得通、用得稳”的思路,把 Mac 上的完整链路拆开讲。

一、先搞清楚:OpenClaw 在 Mac 上怎么工作

核心是一个本地 Gateway(网关进程),默认监听 127.0.0.1:18789:

  • 上层:macOS 菜单栏 App 提供 UI,或接 Telegram 等聊天渠道
  • 中层:OpenClaw 网关做 Agent 编排、工具调用、会话管理
  • 底层:模型后端,三种选其一或混用
    • 本地:Ollama / LM Studio(离线、零 token 费)
    • 云端:OpenAI、Anthropic、DeepSeek、Qwen(OpenAI 兼容协议)
    • 代理网关:OpenRouter、Cloudflare AI Gateway 等

状态与配置都在 ~/.openclaw/ 下:openclaw.json 是主配置,workspace/ 放技能与记忆,凭证存 Keychain 或 .env。

二、安装:三种方式,挑最省心的

方式 1:macOS 官方 App(推荐大多数用户)

  • 系统要求:macOS 15+,Apple Silicon 或 Intel 都行
  • 官网下 .dmg 安装,首次启动走图形化 onboarding
  • App 自动管理 Gateway 生命周期,不用自己守终端

方式 2:一行脚本装 CLI(开发者偏好)

curl -fsSL https://openclaw.ai/install.sh | bash

装完有 openclaw 命令,走 openclaw onboard 引导。

方式 3:Node 源码跑(前沿体验)

需 Node ≥ 22、pnpm:

pnpm install
pnpm gateway:watch   # 热重载网关

再用 macOS App 以“Local 模式”挂到这个网关上。

前置检查:本地模型路线先装 Ollama(ollama.com);云端路线准备至少一个 API Key。

三、接本地模型:Ollama 零成本方案

1. 拉模型

ollama pull qwen2.5-coder:32b-instruct   # 工具调用强,推荐
# 或
ollama pull deepseek-r1:32b
ollama pull llama3.3:70b

中文场景优先 qwen3 系列;14B 以下模型容易在多点工具调用里“幻觉掉链子”。

2. 最快启动(一条命令)

ollama launch openclaw

会自动:装 OpenClaw → 选 Ollama 后端 → 选刚拉的模型 → 起网关。

3. 手动配置 ~/.openclaw/openclaw.json

{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434",
        "apiKey": "ollama-local",
        "api": "ollama"
      }
    },
    "default": "ollama/qwen3:32b"
  }
}

启动:

openclaw start --daemon

四、接云端大模型:DeepSeek / Qwen / Claude 怎么配

OpenClaw 对“OpenAI 兼容端点”支持很好,国产模型基本零改造。

1. DeepSeek 示例

{
  "models": {
    "default": "openai-compatible:deepseek-chat",
    "providers": {
      "openai-compatible": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-你的key"
      }
    }
  }
}

2. 阿里通义千问(DashScope)

{
  "models": {
    "default": "openai-compatible:qwen-max",
    "providers": {
      "openai-compatible": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-你的key"
      }
    }
  }
}

3. Anthropic Claude(原生协议)

onboarding 里选 Anthropic,读 ANTHROPIC_API_KEY;或写配置:

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "$ANTHROPIC_API_KEY"
  }
}

4. 多模型并存 + 兜底

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-compatible:deepseek-chat",
        "fallbacks": ["ollama/qwen3:14b"]
      },
      "utilityModel": "ollama/qwen3:14b"
    }
  }
}

主模型用云端,轻量任务或断网时回落本地。

安全习惯:Key 写环境变量("apiKey": "$DEEPSEEK_KEY"),别把 json 提交进 Git。

五、跑通第一个 Agent 调用

网关起来后,验证健康度:

openclaw health

在 macOS App 的对话框里直接问:

“读取 ~/Desktop/notes.md,总结成 3 条待办,并帮我写一封跟进邮件”

OpenClaw 会:

  1. 调模型做规划
  2. 调 file_read 工具读文件
  3. 调 code_run / 脚本工具生成文本
  4. 回传结果到聊天界面

接 Telegram 只需 BotFather 拿 token,走:

openclaw channels login telegram

手机发消息,Mac 本地网关在跑模型——数据不出本机网关(云端模型例外)。

六、Mac 专属坑位与调优

权限

  • 首次运行会弹 TCC 权限(文件访问、辅助功能),全点“允许”
  • 若用 Claude Code 凭证,Keychain 里“Claude Code-credentials”要对 launchd 放行

端口冲突

  • 网关默认 WS 端口 18789,App 与 CLI 必须同端口
  • 改端口在 gateway.port 字段,别只改一端

本地模型太慢

  • 32B 模型建议 32G+ 内存统一内存机器(M2 Max 及以上更舒服)
  • 退到 14B 或开 num_ctx 降上下文窗口
  • 或把重推理丢给 DeepSeek,本地只跑轻量 qwen3:14b 做心跳

心跳与成本

  • 开 heartbeat 会让模型定期“自言自语”,云端 Key 会悄悄烧钱
  • 调试期先关 heartbeat,或单独配 utilityModel 用便宜模型

七、典型组合建议(直接抄作业)

  • 隐私优先:Ollama + qwen3:32b,全离线,适合写代码/整理本地文档
  • 中文日常助手:DeepSeek-Chat 为主 + 本地兜底,成本低、响应快
  • 强推理+长上下文:Claude Sonnet 主模型,Haiku 做心跳,Telegram 收发
  • 团队共享:1Panel/Docker 部署网关,Mac 只做开发调试,云端 Key 走代理网关

八、一句话总括

在 Mac 上,OpenClaw 的价值不是“又多一个聊天客户端”,而是把模型选择权、数据驻留权、工具执行权交回你手里:想省钱就本地跑 Qwen,想聪明就接 Claude,想不断网就双后端热备。配置本质就是一份 openclaw.json——写清楚“模型从哪来、Key 放哪、工具开哪些”,剩下的事,让 Agent 自己 claws 起来。

模型是租的,Agent 是自己的。

在 macOS 菜单栏亮起那只小龙爪时,你的电脑才算真的会“想事”。

本文网址: https://www.gd230.cn/a/207.html