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 会:
- 调模型做规划
-
调
file_read工具读文件 -
调
code_run/ 脚本工具生成文本 - 回传结果到聊天界面
接 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 菜单栏亮起那只小龙爪时,你的电脑才算真的会“想事”。