Mac 本地部署 OpenClaw 完整教程（新手小白必看）
Mac 本地部署 OpenClaw 完整教程（新手小白必看）
摘要： 本文详细介绍如何在 macOS 本地部署 OpenClaw 智能助理框架，从环境准备到首次运行，手把手教你搭建属于自己的 AI 助理。适合零基础新手，全程实操无坑。
关键词： OpenClaw、macOS、AI 助理、本地部署、Node.js
一、前言
1.1 什么是 OpenClaw？
OpenClaw 是一个本地运行的 AI 助理框架，和普通的聊天机器人不一样：
- ✅ 有记忆 - 记住你们之间的对话和约定
- ✅ 有手脚 - 能读写文件、执行命令、控制浏览器
- ✅ 能主动 - 定时检查邮件、日历、项目状态
- ✅ 可扩展 - 支持技能系统，自定义功能
简单说：它不是陪你聊天的 AI，是能帮你干活的助理。
1.2 为什么要本地部署？
| 对比项 | 云端 AI | OpenClaw 本地部署 |
|---|---|---|
| 数据隐私 | 数据上传云端 | 所有数据本地存储 |
| 文件访问 | 无法访问本地文件 | 完整读写权限 |
| 命令执行 | 不支持 | 可执行 shell 命令 |
| 定制性 | 有限 | 完全可定制 |
| 成本 | 按次付费 | 一次部署，免费使用 |
1.3 本文适合谁？
- ✅ Mac 用户（Intel/Apple Silicon 均可）
- ✅ 零基础新手（会打开终端就行）
- ✅ 想拥有自己的 AI 助理
- ❌ 想用 Windows/Linux 的（本文不覆盖）
二、环境准备
2.1 系统要求
- 操作系统： macOS 12.0 或更高版本
- 处理器： Intel 或 Apple Silicon（M1/M2/M3）
- 内存： 至少 8GB（推荐 16GB）
- 磁盘空间： 至少 5GB 可用空间
2.2 检查系统版本
打开终端（Terminal），输入：
sw_vers 输出示例：
ProductName: macOS ProductVersion: 14.2 BuildVersion: 23C64 2.3 安装 Homebrew（如果没有）
Homebrew 是 macOS 的包管理器，OpenClaw 依赖它。
/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后，根据提示执行初始化命令（Apple Silicon 用户）：
echo'eval "$(/opt/homebrew/bin/brew shellenv)"'>> ~/.zprofile eval"$(/opt/homebrew/bin/brew shellenv)"验证安装：
brew --version2.4 安装 Node.js
OpenClaw 基于 Node.js 运行。
brew installnode验证安装：
node--versionnpm--version注意： 需要 Node.js v18 或更高版本
2.5 安装 Git
brew installgit验证：
git--version三、安装 OpenClaw
3.1 全局安装 OpenClaw
npminstall-g openclaw 安装完成后验证：
openclaw --version3.2 初始化工作区
openclaw init 这个命令会：
- 创建配置目录
~/.openclaw - 初始化工作区
~/.openclaw/workspace - 生成默认配置文件
3.3 启动 Gateway
Gateway 是 OpenClaw 的核心服务：
openclaw gateway start 验证状态：
openclaw gateway status 看到 running 表示成功！
四、配置 API 密钥
4.1 获取 API 密钥
OpenClaw 支持多个 AI 模型提供商，选择一个：
| 提供商 | 模型 | 获取地址 |
|---|---|---|
| 阿里云百炼 | Qwen3.5 | https://bailian.console.aliyun.com |
| OpenAI | GPT-4 | https://platform.openai.com |
| Gemini | https://makersuite.google.com |
4.2 配置认证文件
编辑认证文件：
nano ~/.openclaw/agents/main/agent/auth-profiles.json 添加你的 API 密钥（以阿里云为例）：
{"bailian":{"apiKey":"sk-xxxxxxxxxxxxxxxxxxxxxxxx"}}提示： 按Ctrl+O保存，Ctrl+X退出
4.3 设置默认模型
编辑配置文件：
nano ~/.openclaw/gateway/config.json 添加或修改：
{"default_model":"bailian/qwen3.5-plus"}五、首次运行
5.1 启动 Web 聊天界面
openclaw webchat 浏览器会自动打开，访问 http://localhost:3000
5.2 第一次对话
启动后，OpenClaw 会读取 BOOTSTRAP.md 引导你：
- 给自己起个名字（比如：小助手、Jarvis）
- 设定性格（正式/ casual/ 毒舌）
- 填写 USER.md（告诉它你的信息）
5.3 测试基本功能
在聊天框输入：
帮我创建一个测试文件 它应该会在工作区创建一个文件并告诉你位置。
六、核心文件说明
6.1 工作区结构
~/.openclaw/workspace/ ├── MEMORY.md # 长期记忆（重要！） ├── USER.md # 用户信息 ├── SOUL.md # AI 人格设定 ├── IDENTITY.md # AI 身份信息 ├── HEARTBEAT.md # 定时任务配置 ├── TOOLS.md # 工具配置笔记 └── memory/ # 每日日志目录 └── YYYY-MM-DD.md 6.2 关键文件说明
| 文件 | 作用 | 是否需要修改 |
|---|---|---|
| MEMORY.md | 存储长期记忆 | 让它自动维护 |
| USER.md | 你的个人信息 | 需要填写 |
| SOUL.md | AI 人格设定 | 可选修改 |
| HEARTBEAT.md | 定时任务 | 根据需要添加 |
七、常用命令速查
7.1 Gateway 管理
openclaw gateway start # 启动服务 openclaw gateway stop # 停止服务 openclaw gateway restart # 重启服务 openclaw gateway status # 查看状态7.2 会话管理
openclaw sessions list # 查看会话列表 openclaw sessions spawn # 创建子会话7.3 技能管理
openclaw skills list # 查看已安装技能 openclaw skills install# 安装新技能7.4 配置管理
openclaw config get # 查看配置 openclaw config patch # 修改配置八、实用配置示例
8.1 配置定时检查（HEARTBEAT.md）
编辑 ~/.openclaw/workspace/HEARTBEAT.md：
# 每 2 小时检查一次 ## 邮箱检查 如果有未读邮件，提醒我。 ## 日历检查 如果有 2 小时内的会议，提前通知。 ## 天气检查 如果要下雨，提醒带伞。 8.2 配置 Cron 任务
openclaw cronadd示例：每天早上 9 点提醒
{"name":"morning-reminder","schedule":{"kind":"cron","expr":"0 9 * * *","tz":"Asia/Shanghai"},"payload":{"kind":"systemEvent","text":"早上好！今天有什么安排？"},"sessionTarget":"main","enabled":true}九、常见问题
Q1: 启动失败，提示端口占用
解决：
lsof-i :3000 kill-9<PID> openclaw gateway restart Q2: API 密钥无效
检查：
- 确认密钥格式正确
- 确认账户有余额
- 重启 Gateway：
openclaw gateway restart
Q3: 文件无法读写
检查权限：
ls-la ~/.openclaw/workspace/ chmod-R755 ~/.openclaw/workspace/ Q4: 中文乱码
解决： 确保终端编码为 UTF-8
exportLANG=zh_CN.UTF-8 exportLC_ALL=zh_CN.UTF-8 Q5: 内存占用过高
解决： 定期清理会话
openclaw sessions list # 清理不需要的会话十、进阶玩法
10.1 自定义技能
在 ~/.openclaw/skills/ 目录下创建新技能：
my-skill/ ├── SKILL.md # 技能说明 ├── script.sh # 执行脚本 └── assets/ # 资源文件 10.2 浏览器自动化
OpenClaw 可以控制浏览器：
帮我打开 GitHub，查看我的仓库列表 10.3 多设备联动
如果有多个设备，可以配置 node 联动：
openclaw nodes status 10.4 消息推送
配置后可通过 Telegram/WhatsApp/Discord 接收消息：
openclaw message send --target<channel>--message"测试消息"十一、总结
11.1 部署流程回顾
- ✅ 安装 Homebrew、Node.js、Git
- ✅
npm install -g openclaw - ✅
openclaw init初始化 - ✅
openclaw gateway start启动 - ✅ 配置 API 密钥
- ✅
openclaw webchat开始使用
11.2 下一步建议
- 📚 阅读官方文档：
/opt/homebrew/lib/node_modules/openclaw/docs - 🔗 加入社区：https://discord.com/invite/clawd
- 🛠️ 探索技能市场：https://clawhub.com
- 📝 完善 USER.md 和 MEMORY.md
11.3 注意事项
- ⚠️ 定期备份
~/.openclaw/workspace目录 - ⚠️ 不要随意删除 MEMORY.md
- ⚠️ API 密钥妥善保管，不要上传到公开仓库
- ⚠️ 执行外部命令前确认安全性
附录：完整命令清单
# 环境检查 sw_vers node--versionnpm--versiongit--version# 安装npminstall-g openclaw # 初始化 openclaw init openclaw gateway start openclaw gateway status # 使用 openclaw webchat openclaw sessions list openclaw cron list # 维护 openclaw gateway restart openclaw config get 作者： 森小妹
更新时间： 2026-02-28
适用版本： OpenClaw 最新版
系统： macOS 12.0+
如果本文帮到你，欢迎点赞收藏！有问题评论区见～ 😤
相关链接：
- OpenClaw 官方文档：https://docs.openclaw.ai
- GitHub 仓库：https://github.com/openclaw/openclaw
- 技能市场：https://clawhub.com
- 社区 Discord：https://discord.com/invite/clawd
