Project Golem v9.６

可長期陪跑的自主 AI 代理系統：Web Gemini、Ollama、LM Studio、多代理、技能、記憶與 Web Dashboard。

<img src="https://img.shields.io/badge/Version-9.6.14-blue?style=for-the-badge" alt="Version">
<img src="https://img.shields.io/badge/Node.js-20--22-green?style=for-the-badge&logo=nodedotjs" alt="Node.js">
<img src="https://img.shields.io/badge/Backend-Gemini%20Web%20%7C%20Ollama%20%7C%20LM%20Studio-orange?style=for-the-badge" alt="Backends">
<img src="https://img.shields.io/badge/Dashboard-Next.js%2016-black?style=for-the-badge&logo=nextdotjs" alt="Dashboard">
<img src="https://img.shields.io/badge/License-Source--Available%20NC-red?style=for-the-badge" alt="License">







<a href="#這是什麼">這是什麼</a> ·
<a href="#核心能力">核心能力</a> ·
<a href="#快速開始">快速開始</a> ·
<a href="#設定重點">設定重點</a> ·
<a href="#文件地圖">文件地圖</a>

繁體中文 | English | 貢獻指南

這是什麼

Project Golem 是一套以 Node.js 驅動的自主 AI 代理系統。它可以透過 Playwright 操控 Web Gemini，也可以切換到 Ollama 或 LM Studio 走本機/私有模型路線；前端則提供 Web Dashboard，用來管理對話、技能、人格、記憶、MCP 工具、多代理會議與系統設定。

這個專案目前比較像「個人 AI 作業系統」而不是單純 chatbot：它有長期記憶、任務隊列、指令安全防護、Telegram/Discord bridge、瀏覽器操作、排程自省、技能熱載入，以及一個能直接操作 Golem 的網頁控制台。

核心能力

介面預覽

快速開始

環境需求

• Node.js >=20 <23
• npm
• Chromium 或 Google Chrome
• 第一次使用 Web Gemini 時，需要可互動的瀏覽器畫面完成 Google 登入與授權
• Telegram/Discord token 為選填；只用 Web Dashboard 可以先不設定

一鍵模式

macOS / Linux 可直接使用啟動腳本：

chmod +x setup.sh
./setup.sh --magic
./setup.sh --start

也可以雙擊根目錄的 Start-Golem.command。Windows 使用者可用 Start-Golem.bat、setup.bat，或在 Git Bash 裡執行 ./setup.sh --magic。

手動模式

npm install
npx playwright install chromium
cp .env.example .env
npm run dashboard

啟動後開啟：

http://localhost:3000/dashboard

如果只想跑主 runtime，也可以使用：

npm start

設定重點

.env.example 已收錄主要設定。第一次啟動時若根目錄沒有 .env，系統會自動從 .env.example 複製一份。

Web Gemini 預設模式

GOLEM_BACKEND=gemini
GOLEM_MEMORY_MODE=lancedb-pro
PLAYWRIGHT_STEALTH_ENABLED=true
ALLOW_REMOTE_ACCESS=false

第一次登入請不要開 headless：

PLAYWRIGHT_HEADLESS=

等 Google session 寫入 golem_memory/ 後，再視需求改成背景模式：

PLAYWRIGHT_HEADLESS=true

Ollama 本機模型

GOLEM_BACKEND=ollama
GOLEM_OLLAMA_BASE_URL=http://127.0.0.1:11434
GOLEM_OLLAMA_BRAIN_MODEL=llama3.1:8b
GOLEM_EMBEDDING_PROVIDER=ollama
GOLEM_OLLAMA_EMBEDDING_MODEL=nomic-embed-text

LM Studio

GOLEM_BACKEND=lmstudio
GOLEM_LMSTUDIO_BASE_URL=http://127.0.0.1:1234/v1
GOLEM_LMSTUDIO_BRAIN_MODEL=local-model
GOLEM_LMSTUDIO_API_KEY=

Dashboard 與遠端存取

ENABLE_WEB_DASHBOARD=true
DASHBOARD_PORT=3000
ALLOW_REMOTE_ACCESS=false
REMOTE_ACCESS_PASSWORD=
SYSTEM_OP_TOKEN=

若把 ALLOW_REMOTE_ACCESS 設為 true，請務必設定強密碼，並搭配防火牆、VPN 或反向代理權限控管。

Telegram / Discord

TELEGRAM_TOKEN=
TG_AUTH_MODE=ADMIN
ADMIN_ID=
TG_CHAT_ID=

DISCORD_TOKEN=
DISCORD_ADMIN_ID=

Token 取得方式請看 如何獲取 TG 或 DC 的 Token 及開啟權限。

常用指令

npm scripts

對話指令

更多指令請看 Golem 指令說明一覽表。

遠端安裝採開放來源模式（技能限 github.com、MCP 限 https URL）；安裝風險由使用者自行承擔。

Docker / VPS

本專案提供 Docker Compose 與 noVNC/headless 相關設定。常用入口：

docker compose up -d --build

或使用 setup 腳本：

./setup.sh --deploy-docker
./setup.sh --deploy-linux
./setup.sh --headless-stop

詳細部署方式請看 Docker 本機部署指南 與 VPS Headless + VNC 指南。

專案結構

project-golem-plus/
├── apps/
│   ├── runtime/              # 實際核心啟動入口
│   └── dashboard/            # Dashboard app/plugin layer
├── src/
│   ├── core/                 # GolemBrain、ConversationManager、ActionQueue 等核心流程
│   ├── managers/             # 記憶、技能、設定、日誌、自主行動等管理器
│   ├── bridges/              # Telegram / Discord bridge
│   ├── services/             # Ollama、LM Studio、DOM Doctor、Optic Nerve 等服務
│   ├── mcp/                  # MCP client/manager
│   └── skills/               # 核心技能與技能文件
├── web-dashboard/            # Next.js Dashboard
├── packages/                 # memory / protocol / security facade
├── infra/                    # 架構治理與部署相關資料
├── docs/                     # 使用、部署、架構與開發文件
├── assets/                   # README 與 Dashboard 截圖素材
├── index.js                  # 相容入口，轉交 apps/runtime
└── dashboard.js              # 相容入口，啟動 Dashboard server

新開發請優先參考 apps/、src/、packages/ 的分層；提交前建議跑：

npm run arch:check
npm test

文件地圖

安全與隱私

• golem_memory/ 可能包含 Google session、對話記憶與私人資料，請不要提交或公開。
• .env 可能包含 token、密碼與操作金鑰，請只提交 .env.example。
• 不建議以 root/admin 身份長期運行 Golem。
• 開放遠端 Dashboard 前，請先設定 REMOTE_ACCESS_PASSWORD、SYSTEM_OP_TOKEN，並使用可信網路邊界。
• Golem 可執行本地指令與自動化流程，請謹慎啟用 GOLEM_AUTO_APPROVE_ALL。

授權

Project Golem 採用 Source-Available Non-Commercial License。

• 個人使用、學習、研究、評估與非商業社群貢獻：允許。
• 商業使用、公司/團隊生產環境、SaaS、代部署、顧問交付、商業整合、改版販售或盈利性服務：必須先取得 Arvincreator 的書面授權。
• 商業授權與合作請參考 COMMERCIAL-LICENSE.md。

注意：本專案過去已用 MIT 發佈的舊版本或舊副本，仍依取得當時的授權條款處理；本次授權變更後的新版本與新增內容適用目前的非商業授權。

社群與支持

如果 Project Golem 對你有幫助，歡迎 star 這個 repo，或請作者喝杯咖啡。

• Line 社群：Project Golem AI 系統代理群
• Discord 社群：Project Golem 官方頻道

Developed by Arvincreator and contributors.