龍蝦新手指南：從零開始學(xué)AI

1. 什么是YOYO Claw？

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

它不依賴持續(xù)聯(lián)網(wǎng)，所有核心推理都在設(shè)備端完成；Agent設(shè)計(jì)面向真實(shí)工作流，不是玩具模型。

2. 為什么用YOYO Claw？

本地推理，不上傳數(shù)據(jù)

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

多端一致，非簡單移植

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

預(yù)置5個高頻Agent，開箱即用

每個Agent解決一個具體問題，接口統(tǒng)一，無需調(diào)參：

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

3. 安裝和配置

系統(tǒng)要求

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

下載安裝包

官網(wǎng)地址：https://yoyoclaws.ai
下載后校驗(yàn)SHA256（安裝包頁面底部提供）：

sha256sum YOYO_Claw_Installer.exe
# 應(yīng)與官網(wǎng)公示值一致

運(yùn)行安裝

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

初始配置

首次啟動彈出向?qū)В恍枞剑?/p>

• 選設(shè)備類型（PC/PAD，影響UI密度和快捷鍵）
• 設(shè)定默認(rèn)語言（中/英，影響所有Agent的輸出風(fēng)格）
• 開關(guān)隱私選項(xiàng)（如是否允許會議紀(jì)要蝦訪問麥克風(fēng)，默認(rèn)關(guān)閉）

命令行配置（可選）：

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

啟動Agent

Agent按需加載，不常駐內(nèi)存：

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

# 啟動代碼輔助蝦（監(jiān)聽當(dāng)前目錄）
yoyoclaws --start agent:code_assistant --watch .

# 啟動會議紀(jì)要蝦（錄音+實(shí)時(shí)轉(zhuǎn)寫）
yoyoclaws --start agent:meeting_summary --record --mic=system

4. 實(shí)際怎么用

快速吃透一份PDF報(bào)告

yoyoclaws --start agent:document_understanding \
  --file "Q3財(cái)報(bào).pdf" \
  --output summary.md \
  --focus "營收增長原因|風(fēng)險(xiǎn)提示"

輸出summary.md里只有兩節(jié)：用3句話說清增長邏輯，用表格列出3條具體風(fēng)險(xiǎn)及原文頁碼。

寫Python腳本時(shí)實(shí)時(shí)糾錯

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

• 自動補(bǔ)全路徑（基于當(dāng)前項(xiàng)目文件結(jié)構(gòu)）
• 檢測到encoding='utf-8'但文件含中文亂碼，提示改用gbk
• 發(fā)現(xiàn)后續(xù)有df.dropna()但沒處理空列，建議加how='all'

開會時(shí)自動生成帶行動項(xiàng)的紀(jì)要

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

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

• 時(shí)間戳錨點(diǎn)（點(diǎn)擊跳轉(zhuǎn)錄音位置）
• 所有“請XX負(fù)責(zé)…”語句自動轉(zhuǎn)為待辦項(xiàng)，帶截止時(shí)間建議

5. 驗(yàn)證是否正常

查看運(yùn)行狀態(tài)

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

功能快速驗(yàn)證

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

預(yù)期輸出：指出截圖中哪個按鈕區(qū)域最可能被誤觸，并關(guān)聯(lián)文本給出優(yōu)化建議。

6. 常見問題

安裝失敗：提示“GPU驅(qū)動不兼容”

→ 進(jìn)入設(shè)備管理器，更新顯卡驅(qū)動到最新版（Intel需≥31.0.101.4888，AMD需≥23.Q3.1）
→ 或強(qiáng)制使用CPU后端：yoyoclaws --install --backend=cpu

Agent啟動后立即退出

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

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

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

7. 接下來做什么

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

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