在 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 技术架构解析

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 开发。

核心能力矩阵

🔔 主动式智能（Proactive Intelligence）

这是 OpenClaw 区别于传统 AI 助手的关键特性：

• 无需你询问"服务器宕机了吗？"——OpenClaw 会自动检测并主动通知你
• 无需你查询"股价下跌了吗？"——OpenClaw 会监控阈值并及时预警
• 内置"心跳引擎"和 Cron 任务集成，真正实现"设置后遗忘"的自动化

🔧 Skills 技能系统

OpenClaw 拥有独特的"技能"系统：社区通过 clawhub.ai 分享数千种能力。一个技能是包含 markdown 指令和可选脚本的 zip 文件，功能类似插件系统。超过 100 个预配置的 AgentSkills 可让 AI 执行 shell 命令、管理文件系统和执行 Web 自动化。

💰 费用说明

OpenClaw 本身是 MIT 许可证下的免费开源软件。实际费用来源于 AI 模型提供商的 API 调用，通常为每月 $10-150 美元。

🛠️ 部署前的准备工作

✅ 准备清单（请逐项确认）

⚠️ 重要更新：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：配置虚拟机

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

📸 界面说明：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 分钟，请耐心等待。期间会显示很多滚动的文字，这是正常的。

📋 脚本执行过程说明

执行过程中你会看到以下阶段：

✅ 安装成功的标志

• 屏幕不再滚动，显示新的命令提示符
• 可以输入 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 图形界面管理虚拟机

通过终端管理 OpenClaw 服务

如果需要更精细的控制，可以进入虚拟机终端执行命令：

🔍 常见问题解答（FAQ）

❓ Q1: Web 控制台打不开怎么办？

可能原因及解决方案：

❓ 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 检查配置安全性

📚 延伸阅读与参考资源

官方文档

• 🦞 OpenClaw 官方网站
• 📖 OpenClaw 官方文档
• 🐙 OpenClaw GitHub 仓库
• 🔌 ClawhHub 技能市场
• 🐳 OrbStack 官方网站
• 📖 OrbStack 官方文档
• 🐳 OrbStack Linux 虚拟机指南

社区资源

• OpenClaw Discord 社区
• OrbStack GitHub 仓库

✨ 本文小结

通过本教程，你已经学会了：

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