Buzz 自架教學：使用 Docker 架設 Relay 與設定 AI Agent 自動回覆
Buzz 自架教學：使用 Docker 架設 Relay 與設定 AI Agent 自動回覆
寫在文章之前，關於本文配圖 這篇文章的配圖，選擇了熊本城，是因為這周發生了熊本大地震，而 August 在今年的五月才去那裡旅遊過。 記得在逛熊本城的時候，裡面有個影片，是在講十年前的熊本大地震發生後，這幾年一路是怎麼走過來，一路又修復成目前的樣子。 雖然，這次又發生了地震，但相信熊本可以再站起來的。 本篇要解決的問題 最近一直在找一個可以把 AI Agent 一起加入到群組聊天的通訊軟體。 大部份都要錢，比如 Slack、Google Chat、Teams。 剛好不知怎麼回事，最近也常常看到講 AI 的電子報提到一個 Buzz，似乎可以解決這需求。 Buzz，是一套可自架的團隊協作工具。除了頻道聊天，也能加入 Codex、Claude Code 等 AI Agent，讓團隊成員直接在頻道中透過 tag Agent 來呼叫 AI。 雖說官方提供了 Self Hosting 的安裝說明，但實際上還是踩了幾個坑才順利的讓 Agent 回覆訊息。 本篇就是筆記實作安裝 Buzz 時的筆記，也把怎麼跳過這些坑的方式紀錄下來，讓看到這篇的你可以從從容容、遊刃有餘的閃過。 完成本文後，可以做到： 在 Mac 上透過 Docker Compose 自架 Buzz Relay。 使用 Buzz Desktop 連接自己的 Relay。 建立 Buzz Community 與頻道。 啟動內建的三個 Agent。 使用 Codex 作為 Fizz 的 AI 執行環境。（也可以用 Claude） 在頻道中透過 @Fizz 讓 Agent 回覆訊息。 安裝 Buzz Relay 1. 安裝必要工具 需要先安裝好以下： Git Docker Desktop Docker Compose 2.24.4 以上 確認 Docker Desktop 已經啟動後，再繼續安裝。 2. 下載 Buzz 原始碼 Clone 官方 GitHub 上的專案： https://github.com/block/buzz 接著進到「deploy/compose」資料夾中，本篇會用 Docker 的方式安裝。 3. 建立 .env deploy/compose 的資料夾裡有一個「.env.example」，這份檔另存為「.env」。 接著，把 .env 裡「buzz.example.com」、「CHANGE_ME…」的部份全都修改，變成我們要的內容。 另外要注意，目前官方的版本有個 bug，主要是Buzz Relay 容器會顯示 unhealthy ，造成後續安裝不起來，目前解決的方式就是： # 原本 BUZZ_GIT_CONFORMANCE_PROBE = true # 改成 BUZZ_GIT_CONFORMANCE_PROBE = false 需要 KEY 的部份，可以使用以下指令產生隨機密鑰： openssl rand -hex 32 產生一般密碼： openssl rand -base64 24 不同用途的密鑰應分開產生，不要全部使用同一組。 如果覺得一行行修改很麻煩，這一步 ChatGPT 有給了一組指令，直接專案內開啟終端機執行以下也行： cat > .env << EOF BUZZ_IMAGE=ghcr.io/block/buzz:main
BUZZ_DOMAIN=127.0.0.1
RELAY_URL=ws://127.0.0.1:3300