【把Gemini AI拉進LINE私人群組當專屬特助🤖✨】免寫程式，還會自己 @Tag 標記人，打造超會聊的 LINE AI 私人 & 親友群 bot

21

本文將教你如何將 Google Gemini 拉進你的 LINE 私人群組裡，讓你擁有自己的 LINE AI 小幫手!

你有沒有想過要在 LINE 群組裡放一個「會給情緒價值，認識群組裡每個人」的小夥伴？

當群組有時氣氛忽然安靜時，如果有一個會炒熱場子的「群組專屬氣氛王」，

比如有人問晚餐吃什麼，它可以直接丟出三個選項還會吐槽你；

又或是，這就像全家在 LINE 群組裡養一隻「電子雞」，只不過它是AI 版的特助，那是什麼感覺?

最後，它還會 @ tag 所有家人對話，那種”專屬感” 可立馬瞬間拉高!

(詳見影片)

建立KV忘了在影片展示，請見下方說明。(Step 3: 建立「記憶抽屜」 (KV 綁定) 🚨 極度重要！)

🌏 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 私人 AI 助理 🤖✨ (無腦複製貼上版)

這份完整操作手冊，將帶你一步步把強大的 Gemini AI 裝進 LINE 群組裡，讓它成為會認人、有記憶的專屬氣氛王！不管你有沒有程式基礎，只要跟著做，就能成功通電！

我們提供兩種架構選擇，請依照你的需求挑選其中一種跟著做即可：

• 路線 A：免費雲端版 (Cloudflare Workers) 不用花錢租主機，最適合新手！(但要注意每天的免費額度與綁定資料庫步驟)。
  
  
• 路線 B：私有主機版 (Cloudways / 自有網站環境) 如果你已經有自己的網站主機 (PHP 環境)，強烈推薦這招！最穩定、無限制、維護最簡單。

🔑 共用前置作業 (不管選哪條路都要做)

不管你選哪種架構，一開始我們都需要去跟 LINE 和 Google 申請「身分證」跟「大腦鑰匙」。

Step 1: 建立 LINE 機器人並取得金鑰 (LINE Developers)

1. 進入 LINE Developers Console 並用你的 LINE 帳號登入。
   
2. 點擊 Create a new provider (隨便取個名字，例如你的英文名)，然後選擇 Create a Messaging API channel。
   
3. 填寫機器人基本資料 (名稱、Email、業種等) 並送出。
   
4. 建立完成後，在 Basic settings 分頁往下拉，找到並複製這兩樣東西存進記事本：
   • Channel secret (這是密碼之一)
   • Your user ID (這是機器人本身的內部 ID，通常是 U 開頭的長字串)
     
     
5. 切換到 Messaging API 分頁，往下拉到底找到 Channel access token (long-lived)，點擊 Issue 產生一串很長字串，把它複製存進記事本。(這是最重要的通訊密碼)。
   
   
6. ⚠️ 重要設定：開啟群組權限
   
   • 同樣在 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)

1. 進入 Google AI Studio 並用 Google 帳號登入。
   
2. 點擊左上角 Get API key > Create API key。
   
3. 建立一個專案並產生 Key。把這串密碼複製存進剛剛的記事本。

現在你的記事本裡應該要有 4 串文字了：Channel secret, user ID, Channel access token, GEMINI API KEY。準備好就可以選擇下方的路線開始架設囉！

🏖️路線 A：免費雲端版 (Cloudflare Workers 架設流程)

這套架構完全免費，只要把我們準備好的「大腦程式碼」貼上去即可。請特別注意 Step 3 的資料庫綁定，如果漏掉這步機器人會完全失憶當機喔！

✅Step 1: 註冊 Cloudflare 並部署程式碼

1. 進入 Cloudflare 註冊並登入。
   
2. 點擊左側欄的 Workers & Pages，然後點擊 Create application > Create Worker。
   
3. 幫你的機器人專案取個名字 (不能有空格)，點擊 Deploy。
   
4. 部署成功後，點擊 Edit code。將左側編輯器裡預設的程式碼全部刪除，然後貼上我提供給你的 cloudflare-gemini template.md 裡面的所有程式碼。
   
5. 點擊右上角的 Deploy 存檔。

✅Step 2: 填入你的專屬密碼 (環境變數設定)

程式碼貼好後，我們要告訴這台主機你的專屬密碼。

1. 回到 Worker 的主畫面，點擊上方的 Settings 頁籤，再點選左邊欄的 Variables & Secrets。
   
2. 在 Secret 區塊點擊 Add，依次新增以下三個變數 (名稱必須完全一致)：
   
   • 變數名稱 LINE_CHANNEL_SECRET，值填寫記事本裡的 Channel secret。
   • 變數名稱 LINE_ACCESS_TOKEN，值填寫記事本裡的 Channel access token。
   • 變數名稱 GEMINI_API_KEY，值填寫記事本裡的 GEMINI API KEY。
     
3. (強烈建議加裝) 如果你怕手機標記失敗，可以再新增一個變數 LINE_BOT_USER_ID，值填寫記事本裡的 user ID。

✅Step 3: 建立「記憶抽屜」 (KV 綁定) 🚨 極度重要！

有了大腦，我們還需要給它一個抽屜存放記憶，它才會知道群組裡誰是誰，並且記住上下文。這步沒做，機器人會死當！(👇見下方影片)

1. 回到 Cloudflare 左側主選單，點擊 Workers & Pages > KV。
   
2. 點擊 Create a namespace，取一個名字，例如 JELENA_KV (這裡的名稱可自取)，點擊 Add 建立。
   
3. 再次回到你剛剛建好的 Worker 主畫面，點擊 Settings 頁籤 > 左側欄選 Bindings。
   
4. 在 KV Namespace Bindings 區塊點擊 Add 新增綁定：
   
   • Variable name：這裡絕對必須填寫 MY_BINDING_2 (不可打錯字，程式碼是認這個名字去開抽屜的)。
     
     (📍注意: 「Variable name」 (變數名稱) 這裡，必須 填 “MY_BINDING_2” ，請看以下補充影片。如果你堅持要打其它的名稱，程式碼裡也必須同步改成一樣的。 )
     
   • KV namespace：選擇你剛剛建立的 JELENA_KV (你剛才在第2點時自取的名稱)。
     
     
5. 點擊 Deploy 儲存。

(補充影片，請前往👉 Patreon會員)

🖐注意！workers and pages 頁面 > 你建好的機器人專案>. 程式碼裡第一段，

const BOT_NAME = “你的機器人名稱” (你在LINE裡設定的名稱);

—>如果你沒在程式碼裡改這行，之後就無法成功呼叫它。 程式碼這種東西必須一字不差（包含空格、符號、表情）。

✅Step 4: 把機器人接通 LINE (Webhook)

1. 在 Worker 主畫面複製它分配給你的專屬網址，例如：https://my-line-bot.xxxx.workers.dev。
   
2. 回到 LINE Developers Console 的 Messaging API 分頁。
   
3. 找到 Webhook URL，點擊 Edit，貼上你的專屬網址，然後點 Update。
   
4. 開啟下方的 Use webhook 開關，點擊 Verify。如果彈出 Success，恭喜你成功了！
   
5. 最後，回到 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: 上傳檔案到伺服器

1. 打開你的 SFTP 軟體 (如 FileZilla)，連上你的 Cloudways 或網站主機。
   
2. 進入對外公開的根目錄 (在 Cloudways 通常是 public_html，其他主機可能叫 htdocs 或 www)。
   
3. 在裡面按右鍵，建立一個新資料夾。為了安全起見，請取一個別人猜不到的名字，例如 mybot_a8x9。
   
4. 將剛剛的 index.php 和 .htaccess 這對雙胞胎，直接拖曳上傳到這個資料夾裡面。

✅Step 3: 把機器人接通 LINE (Webhook)

1. 你的機器人專屬網址已經誕生了！格式會是：https://你的網站網域/剛剛建的包含亂碼的資料夾名稱/index.php (例如：https://test.com/mybot_a8x9/index.php)。
   
2. 回到 LINE Developers Console 的 Messaging API 分頁。
   
3. 找到 Webhook URL，點擊 Edit，貼上這串專屬網址，然後點 Update。
   
4. 開啟下方的 Use webhook 開關，點擊 Verify。如果彈出 Success，恭喜你接通了！
   
5. 最後，回到 LINE 官方帳號管理平台 (剛剛設定自動回覆的地方)，把 Webhook 開關改成「啟用」。

🎉 大功告成！不用設定任何環境變數，你的機器人已經活在你的專屬主機裡囉！快對他說句 “aii hi” 試試看吧！

🔔 特別注意:
使用免費google gemini額度時，雖然 “官方” 有在各個不同模型上給一定額度，但根據經驗，用 gemini 3 flash 有好幾次都會因為高峰期被”斷話”，
在程式碼那裡換回 gemini-2.5-flash-lite 又會”復話”，
免費的基本上沒什麼 “話語權”，全靠Google隨時視情況給予限流!

🚨注意

▶️1.如果是群組，你必須主動呼叫它。文字包含 “aii” 或是

或訊息裡有 @你的BOT_NAME（真的要對得上）

或手機端「@提到機器人」的 mention 物件能被正確辨識（LINE 的botUser ID 要對） 影片 5:50

試著輸入 「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-額度有限，功能有限，仍可試用

請前往👉 Patreon會員

🔔更新: 3/1 – 變更成1對1不用tag機器人就能回話；但在群組裡時必須 @AI 它才會反應。

📍版主保有變更或刪儲檔案的權利

📂程式碼模板 — 私有網域 Server

請前往👉 Patreon會員

🔔更新: 3/2 – 變更成1對1不用tag機器人就能回話；但在群組裡時必須 @AI 它才會反應 +
把自動記憶檔改為php 避免純文字檔被讀取

📍版主保有變更或刪儲檔案的權利