Mac安装OpenClaw安装教程 & 常见问题避坑 & 指令的使用

说出来你们可能不信，我之前一直觉得本地部署AI助手这件事特别复杂，直到我研究了 OpenClaw 的文档.，才发现比想象中简单今天给大家分享一下，在 Mac 下安装 Openclaw 的教程

🟦 为什么选择 OpenClaw？

先说说为什么推荐 OpenClaw：

✅ 硬件要求极低：512MB 内存就能跑，MacBook Air 完全没问题
✅ 隐私完全可控：所有数据留在本地，不上传第三方服务器
✅ 插件生态丰富：支持飞书、微信、Telegram、WhatsApp 等各种渠道
✅ 开源免费：白嫖党狂喜

🟨 安装前准备

在安装之前，你需要确认以下几点：

1️⃣ 检查 Node.js 版本

OpenClaw 需要 Node.js 18+，打开终端输入：

node -v

如果版本低于 18，用 nvm 升级：

nvm install 18nvm use 18

2️⃣ 安装 OpenClaw

有两种方式，推荐用 npm：

npm install -g openclaw

或者用 Homebrew：

brew install openclaw

3️⃣ 初始化配置

安装完成后，运行初始化向导：

openclaw setup

或者一步到位的 onboarding：

openclaw onboard

跟着提示走，基本就是点点点的事儿～

🟦 常见安装坑点

⚠️ npm error code 128：这个错误很常见，大概率是 git 仓库没拉下来。解决方案：

# 换个网络环境，或者挂代理git config --global http.proxy http://127.0.0.1:7890git config --global https.proxy http://127.0.0.1:7890

⚠️ Node.js 版本不满足：用 nvm 切换到 18+ 版本即可。

❗️ 常用命令大全

这里整理了 OpenClaw 最常用的命令，建议收藏！

基础命令

命令	作用
`openclaw setup`	初始化配置和 workspace
`openclaw onboard`	交互式引导设置
`openclaw configure`	配置 AI 模型、渠道、技能
`openclaw status`	查看当前状态
`openclaw doctor`	健康检查+修复

Gateway 管理

命令	作用
`openclaw gateway start`	启动 Gateway
`openclaw gateway stop`	停止 Gateway
`openclaw gateway restart`	重启 Gateway
`openclaw gateway status`	查看 Gateway 状态

定时任务 (Cron)

命令	作用
`openclaw cron list`	查看定时任务
`openclaw cron add`	添加定时任务
`openclaw cron rm <id>`	删除定时任务

插件管理

命令	作用
`openclaw plugins list`	查看已安装插件
`openclaw plugins install <插件>`	安装插件
`openclaw plugins enable <插件>`	启用插件

技能 (Skills)

命令	作用
`openclaw skills list`	查看可用技能
`openclaw skills info <技能名>`	查看技能详情

消息发送

命令	作用
`openclaw message send --target <用户> --message <内容>`	发送消息

🔴 进阶：配置多个渠道

OpenClaw 支持同时配置多个聊天渠道，非常强大：

# 添加 Telegram 渠道openclaw channels add --channel telegram --token <你的BOT_TOKEN># 添加 WhatsAppopenclaw channels add --channel whatsapp# 查看所有渠道状态openclaw channels status

🟧 小缺点

🟧 首次配置需要一点终端操作经验
🟧 部分高级功能需要外网访问
🟧 高级渠道（Telegram/Discord 等）需要自备账号

🔥 适合谁？

人群	推荐理由
技术爱好者	可玩性高，插件丰富
注重隐私的用户	数据完全本地存储
想自建 AI 助手的	门槛比想象中低很多
开发者	支持 ACP 协议连接 IDE