← 返回博客

OpenClaw 安装指南：CLI vs GUI — 完整安装教程（2026）

2026-03-16·9 分钟阅读·OpenClawWay
openclaw 安装openclaw 设置openclaw manager安装指南CLIGUI

说实话：安装是大多数人放弃 OpenClaw 的地方。

不是因为 OpenClaw 难用 — 一旦跑起来，它真的很神奇。但从"我想试试"到"我的第一个 Agent 活了"需要安装 Node.js、配置 API 密钥、设置消息通道、处理环境变量。对开发者来说，这是周二下午的事。对其他人来说，这是一堵墙。

好消息？OpenClaw 社区构建了两个优秀的工具，让整个过程大幅简化。一个是命令行安装器，一个脚本搞定一切。另一个是完整的桌面应用，有按钮、仪表板，完全不需要终端。

本指南涵盖两种方式。读完后，你会确切知道哪种方法适合你 — 并且让 OpenClaw 跑起来。

开始之前：你需要什么

无论选择哪种安装方式，你都需要：

  • 一台运行 OpenClaw 的机器 — VPS（DigitalOcean、Hetzner、AWS）、树莓派或你自己的笔记本/台式机。最低 2GB RAM，1GB 磁盘空间。
  • 至少一个 AI 提供商的 API 密钥 — Anthropic（Claude）、OpenAI（GPT）、Google（Gemini）等。大多数人从 Anthropic 开始。在 console.anthropic.com 注册。
  • 一个消息账号（可选但推荐）— Telegram、Discord、WhatsApp、Slack 或飞书，用于将 Agent 连接到聊天界面。

启动总成本：大约 $5-15/月的 API 使用费，加上服务器费用（本地运行则免费）。

方式 1：CLI 安装（OpenClawInstaller）

最适合： 开发者、系统管理员、VPS 用户、任何熟悉终端的人。

OpenClawInstaller 是 miaoxworld 创建的一行部署脚本。它在 macOS 和 Linux 上自动化整个 OpenClaw 安装过程 — 依赖安装、AI 模型配置、消息通道连接和服务启动。一条命令搞定。

系统要求

要求详情
操作系统macOS 12+ / Ubuntu 20.04+ / Debian 11+ / CentOS 8+
Node.jsv22 或更高（缺失时自动安装）
RAM最低 2GB，推荐 4GB+
磁盘最低 1GB 可用空间

分步安装

第 1 步：运行一行命令。

打开终端粘贴：

curl -fsSL https://raw.githubusercontent.com/miaoxworld/OpenClawInstaller/main/install.sh | bash

就这样。脚本自动检测系统环境、安装缺失依赖（包括 Node.js）、全局安装 OpenClaw、启动交互式设置向导。

第 2 步：配置 AI 模型。

向导会让你选择 AI 提供商。支持的选项包括：

  • Anthropic Claude（claude-sonnet-4-5、claude-opus-4-5、claude-haiku-4-5）
  • OpenAI GPT（gpt-4o、gpt-4o-mini、gpt-4-turbo）
  • Google Gemini（gemini-2.0-flash、gemini-1.5-pro）
  • OpenRouter（多模型网关 — 一个密钥访问所有模型）
  • Groq（超快推理，Llama 和 Mixtral）
  • Mistral AI
  • Ollama（本地部署，不需要 API 密钥）

第 3 步：设置消息通道（可选）。

向导会提供配置消息通道的选项。Telegram 需要 @BotFather 的 Bot Token 和 @userinfobot 的 User ID。Discord 需要 Bot Token 和 Channel ID。脚本会引导你完成每一步。

第 4 步：启动服务。

配置完成后，脚本询问是否立即启动 OpenClaw。选是。它将网关作为后台守护进程启动。

# 验证运行状态
openclaw gateway status

CLI 安装：优缺点

优点：

  • 从零到运行最快的路径 — 字面意思一条命令
  • 通过 SSH 在远程服务器上工作（VPS、云实例）
  • 轻量 — 无 GUI 开销
  • 完全访问所有 OpenClaw CLI 命令
  • 支持自定义 API 代理和自托管模型（Ollama）

缺点：

  • 需要终端操作能力
  • 仅 macOS 和 Linux（不支持 Windows）
  • 文本界面，无可视化仪表板

方式 2：GUI 安装（OpenClaw Manager）

最适合： 视觉学习者、Windows 用户、喜欢点击而非打字的人。

OpenClaw Manager 是 miaoxworld 使用 Tauri 2.0、React、TypeScript 和 Rust 构建的桌面应用。它提供现代、精致的界面来安装、配置和监控 OpenClaw — 包括实时仪表板、可视化 AI 模型配置和一键服务管理。

支持 macOS、Windows 和 Linux。

分步安装

第 1 步：下载 OpenClaw Manager。

前往 GitHub releases 页面下载你平台的安装程序：

  • macOS：.dmg 文件
  • Windows：.msi 或 .exe 安装程序
  • Linux：.deb 或 .AppImage

第 2 步：安装并启动。

macOS 上拖到应用程序文件夹。Windows 上运行 .msi 安装程序。Linux 上安装 .deb 包或直接运行 .AppImage。

第 3 步：配置 AI 模型。

打开应用导航到 AI 配置面板。你会看到列出 14+ AI 提供商的清晰界面。输入 API 密钥，选择模型，点击保存。

第 4 步：设置消息通道。

切换到通道面板。每个通道有专用配置表单。填写字段，保存，连接完成。

第 5 步：启动服务。

进入仪表板。你会看到实时服务状态，包括端口、进程 ID、内存使用和运行时间。点击启动按钮。

GUI 安装：优缺点

优点：

  • 不需要终端知识 — 全部点击操作
  • 支持 Windows
  • 实时仪表板监控
  • 可视化配置 AI 模型和消息通道
  • 内置诊断和连接测试
  • 得益于 Rust 后端，内存占用极低

缺点：

  • 需要下载安装桌面应用
  • 不太适合无桌面环境的服务器（无头 VPS）

CLI vs GUI：并排对比

特性CLI（OpenClawInstaller）GUI（OpenClaw Manager）
安装速度~2 分钟（一条命令）~5 分钟（下载 + 安装）
平台支持macOS、LinuxmacOS、Windows、Linux
需要终端是否
可视化仪表板否是（实时监控）
远程服务器（VPS）优秀（通过 SSH）不理想（需要桌面）
最适合开发者、系统管理员、VPS视觉学习者、Windows 用户

简短版： 如果你在远程服务器上部署或常驻终端，选 CLI。如果你想要可视化体验或在 Windows 上，选 GUI。两个工具都由 miaoxworld 维护，都能达到相同结果。

安装后：配置你的第一个 Agent

无论使用哪种方式，OpenClaw 现在已经在运行。以下是设置第一个 Agent 的方法。

理解工作区

每个 OpenClaw Agent 都在一个工作区中 — 一个包含定义其个性、记忆和能力的 markdown 文件的文件夹。默认工作区在 ~/.openclaw/workspace/。

关键文件：

  • SOUL.md — Agent 的个性、价值观和沟通风格
  • IDENTITY.md — 名称、角色、专长和职责
  • USER.md — 关于你的信息（让 Agent 知道它在帮谁）
  • AGENTS.md — Agent 的操作指令
  • memory/ — Agent 存储每日笔记和长期记忆的地方

创建一个简单的 Agent

创建一个基础助手。打开 ~/.openclaw/workspace/SOUL.md 写入：

# Soul: 个人助手

## 个性
你乐于助人、简洁、主动。你预判需求，
给出清晰的建议而不是只列选项。

## 沟通风格
- 直接且面向行动
- 使用要点列表保持清晰
- 每次回复以明确的下一步结束

然后编辑 IDENTITY.md：

# Identity: 助手

- **名称：** Atlas
- **角色：** 个人助手
- **专长：** 研究、日程安排、写作、任务管理

就这样。你的 Agent 现在有了个性。在 Telegram（或你配置的任何通道）上发消息，它会以 Atlas 的身份回复。

常见问题

可以同时使用 CLI 安装器和 GUI 管理器吗？

可以。它们配置的是同一个底层 OpenClaw 安装（~/.openclaw/）。你可以在服务器上用 CLI 安装，然后在桌面上用 OpenClaw Manager 监控和调整设置。它们是互补工具，不是竞争工具。

需要强大的服务器来运行 OpenClaw 吗？

不需要。OpenClaw 本身很轻量 — 本质上是一个协调 API 调用的 Node.js 进程。繁重的计算在 Anthropic/OpenAI/Google 的服务器上进行。$5/月的 1GB RAM VPS 个人使用完全够用。

应该从哪个 AI 模型开始？

大多数人从 Anthropic 的 Claude Sonnet 开始。它在智能、速度和成本之间提供最佳平衡。想要最强模型且不介意更高成本，试试 Claude Opus。预算友好的选择：Google Gemini Flash 或 Groq 的 Llama 模型。

可以在 Windows 上运行 OpenClaw 吗？

用 OpenClaw Manager（GUI），可以 — 它有原生 Windows 支持。CLI 安装器目前只支持 macOS 和 Linux。如果你在 Windows 上且偏好命令行，可以用 WSL（Windows 子系统 Linux）运行 CLI 安装器。

我的数据安全吗？OpenClaw 会向第三方发送数据吗？

OpenClaw 完全在你的机器上运行。你的对话、记忆文件和配置保持本地。唯一的外部通信是与你配置的 AI 提供商（Anthropic、OpenAI 等）— 那只是生成回复所需的 API 调用。没有遥测，没有跟踪，没有数据收集。

接下来做什么？

你已经安装了 OpenClaw 并配置了第一个 Agent。这是最难的部分 — 真的。从这里开始，可能性迅速展开：

  • 构建自定义技能 — 通过编写简单的 markdown 文件教 Agent 新能力
  • 连接多个通道 — 让同一个 Agent 在 Telegram、Discord 和 Slack 上回复
  • 设置 Agent 团队 — 创建互相协调的专业 Agent
  • 自动化工作流 — 从每日简报到内容创作到代码部署

OpenClawInstaller 和 OpenClaw Manager 都是 miaoxworld 的开源项目。如果它们节省了你的时间，考虑在 GitHub 上给仓库加星 — 这帮助更多人发现这些工具。

现在去用你的新 Agent 构建一些酷的东西吧。安装完成了。有趣的部分现在开始。

想要完整攻略？

获取免费指南：5 个 OpenClaw 自动化方案，30 天内回本。

获取免费指南 →

更多文章

2026-03-18
YC CEO 教你如何构建 AI Agent 团队（2026 指南）
2026-03-18
GStack vs OpenClaw：AI 编程团队 vs AI 全业务团队（2026 对比）
2026-03-17
用 Docker 部署 OpenClaw：完整安装指南（2026）