🔥 BRAVE 質押池已上線 — 在錢包搜尋 BRAVE 即可委託

如何在 MacOS 中利用 OrbStack 虚拟机一键部署 Clawdbot/Moltbot/OpenClaw

    • #32928

      在 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

      1. 打开浏览器,访问 https://orbstack.dev
      2. 点击页面中央醒目的 「Download」 按钮
      3. 浏览器会自动下载 OrbStack.dmg 文件

      📸 界面说明:OrbStack 官网首页非常简洁,下载按钮位于页面正中央,标有 “Get OrbStack” 字样,非常显眼。

      步骤 1.2:安装 OrbStack

      1. 打开 访达(Finder) → 进入 「下载」 文件夹
      2. 双击 OrbStack.dmg 文件,会弹出一个安装窗口
      3. OrbStack 图标 拖拽到右侧的 「Applications」 文件夹图标上
      4. 等待复制完成后,关闭安装窗口

      📸 界面说明:这是标准的 macOS 应用安装方式,窗口中会显示一个箭头,提示你将左侧的 OrbStack 图标拖到右侧的 Applications 文件夹。

      步骤 1.3:首次启动与授权

      1. 打开 启动台(Launchpad)访达 → 应用程序
      2. 找到并双击 OrbStack 图标
      3. 首次启动会弹出安装依赖组件的提示,点击 「Install」
      4. 系统会要求输入你的 Mac 登录密码,输入后点击确定
      5. 等待安装完成(通常只需几秒钟)

      📸 界面说明:OrbStack 需要安装虚拟化框架组件,这是一次性的操作。授权后,你会在屏幕右上角的菜单栏看到 OrbStack 的图标(一个小方块)。

      ✅ 检查安装是否成功

      安装完成后,你应该能在 屏幕右上角的菜单栏 看到 OrbStack 的图标。点击它可以快速访问 OrbStack 的功能。


      📦 第二阶段:创建 Linux 虚拟机(图形界面操作)

      💡 本阶段主要使用图形界面,只需点击几下鼠标

      步骤 2.1:打开 OrbStack 主窗口

      • 方式一(推荐): 点击屏幕右上角菜单栏的 OrbStack 图标 → 选择 「Open OrbStack」
      • 方式二: 打开 启动台访达 → 应用程序 → 双击 OrbStack

      步骤 2.2:进入虚拟机管理界面

      1. 在 OrbStack 主窗口中,看左侧边栏
      2. 找到 「Machines」 分类(有一个企鹅或电脑图标)
      3. 点击它,右侧会显示虚拟机列表(首次使用时为空)

      📸 界面说明:OrbStack 的界面非常简洁。左侧是导航栏,分为 Containers(容器)和 Machines(虚拟机)两大区域。我们需要在 Machines 区域操作。

      步骤 2.3:创建新虚拟机

      1. 在 Machines 界面的右上角,点击 「+ New Machine」 按钮
      2. 弹出创建虚拟机的对话框

      📸 界面说明:”+ New Machine” 按钮通常位于右上角,是一个带加号的按钮,点击后会弹出配置对话框。

      步骤 2.4:配置虚拟机

      在弹出的对话框中进行以下设置:

      配置项设置值说明
      Distribution(发行版)Ubuntu默认选项,保持不变即可
      Version(版本)默认(最新 LTS)OrbStack 会自动选择最新的稳定版本
      Name(名称)openclaw-vm⚠️ 请务必输入这个名称,后续步骤会用到

      📸 界面说明:OrbStack 已经为你预填了合理的默认值,你只需要修改虚拟机名称为 openclaw-vm 即可。

      步骤 2.5:完成创建

      1. 确认配置无误后,点击 「Create」 按钮
      2. OrbStack 会开始下载 Ubuntu 镜像(首次需要几分钟,取决于网速)
      3. 下载完成后,虚拟机会 自动启动

      📸 界面说明:创建过程中会显示下载进度条。完成后,你会在 Machines 列表中看到新创建的 openclaw-vm,旁边有一个绿色圆点表示正在运行。

      ✅ 创建成功的标志

      • Machines 列表中出现 openclaw-vm
      • 虚拟机名称旁边有 绿色圆点(表示运行中)
      • 点击虚拟机名称可以看到详细信息

      ⚙️ 第三阶段:安装运行环境(需要使用终端)

      ⚠️ 从这一步开始需要输入命令,但别担心,只需要复制粘贴即可

      步骤 3.1:打开虚拟机终端

      方式一:通过 OrbStack 图形界面(推荐新手)

      1. 在 OrbStack 主窗口的 Machines 列表中,找到 openclaw-vm
      2. 点击它,右侧会显示虚拟机详情
      3. 点击 「Terminal」 标签页
      4. 一个终端窗口就会打开,你已经进入了 Linux 虚拟机内部

      方式二:通过 Mac 终端

      1. 打开 Mac 的 终端(在「启动台」→「其他」文件夹中,或按 Cmd + 空格 搜索 “终端”)
      2. 输入以下命令并按回车:

        orb -m openclaw-vm
      3. 命令提示符会变化,表示你已进入虚拟机

      📸 界面说明:进入虚拟机后,你会看到命令提示符变成类似 用户名@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:

      操作:

      1. 打开浏览器,访问 https://console.anthropic.com/
      2. 登录你的账号
      3. 在左侧菜单找到 「API Keys」
      4. 点击 「Create Key」 创建一个新密钥
      5. 复制生成的密钥(以 sk-ant- 开头的一长串字符)
      6. 回到终端,粘贴密钥(注意:粘贴时不会显示任何字符,这是正常的安全措施)
      7. 回车 确认

      🔒 安全提示:API 密钥非常重要,请不要分享给他人或发布到网上。

      📍 问题 3:选择通讯渠道

      ? Select chat channel:
        > Telegram
          WhatsApp
          Discord
          Slack
          Signal
          ...

      操作: 根据你的需求选择一个通讯平台。以 Telegram 为例:

      1. 选择 Telegram,按回车
      2. 向导会提示你如何获取 Telegram Bot Token
      3. 按照提示在 Telegram 中找 @BotFather 创建机器人
      4. 将获得的 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 的一个强大功能是 可以像访问本地文件一样访问虚拟机内的文件

      1. 打开 访达(Finder)
      2. 在左侧边栏找到 「OrbStack」「Linux」 目录
      3. 点击进入 → 选择 openclaw-vm
      4. 浏览到 home/你的用户名/.config 文件夹

      📸 界面说明:OrbStack 会把虚拟机的文件系统挂载到 Finder 中,就像一个网络硬盘一样,你可以直接双击打开或编辑文件。


      🔄 日常维护指南

      通过 OrbStack 图形界面管理虚拟机

      操作方法
      ▶️ 启动虚拟机打开 OrbStack → Machines → 右键点击 openclaw-vmStart
      ⏹️ 停止虚拟机打开 OrbStack → Machines → 右键点击 openclaw-vmStop
      🔄 重启虚拟机打开 OrbStack → Machines → 右键点击 openclaw-vmRestart
      🗑️ 删除虚拟机打开 OrbStack → Machines → 右键点击 openclaw-vmDelete

      通过终端管理 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
      🖥️ 打开 Dashboardopenclaw 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 不回复消息怎么办?

      排查步骤:

      1. 检查 API 密钥是否有效:登录 Anthropic Console 确认密钥状态
      2. 检查账户余额:确认账户中有足够的 credits
      3. 运行诊断:在虚拟机终端执行 openclaw doctor
      4. 查看日志journalctl --user -u openclaw-gateway -f 查看错误信息

      ❓ Q3: 如何更换 API 密钥?

      重新运行配置向导:

      openclaw onboard

      ❓ Q4: 电脑重启后 Bot 还会自动运行吗?

      会的! 只要 OrbStack 在运行,虚拟机和 OpenClaw 服务都会自动启动。建议将 OrbStack 设置为开机自启动:

      1. 打开 系统设置通用登录项
      2. 点击 + 按钮,添加 OrbStack

      ❓ Q5: 如何升级 OpenClaw?

      npm update -g openclaw@latest

      🔒 安全注意事项

      由于 OpenClaw 需要广泛的权限来执行其功能(访问邮件、日历、消息平台等),请注意以下安全建议:

      1. 不要将 Gateway 端口(18789)暴露到公网
      2. 定期更换 API 密钥
      3. 使用 Tailscale 等 VPN 进行远程访问
      4. 定期运行 openclaw doctor 检查配置安全性

      📚 延伸阅读与参考资源

      官方文档

      社区资源


      ✨ 本文小结

      通过本教程,你已经学会了:

      学习内容
      1了解 OpenClaw 的品牌演变历程:Clawdbot → Moltbot → OpenClaw
      2理解 OrbStack 的技术优势:共享内核架构、极低资源占用
      3认识 OpenClaw 的核心能力:多平台通讯、本地系统操作、主动式智能、Skills 系统
      4通过图形界面安装 OrbStack:下载、安装、授权
      5通过图形界面创建虚拟机:点击几下鼠标即可完成
      6执行安装脚本:使用 npm 全局安装 OpenClaw
      7配置 OpenClaw:通过交互式向导完成
      8日常维护操作:服务管理、日志查看、故障排查

      🎉 现在,你拥有了一个运行在本地、隐私安全、功能强大的个人 AI 助手。开始探索 OpenClaw 的无限可能吧!

  • 抱歉,回覆主題必需先登入。