安裝與快速開始

這一頁帶你從零開始：準備 AI 大腦、安裝 DuDuClaw、打開管理後台建立第一位 AI 員工，最後接上通訊軟體。內容整理自 DuDuClaw README。

1. 準備一個 AI 大腦

DuDuClaw 本身不附帶 AI 模型，負責的是通道、記憶、任務與帳本這些管線。以下三種擇一即可，之後也能在瀏覽器的設定精靈裡設定：

• 一套 AI 指令列工具加上 API 金鑰：例如 Claude Code、Codex、Antigravity 或 Grok，完整清單見多 runtime 執行。Anthropic 與 Google 不允許第三方產品使用一般個人帳號的登入權杖，已經有帳號因此被停權，請改用 API 金鑰。
• 任何 OpenAI 相容服務的 API 金鑰。
• 本機模型：放在 OpenAI 相容的伺服器後面（llama-server、Ollama、vLLM、llamafile），不需要雲端帳號。

Gemini CLI 已經棄用，新的設定請改用 Antigravity，時程見棄用與移除。

2. 安裝

桌面版（個人使用建議）

桌面版打開就會自動啟動本機 gateway，不必碰終端機，資料與指令列版本共用 ~/.duduclaw。到 GitHub Releases 找最新的 desktop-v… 版本下載：

平台	檔案	備註
macOS（Apple Silicon／Intel）	DuDuClaw_*.dmg	已簽章並經 Apple 公證
Windows x64	DuDuClaw_*_x64_en-US.msi	還沒有 Authenticode 憑證，SmartScreen 會跳一次「未知發行者」警告，點「其他資訊」→「仍要執行」即可安裝
Linux	*_amd64.AppImage／.deb	不需要簽章

npm（伺服器或習慣指令列）

只需要 Node.js 20 以上：

npm install -g duduclaw

npm 會裝上對應平台預先編好的執行檔（macOS ARM64／x64、Linux x64／ARM64、Windows x64），不需要編譯器或 Rust。如果安裝過程要你裝 Rust 或 MSVC Build Tools，代表走到了給貢獻者的原始碼建置路徑，請改用上面這行。

從原始碼建置

需要 Rust 1.85 以上與 Node.js 20 以上：

git clone https://github.com/zhixuli0406/DuDuClaw.git
cd DuDuClaw
cd web && npm ci --legacy-peer-deps && npm run build && cd ..
cargo build --release -p duduclaw-cli -p duduclaw-gateway --features duduclaw-gateway/dashboard
./target/release/duduclaw run

3. 啟動並建立第一位 AI 員工

桌面版直接打開即可。npm 或原始碼安裝的話：

duduclaw run    # 一次啟動 gateway、通道、排程與派工

接著用瀏覽器打開 http://localhost:18789。第一次進來會看到設定精靈：選 AI 後端、建立第一位 AI 員工，然後在內建的 WebChat 直接跟它對話，不必先在終端機跑 duduclaw onboard。管理後台每個設定在哪裡，見管理後台設定地圖。

4. 接上通訊軟體

到管理後台的「通道」頁貼上 bot token，同一位 AI 員工就會出現在 Telegram、LINE、Discord 等平台，不需要重啟。DuDuClaw 支援 11 個通道：Telegram、LINE、Discord、Slack、WhatsApp、飛書、Google Chat、Microsoft Teams、企業微信、釘釘與 WebChat。

• LINE、WhatsApp 這類用 webhook 的通道需要一個外部連得到的 HTTPS 網址，Tailscale Funnel、ngrok、Cloudflare Tunnel 的設定方式見部署指南。
• Google Chat 與 Microsoft Teams 的申請步驟見Google Chat 與 Teams 通道。

5. 交辦第一件事

在任何已接上的通道輸入：

/goal 整理本週客訴重點 || 列出前三大問題與各自件數

|| 後面是驗收標準。AI 員工回報做完之後由判官驗收，檢查正確性、完整性與安全性（簡單的單步目標只查正確性與安全性），全部通過才算完成；卡住時會轉給你裁決。流程與設定見自主目標迴圈與目標迴圈指南。

常用的下一步

duduclaw agent create      # 建立更多 AI 員工
duduclaw wizard            # 用產業板模設定
duduclaw status            # 系統健康狀態
duduclaw update            # 檢查並安裝新版本
duduclaw service install   # 設成開機自動啟動（launchd／systemd）

從 OpenClaw、Hermes 或 paperclip 搬過來，見從其他平台搬家。