LangManus FAQ - AI 自動化框架常見問題解答

LangManus 支持哪些模型？

在 LangManus 中，我們將模型分為以下三類：

1. Chat Model（聊天模型）

• 用途：用于對話場景，主要在 Supervisor 和 Agent 中被調(diào)用。
• 支持的模型：gpt-4o、qwen-max-latest。

2. Reasoning Model（推理模型）

• 用途：用于復雜推理任務，當 “Deep Think” 模式啟用時，在 Planner 中被使用。
• 支持的模型：o1、o3-mini、QwQ-Plus、DeepSeek-R1, gemini-2.0-flash-thinking-exp。

3. VL Model（視覺語言模型）

• 用途：用于處理視覺和語言結合的任務，主要在 Browser Tool 中被調(diào)用。
• 支持的模型：gpt-4o、qwen2.5-vl-72b-instruct。

如何切換模型？

您可以通過修改項目根目錄下的 conf.yaml 文件使用litellm格式的配置來切換所使用的模型。具體配置方法請參考 README.md。

如何使用 Ollama 模型？

LangManus 支持集成 Ollama 模型。您可以參考litellm Ollama。 以下是使用 Ollama 模型的conf.yaml配置示例：

REASONING_MODEL:
  model: "ollama/ollama-model-name"
  api_base: "http://localhost:11434" # ollama本地服務地址, 可以通過ollama serve啟動/查看地址

如何使用 OpenRouter 模型？

LangManus 支持集成 OpenRouter 模型。你可以參考litellm OpenRouter，要使用OpenRouter模型，您需要:

1. 從 OpenRouter 獲取 OPENROUTER_API_KEY (https://openrouter.ai/) 并設置到環(huán)境變量中
2. 在模型名稱前添加 openrouter/ 前綴
3. 配置正確的 OpenRouter 基礎 URL

以下是使用 OpenRouter 模型的配置示例：

1. 在環(huán)境變量（比如.env文件）中配置OPENROUTER_API_KEY

OPENROUTER_API_KEY=""

1. 在conf.yaml中配置模型

REASONING_MODEL:
  model: "openrouter/google/palm-2-chat-bison"

注意：可用模型及其確切名稱可能隨時間變化。請在 OpenRouter 的官方文檔 上驗證當前可用的模型及其正確標識符。

如何使用 Google Gemini 模型？

LangManus 支持集成 Google 的 Gemini 模型。您可以參考litellm Gemini，要使用 Gemini 模型，請按照以下步驟操作：

1. 從 Google AI Studio 獲取 Gemini API 密鑰 (https://makersuite.google.com/app/apikey)
2. 在環(huán)境變量（比如.env文件）中配置Gemini API 密鑰

GEMINI_API_KEY="您的Gemini API密鑰"

1. 在conf.yaml中配置模型

REASONING_MODEL:
  model: "gemini/gemini-pro"

注意事項：

• 將 YOUR_GEMINI_KEY 替換為你實際的 Gemini API 密鑰
• 基礎 URL 專門配置為通過 LangManus 的 OpenAI 兼容接口使用 Gemini
• 可用模型包括用于聊天和視覺任務的 gemini-2.0-flash

如何使用 Azure 模型？

LangManus 支持集成 Azure 的模型。您可以參考litellm Azure。conf.yaml配置示例：

REASONING_MODEL:
  model: "azure/gpt-4o-2024-08-06"
  api_base: $AZURE_API_BASE
  api_version: $AZURE_API_VERSION
  api_key: $AZURE_API_KEY

如何部署 Web UI 前端項目？

LangManus 提供了一個開箱即用的 Web UI 前端項目，您可以通過以下步驟完成部署。請訪問 LangManus Web UI GitHub 倉庫 獲取更多信息。

步驟 1：啟動 LangManus 的后端服務

首先，確保您已經(jīng)克隆并安裝了 LangManus 的后端項目。進入后端項目目錄并啟動服務：

cd langmanus
make serve

默認情況下，LangManus 后端服務會運行在 http://localhost:8000。

步驟 2：安裝 Web UI 前端項目及其依賴

接下來，克隆 LangManus 的 Web UI 前端項目并安裝依賴：

git clone https://github.com/langmanus/langmanus-web.git
cd langmanus-web
pnpm install

注意: 如果您尚未安裝 pnpm，請先安裝它?？梢酝ㄟ^以下命令安裝：


npm install -g pnpm


步驟 3：啟動 Web UI 服務

完成依賴安裝后，啟動 Web UI 的開發(fā)服務器：

pnpm dev

默認情況下，LangManus 的 Web UI 服務會運行在 http://localhost:3000。

Browser Tool 無法正常啟動？

LangManus 使用 browser-use 來實現(xiàn)瀏覽器相關功能，而 browser-use 是基于 Playwright 構建的。因此，在首次使用前，需要安裝 Playwright 的瀏覽器實例。

uv run playwright install

可以用本地的 Chrome 瀏覽器作為 Browser Tool 嗎？

是的，LangManus 支持使用本地的 Chrome 瀏覽器作為 Browser Tool。LangManus 使用 browser-use 來實現(xiàn)瀏覽器相關功能，而 browser-use 是基于 Playwright 實現(xiàn)的。通過配置 .env 文件中的 CHROME_INSTANCE_PATH，你可以指定本地 Chrome 瀏覽器的路徑，從而實現(xiàn)使用本地瀏覽器實例的功能。

配置步驟

1. 退出所有 Chrome 瀏覽器進程 在使用本地 Chrome 瀏覽器之前，確保所有 Chrome 瀏覽器進程已完全退出。否則，browser-use 無法正常啟動瀏覽器實例。

1. 設置 CHROME_INSTANCE_PATH 在項目的 .env 文件中，添加或修改以下配置項：

   CHROME_INSTANCE_PATH=/path/to/your/chrome

將 /path/to/your/chrome 替換為本地 Chrome 瀏覽器的可執(zhí)行文件路徑。例如：

• macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
• Windows: C:\Program Files\Google\Chrome\Application\chrome.exe
• Linux: /usr/bin/google-chrome

1. 啟動 LangManus 啟動 LangManus 后，browser-use 將使用你指定的本地 Chrome 瀏覽器實例。

1. 訪問 LangManus 的 Web UI 由于本地 Chrome 瀏覽器被 browser-use 占用，你需要使用其他瀏覽器（如 Safari、Mozilla Firefox）訪問 LangManus 的 Web 界面，地址通常為 http://localhost:3000?；蛘?，你也可以從另一臺計算機上訪問 LangManus 的 Web UI。

請參考 FAQ.md 了解更多信息。