macOS 苹果电脑部署 OpenClaw 保姆级教程 - 从零打造你的 AI 助手

# macOS 苹果电脑部署 OpenClaw 保姆级教程 - 从零打造你的 AI 助手

OpenClaw 是一个开源的 AI 助手框架，支持多种 AI 模型和聊天平台。本教程从安装 Homebrew 开始，手把手教你完成 OpenClaw 的部署、配置和飞书对接。

---

一、准备工作

系统要求

• macOS 10.15 (Catalina) 或更高版本
• 至少 4GB 可用内存
• 稳定的网络连接

需要准备的账号

1. AI 模型 API Key（任选其一） - DeepSeek：https://platform.deepseek.com（推荐，免费额度多） - 百度千帆：https://qianfan.cloud.baidu.com - OpenAI：https://platform.openai.com - Claude：https://console.anthropic.com

2. 飞书账号（可选，用于飞书机器人） - 飞书开放平台：https://open.feishu.cn

---

二、安装 Homebrew

Homebrew 是 macOS 的包管理器，用于安装开发工具。

安装 Homebrew

打开「终端」应用，执行：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

按提示选择镜像源（推荐选择清华大学镜像）。

如果之前安装失败，先清理残留

# 清理旧版本残留
sudo rm -rf /opt/homebrew
sudo rm -rf /usr/local/Homebrew
sudo rm -rf ~/Library/Caches/Homebrew
sudo rm -rf ~/Library/Logs/Homebrew
rm -rf ~/.zprofile
touch ~/.zprofile

清理后重新执行安装命令。

验证安装

brew --version

显示版本号即安装成功。

---

三、安装 Git

Git 用于代码版本管理。

brew install git

配置 Git

# 配置用户名和邮箱
git config --global user.name "你的名字"
git config --global user.email "your@email.com"
# 自动把 SSH 地址切换成 HTTPS（国内推荐）
git config --global url."https://github.com/".insteadOf git@github.com/

---

四、安装 Node.js

Node.js 是 OpenClaw 的运行环境。

方式一：官网下载（推荐）

1. 访问 Node.js 官网 2. 下载 LTS 版本（长期支持版，推荐 20.x） 3. 双击安装包，一路下一步完成安装

方式二：使用 Homebrew 安装

brew install node

验证安装

node -v
npm -v

显示版本号即安装成功。

切换 npm 国内镜像源

npm config set registry https://registry.npmmirror.com

---

五、安装 OpenClaw

全局安装

sudo npm install -g openclaw@latest

验证安装

openclaw --version

删除飞书插件重复（如有）

sudo rm -rf ~/.openclaw/extensions/feishu

---

六、初始化配置

启动配置向导

openclaw onboard

按提示完成配置： 1. 选择 AI 模型提供商 2. 输入 API Key 3. 选择默认模型

或手动配置

如果跳过配置向导，可以手动配置 API：

# DeepSeek 配置
openclaw config set providers.deepseek.apiKey "your-api-key"
openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"
# 百度千帆配置
openclaw config set providers.baiduqianfan.apiKey "your-api-key"
openclaw config set providers.baiduqianfan.secretKey "your-secret-key"
openclaw config set agents.defaults.model.primary "baiduqianfancodingplan/qianfan-code-latest"
# OpenAI 配置
openclaw config set providers.openai.apiKey "sk-xxxxx"
openclaw config set agents.defaults.model.primary "openai/gpt-4o-mini"
# Claude 配置
openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"
openclaw config set agents.defaults.model.primary "anthropic/claude-3-sonnet"

---

七、启动服务

前台启动（调试用）

openclaw gateway run

后台启动（推荐）

# 启动服务
openclaw gateway start
# 查看状态
openclaw gateway status
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart

访问 Web Chat

启动后，打开浏览器访问：

http://localhost:18789

即可开始与 AI 对话。

---

八、对接飞书机器人

创建飞书应用

1. 访问 飞书开放平台 2. 点击「开发者后台」→「创建企业自建应用」 3. 填写应用名称和描述 4. 创建后，记录 App ID 和 App Secret

配置应用权限

在飞书应用后台，添加以下权限：

配置 OpenClaw

# 启用飞书通道
openclaw config set channels.feishu.enabled true
# 配置 App ID 和 Secret
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your-app-secret"
# 使用长连接模式（无需公网 IP）
openclaw config set channels.feishu.connectionMode "websocket"

重启服务

openclaw gateway restart

发布应用

1. 在飞书应用后台，点击「版本管理」→「发布版本」 2. 提交审核，等待通过 3. 审核通过后，在飞书中搜索你的机器人即可开始对话

---

九、安装推荐技能

OpenClaw 支持技能扩展，以下是推荐的实用技能：

技能列表

安装技能

技能默认已经内置在 OpenClaw 中，无需额外安装。

使用技能

查询北京天气
检查系统安全
帮我创建一个技能

---

十、常用命令汇总

# 启动服务（后台）
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看状态
openclaw gateway status
# 查看详细状态
openclaw status --deep
# 查看日志
openclaw logs --follow
# 诊断问题
openclaw doctor
# 卸载服务（取消自启）
openclaw gateway uninstall
# 更新版本
npm update -g openclaw

---

十一、常见问题

1. 端口被占用

# 查看端口占用
lsof -i :18789
# 结束占用进程
kill -9 <PID>
# 重启服务
openclaw gateway restart

2. API 调用失败

检查 API Key 是否正确：

openclaw config get providers.deepseek.apiKey

3. 飞书机器人不响应

# 检查通道状态
openclaw status --deep
# 查看错误日志
openclaw logs --follow
# 确认应用已发布

4. 配置文件位置

# macOS 配置文件位置
~/.openclaw/openclaw.json

---

十二、进阶配置

设置多个模型

# 添加备用模型
openclaw config set agents.defaults.model.fallback "deepseek/deepseek-coder"

配置定时任务

# 每天早上 8 点提醒
openclaw cron add --name "morning" --schedule "0 8 * * *" --message "早安！今天有什么计划？"

开启隐私模式

# 启用工作区限制
openclaw config set tools.fs.workspaceOnly true

---

十三、获取帮助

• 官方文档：https://docs.openclaw.ai
• GitHub：https://github.com/openclaw/openclaw
• 社区：https://discord.com/invite/clawd
• 插件市场：https://clawhub.com

OpenClaw 让你轻松拥有自己的 AI 助手，开始你的智能化之旅吧！

作者：廖万里

发布时间：2026年3月16日

本文链接：https://www.kkkliao.cn/?id=695 转载需授权！