1. 🍎 前言
OpenClaw 是一个开源的 AI Agent 网关，让你的 Mac 瞬间变成智能体控制中心！支持多种 LLM 和工具集成，今天分享完整部署流程。
2. 📋 环境准备
2.1. 前置条件
- Node.js >= 22（必需）
- pnpm（可选，源码构建推荐）
- Brave Search API（推荐，用于网页搜索）
- Xcode / CLT（计划构建应用时需要）
3. 🛠️ 安装步骤
3.1. 1️⃣ 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
验证安装：
brew -v # 应显示 Homebrew 5.0.5+
3.2. 2️⃣ 安装 Node.js
推荐使用 nvm 管理 Node 版本：
# 安装 Node 22
nvm install 22
nvm alias default 22
nvm use default
# 验证
node -v # v22.x.x
npm -v
4. ⚡ 快速安装 OpenClaw
4.1. 方式一：npm 全局安装
npm install -g openclaw@latest
4.2. 方式二：修复权限后安装
如果遇到权限问题：
# 修复 nvm 目录权限
sudo chown -R $(whoami) ~/.nvm
# 修复 Node 模块目录权限
sudo chown -R $(whoami) ~/.nvm/versions/node/v22.x.x/lib/node_modules
# 重新安装
npm i -g openclaw
5. 🚀 初始化配置
5.1. 运行引导向导
openclaw onboard
按提示完成：
- 🔑 配置 API Keys
- 🌐 设置 Gateway 端口（默认 18789）
- 💾 选择存储路径
5.2. 启动 Gateway 服务
# 查看状态
openclaw gateway status
# 启动服务
openclaw gateway
# 后台运行（推荐）
openclaw onboard --install-daemon
6. 🎛️ 核心命令速查
| 命令 | 功能 |
|---|---|
openclaw status |
查看整体状态 |
openclaw health |
健康检查 |
openclaw doctor |
诊断问题 |
openclaw dashboard |
打开控制面板 |
openclaw config |
查看配置 |
6.1. 获取 Dashboard 链接
# 带 Token 的安全链接
openclaw dashboard --no-open
# 获取 Token
openclaw config get gateway.auth.token
7. 🔧 常见问题解决
7.1. ❌ "command not found"
# 加载 nvm 环境
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
nvm use --lts
7.2. ❌ Dashboard 报错 1008
# 1. 批准设备配对
openclaw devices approve --latest
# 2. 重新生成链接
openclaw dashboard --no-open
# 3. 清理并重新配对（如仍有问题）
openclaw devices clear --pending --yes
8. 🌐 配置网页搜索
让 AI 具备联网能力：
openclaw configure --section web
填入 Brave Search API Key 即可。
9. 📁 重要文件路径
| 路径 | 说明 |
|---|---|
~/.openclaw/openclaw.json |
主配置文件 |
~/.openclaw/workspace/ |
Agent 工作区 |
~/.openclaw/credentials/ |
凭证存储 |
~/.openclaw/logs/gateway.log |
网关日志 |
~/Library/LaunchAgents/ai.openclaw.gateway.plist |
macOS 服务配置 |
10. 🔗 相关资源
- 📖 官方文档：https://docs.openclaw.ai/zh-CN
- 🇨🇳 中文社区：https://clawcn.net/start/getting-started
- 🔌 插件市场：https://clawhub.ai/
- 💻 GitHub：https://github.com/VoltAgent/awesome-openclaw-skills
11. 📝 安装验证
# 查看版本
openclaw --version
# 查看状态
openclaw status
# TUI 界面
OPENCLAW_TOKEN="$(openclaw config get gateway.auth.token | tr -d '\"')"
openclaw tui --token "$OPENCLAW_TOKEN" --url ws://127.0.0.1:18789
12. ✨ 总结
部署完成后，你的 Mac 就拥有了强大的 AI Agent 能力：
✅ 支持多种大模型切换 ✅ 丰富的工具插件生态 ✅ 可视化的 Web 控制面板 ✅ 飞书/钉钉等渠道集成
遇到问题记得用 openclaw doctor 诊断！
13. OpenClaw #AI工具 #Mac技巧 #开发者工具 #智能体 #开源项目 #效率工具 #编程入门
作者: 雪之梦技术驿站
来源: 雪之梦技术驿站
本文原创发布于「雪之梦技术驿站」,转载请注明出处,谢谢合作!
