U-Claw 小龍蝦便携版
隨身攜帶的 AI 助手 · 使用說明書
版本 v2.3.4
一、快速開始（3 步）
拿到隨身碟後，只要三步就能用：
圖 1 · 快速開始三步流程
第一次使用需要「設定模型」（填入 API Key 或使用蝦盤云錢包），之後每次開啟會自動記住，不用重複設定。
二、啟動小龍蝦
2.1 開啟程式
- 插入隨身碟，打開「本機」找到磁碟（例如
F:）。
- 雙擊
Windows-Start.bat 啟動。
圖 2 · 啟動流程示意
重要：啟動時會跳出一個黑色命令視窗（如下圖），這是程式本體，使用期間絕對不能關閉。關掉它，小龍蝦就會停止運作。
2.2 首次連線：輸入密碼
網頁第一次打開時，可能跳出「此 Gateway 需要其權杖」的畫面。請在「Gateway 密碼」欄輸入：
uclaw
然後按「連線」即可進入主畫面。
圖 3 · 首次連線輸入密碼 uclaw
三、設定你的模型
第一次使用要選一個 AI 模型。你有三種方式：
- 用蝦盤云錢包（官方雲端，可直接充值，不用自己申請 Key）；或
- 用你自己的 API Key（DeepSeek、豆包、Kimi、OpenAI 等 11 家）；或
- 自訂模型（OpenAI 兼容格式，填任意地址）。
3.0 開啟設定畫面（Config.html）
所有的模型設定，都在「U-Claw 配置中心」完成。開啟方式二選一：
- 在隨身碟根目錄找到
Config.html，雙擊開啟；或
- 在主畫面找「設定」／「模型」入口進入。
開啟後會看到「選模型 → 填 Key → 一鍵啟動」三步畫面（下圖）。
3.1 自行設定模型要點（用自己的 Key）
如果你要用自己的模型／自己的 API Key，掌握這幾個要點即可：
- 選卡片：點選想用的模型卡片（豆包、DeepSeek、Kimi…），或點「自訂 · OpenAI 兼容」填任意模型。
- 填 Key：到對應官網註冊並取得 API Key，貼入「填 Key」欄位。
- 一鍵啟動：按「一鍵啟動」保存套用，稍等片刻即可對話。
| 要點 | 說明 |
|---|
| 地址（baseUrl） | 要填「完整 API 網址」，例如 https://api.deepseek.com/v1 |
| 模型名稱 | 要填「正確的模型 id」，例如 gemini-2.5-flash |
| API Key | 必須有效且有餘額，否則對話會失敗 |
| 保存生效 | 按「一鍵啟動」保存後，請等待約 20～30 秒 讓設定生效，勿急著關閉 |
設定模型按「一鍵啟動」保存後，請等待約 20～30 秒 讓設定生效，之後再開始對話。
圖 4 · 設定模型三步
3.2 用蝦盤云錢包（最簡單）
選擇「蝦盤云 · 設備錢包」卡片，點「一鍵領取」即可獲得一個專屬金鑰（就是你的錢包，請截圖備份）。之後到 cloud.u-claw.org 充值即可使用。
你的金鑰就是你的錢包，請務必複製備份——重裝或換電腦要靠它找回餘額。
3.3 用自己的 API Key
選擇想用的模型卡片（例如「豆包」「DeepSeek」「Kimi」），到對應官網註冊並取得 API Key，貼進「填 Key」欄位，按「一鍵啟動」。
3.4 自訂模型（OpenAI 兼容）
若要使用說明書未列出的模型，選「自訂 · OpenAI 兼容」，填三個欄位：
| 欄位 | 填什麼 |
|---|
| 地址（baseUrl） | 模型的 API 網址，例如 https://api.example.com/v1 |
| 模型名稱 | 例如 gpt-4o、gemini-2.5-flash |
| API Key | 你的金鑰 |
四、開始對話
設定完成後，網頁會進入主畫面。在下方的對話框輸入文字，按送出，小龍蝦就會回覆你。
圖 5 · 對話介面示意
五、常見問題（FAQ）
Q1：啟動很慢、畫面一直轉圈？
首次啟動需要載入元件，通常 30～200 秒。若超過 5 分鐘仍卡住，關掉黑色視窗再重新啟動一次（第二次會明顯變快）。
Q2：關掉黑色視窗會怎樣？
小龍蝦會停止運作。要使用時再雙擊 Windows-Start.bat 重新啟動即可。
Q3：換一台電腦要重新設定嗎？
模型設定、對話紀錄都存在隨身碟裡，換電腦不用重設。但瀏覽器登入狀態與部分快取存於本機，換電腦後可能需要重新登入網站。
六、注意事項
- 使用期間請勿拔出隨身碟，否則程式會中斷。
- 黑色啟動視窗請勿關閉。
- API Key 與錢包金鑰請自行妥善保管，勿外流。
- 模型 API 需要可用的 Key、餘額與網路連線。
- 建議在安全的網路環境使用，避免在公用電腦登入重要帳號。