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

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

🖥️ 系统要求

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

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

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

🔧 前提条件

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

MacOS

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

Linux

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

Windows

安装 WSL：
- 在 PowerShell 中运行 wsl --version，确认默认版本为 2。
安装 Docker Desktop：从 Docker 官方网站下载并安装。
配置 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 替换为版本号。我们使用语义版本控制（SemVer），例如，0.9 会自动指向最新的 0.9.x 版本。

对于开发版本，你可以将 $VERSION 替换为 main，但请注意，这个版本不稳定，建议仅用于测试或开发目的。

❓ 遇到问题？

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

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