OpenManus 在 Windows 上的安裝與使用教學

OpenManus 是一個強大的 AI 代理工具,可以執行網頁搜索、瀏覽網站、處理數據和自動化任務。這篇教學將指導您如何在 Windows 系統上安裝、配置和使用 OpenManus,讓您能夠順利地開始使用這個強大的工具。

前置需求

在開始安裝前,您需要準備:

  • Windows 操作系統
  • 網絡連接
  • 基本的命令行操作知識

安裝 Anaconda/Miniconda

首先,我們需要安裝 Python 環境管理工具:

  1. Anaconda 官方網站 下載 Windows 版本
  2. 執行下載的安裝檔並按照指示完成安裝
  3. 安裝時建議選擇「添加到 PATH」選項(如果提示)

開啟 Anaconda Prompt

完成 Anaconda 安裝後:

  1. 在 Windows 開始選單中搜尋 “Anaconda Prompt”
  2. 點擊搜尋結果開啟命令視窗
  3. 確認命令提示符顯示 (base) C:\Users\您的用戶名>

創建和啟用環境

在 Anaconda Prompt 中,執行以下命令:

# 創建名為 open_manus 的環境,指定使用 Python 3.12
conda create -n open_manus python=3.12

# 等待環境創建完成後,啟用環境
conda activate open_manus

# 確認環境已正確創建
python --version  # 應顯示 Python 3.12.x

安裝 Git

您可以選擇以下兩種方式之一安裝 Git:

方法一:Git for Windows(命令列方式)

  1. 前往 Git 官方網站 下載 Git for Windows
  2. 執行安裝檔,按照精靈指引進行安裝
  3. 確保選擇「將 Git 加入系統 PATH」的選項

方法二:GitHub Desktop(圖形介面方式)

  1. 前往 GitHub Desktop 官網 下載 GitHub Desktop
  2. 執行安裝檔,按照指示完成安裝
  3. 登入 GitHub 帳號(如果有的話)

克隆 OpenManus 儲存庫

使用 Git 命令(推薦):

在 Anaconda Prompt 中執行:

git clone https://github.com/mannaandpoem/OpenManus.git
cd OpenManus

或使用 GitHub Desktop:

  1. 點擊「File」→「Clone repository」
  2. 切換到 URL 標籤
  3. 輸入:https://github.com/mannaandpoem/OpenManus.git
  4. 選擇儲存位置
  5. 點擊「Clone」按鈕

安裝依賴套件與瀏覽器

返回 Anaconda Prompt,確保已啟用 open_manus 環境,然後導航到項目目錄:

# 確保環境已啟用,提示符應顯示 (open_manus)
conda activate open_manus

# 導航到項目目錄
cd 路徑\到\OpenManus

# 安裝依賴套件
pip install -r requirements.txt

# 安裝 Playwright 瀏覽器(執行此步驟前請確保網絡連接良好)
python -m playwright install

重要提示:安裝 Playwright 瀏覽器是必須的步驟,這將允許 OpenManus 自動控制瀏覽器來執行任務

配置 OpenManus

創建配置文件

在 Anaconda Prompt 中執行以下命令:

# 複製範例配置文件
copy config\config.example.toml config\config.toml

# 使用文字編輯器開啟配置文件
notepad config\config.toml

配置 API 金鑰

編輯 config\config.toml 文件,添加您的 OpenAI API 金鑰:

# Global LLM configuration

[llm]

model = “gpt-4o” base_url = “https://api.openai.com/v1” api_key = “sk-您的OpenAI金鑰” # 替換為您的真實金鑰 max_tokens = 4096 temperature = 0.0 # Optional configuration for specific LLM models

[llm.vision]

model = “gpt-4o” base_url = “https://api.openai.com/v1” api_key = “sk-您的OpenAI金鑰” # 替換為您的真實金鑰

如何獲取 OpenAI API 金鑰:

  1. 訪問 OpenAI 平台
  2. 登入或註冊帳號
  3. 前往「API Keys」或「金鑰管理」頁面
  4. 點擊「Create new secret key」或「創建新金鑰」
  5. 複製生成的金鑰(以 sk- 開頭)
  6. 將完整金鑰貼到配置文件對應位置

保存配置文件後關閉編輯器。

運行 OpenManus

完成所有準備工作後,您可以運行 OpenManus:

# 確保在正確的目錄和環境下
cd 路徑\到\OpenManus
conda activate open_manus

# 啟動 OpenManus
python main.py

成功啟動後,會看到類似以下的提示:

INFO     [browser_use] BrowserUse logging setup complete with level info
INFO     [root] Anonymized telemetry enabled. See https://docs.browser-use.com/development/telemetry for more information.
Enter your prompt (or 'exit' to quit):

看到這個提示後,您就可以開始輸入指令,讓 OpenManus 為您工作了!

提示:若要退出程序,只需輸入 exit 並按 Enter 鍵。

使用示例

基本搜索

啟動 OpenManus 後,您會看到提示符 Enter your prompt (or 'exit' to quit):。可以嘗試以下範例:

範例 1:研究公司資訊

研究程創科技這間台灣公司

OpenManus 將執行以下操作:

  1. 執行 Google 搜尋,找到相關網站
  2. 訪問官方網站
  3. 提取公司信息
  4. 將信息保存到文本文件中

範例 2:詳細分析特定主題

針對程創科技的產品線進行分析並比較市場定位

範例 3:獲取特定資訊並整理

找出程創科技的核心技術與專利,並整理成摘要

查看結果

完成任務後,OpenManus 會在當前目錄生成文件,例如:

  • VierMTech_Company_Info.txt – 包含公司基本信息
  • VierM_Tech_Links.txt – 包含相關網站連結

您可以使用任何文本編輯器開啟這些文件查看結果。

使用技巧與訣竅

有效指令格式

為了獲得最佳結果,請嘗試使用以下格式的指令:

  • 具體且明確:「搜索程創科技的產品介紹並保存」
  • 指定研究方向:「分析程創科技的公司歷史和業務範圍」
  • 請求特定動作:「對比程創科技與其競爭對手的主要產品」

確保 API 金鑰設置正確

確保您在配置文件中正確設置了 API 金鑰:

  • OpenAI 金鑰以 sk- 開頭
  • API 端點與您使用的模型相匹配
  • 金鑰有足夠的使用額度和權限

保持依賴項更新

定期更新依賴項可以確保最佳性能:

pip install --upgrade -r requirements.txt
python -m playwright install --with-deps

OpenManus 的核心功能

主要工具介紹

OpenManus 提供多種強大工具,可以根據您的需求自動選擇和使用:

  • google_search:執行網頁搜尋,獲取最新的網絡資訊
  • browser_use:瀏覽和互動網頁,獲取網站內容
  • python_execute:執行 Python 代碼,處理和分析數據
  • file_saver:將內容保存到文件,方便日後查閱

高級用法示例

以下是一些進階使用方式:

  1. 研究分析深入分析人工智能在台灣半導體產業的應用趨勢,並整理成報告
  2. 數據處理搜集最近三個月的台股大盤指數走勢,並製作圖表分析
  3. 內容創建生成一篇關於可持續發展在科技企業的實踐方式的文章

結論

OpenManus 是一個功能強大的 AI 代理工具,能夠有效自動化各種任務。通過本教學,您已經學會了如何在 Windows 系統上安裝、配置和使用 OpenManus。只需提供明確的指令,它就能執行網頁搜索、信息提取和分析等任務,大大提升您的工作效率。

開始使用 OpenManus,探索 AI 代理的無限可能!


希望這份教學能幫助您成功部署和使用 OpenManus。如有更多問題,可以參考 OpenManus GitHub 頁面 或加入其社群獲取支持。

發佈留言