🚀 如何运行 OpenHands：一步步指南

在这个快速发展的科技时代，OpenHands 为软件开发带来了全新的可能性。无论你是开发新手还是资深工程师，了解如何有效地运行 OpenHands 都是至关重要的。本文将为你提供详细的步骤和要求，帮助你顺利启动 OpenHands。

🖥️ 系统要求

要运行 OpenHands，你的系统需要满足以下基本要求：

• 操作系统：
  • MacOS：支持 Docker Desktop
  • Linux：推荐使用 Ubuntu 22.04
  • Windows：需要 WSL 和 Docker Desktop 支持
• 硬件要求：
  • 现代处理器
  • 至少 4GB RAM

确保你的系统符合这些要求，以便顺利运行 OpenHands。

🔧 前提条件

在开始之前，你需要安装一些必要的软件：

MacOS

1. 安装 Docker Desktop：可以从 Docker 官方网站下载并安装。
2. 配置 Docker：
   • 打开 Docker Desktop，进入 Settings > Advanced，确保 Allow the default Docker socket to be used 选项已启用。

Linux

1. 安装 Docker Desktop：请参考 Docker 官方文档进行安装。

Windows

1. 安装 WSL：
   • 在 PowerShell 中运行 wsl --version，确认默认版本为 2。
2. 安装 Docker Desktop：从 Docker 官方网站下载并安装。
3. 配置 Docker：
   • 打开 Docker Desktop，进入 Settings，确认以下选项已启用：
     • General：使用 WSL 2 基于引擎
     • Resources > WSL Integration：与我的默认 WSL 发行版集成

注意：启动应用程序的命令必须在 WSL 终端中运行。

🚀 启动应用程序

启动 OpenHands 的最简单方法是使用 Docker。以下是启动 OpenHands 的命令：

docker pull docker.all-hands.dev/all-hands-ai/runtime:0.30-nikolaik

docker run -it --rm --pull=always \
-e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.30-nikolaik \
-e LOG_ALL_EVENTS=true \
-v /var/run/docker.sock:/var/run/docker.sock \
-v ~/.openhands-state:/.openhands-state \
-p 3000:3000 \
--add-host host.docker.internal:host-gateway \
--name openhands-app \
docker.all-hands.dev/all-hands-ai/openhands:0.30

运行后，你可以在浏览器中访问 http://localhost:3000 来与 OpenHands 进行交互。

⚙️ 设置

在启动 OpenHands 后，你会看到一个设置页面。你需要选择一个 LLM 提供者和 LLM 模型，并输入相应的 API 密钥。这些设置可以随时通过 UI 中的设置按钮（齿轮图标）进行更改。

如果所需的模型不在列表中，你可以切换到高级选项，手动输入正确的前缀。

获取 API 密钥

OpenHands 需要 API 密钥来访问大多数语言模型。以下是从推荐提供者获取 API 密钥的步骤：

• Anthropic (Claude)：
  1. 创建一个 Anthropic 账户
  2. 生成 API 密钥
  3. 设置账单
  4. 考虑设置使用限制以控制成本
• OpenAI：
  1. 创建一个 OpenAI 账户
  2. 生成 API 密钥
  3. 设置账单

📦 版本管理

上面的 Docker 命令会拉取 OpenHands 的最新稳定版本。如果你需要特定版本，可以将 VERSION 替换为 main，但请注意，这个版本不稳定，建议仅用于测试或开发目的。

❓ 遇到问题？

如果在使用过程中遇到问题，可以查看我们的 故障排除指南。

---

通过以上步骤，你应该能够顺利运行 OpenHands，开启高效的开发之旅。无论是进行日常开发还是探索新功能，OpenHands 都将是你强大的助手。