龍蝦新手指南：從零開始學AI

1. 什么是YOYO Claw？

YOYO Claw（代號“龍蝦”）是榮耀推出的終端側AI智能體，不是概念演示，而是已落地的本地AI運行時。它直接集成在榮耀MagicBook系列筆記本中，把PC變成能理解、能協作、能執行的“Partner Creator”。

它不依賴持續聯網，所有核心推理都在設備端完成；Agent設計面向真實工作流，不是玩具模型。

2. 為什么用YOYO Claw？

本地推理，不上傳數據

YOYO Claw的模型和推理引擎全部跑在本地。文檔、代碼、會議錄音、截圖——所有輸入都不離開設備。響應延遲低至毫秒級，斷網時照樣工作。

多端一致，非簡單移植

PC和Pad共用同一套Agent Runtime。同一個會議紀要蝦，在筆記本上聽語音，在平板上同步標注PPT，上下文自動延續，不是兩個獨立App。

預置5個高頻Agent，開箱即用

每個Agent解決一個具體問題，接口統一，無需調參：

• 文檔理解蝦：支持PDF、Word、Markdown，提取關鍵結論+生成問答對
• 代碼輔助蝦：接入本地VS Code插件，補全基于你項目里的函數和注釋
• 會議紀要蝦：實時轉寫+區分發言人+自動標記待辦項（如“@張三 3天內提交方案”）
• 多模態摘要蝦：拖入一張截圖+一段語音+一份Excel，輸出交叉分析摘要
• 個性化工作流蝦：用自然語言定義規則，比如“每周五下午3點，匯總釘釘未讀消息+飛書日程，生成周報草稿”

3. 安裝和配置

系統要求

• Windows 10 22H2+ 或 macOS 13.0+
• Intel Core i5-1135G7 / AMD Ryzen 5 5600U 起（需支持AVX2）
• 8GB RAM（推薦16GB）
• 10GB 可用空間（含模型緩存）

下載安裝包

官網地址：https://yoyoclaws.ai
下載后校驗SHA256（安裝包頁面底部提供）：

sha256sum YOYO_Claw_Installer.exe
# 應與官網公示值一致

運行安裝

Windows雙擊安裝包，macOS拖入Applications文件夾。安裝過程自動檢測顯卡驅動并部署對應推理后端（DirectML / Metal）。

初始配置

首次啟動彈出向導，只需三步：

• 選設備類型（PC/PAD，影響UI密度和快捷鍵）
• 設定默認語言（中/英，影響所有Agent的輸出風格）
• 開關隱私選項（如是否允許會議紀要蝦訪問麥克風，默認關閉）

命令行配置（可選）：

yoyoclaws --configure --device=pc --lang=zh --mic=off

啟動Agent

Agent按需加載，不常駐內存：

# 啟動文檔理解蝦，處理PDF
yoyoclaws --start agent:document_understanding --file ~/report.pdf

# 啟動代碼輔助蝦（監聽當前目錄）
yoyoclaws --start agent:code_assistant --watch .

# 啟動會議紀要蝦（錄音+實時轉寫）
yoyoclaws --start agent:meeting_summary --record --mic=system

4. 實際怎么用

快速吃透一份PDF報告

yoyoclaws --start agent:document_understanding \
  --file "Q3財報.pdf" \
  --output summary.md \
  --focus "營收增長原因|風險提示"

輸出summary.md里只有兩節：用3句話說清增長邏輯，用表格列出3條具體風險及原文頁碼。

寫Python腳本時實時糾錯

在VS Code中裝好YOYO Claw插件，打開data_clean.py，光標停在pd.read_csv()后，按Ctrl+Shift+Y：

• 自動補全路徑（基于當前項目文件結構）
• 檢測到encoding='utf-8'但文件含中文亂碼，提示改用gbk
• 發現后續有df.dropna()但沒處理空列，建議加how='all'

開會時自動生成帶行動項的紀要

yoyoclaws --start agent:meeting_summary \
  --record \
  --endpoints "10:00-10:45,11:00-11:30" \
  --actionables

錄音分段處理，輸出Markdown含：

• 時間戳錨點（點擊跳轉錄音位置）
• 所有“請XX負責…”語句自動轉為待辦項，帶截止時間建議

5. 驗證是否正常

查看運行狀態

yoyoclaws --status
# 輸出示例：
# document_understanding: idle (last run: 2min ago)
# code_assistant: active (PID: 12489, GPU: 32%)
# meeting_summary: stopped

查日志定位問題

# 查最近100行錯誤日志
yoyoclaws --logs --level=error --tail=100

# 查某Agent完整日志
yoyoclaws --logs --agent=code_assistant

功能快速驗證

# 測試多模態摘要蝦（用一張截圖+一段文本）
yoyoclaws --start agent:multimodal_summary \
  --file ~/screenshot.png \
  --text "這個界面按鈕位置不合理，用戶反饋點擊率下降20%"

預期輸出：指出截圖中哪個按鈕區域最可能被誤觸，并關聯文本給出優化建議。

6. 常見問題

安裝失?。禾崾尽癎PU驅動不兼容”

→ 進入設備管理器，更新顯卡驅動到最新版（Intel需≥31.0.101.4888，AMD需≥23.Q3.1）
→ 或強制使用CPU后端：yoyoclaws --install --backend=cpu

Agent啟動后立即退出

→ 檢查yoyoclaws --logs --level=error，常見原因是模型文件損壞
→ 刪除~/.yoyoclaws/models/目錄，重啟Agent自動重下

文檔理解蝦卡在“解析中”

→ PDF含掃描圖片？該Agent不處理OCR，需先用系統自帶“照片”App轉文字
→ 文件超50MB？拆分后分別處理，或用--pages=1-10指定范圍

7. 接下來做什么

• 看源碼：AI Agent平臺 SDK已開源（https://github.com/ai-agent/sdk），所有Agent協議定義在/proto/agent.proto
• 改行為：修改~/.yoyoclaws/config.yaml里的prompt_template字段，調整文檔理解蝦的摘要風格
• 寫新Agent：用Python實現符合AgentInterface的類，放入~/.yoyoclaws/agents/，重啟即可調用

別被“AI”嚇住——YOYO Claw本質是個工具鏈。它不教你怎么思考，只幫你把重復動作自動化。先跑通一個Agent，再換下一個。