如何在 MacOS 中利用 OrbStack 虚拟机一键部署 Clawdbot/Moltbot/OpenClaw
-
如何在 MacOS 中利用 OrbStack 虚拟机一键部署 Clawdbot/Moltbot/OpenClaw
目录- 🔄 关于品牌更名说明
- 🎯 为什么选择这套方案
- 核心优势速览
- 📊 OrbStack 技术架构解析
- 🦞 什么是 OpenClaw
- 核心能力矩阵
- 🔔 主动式智能（Proactive Intelligence）
- 🔧 Skills 技能系统
- 💰 费用说明
- 🛠️ 部署前的准备工作
- ✅ 准备清单（请逐项确认）
- 🚀 第一阶段：安装 OrbStack（图形界面操作）
- 步骤 1.1：下载 OrbStack
- 步骤 1.2：安装 OrbStack
- 步骤 1.3：首次启动与授权
- ✅ 检查安装是否成功
- 📦 第二阶段：创建 Linux 虚拟机（图形界面操作）
- 步骤 2.1：打开 OrbStack 主窗口
- 步骤 2.2：进入虚拟机管理界面
- 步骤 2.3：创建新虚拟机
- 步骤 2.4：配置虚拟机
- 步骤 2.5：完成创建
- ✅ 创建成功的标志
- ⚙️ 第三阶段：安装运行环境（需要使用终端）
- 步骤 3.1：打开虚拟机终端
- 步骤 3.2：执行一键安装脚本
- 📋 脚本执行过程说明
- ✅ 安装成功的标志
- 🔧 第四阶段：配置 OpenClaw
- 步骤 4.1：启动配置向导
- 步骤 4.2：按向导提示完成配置
- ✅ 配置成功的标志
- 🖥️ 第五阶段：访问与日常使用
- 📱 通过聊天软件使用 OpenClaw
- 🌐 通过 Web 控制台管理
- 📂 通过 Finder 访问配置文件
- 🔄 日常维护指南
- 通过 OrbStack 图形界面管理虚拟机
- 通过终端管理 OpenClaw 服务
- 🔍 常见问题解答（FAQ）
- ❓ Q1: Web 控制台打不开怎么办？
- ❓ Q2: Bot 不回复消息怎么办？
- ❓ Q3: 如何更换 API 密钥？
- ❓ Q4: 电脑重启后 Bot 还会自动运行吗？
- ❓ Q5: 如何升级 OpenClaw？
- 🔒 安全注意事项
- 📚 延伸阅读与参考资源
- 官方文档
- 社区资源
- ✨ 本文小结
在 Mac 生态中，OrbStack 凭借其瞬间启动和极低的内存占用，已成为开发者运行 Linux 环境的首选方案。将 OpenClaw（曾用名 Clawdbot/Moltbot）部署在 OrbStack 的虚拟机（VM）中，不仅能享受原生 systemd 的稳定性，还能获得比 Docker 更简单的网络访问体验。
🔄 关于品牌更名说明
Clawdbot → Moltbot → OpenClaw 的演变历程：
- Clawdbot（2025年11月）：项目由 PSPDFKit 创始人 Peter Steinberger 创建，名称源自对 Anthropic 公司 Claude AI 模型的致敬（Clawd 谐音 Claude）。
- Moltbot（2026年1月27日）：由于 Anthropic 提出商标异议，项目被迫更名。Steinberger 选择了 Moltbot——象征着龙虾蜕壳（molt）般的蜕变与成长，并表示"Anthropic 让我们改名（商标问题），说实话？'Molt' 非常契合——这正是龙虾成长的方式。"
- OpenClaw（2026年1月底至今）：由于 Steinberger 对 Moltbot 这个名称并不满意，几天后再次更名为 OpenClaw，这也是目前的正式名称。
⚠️ 注意：更名期间曾发生安全事件——在 GitHub 和 Twitter 账号更名的短暂空档（约10秒），加密货币诈骗者抢注了原账号名，甚至出现了市值高达 1600 万美元的假冒 $CLAWD 代币。
目前项目已在 GitHub 上获得超过 145,000 颗星标，成为 2026 年最受瞩目的开源 AI 项目之一，也是 GitHub 历史上增长最快的开源项目之一（曾在 24 小时内获得 17,830 颗星）。
🎯 为什么选择这套方案
核心优势速览
优势维度 具体表现 🌐 原生域名 OrbStack 为虚拟机自动分配 http://机器名.orb.local域名，无需手动配置⚡ 资源节约 后台 CPU 使用率低于 0.1%，开箱磁盘占用不到 10MB 🔋 持久运行 配合 systemd 守护进程，实现 7×24 小时不间断运行 🔒 隐私优先 OpenClaw 完全运行在本地，数据不上传任何第三方服务器 📊 OrbStack 技术架构解析
OrbStack 是一款原生 Swift 应用程序，专为 macOS 设计，可视为 macOS 版的 WSL（Windows Subsystem for Linux）。其核心技术特点包括：
- 🚀 共享内核架构：在宿主操作系统内核之上运行独立的用户空间环境，比传统虚拟机更加轻量
- 📂 VirtioFS 文件共享：Mac 与 Linux 虚拟机之间的高性能文件共享，读写速度显著优于传统方案
- 🔄 Rosetta 兼容层：在 Apple Silicon（M1/M2/M3/M4）芯片上透明运行 x86_64 架构的应用程序
- 🌐 原生网络支持：开箱即支持 IPv6 和 ICMP 协议
- 🐳 Docker Desktop 替代品：完全兼容 Docker CLI，是 Docker Desktop 的轻量级替代方案
💡 OrbStack 在后台功耗方面效率显著优于 Docker Desktop，且支持 Kubernetes 集群。
🦞 什么是 OpenClaw
OpenClaw 不仅仅是一个聊天机器人——它是一个运行在你本地设备上的个人 AI 操作系统，由 PSPDFKit 创始人 Peter Steinberger 开发。
核心能力矩阵
能力类型 具体功能 💬 多平台通讯 支持 WhatsApp、Telegram、Discord、Slack、Teams、Signal 等 🖥️ 系统操作 执行 Shell 命令、管理文件系统、运行脚本、浏览器自动化 🤖 自动化工作流 日历管理、航班值机、邮件整理、智能家居控制 📊 数据处理 搜索文件、读取日志、生成报告 🧠 模型无关 支持 Claude、GPT、Gemini、本地模型（Ollama）等多种 LLM 🔔 主动式智能（Proactive Intelligence）
这是 OpenClaw 区别于传统 AI 助手的关键特性：
- 无需你询问"服务器宕机了吗？"——OpenClaw 会自动检测并主动通知你
- 无需你查询"股价下跌了吗？"——OpenClaw 会监控阈值并及时预警
- 内置"心跳引擎"和 Cron 任务集成，真正实现"设置后遗忘"的自动化
🔧 Skills 技能系统
OpenClaw 拥有独特的"技能"系统：社区通过 clawhub.ai 分享数千种能力。一个技能是包含 markdown 指令和可选脚本的 zip 文件，功能类似插件系统。超过 100 个预配置的 AgentSkills 可让 AI 执行 shell 命令、管理文件系统和执行 Web 自动化。
💰 费用说明
OpenClaw 本身是 MIT 许可证下的免费开源软件。实际费用来源于 AI 模型提供商的 API 调用，通常为每月 $10-150 美元。
🛠️ 部署前的准备工作
✅ 准备清单（请逐项确认）
✓ 准备项目 说明 获取方式 ☐ 💻 Mac 电脑 macOS 13.0 (Ventura) 或更高版本 — ☐ 📦 OrbStack 应用 用于运行 Linux 虚拟机 官网下载 ☐ 🔑 Anthropic API Key 用于调用 Claude AI 模型 Anthropic Console ☐ 📱 Telegram 账号 用于与 Bot 交互（或 WhatsApp） Telegram 官网 ⚠️ 重要更新：OrbStack 目前仅支持 macOS 13.0 (Ventura) 及更新版本，不再支持 macOS 12.3。
🚀 第一阶段：安装 OrbStack（图形界面操作）
💡 本阶段完全使用鼠标操作，无需输入任何命令
步骤 1.1：下载 OrbStack
- 打开浏览器，访问 https://orbstack.dev
- 点击页面中央醒目的 「Download」 按钮
- 浏览器会自动下载
OrbStack.dmg文件
📸 界面说明：OrbStack 官网首页非常简洁，下载按钮位于页面正中央，标有 "Get OrbStack" 字样，非常显眼。
步骤 1.2：安装 OrbStack
- 打开 访达（Finder） → 进入 「下载」 文件夹
- 双击
OrbStack.dmg文件，会弹出一个安装窗口 - 将 OrbStack 图标 拖拽到右侧的 「Applications」 文件夹图标上
- 等待复制完成后，关闭安装窗口
📸 界面说明：这是标准的 macOS 应用安装方式，窗口中会显示一个箭头，提示你将左侧的 OrbStack 图标拖到右侧的 Applications 文件夹。
步骤 1.3：首次启动与授权
- 打开 启动台（Launchpad） 或 访达 → 应用程序
- 找到并双击 OrbStack 图标
- 首次启动会弹出安装依赖组件的提示，点击 「Install」
- 系统会要求输入你的 Mac 登录密码，输入后点击确定
- 等待安装完成（通常只需几秒钟）
📸 界面说明：OrbStack 需要安装虚拟化框架组件，这是一次性的操作。授权后，你会在屏幕右上角的菜单栏看到 OrbStack 的图标（一个小方块）。
✅ 检查安装是否成功
安装完成后，你应该能在 屏幕右上角的菜单栏 看到 OrbStack 的图标。点击它可以快速访问 OrbStack 的功能。
📦 第二阶段：创建 Linux 虚拟机（图形界面操作）
💡 本阶段主要使用图形界面，只需点击几下鼠标
步骤 2.1：打开 OrbStack 主窗口
- 方式一（推荐）： 点击屏幕右上角菜单栏的 OrbStack 图标 → 选择 「Open OrbStack」
- 方式二： 打开 启动台 或 访达 → 应用程序 → 双击 OrbStack
步骤 2.2：进入虚拟机管理界面
- 在 OrbStack 主窗口中，看左侧边栏
- 找到 「Machines」 分类（有一个企鹅或电脑图标）
- 点击它，右侧会显示虚拟机列表（首次使用时为空）
📸 界面说明：OrbStack 的界面非常简洁。左侧是导航栏，分为 Containers（容器）和 Machines（虚拟机）两大区域。我们需要在 Machines 区域操作。
步骤 2.3：创建新虚拟机
- 在 Machines 界面的右上角，点击 「+ New Machine」 按钮
- 弹出创建虚拟机的对话框
📸 界面说明："+ New Machine" 按钮通常位于右上角，是一个带加号的按钮，点击后会弹出配置对话框。
步骤 2.4：配置虚拟机
在弹出的对话框中进行以下设置：
配置项 设置值 说明 Distribution（发行版） Ubuntu 默认选项，保持不变即可 Version（版本） 默认（最新 LTS） OrbStack 会自动选择最新的稳定版本 Name（名称） openclaw-vm ⚠️ 请务必输入这个名称，后续步骤会用到 📸 界面说明：OrbStack 已经为你预填了合理的默认值，你只需要修改虚拟机名称为
openclaw-vm即可。步骤 2.5：完成创建
- 确认配置无误后，点击 「Create」 按钮
- OrbStack 会开始下载 Ubuntu 镜像（首次需要几分钟，取决于网速）
- 下载完成后，虚拟机会 自动启动
📸 界面说明：创建过程中会显示下载进度条。完成后，你会在 Machines 列表中看到新创建的
openclaw-vm，旁边有一个绿色圆点表示正在运行。✅ 创建成功的标志
- Machines 列表中出现 openclaw-vm
- 虚拟机名称旁边有 绿色圆点（表示运行中）
- 点击虚拟机名称可以看到详细信息
⚙️ 第三阶段：安装运行环境（需要使用终端）
⚠️ 从这一步开始需要输入命令，但别担心，只需要复制粘贴即可
步骤 3.1：打开虚拟机终端
方式一：通过 OrbStack 图形界面（推荐新手）
- 在 OrbStack 主窗口的 Machines 列表中，找到
openclaw-vm - 点击它，右侧会显示虚拟机详情
- 点击 「Terminal」 标签页
- 一个终端窗口就会打开，你已经进入了 Linux 虚拟机内部
方式二：通过 Mac 终端
- 打开 Mac 的 终端（在「启动台」→「其他」文件夹中，或按
Cmd + 空格搜索 "终端"） 输入以下命令并按回车：
orb -m openclaw-vm- 命令提示符会变化，表示你已进入虚拟机
📸 界面说明：进入虚拟机后，你会看到命令提示符变成类似
用户名@openclaw-vm:~$的样式，这表示你现在是在 Linux 环境中操作。步骤 3.2：执行一键安装脚本
现在你已经在虚拟机的终端中，请 完整复制 下面这段命令，然后粘贴到终端窗口中，按 回车 执行：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && \ sudo apt install -y nodejs && \ npm install -g openclaw@latest && \ exec bash⏱️ 这个过程需要 2-5 分钟，请耐心等待。期间会显示很多滚动的文字，这是正常的。
📋 脚本执行过程说明
执行过程中你会看到以下阶段：
阶段 屏幕显示内容 说明 1️⃣ "Installing the NodeSource..." 正在配置 Node.js 软件源 2️⃣ "Reading package lists..." 正在更新软件包列表 3️⃣ "Setting up nodejs..." 正在安装 Node.js 22 LTS 4️⃣ "added X packages..." 正在安装 OpenClaw 主程序 ✅ 安装成功的标志
- 屏幕不再滚动，显示新的命令提示符
- 可以输入
node --version验证，应显示v22.x.x - 可以输入
openclaw --version验证，应显示版本号
🔧 第四阶段：配置 OpenClaw
步骤 4.1：启动配置向导
在同一个终端窗口中，输入以下命令并按回车：
openclaw onboard --install-daemon📸 界面说明：这个命令会启动一个交互式向导，通过问答方式引导你完成配置。
--install-daemon参数会让 OpenClaw 在配置完成后自动设置为后台服务（使用 systemd）。步骤 4.2：按向导提示完成配置
向导会依次询问你以下问题，请根据提示操作：
📍 问题 1：选择 LLM 提供商
? Select LLM Provider: > Anthropic OpenAI Google Ollama (本地模型) Other操作： 使用键盘 ↑↓ 箭头 移动光标，选择 Anthropic，按 回车 确认
💡 推荐选择 Anthropic，因为 OpenClaw 对 Claude 模型的支持最为完善。
📍 问题 2：输入 API Key
? Enter your Anthropic API Key:操作：
- 打开浏览器，访问 https://console.anthropic.com/
- 登录你的账号
- 在左侧菜单找到 「API Keys」
- 点击 「Create Key」 创建一个新密钥
- 复制生成的密钥（以
sk-ant-开头的一长串字符） - 回到终端，粘贴密钥（注意：粘贴时不会显示任何字符，这是正常的安全措施）
- 按 回车 确认
🔒 安全提示：API 密钥非常重要，请不要分享给他人或发布到网上。
📍 问题 3：选择通讯渠道
? Select chat channel: > Telegram WhatsApp Discord Slack Signal ...操作： 根据你的需求选择一个通讯平台。以 Telegram 为例：
- 选择 Telegram，按回车
- 向导会提示你如何获取 Telegram Bot Token
- 按照提示在 Telegram 中找 @BotFather 创建机器人
- 将获得的 Token 粘贴到终端
📍 后续问题
向导可能还会询问工作空间路径等问题，一般保持默认值即可，直接按回车跳过。
✅ 配置成功的标志
配置完成后，你会看到类似以下信息：
✓ Configuration saved ✓ OpenClaw daemon installed and started ✓ Your bot is now running!🎉 恭喜！OpenClaw 已经在后台运行了！
🖥️ 第五阶段：访问与日常使用
📱 通过聊天软件使用 OpenClaw
配置完成后，打开你选择的通讯应用（如 Telegram），找到你创建的机器人，发送一条消息试试：
你好，请介绍一下你自己如果一切正常，OpenClaw 会回复你！
🌐 通过 Web 控制台管理
在 Mac 的浏览器中输入以下地址：
http://openclaw-vm.orb.local:18789这会打开 OpenClaw 的 Web Dashboard 管理界面，你可以在这里：
- 📊 查看 Bot 运行状态
- ⚙️ 修改配置
- 📋 查看对话历史
- 💬 直接在浏览器中与 AI 对话
💡 小技巧：把这个地址加入浏览器书签，方便随时访问。
📂 通过 Finder 访问配置文件
OrbStack 的一个强大功能是 可以像访问本地文件一样访问虚拟机内的文件：
- 打开 访达（Finder）
- 在左侧边栏找到 「OrbStack」 或 「Linux」 目录
- 点击进入 → 选择
openclaw-vm - 浏览到
home/你的用户名/.config文件夹
📸 界面说明：OrbStack 会把虚拟机的文件系统挂载到 Finder 中，就像一个网络硬盘一样，你可以直接双击打开或编辑文件。
🔄 日常维护指南
通过 OrbStack 图形界面管理虚拟机
操作 方法 ▶️ 启动虚拟机 打开 OrbStack → Machines → 右键点击 openclaw-vm→ Start⏹️ 停止虚拟机 打开 OrbStack → Machines → 右键点击 openclaw-vm→ Stop🔄 重启虚拟机 打开 OrbStack → Machines → 右键点击 openclaw-vm→ Restart🗑️ 删除虚拟机 打开 OrbStack → Machines → 右键点击 openclaw-vm→ Delete通过终端管理 OpenClaw 服务
如果需要更精细的控制，可以进入虚拟机终端执行命令：
操作 命令 📊 查看服务状态 systemctl --user status openclaw-gateway🔄 重启服务 systemctl --user restart openclaw-gateway⏹️ 停止服务 systemctl --user stop openclaw-gateway▶️ 启动服务 systemctl --user start openclaw-gateway📋 查看实时日志 journalctl --user -u openclaw-gateway -f🔧 运行诊断 openclaw doctor📊 查看网关状态 openclaw gateway status🖥️ 打开 Dashboard openclaw dashboard🔍 常见问题解答（FAQ）
❓ Q1: Web 控制台打不开怎么办？
可能原因及解决方案：
原因 解决方法 虚拟机未运行 打开 OrbStack → 确认 openclaw-vm旁边有绿色圆点OpenClaw 服务未启动 进入虚拟机终端，运行 systemctl --user start openclaw-gateway地址输入错误 确认地址是 http://openclaw-vm.orb.local:18789（注意是 http 不是 https）端口被占用 检查端口 18789 是否可用，或手动指定端口： openclaw gateway --port 18790❓ Q2: Bot 不回复消息怎么办？
排查步骤：
- 检查 API 密钥是否有效：登录 Anthropic Console 确认密钥状态
- 检查账户余额：确认账户中有足够的 credits
- 运行诊断：在虚拟机终端执行
openclaw doctor - 查看日志：
journalctl --user -u openclaw-gateway -f查看错误信息
❓ Q3: 如何更换 API 密钥？
重新运行配置向导：
openclaw onboard❓ Q4: 电脑重启后 Bot 还会自动运行吗？
会的！ 只要 OrbStack 在运行，虚拟机和 OpenClaw 服务都会自动启动。建议将 OrbStack 设置为开机自启动：
- 打开 系统设置 → 通用 → 登录项
- 点击 + 按钮，添加 OrbStack
❓ Q5: 如何升级 OpenClaw？
npm update -g openclaw@latest🔒 安全注意事项
由于 OpenClaw 需要广泛的权限来执行其功能（访问邮件、日历、消息平台等），请注意以下安全建议：
- 不要将 Gateway 端口（18789）暴露到公网
- 定期更换 API 密钥
- 使用 Tailscale 等 VPN 进行远程访问
- 定期运行
openclaw doctor检查配置安全性
📚 延伸阅读与参考资源
官方文档
- 🦞 OpenClaw 官方网站
- 📖 OpenClaw 官方文档
- 🐙 OpenClaw GitHub 仓库
- 🔌 ClawhHub 技能市场
- 🐳 OrbStack 官方网站
- 📖 OrbStack 官方文档
- 🐳 OrbStack Linux 虚拟机指南
社区资源
✨ 本文小结
通过本教程，你已经学会了：
✅ 学习内容 1 了解 OpenClaw 的品牌演变历程：Clawdbot → Moltbot → OpenClaw 2 理解 OrbStack 的技术优势：共享内核架构、极低资源占用 3 认识 OpenClaw 的核心能力：多平台通讯、本地系统操作、主动式智能、Skills 系统 4 通过图形界面安装 OrbStack：下载、安装、授权 5 通过图形界面创建虚拟机：点击几下鼠标即可完成 6 执行安装脚本：使用 npm 全局安装 OpenClaw 7 配置 OpenClaw：通过交互式向导完成 8 日常维护操作：服务管理、日志查看、故障排查 🎉 现在，你拥有了一个运行在本地、隐私安全、功能强大的个人 AI 助手。开始探索 OpenClaw 的无限可能吧！
-
0 回复
歡迎留言回复交流。
Log in to reply.