前言

OpenClaw(江湖人称”龙虾”)是一个强大的本地 AI 助理框架,支持插件扩展、多渠道接入(QQ、Telegram、飞书等)、MCP 协议、浏览器自动化…功能非常丰富。

如果你有一台 Mac mini,完全可以把它当作 24 小时运行的 AI 服务器。本文详细介绍如何在一台全新 Mac mini(M4/M4 Pro)上部署 OpenClaw。


环境要求

  • 系统:macOS 14+ (Sonoma)
  • 内存:建议 16GB 以上
  • Node.js:v24(推荐),v22 LTS 也支持
  • 磁盘:建议 256GB SSD 以上

Mac mini M4 最低配 16GB 内存版本是性价比最高的选择。


安装步骤

第一步:检查环境

打开终端,检查 Node.js 是否已安装:

node --version
# v24.x.x 为佳

npm --version
# 应大于 10.x

如果没有安装 Node,使用 Homebrew 安装:

brew install node

第二步:一键安装 OpenClaw

运行官方安装脚本:

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

这个脚本会自动完成:

  1. 检测 Node 环境
  2. 全局安装 OpenClaw CLI
  3. 启动初始配置向导

如果只想安装不启动配置向导:

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

第三步:配置向导

安装完成后,首次运行 openclaw 会进入配置向导,主要配置:

  • Gateway 端口:默认 18789,可保持默认
  • 工作区路径:默认 ~/.openclaw/workspace
  • 渠道接入:选择需要接入的聊天平台(QQ、Telegram、飞书等)
  • AI 模型:配置使用的语言模型(支持 Ollama、OpenAI、Moonshot 等)

第四步:验证安装

openclaw doctor      # 检查配置问题
openclaw status      # 查看 Gateway 状态
openclaw dashboard   # 打开浏览器控制台

进阶配置

配置 QQ 机器人

  1. 前往 QQ 开放平台(q.qq.com)创建应用
  2. 获取 App ID 和 Client Secret
  3. 运行配置命令:openclaw configure --section channels

配置本地模型(Ollama)

# 安装 Ollama
brew install ollama

# 拉取模型
ollama pull llama3.2:3b

# 启动服务
ollama serve

开机自启配置

Mac mini 作为服务器,需要配置开机自启。使用 launchd:

cat > ~/Library/LaunchAgents/com.openclaw.gateway.plist << 'EOF'




    Label
    com.openclaw.gateway
    ProgramArguments
    
        /opt/homebrew/bin/openclaw
        gateway
        start
    
    RunAtLoad
    


EOF

launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist

常用命令

  • openclaw status — 查看状态
  • openclaw dashboard — 打开控制台
  • openclaw update — 更新版本
  • openclaw doctor — 诊断问题
  • openclaw logs — 查看日志

常见问题

Q: 提示 openclaw: command not found

重新加载 PATH 或手动添加到 ~/.zshrc

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Q: QQ 机器人无法接收消息

检查 WebSocket 连接状态:openclaw status

确认 QQ 开放平台的事件订阅配置正确。


总结

Mac mini 是部署 OpenClaw 的绝佳选择——体积小巧、功耗低、性能强,可以 24 小时运行。安装过程非常简单,一条命令即可完成核心部署。

部署完成后,你就拥有了一个完全私有的 AI 助理,所有数据都在本地处理,隐私安全有保障。


参考资料:

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。