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

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

一、前言

1.1 什么是 OpenClaw？

OpenClaw 是一個本地運行的 AI 助理框架，和普通的聊天機器人不一樣：

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

簡單說：它不是陪你聊天的 AI，是能幫你干活的助理。

1.2 為什么要本地部署？

1.3 本文適合誰？

• ? Mac 用戶（Intel/Apple Silicon 均可）
• ? 零基礎(chǔ)新手（會打開終端就行）
• ? 想擁有自己的 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）
• 磁盤空間： 至少 5GB 可用空間

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

打開終端（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)"

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

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

驗證安裝：

brew --version

2.4 安裝 Node.js

OpenClaw 基于 Node.js 運行。

brew install node

驗證安裝：

node --version
npm --version

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

2.5 安裝 Git

brew install git

驗證：

git --version

三、安裝 OpenClaw

3.1 全局安裝 OpenClaw

npm install -g openclaw

安裝完成后驗證：

openclaw --version

3.2 初始化工作區(qū)

openclaw init

這個命令會：

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

3.3 啟動 Gateway

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

openclaw gateway start

驗證狀態(tài)：

openclaw gateway status

看到 running 表示成功！

四、配置 API 密鑰

4.1 獲取 API 密鑰

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

4.2 配置認證文件

編輯認證文件：

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

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

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

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

4.3 設(shè)置默認模型

編輯配置文件：

nano ~/.openclaw/gateway/config.json

添加或修改：

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

五、首次運行

5.1 啟動 Web 聊天界面

openclaw webchat

瀏覽器會自動打開，訪問 http://localhost:3000

5.2 第一次對話

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

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

5.3 測試基本功能

在聊天框輸入：

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

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

六、核心文件說明

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

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

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

七、常用命令速查

7.1 Gateway 管理

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

7.2 會話管理

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

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 小時內(nèi)的會議，提前通知。
## 天氣檢查
如果要下雨，提醒帶傘。

8.2 配置 Cron 任務(wù)

openclaw cron add

示例：每天早上 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 密鑰無效

檢查：

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

Q3: 文件無法讀寫

檢查權(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)存占用過高

解決： 定期清理會話

openclaw sessions list
# 清理不需要的會話

十、進階玩法

10.1 自定義技能

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

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

10.2 瀏覽器自動化

OpenClaw 可以控制瀏覽器：

幫我打開 GitHub，查看我的倉庫列表

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

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

openclaw nodes status

10.4 消息推送

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

openclaw message send --target <channel> --message "測試消息"

十一、總結(jié)

11.1 部署流程回顧

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

11.2 下一步建議

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

11.3 注意事項

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

附錄：完整命令清單

# 環(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
# 維護
openclaw gateway restart
openclaw config get

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

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

最新評論