一、核心环境准备
硬件：Apple Mac mini M4 (16GB RAM)
系统：macOS Sequoia
模型后端：Ollama (运行 Qwen 2.5-7B)
Agent 框架：OpenClaw (v2026.3.2)
Node 版本：v24.14.0 (通过 nvm 管理)
二、环境初始化与权限
在 Mac 终端部署时，首要解决的是权限与路径问题。以下是常用操作建议：
Control + C：强制停止当前运行的命令（如安装卡死时）。sudo：以管理员身份运行。若遇到权限不足，在指令前加sudo即可。
Node.js 环境修复
若遇到 zsh: command not found: openclaw，通常说明 NVM 路径未加载到当前 Shell 会话中。
临时加载环境
source ~/.nvm/nvm.sh && nvm use 24
永久写入配置
echo 'export NVM_DIR="$HOME/.nvm"\n[ -s "$NVM_DIR/nvm.sh" ] && \ . "$NVM_DIR/nvm.sh"' >> ~/.zshrc && source ~/.zshrc
三、模型选择与性能调优
针对 16GB 内存，测试了不同参数量的模型表现：
- Qwen 2.5-14B：逻辑极强，但占用约 9GB 显存，响应稍慢。
- DeepSeek-R1-8B：推理能力卓越，但对 OpenClaw 的 Tools (函数调用) 兼容性一般。
- Qwen 2.5-7B (推荐)：秒回速度，完美支持自动化工具协议，是 M4 下的最佳平衡点。
安装命令：
ollama run qwen2.5:7b
四、OpenClaw 配置详解
手动编辑 ~/.openclaw/openclaw.json 是解决配置报错的最快方式。关键配置项说明如下：
baseUrl: 必须指向http://127.0.0.1。appSecret: 飞书后台的真实密钥（非 cli_ 开头）。tools.profile: 设置为minimal或none以减少小模型工具调用的报错。
最终稳定版配置参考：
{
"models": {
"providers": {
"custom-127-0-0-1-11434"
