乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > �� OpenClaw Mac 本地部署实战指南:从入门到精通

�� OpenClaw Mac 本地部署实战指南:从入门到精通

当前时间： 2026-05-07 16:47:45 更新时间： 2026-05-07 分类：软件教程 评论(0)

�� OpenClaw Mac 本地部署实战指南:从入门到精通

AI Agent 时代的私人助理：让你的 Mac 拥有超能力

📖 前言：当 AI 真正开始”干活”

2026年，OpenClaw（业内昵称”小龙虾”）已成为 GitHub 上备受关注的个人 AI Agent 框架，在短短几个月内超越 n8n，成为 GitHub Star 突破 30 万的开源项目。但这不仅仅是一个能聊天的 AI，它是一个能执行动作的智能体。

想象一下：

  • • 🤖 让 AI 自动搜索网页、抓取数据
  • • 📧 自动处理邮件、回复消息
  • • 🗓️ 安排日程、管理任务
  • • 💻 执行代码、操作浏览器
  • • 📱 接入飞书、Telegram 等聊天平台

这不是科幻，而是你已经可以拥有的 AI 助理。

本文将带你从零开始在 Mac 上完成 OpenClaw 的本地部署，手把手教你如何让它成为你的私人智能助理。

🎯 一、什么是 OpenClaw？

核心定位

OpenClaw 是一个开源、本地部署的 AI Agent 网关框架。它的核心思路不是”只回答问题”，而是让 AI 具备执行动作的能力：

能力
说明
exec
执行 shell 命令
web_search / web_fetch
网页搜索与抓取
browser
控制专用浏览器
canvas
界面/内容操作
pdf
PDF 处理
message
消息相关
cron
定时任务
gateway
重启、应用配置、更新网关
sessions_
会话管理
agents_list
Agent 管理

为什么选择 OpenClaw？

✅ 隐私保护

数据完全不出本机，你的所有操作都在本地完成

✅ 成本可控

使用本地模型（如 DeepSeek），无需支付昂贵的 API 费用

✅ 灵活可定制

支持多种聊天平台集成，可自定义 AI 模型

✅ 功能强大

内置丰富的工具能力，支持自动化任务

⚙️ 二、部署前准备

1. 系统要求

项目
最低配置
推荐配置
操作系统
macOS 12.0+
macOS 14+ (Sonoma)
处理器
Intel / Apple Silicon (M1/M2/M3/M4)
同左
内存
≥4GB
8GB+，运行更流畅
存储
可用空间≥2GB
10GB+，预留模型空间
网络
稳定联网
带宽≥10Mbps
权限
需 Mac 管理员密码
同左

2. 推荐模型选择

模型
优点
缺点
DeepSeek
国内网络直接支持、有免费额度
–
Claude / GPT-4
模型能力强
需国际信用卡、合规网络
Kimi
国内可用、支持 RAG
–

💡 新手建议：优先使用 DeepSeek，成本低、适配性好

🚀 三、一键部署（新手友好，5分钟搞定）

步骤 1：打开终端

Command + 空格 → 输入 Terminal → 回车

步骤 2：执行官方安装脚本

# 官方原版（推荐，网络好时使用）curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw/main/install.sh | bash# 国内加速版（网络慢/下载失败时使用）# curl -fsSL https://cdn.jsdelivr.net/gh/openclaw/openclaw@main/install.sh | bash

脚本会自动完成：

  • • ✅ 系统环境检测
  • • ✅ Node.js 安装（≥v22）
  • • ✅ OpenClaw 核心程序部署
  • • ✅ 环境变量配置

预计时间：2-5分钟

步骤 3：加载环境变量

Mac 默认使用 Zsh，执行以下命令使配置生效：

source ~/.zshrc

若使用老版 Bash，执行：

source ~/.bash_profile

步骤 4：验证安装成功

openclaw --version

输出 OpenClaw 2026.x.x 即安装成功！

⚙️ 四、初始化配置（3分钟完成）

步骤 1：启动初始化向导

openclaw onboard

步骤 2：按提示配置（新手直接默认回车）

步骤
提示
推荐选择
1
是否接受风险提示
 Yes
2
启动模式
 QuickStart

（快速启动）
3
AI 模型供应商
 Custom Provider
4
BaseURL
模型 API 地址
5
API Key
你的 API Key
6
聊天工具
飞书/Telegram（按需选择）
7
Gateway 端口
 18789

（默认即可）
8
Skills
根据需要选择（可跳过）

🌐 五、启动服务与访问控制台

步骤 1：启动网关服务

保持终端运行，执行：

openclaw gateway

终端显示 Gateway started on port 18789 即启动成功。

步骤 2：访问 Web 控制台

浏览器自动跳转至：

http://localhost:18789

或使用命令：

openclaw dashboard

步骤 3：终端模式（可选）

如果你更喜欢终端界面，可以使用：

openclaw tui

🔌 六、集成飞书（Mac 专属）

步骤 1：安装飞书插件

clawhub install feishu

步骤 2：配置应用凭证

在飞书开放平台创建应用，获取：

  • • App ID
  • • App Secret

步骤 3：配置 OpenClaw

openclaw config set chat.providers.feishu.appId "your_app_id"openclaw config set chat.providers.feishu.appSecret "your_app_secret"

步骤 4：赋予机器人权限

在飞书应用设置中，添加权限：

  • • 发送消息
  • • 读取消息
  • • 接收事件通知

📊 七、常用命令速查表

命令
说明
openclaw status
查看服务状态
openclaw gateway restart
重启服务（修改配置后生效）
openclaw gateway stop
停止服务
openclaw logs --follow
实时监控运行日志
openclaw update
升级 OpenClaw 到最新版本
clawhub search 关键词
搜索技能
clawhub install 技能名称
安装技能
clawhub uninstall 技能名称
卸载技能
openclaw config set
设置配置项
openclaw config get
获取配置项

🛠️ 八、常见问题解决

问题 1：命令找不到（command not found）

执行以下命令配置环境变量：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrcsource ~/.zshrc

问题 2：安装超时 / 下载失败

使用国内加速源：

curl -fsSL https://cdn.jsdelivr.net/gh/openclaw/openclaw@main/install.sh | bash

问题 3：端口占用（18789）

查看占用程序并终止：

lsof -i :18789kill -9 <进程ID>

或修改端口：

openclaw gateway --port 18790

问题 4：权限不足

所有命令前加 sudo：

sudo openclaw gateway

问题 5：DeepSeek API 调用失败

检查以下几点：

  • • ✅ API Key 是否有效
  • • ✅ 账号是否有余额
  • • ✅ 网络是否正常
  • • ✅ 模型 ID 是否正确（应为 deepseek-chat）

💡 九、进阶使用技巧

1. 定时任务

配置 cron 定时执行任务：

# 每 30 分钟检查邮件0,30 * * * * openclaw gateway exec "check-email"# 每天凌晨备份数据0 0 * * * openclaw gateway exec "backup-data"

2. 技能管理

ClawHub 有 5000+ 技能，按需安装：

# 查看技能详情clawhub show 技能名称# 安装技能clawhub install 技能名称# 卸载技能clawhub uninstall 技能名称

3. 日志管理

查看实时日志：

openclaw logs --follow

日志文件位置：

  • • /tmp/openclaw/openclaw-YYYY-MM-DD.log

4. 数据备份

备份 OpenClaw 配置：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

🔒 十、安全最佳实践

1. 最小权限原则

  • • ✅ 只授予完成任务所需的权限
  • • ✅ 定期审计行为日志
  • • ✅ 发现异常及时处理

2. 环境配置规范

配置项
要求
Node.js 版本
必须 ≥v22.0.0
npm 全局路径
配置后避免 EACCES
配置文件格式
JSON 严格格式，无注释

3. 模型使用注意

  • • ✅ 优先选择 DeepSeek（成本低、适配好）
  • • ✅ 确保模型 ID 正确（如 deepseek-chat）
  • • ✅ 定期检查 API Key 有效期

📝 十一、部署后 checklist

完成部署后，建议检查以下项目：

  • • [ ] 网关服务正常运行（openclaw status）
  • • [ ] Web 控制台可以访问
  • • [ ] AI 模型可以正常调用
  • • [ ] 飞书机器人可以发送/接收消息
  • • [ ] 日志无错误信息
  • • [ ] 配置文件已备份
  • • [ ] 理解了核心命令的使用

🎓 十二、学习路径推荐

新手阶段（1-2周）

  1. 1. ✅ 完成基础部署
  2. 2. ✅ 与 AI 进行对话测试
  3. 3. ✅ 尝试执行简单命令
  4. 4. ✅ 接入飞书机器人

进阶阶段（1-2个月）

  1. 1. ✅ 学习使用各种工具（exec、web_search 等）
  2. 2. ✅ 配置定时任务
  3. 3. ✅ 安装常用技能
  4. 4. ✅ 优化配置和性能

高手阶段（持续）

  1. 1. ✅ 开发自定义技能
  2. 2. ✅ 集成更多平台
  3. 3. ✅ 优化模型选择
  4. 4. ✅ 分享经验与成果

🌟 十三、成功案例分享

案例 1：程序员助手

# 让 AI 自动读取项目文档、生成代码AI: "读取 README.md，帮我分析项目结构"OpenClaw: [读取文档] → [分析结构] → [输出分析报告]

案例 2：内容创作者

# 自动搜索素材、整理文章AI: "搜索今天关于 AI 的最新新闻，整理成列表"OpenClaw: [web_search] → [抓取内容] → [整理列表] → [发送到飞书]

案例 3：开发者日常

# 管理日程、监控任务AI: "每小时检查一次服务器状态，有问题就通知我"OpenClaw: [cron 任务] → [执行检查] → [发送结果]

📚 十四、推荐资源

官方文档

  • • 📖 OpenClaw GitHub[1]
  • • 📖 ClawHub 技能市场[2]
  • • 📖 官方安装脚本[3]

学习教程

  • • 🦞 OpenClaw Mac 版保姆级教程[4]
  • • 🦞 2026最新部署指南[5]
  • • 🦞 飞书集成教程[6]

社区交流

  • • 💬 OpenClaw Discord[7]
  • • 💬 GitHub Issues[8]
  • • 💬 技术博客[9]

🙏 结语

OpenClaw 的魅力在于，它不仅仅是另一个聊天机器人，而是一个真正能干活的 AI 助理。当你第一次看到 AI 自动帮你完成一系列复杂任务时，你会发现：AI 时代已经到来，而你刚刚拥有了你的 AI 员工。

🚀 开始你的 OpenClaw 之旅吧！