摘要： 本文詳細(xì)介紹如何在 macOS 本地部署 OpenClaw 智能助理框架，從環(huán)境準(zhǔn)備到首次運(yùn)行，手把手教你搭建屬于自己的 AI 助理。適合零基礎(chǔ)新手，全程實(shí)操無(wú)坑 

關(guān)鍵詞： OpenClaw、macOS、AI 助理、本地部署、Node.js

一、前言

1.1 什么是 OpenClaw？

OpenClaw 是一個(gè)本地運(yùn)行的 AI 助理框架，和普通的聊天機(jī)器人不一樣：

• ? 有記憶 - 記住你們之間的對(duì)話和約定
• ? 有手腳 - 能讀寫(xiě)文件、執(zhí)行命令、控制瀏覽器
• ? 能主動(dòng) - 定時(shí)檢查郵件、日歷、項(xiàng)目狀態(tài)
• ? 可擴(kuò)展 - 支持技能系統(tǒng)，自定義功能

簡(jiǎn)單說(shuō)：它不是陪你聊天的 AI，是能幫你干活的助理。

1.2 為什么要本地部署？

1.3 本文適合誰(shuí)？

• ? Mac 用戶（Intel/Apple Silicon 均可）
• ? 零基礎(chǔ)新手（會(huì)打開(kāi)終端就行）
• ? 想擁有自己的 AI 助理
• ? 想用 Windows/Linux 的（本文不覆蓋）

二、環(huán)境準(zhǔn)備

2.1 系統(tǒng)要求

• 操作系統(tǒng)： macOS 12.0 或更高版本
• 處理器： Intel 或 Apple Silicon（M1/M2/M3）
• 內(nèi)存： 至少 8GB（推薦 16GB）
• 磁盤(pán)空間： 至少 5GB 可用空間

2.2 檢查系統(tǒng)版本

打開(kāi)終端（Terminal），輸入：

sw_vers

輸出示例：

ProductName:    macOS
ProductVersion: 14.2
BuildVersion:   23C64

2.3 安裝 Homebrew（如果沒(méi)有）

Homebrew 是 macOS 的包管理器，OpenClaw 依賴(lài)它。

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

安裝完成后，根據(jù)提示執(zhí)行初始化命令（Apple Silicon 用戶）：

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

驗(yàn)證安裝：

brew --version

2.4 安裝 Node.js

OpenClaw 基于 Node.js 運(yùn)行。

brew install node

驗(yàn)證安裝：

node --version
npm --version

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

2.5 安裝 Git

brew install git

驗(yàn)證：

git --version

三、安裝 OpenClaw

3.1 全局安裝 OpenClaw

npm install -g openclaw

安裝完成后驗(yàn)證：

openclaw --version

3.2 初始化工作區(qū)

openclaw init

這個(gè)命令會(huì)：

1. 創(chuàng)建配置目錄 ~/.openclaw
2. 初始化工作區(qū) ~/.openclaw/workspace
3. 生成默認(rèn)配置文件

3.3 啟動(dòng) Gateway

Gateway 是 OpenClaw 的核心服務(wù)：

openclaw gateway start

驗(yàn)證狀態(tài)：

openclaw gateway status

看到 running 表示成功！

四、配置 API 密鑰

4.1 獲取 API 密鑰

OpenClaw 支持多個(gè) AI 模型提供商，選擇一個(gè)：

4.2 配置認(rèn)證文件

編輯認(rèn)證文件：

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

添加你的 API 密鑰（以阿里云為例）：

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

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

4.3 設(shè)置默認(rèn)模型

編輯配置文件：

nano ~/.openclaw/gateway/config.json

添加或修改：

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

五、首次運(yùn)行

5.1 啟動(dòng) Web 聊天界面

openclaw webchat

瀏覽器會(huì)自動(dòng)打開(kāi)，訪問(wèn) http://localhost:3000

5.2 第一次對(duì)話

啟動(dòng)后，OpenClaw 會(huì)讀取 BOOTSTRAP.md 引導(dǎo)你：

1. 給自己起個(gè)名字（比如：小助手、Jarvis）
2. 設(shè)定性格（正式/ casual/ 毒舌）
3. 填寫(xiě) USER.md（告訴它你的信息）

5.3 測(cè)試基本功能

在聊天框輸入：

幫我創(chuàng)建一個(gè)測(cè)試文件

它應(yīng)該會(huì)在工作區(qū)創(chuàng)建一個(gè)文件并告訴你位置。

六、核心文件說(shuō)明

6.1 工作區(qū)結(jié)構(gòu)

~/.openclaw/workspace/
├── MEMORY.md          # 長(zhǎng)期記憶（重要?。?
├── USER.md            # 用戶信息
├── SOUL.md            # AI 人格設(shè)定
├── IDENTITY.md        # AI 身份信息
├── HEARTBEAT.md       # 定時(shí)任務(wù)配置
├── TOOLS.md           # 工具配置筆記
└── memory/            # 每日日志目錄
    └── YYYY-MM-DD.md

6.2 關(guān)鍵文件說(shuō)明

七、常用命令速查

7.1 Gateway 管理

openclaw gateway start      # 啟動(dòng)服務(wù)
openclaw gateway stop       # 停止服務(wù)
openclaw gateway restart    # 重啟服務(wù)
openclaw gateway status     # 查看狀態(tài)

7.2 會(huì)話管理

openclaw sessions list      # 查看會(huì)話列表
openclaw sessions spawn     # 創(chuàng)建子會(huì)話

7.3 技能管理

openclaw skills list        # 查看已安裝技能
openclaw skills install     # 安裝新技能

7.4 配置管理

openclaw config get         # 查看配置
openclaw config patch       # 修改配置

八、實(shí)用配置示例

8.1 配置定時(shí)檢查（HEARTBEAT.md）

編輯 ~/.openclaw/workspace/HEARTBEAT.md：

# 每 2 小時(shí)檢查一次
## 郵箱檢查
如果有未讀郵件，提醒我。
## 日歷檢查
如果有 2 小時(shí)內(nèi)的會(huì)議，提前通知。
## 天氣檢查
如果要下雨，提醒帶傘。

8.2 配置 Cron 任務(wù)

openclaw cron add

示例：每天早上 9 點(diǎn)提醒

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

九、常見(jiàn)問(wèn)題

Q1: 啟動(dòng)失敗，提示端口占用

解決：

lsof -i :3000
kill -9 <PID>
openclaw gateway restart

Q2: API 密鑰無(wú)效

檢查：

1. 確認(rèn)密鑰格式正確
2. 確認(rèn)賬戶有余額
3. 重啟 Gateway：openclaw gateway restart

Q3: 文件無(wú)法讀寫(xiě)

檢查權(quán)限：

ls -la ~/.openclaw/workspace/
chmod -R 755 ~/.openclaw/workspace/

Q4: 中文亂碼

解決： 確保終端編碼為 UTF-8

export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

Q5: 內(nèi)存占用過(guò)高

解決： 定期清理會(huì)話

openclaw sessions list
# 清理不需要的會(huì)話

十、進(jìn)階玩法

10.1 自定義技能

在 ~/.openclaw/skills/ 目錄下創(chuàng)建新技能：

my-skill/
├── SKILL.md      # 技能說(shuō)明
├── script.sh     # 執(zhí)行腳本
└── assets/       # 資源文件

10.2 瀏覽器自動(dòng)化

OpenClaw 可以控制瀏覽器：

幫我打開(kāi) GitHub，查看我的倉(cāng)庫(kù)列表

10.3 多設(shè)備聯(lián)動(dòng)

如果有多個(gè)設(shè)備，可以配置 node 聯(lián)動(dòng)：

openclaw nodes status

10.4 消息推送

配置后可通過(guò) Telegram/WhatsApp/Discord 接收消息：

openclaw message send --target <channel> --message "測(cè)試消息"

十一、總結(jié)

11.1 部署流程回顧

1. ? 安裝 Homebrew、Node.js、Git
2. ? npm install -g openclaw
3. ? openclaw init 初始化
4. ? openclaw gateway start 啟動(dòng)
5. ? 配置 API 密鑰
6. ? openclaw webchat 開(kāi)始使用

11.2 下一步建議

• ?? 閱讀官方文檔：/opt/homebrew/lib/node_modules/openclaw/docs
• ?? 加入社區(qū)：https://discord.com/invite/clawd
• ??? 探索技能市場(chǎng)：https://clawhub.com
• ?? 完善 USER.md 和 MEMORY.md

11.3 注意事項(xiàng)

• ?? 定期備份 ~/.openclaw/workspace 目錄
• ?? 不要隨意刪除 MEMORY.md
• ?? API 密鑰妥善保管，不要上傳到公開(kāi)倉(cāng)庫(kù)
• ?? 執(zhí)行外部命令前確認(rèn)安全性

附錄：完整命令清單

# 環(huán)境檢查
sw_vers
node --version
npm --version
git --version
# 安裝
npm install -g openclaw
# 初始化
openclaw init
openclaw gateway start
openclaw gateway status
# 使用
openclaw webchat
openclaw sessions list
openclaw cron list
# 維護(hù)
openclaw gateway restart
openclaw config get

適用版本： OpenClaw 最新版
系統(tǒng)： macOS 12.0+

以上就是Mac本地部署OpenClaw的完整教程(新手小白必看)的詳細(xì)內(nèi)容，更多關(guān)于Mac本地部署OpenClaw的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論