AI创想

标题: Mac 本地部署 OpenClaw 完整教程（新手小白必看） [打印本页]

---

作者: AI小编    时间: 昨天 23:06
标题: 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），输入：

1. sw_vers

复制代码

输出示例：

1. ProductName:    macOS
2. ProductVersion: 14.2
3. BuildVersion:   23C64

复制代码

2.3 安装 Homebrew（如果没有）

Homebrew 是 macOS 的包管理器，OpenClaw 依赖它。

1. /bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

复制代码

安装完成后，根据提示执行初始化命令（Apple Silicon 用户）：

1. echo'eval "$(/opt/homebrew/bin/brew shellenv)"'>> ~/.zprofile
2. eval"$(/opt/homebrew/bin/brew shellenv)"

复制代码

验证安装：

1. brew --version

复制代码

2.4 安装 Node.js

OpenClaw 基于 Node.js 运行。

1. brew installnode

复制代码

验证安装：

1. node--versionnpm--version

复制代码

注意： 需要 Node.js v18 或更高版本

2.5 安装 Git

1. brew installgit

复制代码

验证：

1. git--version

复制代码

---

三、安装 OpenClaw

3.1 全局安装 OpenClaw

1. npminstall-g openclaw

复制代码

安装完成后验证：

1. openclaw --version

复制代码

3.2 初始化工作区

1. openclaw init

复制代码

这个命令会：

创建配置目录 ~/.openclaw初始化工作区 ~/.openclaw/workspace生成默认配置文件

3.3 启动 Gateway

Gateway 是 OpenClaw 的核心服务：

1. openclaw gateway start

复制代码

验证状态：

1. openclaw gateway status

复制代码

看到 running 表示成功！

---

四、配置 API 密钥

4.1 获取 API 密钥

OpenClaw 支持多个 AI 模型提供商，选择一个：

提供商	模型	获取地址
阿里云百炼	Qwen3.5	https://bailian.console.aliyun.com
OpenAI	GPT-4	https://platform.openai.com
Google	Gemini	https://makersuite.google.com

4.2 配置认证文件

编辑认证文件：

1. nano ~/.openclaw/agents/main/agent/auth-profiles.json

复制代码

添加你的 API 密钥（以阿里云为例）：

1. {"bailian":{"apiKey":"sk-xxxxxxxxxxxxxxxxxxxxxxxx"}}

复制代码

提示： 按 Ctrl+O 保存，Ctrl+X 退出

4.3 设置默认模型

编辑配置文件：

1. nano ~/.openclaw/gateway/config.json

复制代码

添加或修改：

1. {"default_model":"bailian/qwen3.5-plus"}

复制代码

---

五、首次运行

5.1 启动 Web 聊天界面

1. openclaw webchat

复制代码

浏览器会自动打开，访问 http://localhost:3000
5.2 第一次对话

启动后，OpenClaw 会读取 BOOTSTRAP.md 引导你：

给自己起个名字（比如：小助手、Jarvis）设定性格（正式/ casual/ 毒舌）填写 USER.md（告诉它你的信息）

5.3 测试基本功能

在聊天框输入：

1. 帮我创建一个测试文件

复制代码

它应该会在工作区创建一个文件并告诉你位置。

---

六、核心文件说明

6.1 工作区结构

1. ~/.openclaw/workspace/
2. ├── MEMORY.md          # 长期记忆（重要！）
3. ├── USER.md            # 用户信息
4. ├── SOUL.md            # AI 人格设定
5. ├── IDENTITY.md        # AI 身份信息
6. ├── HEARTBEAT.md       # 定时任务配置
7. ├── TOOLS.md           # 工具配置笔记
8. └── memory/            # 每日日志目录
9.     └── YYYY-MM-DD.md

复制代码

6.2 关键文件说明

文件	作用	是否需要修改
MEMORY.md	存储长期记忆	让它自动维护
USER.md	你的个人信息	需要填写
SOUL.md	AI 人格设定	可选修改
HEARTBEAT.md	定时任务	根据需要添加

---

七、常用命令速查

7.1 Gateway 管理

1. openclaw gateway start      # 启动服务
2. openclaw gateway stop       # 停止服务
3. openclaw gateway restart    # 重启服务
4. openclaw gateway status     # 查看状态

复制代码

7.2 会话管理

1. openclaw sessions list      # 查看会话列表
2. openclaw sessions spawn     # 创建子会话

复制代码

7.3 技能管理

1. openclaw skills list        # 查看已安装技能
2. openclaw skills install# 安装新技能

复制代码

7.4 配置管理

1. openclaw config get         # 查看配置
2. openclaw config patch       # 修改配置

复制代码

---

八、实用配置示例

8.1 配置定时检查（HEARTBEAT.md）

编辑 ~/.openclaw/workspace/HEARTBEAT.md：

1. # 每 2 小时检查一次
3. ## 邮箱检查
4. 如果有未读邮件，提醒我。
6. ## 日历检查
7. 如果有 2 小时内的会议，提前通知。
9. ## 天气检查
10. 如果要下雨，提醒带伞。

复制代码

8.2 配置 Cron 任务

1. openclaw cronadd

复制代码

示例：每天早上 9 点提醒

1. {"name":"morning-reminder","schedule":{"kind":"cron","expr":"0 9 * * *","tz":"Asia/Shanghai"},"payload":{"kind":"systemEvent","text":"早上好！今天有什么安排？"},"sessionTarget":"main","enabled":true}

复制代码

---

九、常见问题

Q1: 启动失败，提示端口占用

解决：

1. lsof-i :3000
2. kill-9<PID>
3. openclaw gateway restart

复制代码

Q2: API 密钥无效

检查：

确认密钥格式正确确认账户有余额重启 Gateway：openclaw gateway restart

Q3: 文件无法读写

检查权限：

1. ls-la ~/.openclaw/workspace/
2. chmod-R755 ~/.openclaw/workspace/

复制代码

Q4: 中文乱码

解决： 确保终端编码为 UTF-8

1. exportLANG=zh_CN.UTF-8
2. exportLC_ALL=zh_CN.UTF-8

复制代码

Q5: 内存占用过高

解决： 定期清理会话

1. openclaw sessions list
2. # 清理不需要的会话

复制代码

---

十、进阶玩法

10.1 自定义技能

在 ~/.openclaw/skills/ 目录下创建新技能：

1. my-skill/
2. ├── SKILL.md      # 技能说明
3. ├── script.sh     # 执行脚本
4. └── assets/       # 资源文件

复制代码

10.2 浏览器自动化

OpenClaw 可以控制浏览器：

1. 帮我打开 GitHub，查看我的仓库列表

复制代码

10.3 多设备联动

如果有多个设备，可以配置 node 联动：

1. openclaw nodes status

复制代码

10.4 消息推送

配置后可通过 Telegram/WhatsApp/Discord 接收消息：

1. 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 下一步建议

---

欢迎光临 AI创想 (https://llms-ai.com/)

Powered by Discuz! X3.4