打造超懂你的專屬 LINE 私人 AI 助理 🤖✨ (無腦複製貼上版)
這份完整操作手冊，將帶你一步步把強大的 Gemini AI 裝進 LINE 群組裡，讓它成為會認人、有記憶的專屬氣氛王！不管你有沒有程式基礎，只要跟著做，就能成功通電！
我們提供兩種架構選擇，請依照你的需求挑選其中一種跟著做即可：
- 路線 A：免費雲端版 (Cloudflare Workers) 不用花錢租主機，最適合新手！(但要注意每天的免費額度與綁定資料庫步驟)。
- 路線 B：私有主機版 (Cloudways / 自有網站環境) 如果你已經有自己的網站主機 (PHP 環境)，強烈推薦這招！最穩定、無限制、維護最簡單。
這版影片重錄囉! 祝你打造AI小幫手成功! 🚀
🌏 LINE Developers: ➡️ https://developers.line.biz/
🌏 LINE Official Account Manager :➡️ https://manager.line.biz
🌏 Google 模型 /API Key: ➡️ https://aistudio.google.com
🌏 Google Gemini 模型費率 : ➡️ https://ai.google.dev/gemini-api/docs...
🌏 Cloudflare: (免費server) ➡️ https://dash.cloudflare.com/sign-up
🔑 共用前置作業 (不管選哪條路都要做)
不管你選哪種架構，一開始我們都需要去跟 LINE 和 Google 申請「身分證」跟「大腦鑰匙」。
Step 1: 建立 LINE 機器人並取得金鑰 (LINE Developers)
- 進入 LINE Developers Console 並用你的 LINE 帳號登入。
- 點擊 Create a new provider (隨便取個名字，例如你的英文名)，然後選擇 Create a Messaging API channel。
- 填寫機器人基本資料 (名稱、Email、業種等) 並送出。
- 建立完成後，在 Basic settings 分頁往下拉，找到並複製這兩樣東西存進記事本：
- Channel secret (這是密碼之一)
- Your user ID (這是機器人本身的內部 ID，通常是 U 開頭的長字串) - 切換到 Messaging API 分頁，往下拉到底找到 Channel access token (long-lived)，點擊 Issue 產生一串很長字串，把它複製存進記事本。(這是最重要的通訊密碼)。
- ⚠️ 重要設定：開啟群組權限同樣在 Messaging API 分頁，找到 LINE Official Account Features 下方的設定，點選 Edit 進入官方帳號後台。左側選單點「設定」>「帳號設定」>「功能設定」。加入群組或多人聊天室：設為「接受」。自動回覆訊息：設為「停用」。(此時 Webhook 會顯示無法開啟，請先不管它)。
📍LINE Developers Console >你的Provider > Messaging API 下，也就是有 Webhook URL "verify 鍵" 的地方，
✅ 下方有個 "Use webhook"， 請確保它是有開啟的!
📍LINE Official Account Manager > 帳號 > 右上角"設定" > 左側 "帳號設定"選單，請確保 :
✅ 接受邀請加入群組或多人聊天室
📍LINE Official Account Manager > 帳號 > 右上角"設定" > 左側 "回應設定"選單，請確保 :
✅ "聊天" 功能有開啟
✅Webhook 功能有開啟 (等設完server後才會有網址可以填進去，如還未有可以等等再開啟但是得回來檢查! )
📍LINE Official Account Manager > 帳號 > 右上角"設定" > 左側 "Messaging API"選單，請確保 :
✅ Webhook網址 填入時，要手動加上前綴 "https:// " ，例如 "https://網址"
Step 2: 取得 AI 大腦金鑰 (Google AI Studio)
- 進入 Google AI Studio 並用 Google 帳號登入。
- 點擊左上角 Get API key > Create API key。
- 建立一個專案並產生 Key。把這串密碼複製存進剛剛的記事本。
現在你的記事本裡應該要有 4 串文字了：Channel secret, user ID, Channel access token, GEMINI API KEY。準備好就可以選擇下方的路線開始架設囉！
🏖️路線 A：免費雲端版 (Cloudflare Workers 架設流程)
這套架構完全免費，只要把我們準備好的「大腦程式碼」貼上去即可。
請特別注意 Step 3 的資料庫綁定，如果漏掉這步機器人會完全失憶當機喔！
✅Step 1: 註冊 Cloudflare 並部署程式碼
- 進入 Cloudflare 註冊並登入。
- 點擊左側欄的 Workers & Pages，然後點擊 Create application > Create Worker。
- 幫你的機器人專案取個名字 (不能有空格)，點擊 Deploy。
- 部署成功後，點擊 Edit code。
- 將左側編輯器裡預設的程式碼全部刪除，然後貼上我提供給你的 cloudflare-gemini template.md 裡面的所有程式碼。
- 點擊右上角的 Deploy 存檔。
✅Step 2: 填入你的專屬密碼 (環境變數設定)
程式碼貼好後，我們要告訴這台主機你的專屬密碼。
- 回到 Worker 的主畫面，點擊上方的 Settings 頁籤，再點選左邊欄的 Variables & Secrets。
- 在 Secret 區塊點擊 Add，依次新增以下三個變數 (名稱必須完全一致)：
- 變數名稱 LINE_CHANNEL_SECRET，值填寫記事本裡的 Channel secret。
- 變數名稱 LINE_ACCESS_TOKEN，值填寫記事本裡的 Channel access token。
- 變數名稱 GEMINI_API_KEY，值填寫記事本裡的 GEMINI API KEY。
- (強烈建議加裝) 如果你怕手機標記失敗，可以再新增一個變 LINE_BOT_USER_ID，值填寫記事本裡的 user ID。
✅Step 3: 建立「記憶抽屜」 (KV 綁定) 🚨 極度重要！
有了大腦，我們還需要給它一個抽屜存放記憶，它才會知道群組裡誰是誰，並且記住上下文。這步沒做，機器人會死當！
- 回到 Cloudflare 左側主選單，點擊 Workers & Pages > KV。
- 點擊 Create a namespace，取一個名字，例如 JELENA_KV (這裡的名稱可自取)，點擊 Add 建立。
- 再次回到你剛剛建好的 Worker 主畫面，點擊 Settings 頁籤 > 左側欄選 Bindings。
- 在 KV Namespace Bindings 區塊點擊 Add 新增綁定：Variable name：這裡絕對必須填寫 MY_BINDING_2 (不可打錯字，程式碼是認這個名字去開抽屜的)。
(📍注意: 「Variable name」 (變數名稱) 這裡，必須 填 "MY_BINDING_2" 。如果你堅持要打其它的名稱，程式碼裡也必須同步改成一樣的。 )
KV namespace：選擇你剛剛建立的 JELENA_KV (你剛才在第2點時自取的名稱)。點擊 Deploy 儲存。
🖐注意！workers and pages 頁面 > 你建好的機器人專案>. 程式碼裡第一段，
const BOT_NAME = "你的機器人名稱" (你在LINE裡設定的名稱);
--->如果你沒在程式碼裡改這行，之後就無法成功呼叫它。 程式碼這種東西必須一字不差（包含空格、符號、表情）。
✅Step 4: 把機器人接通 LINE (Webhook)
- 在 Worker 主畫面複製它分配給你的專屬網址，例如：https://my-line-bot.xxxx.workers.dev。
- 回到 LINE Developers Console 的 Messaging API 分頁。
- 找到 Webhook URL，點擊 Edit，貼上你的專屬網址，然後點 Update。
- 開啟下方的 Use webhook 開關，點擊 Verify。如果彈出 Success，恭喜你成功了！
- 最後，回到 LINE 官方帳號管理平台 (剛剛設定自動回覆的地方)，把 Webhook 開關改成「啟用」。
🎉 大功告成！現在你可以去 LINE 裡把機器人加入群組測試囉！
🏘️路線 B：私有主機版 (Cloudways / 自有網站環境)
如果你有自己的網站伺服器 (如 WordPress 主機)，這招最簡單、也最不會遇到平台免費限制。我們用「上傳檔案」的方式一秒解決！
✅Step 1: 下載並設定範本檔案
1. 開啟我為 Patreon 會員準備的兩個檔案：`index.php` 和 `.htaccess`。
2. 用任何文字編輯器 (記事本 / VS Code / Sublime 皆可) 打開 `index.php`。
3. 在上方找到 *⚙️ VIP 門禁與大腦設定區*，把你剛剛記事本裡的密碼對應貼進去：
* `$BOT_NAME` = "你的機器人名字";
* `$ACCESS_TOKEN` = '記事本裡的 Channel access token';
* `$CHANNEL_SECRET` = '記事本裡的 Channel secret';
* `$API_KEY` = '記事本裡的 GEMINI API KEY';
4. 往下設定你要讓它 @Tag 的家人白名單。
5. 存檔關閉。`.htaccess` 檔完全不用動。
✅Step 2: 上傳檔案到伺服器
- 打開你的 SFTP 軟體 (如 FileZilla)，連上你的 Cloudways 或網站主機。
- 進入對外公開的根目錄 (在 Cloudways 通常是 public_html，其他主機可能叫 htdocs 或 www)。
- 在裡面按右鍵，建立一個新資料夾。為了安全起見，請取一個別人猜不到的名字，例如 mybot_a8x9。
- 將剛剛的 index.php 和 .htaccess 這對雙胞胎，直接拖曳上傳到這個資料夾裡面。
✅Step 3: 把機器人接通 LINE (Webhook)
- 你的機器人專屬網址已經誕生了！格式會是：https://你的網站網域/剛剛建的包含亂碼的資料夾名稱/index.php (例如：https://test.com/mybot_a8x9/index.php)。
- 回到 LINE Developers Console 的 Messaging API 分頁。
- 找到 Webhook URL，點擊 Edit，貼上這串專屬網址，然後點 Update。
- 開啟下方的 Use webhook 開關，點擊 Verify。
- 如果彈出 Success，恭喜你接通了！
- 最後，回到 LINE 官方帳號管理平台 (剛剛設定自動回覆的地方)，把 Webhook 開關改成「啟用」。
🎉 大功告成！不用設定任何環境變數，你的機器人已經活在你的專屬主機裡囉！快對他說句 "aii hi" 試試看吧！
🔔 特別注意: 使用免費google gemini額度時，雖然 "官方" 有在各個不同模型上給一定額度，但根據經驗，用 gemini 3 flash 有好幾次都會因為高峰期被"斷話"，
在程式碼那裡換回 gemini-2.5-flash-lite 又會"復話"，免費的基本上沒什麼 "話語權"，全靠Google隨時視情況給予限流!
🚨注意
▶️1.如果是群組，你必須主動呼叫它。文字包含 "aii" 或是 或訊息裡有 @你的BOT_NAME（真的要對得上）或手機端「@提到機器人」的 mention 物件能被正確辨識（LINE 的botUser ID 要對） 試著輸入 「aii 查詢ID」 。
如果這樣會回，就代表 webhook/kv/權限都 OK，只是你呼叫它必須 @ 或打aii
更新版的檔案有1對1你跟bot的對話時，就不用刻意@它或輸入aii，它就能自動回話。
▶️2. const BOT_NAME = "你的機器人名稱" (你在LINE裡設定的名稱); --->如果你沒在程式碼裡改也無法成功呼叫它。 程式碼這種東西必須一字不差（包含空格、符號、表情）。
▶️3. 4個金鑰重新刪除再貼一次確保正確。
▶️4. gemini免費模型先不要調用gemini 3 flash, 先用gemini-2.5-flash-lite，免費容易被限流
▶️5. 真的不行，最好全部再照著文件+影片+本文所有細節重新逐一檢查!
📁免費版 (免費Server+免費Google Gemini AI model-額度有限，功能有限，仍可試用)
見底部附件 ⬇️ "cloudflare-gemini template.md" https://www.patreon.com/posts/line-si-qun-ai-2-153167028
🔔更新: 3/7 - 優化，同一則訊息不重複 @tag用戶，logic 變更。 更新: 3/5 - 改善，讓AI bot 更清楚識別出群組內誰說了什麼。 更新: 3/1 - 變更成1對1不用tag機器人就能回話；但在群組裡時必須 @AI 它才會反應。
📍版主保有變更或刪儲檔案的權利
🔔如要看自有網域版，請看👉這篇
🐱🚀版主的話:
請心平氣和地設定 (設定程式有時很繁鎖)，如果真的環境不適合，或真的找不出接不通的原因，那就先放輕鬆，轉移注意力在更值得的人事物上吧 ☺️!
下次有好用好玩的AI工具，我們再一起來嘗試!
