by Arvincreator
OS-level autonomous AI agent with long-term memory, multi-agent coordination, Titan Chronos scheduler & Moltbot Social Core
# Add to your Claude Code skills
git clone https://github.com/Arvincreator/project-golemProject Golem 不是一個普通的聊天機器人。它是一個可選擇 Web Gemini(Browser-in-the-Loop) 或 Ollama(本地/私有部署) 作為大腦的自主 AI 代理系統。
雙後端架構:預設可使用 Browser-in-the-Loop 直接操控 Web Gemini;也可切換到 Ollama API 走本地模型與私有部署路線。
No comments yet. Be the first to share your thoughts!
為了幫助您更好地監控與管理您的 Golem,我們提供了功能完善的 Web Dashboard。
總覽您的高階 AI 代理人狀態、活躍進程與動態行為決策。
除了 Telegram / Discord 外,您也可以直接在網頁端與 Golem 進行無延遲的交談,並即時追蹤任務狀態。
如同插拔隨身碟般,隨時為您的 Golem 安裝、開啟或關閉各種特殊職能與無縫 API 對接。
設定 Golem 的基本屬性與行為模式。
查看 Golem 的記憶核心。
直觀管理安全權限、API Keys 與深度系統整合,免去手動修改設定檔的麻煩。
我們為初次使用者準備了無腦全自動裝機腳本。
雙擊專案目錄下的 Start-Golem.command (Mac/Linux),即會自動下載依賴並啟動 Node 伺服器與 Dashboard。
🔨 CLI 手動模式 (Terminal)
# 賦予執行權限
chmod +x setup.sh
# 一鍵自動安裝依賴與解決 Port 衝突
./setup.sh --magic
# 直接啟動
./setup.sh --start
🖥️ VPS / 無桌面環境(Headless + noVNC)
# Docker 一鍵安裝部署(含 noVNC)
./setup.sh --deploy-docker
# Linux 本機一鍵安裝部署(含 noVNC)
./setup.sh --deploy-linux
# 停止 headless 服務
./setup.sh --headless-stop
🔐 建議設定(純 Playwright + 安全)
GOLEM_MEMORY_MODE=lancedb-pro
GOLEM_BACKEND=gemini
GOLEM_EMBEDDING_PROVIDER=local
PLAYWRIGHT_STEALTH_ENABLED=true
ALLOW_REMOTE_ACCESS=false
# 若需要遠端管理,務必設定:
# REMOTE_ACCESS_PASSWORD=your-strong-password
# SYSTEM_OP_TOKEN=your-operation-token
🦙 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
# 選填:GOLEM_OLLAMA_RERANK_MODEL=bge-reranker-v2-m3
🏗️ 架構治理檢查
npm run arch:check
建議: 為了獲得最佳的 Linux 環境模擬體驗,強烈建議 Windows 用戶使用 Git Bash 來執行腳本。
./setup.sh --magic 進行自動化安裝與啟動。| 指令 | 功能 |
|------|------|
| /help | 查看完整指令說明 |
| /new | 重置對話並載入相關記憶 |
| /learn <功能> | 讓 AI 自動學習並生成新技能 |
| /skills | 列出所有已安裝的技能 |
Golem 採用 Browser-in-the-Loop 混合架構,賦予其超越標準 API 限制的靈活性。
graph TD
User["👤 用戶"] -->|"平台抽象層"| UniversalContext
UniversalContext -->|"防抖隊列"| ConversationManager
ConversationManager -->|"LLM 核心"| GolemBrain
GolemBrain -->|"解析協定"| NeuroShunter
subgraph Reflex ["神經分流 Reflex"]
NeuroShunter -->|"REPLY"| User
NeuroShunter -->|"MEMORY"| LongTermMemory["🧠 金字塔記憶"]
NeuroShunter -->|"ACTION"| SkillManager["🛠️ 技能膠囊"]
end
brain + embedding,並可選填 rerank 模型做記憶召回重排。GOLEM_PROTOCOL 指令而非純文字。這讓代理人能精準決定何時該說話、何時該記憶、以及何時該執行技能腳本。為了支援多人協作與長期演進,專案已改為「產品級分層」:
project-golem/
├── apps/
│ ├── runtime/ # 核心啟動入口(實際執行)
│ └── dashboard/ # Dashboard 插件層
├── src/ # 核心領域邏輯(Brain / Memory / Skills / Managers)
├── web-dashboard/ # Web UI 與 API 路由
├── packages/ # 共用套件(已落地 security/memory/protocol facade)
├── infra/ # 預留:部署、監控、環境治理
├── index.js # 相容入口(shim,轉發到 apps/runtime)
└── dashboard.js # 相容入口(shim,轉發到 apps/dashboard)
此次重構採「相容優先」策略:既有指令與腳本可持續使用,同時逐步遷移到大型產品結構。
這是 Golem 最獨特的技術能力,透過多層級壓縮確保記憶永不丟失:
50 年存儲對比:
Dashboard 的「繼絆日記」已支援自動分層整理:
日記資料已採用 SQLite (WAL) 儲存(每個 Golem 一個 DB),首次啟動會自動從舊版 diary-book.json 遷移。
可透過 .env 調整策略:
DIARY_RAW_RETENTION_DAYS=7
DIARY_WEEKLY_RETENTION_DAYS=365
DIARY_MONTHLY_RETENTION_DAYS=1825
DIARY_ROTATE_MIN_INTERVAL_MS=300000
DIARY_BACKUP_MAX_FILES=120
DIARY_BACKUP_RETENTION_DAYS=180
也可透過 API 手動觸發:
POST /api/diary/rotateGET /api/diary/rotation/historyGET /api/diary/backup/download?file=...POST /api/diary/backupPOST /api/diary/backup/cleanupGET /api/diary/restore/preview?file=...POST /api/diary/restore為了保持本頁面的簡潔,更深入的技術細節已移至專屬文檔:
| 文件 | 說明 |
|------|------|
| 🤖 編碼代理指南 | [重要] 供 AI 助理或開發者參考的程式碼維護與架構規範 |
| 🗂️ 大型產品架構藍圖 | apps + packages + infra 分層策略與遷移路線圖 |
| 🏗️ 架構治理規範 | 分層邊界規則與 arch:check 自動檢查 |
| 🔌 MCP 使用與開發指南 | [最新] 如何安裝、配置與調用 MCP Server (含 Hacker News 範例) |
| 🧠 記憶系統架構說明 | 金字塔壓縮原理與存放路徑解析 |
| 🖥️ VPS Headless + VNC 指南 | 無桌面 Linux / Docker 的 noVNC 一鍵部署 |
| 🖥️ Web Dashboard 使用說明 | Web UI 各個分頁的延伸細節 |
| 🛠️ 開發者實作指南 | 如何實作新的 Skill 與 Golem Protocol 格式規範 |
| 🎮 完整指令說明一覽表 | Telegram / Discord 指令速查 |
| 🔑 取得機器人 Token 教學 | 如何設定你的外部通訊平台 |
如果 Golem 對你有幫助,歡迎賞顆星星 ⭐️,或請作者喝杯咖啡!
golem_memory/ 資料夾中包含您的 Google 登入 Cookie 會話,請務必妥善保管勿外洩。Developed with ❤️ by Arvincreator & @sz9751210