OpenClaw安装避坑指南：macOS下对接GLM-4.7-Flash全流程

OpenClaw安装避坑指南：macOS下对接GLM-4.7-Flash全流程

1. 为什么选择OpenClaw+GLM-4.7-Flash组合

去年我在尝试自动化处理日常办公文档时，偶然发现了OpenClaw这个开源框架。它最吸引我的是能在本地电脑上实现"AI实体化"——让大模型像真人一样操作我的MacBook。而GLM-4.7-Flash作为轻量级中文模型，在本地部署时显存占用仅6GB左右，特别适合我的M1 MacBook Air。

这个组合帮我实现了：

• 自动整理混乱的会议纪要文档
• 定时抓取指定网页内容生成摘要
• 根据邮件内容自动归类存档

不过初次安装时，我踩遍了所有能想到的坑。下面就把完整的避坑经验分享给大家。

2. macOS环境准备与基础安装

2.1 系统环境检查

在开始前，请确保你的macOS满足：

• 系统版本 ≥ 12.0 (Monterey)
• 可用内存 ≥ 8GB（GLM-4.7-Flash需要6GB左右）
• 已安装Homebrew和Node.js 18+

可以通过终端快速检查：

sw_vers free -m node -v

2.2 官方脚本安装OpenClaw

推荐使用官方一键安装脚本：

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

这里有个隐藏坑点：如果之前安装过旧版本，需要先执行：

sudo npm uninstall -g openclaw

否则会出现奇怪的权限冲突。安装完成后验证版本：

openclaw --version # 预期输出类似：openclaw/0.9.1 darwin-arm64 node-v18.16.0

3. GLM-4.7-Flash本地部署要点

3.1 通过ollama部署模型

使用ollama可以简化模型部署过程：

ollama pull glm-4.7-flash ollama run glm-4.7-flash

部署成功后，默认会在本机11434端口启动API服务。我遇到的最大问题是——ollama有时会占用异常端口。可以通过以下命令确认：

lsof -i :11434

如果没有输出，可能需要手动指定端口：

OLLAMA_HOST=0.0.0.0:11434 ollama serve

3.2 模型服务验证

新建终端窗口测试API连通性：

curl http://localhost:11434/api/generate -d '{ "model": "glm-4.7-flash", "prompt": "你好" }'

正常应该返回类似：

{"response":"你好！有什么我可以帮助你的吗？"}

4. OpenClaw对接GLM-4.7-Flash的关键配置

4.1 修改OpenClaw配置文件

配置文件路径：~/.openclaw/openclaw.json

需要新增GLM-4.7-Flash作为模型提供方：

{ "models": { "providers": { "ollama-glm": { "baseUrl": "http://localhost:11434", "api": "openai-completions", "models": [ { "id": "glm-4.7-flash", "name": "GLM-4.7-Flash (Local)", "contextWindow": 8192 } ] } } } }

4.2 常见配置错误

1. baseUrl错误：必须包含http://前缀
2. api类型错误：ollama使用的是OpenAI兼容协议
3. 端口冲突：确保11434端口未被其他服务占用

配置完成后重启网关：

openclaw gateway restart

5. 权限与网络问题排查指南

5.1 macOS权限问题

首次运行时，OpenClaw会请求：

• 辅助功能权限（控制鼠标键盘）
• 完全磁盘访问权限（读写文件）
• 屏幕录制权限（截图识别）

如果任务执行失败，可以检查：

openclaw doctor

这个命令会列出缺失的权限。

5.2 网络连接问题

典型症状：

• 模型响应超时
• 网关无法启动
• 飞书等渠道连接失败

排查步骤：

1. 检查本地防火墙：

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --listapps

2. 临时关闭防火墙测试：

sudo /usr/libexec/ApplicationFirewall/socketfilterfw --setglobalstate off

3. 检查代理设置：

networksetup -getwebproxy Wi-Fi

6. 我的真实使用体验

经过两周的持续使用，这个组合最让我惊喜的是处理中文文档的能力。比如让它"整理上周所有会议纪要中的待办事项"，它能准确提取出分散在不同文档中的任务项。

但也要注意：

• 长时间运行可能导致内存泄漏（建议每天重启）
• 复杂任务需要拆分成子步骤
• 截图识别受屏幕分辨率影响较大

一个实用的技巧是，在~/.openclaw/custom_skills目录下存放自定义脚本，可以大幅扩展能力边界。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。