AI Agent平臺 本地部署指南：打造完全離線的個人 AI 自動化助手

為什么你需要一個完全離線的 AI 助手？

你可能用過 ChatGPT、Claude 這些云端 AI，它們很強，但有個問題：你的數據得傳到別人的服務器上。

想象這些場景：

• 你想讓 AI 幫你自動回復 WhatsApp 消息，但聊天記錄里有客戶隱私
• 你想讓 AI 幫你整理本地文件，但不想把文件目錄結構暴露出去
• 你在公司內網環境，壓根沒法訪問外網 API

AI Agent平臺 就是為這些場景而生的。 它是一個本地運行的 AI 自動化工具，所有操作都在你自己的電腦上完成，不聯網、不上傳數據，而且支持 macOS、Linux、Windows 全平臺。

方案概覽

AI Agent平臺 的核心賣點：

• 一行命令安裝：自動搞定 Node.js 和所有依賴
• 完全離線運行：不需要任何 API Key，不需要聯網
• 本地自動化能力：WhatsApp 自動發消息、文件管理、瀏覽器控制
• 靈活版本管理：穩定版和開發版隨時切換

下面手把手帶你裝起來。

步驟一：一行命令安裝 AI Agent平臺

不管你用什么系統，安裝命令都一樣。

macOS / Linux

打開終端，粘貼這一行：

curl -fsSL https://ai-agent.com/install.sh | bash

Windows

打開 PowerShell（管理員模式），粘貼這一行：

irm https://ai-agent.com/install.ps1 | iex

為什么要這樣做？ 傳統安裝方式需要你先裝 Node.js、配環境變量、再裝依賴包，新手很容易卡在各種報錯上。AI Agent平臺 的安裝腳本會自動檢測你的系統環境，缺什么補什么，真正做到"一鍵到位"。

驗證安裝是否成功

ai-agent --version

如果看到版本號輸出（比如 ai-agent v0.5.2），說明安裝成功。

再跑一下健康檢查：

ai-agent doctor

這個命令會檢查所有依賴是否就緒。如果全部顯示 ?，就可以進入下一步了。

步驟二：初始化你的第一個項目

mkdir my-ai-assistant
cd my-ai-assistant
ai-agent init

執行后會生成一個項目結構：

my-ai-assistant/
├── ai-agent.config.js    # 主配置文件
├── tasks/                # 你的自動化任務
│   └── example.task.js   # 示例任務
└── package.json

為什么要初始化項目？ AI Agent平臺 采用"項目制"管理，每個項目有獨立的配置和任務。這樣你可以為不同場景創建不同項目——一個管文件整理，一個管消息回復，互不干擾。

步驟三：運行你的第一個離線任務

AI Agent平臺 自帶了幾個示例任務，先跑一個試試。打開 tasks/example.task.js，你會看到類似這樣的代碼：

// 文件整理任務：把下載文件夾里的 PDF 自動歸類
const { fileManager } = require('ai-agent/modules');

module.exports = {
  name: 'organize-pdfs',
  trigger: 'manual',
  
  async run() {
    const downloads = await fileManager.list('~/Downloads');
    const pdfs = downloads.filter(f => f.endsWith('.pdf'));
    
    for (const pdf of pdfs) {
      await fileManager.move(
        `~/Downloads/${pdf}`,
        `~/Documents/PDFs/${pdf}`
      );
      console.log(`已移動: ${pdf}`);
    }
    
    console.log(`整理完成，共處理 ${pdfs.length} 個文件`);
  }
};

運行它：

ai-agent run organize-pdfs

效果展示： 如果你的下載文件夾里有 PDF 文件，它們會被自動移動到 ~/Documents/PDFs/ 目錄下。整個過程完全在本地執行，不涉及任何網絡請求。

為什么這很重要？ 很多 AI 工具做文件操作時需要把文件路徑甚至內容上傳到云端分析。AI Agent平臺 直接調用本地文件系統 API，你的文件始終只在你自己的硬盤上。

步驟四：配置 WhatsApp 自動回復（離線場景）

這是 AI Agent平臺 最實用的功能之一。創建一個新任務文件 tasks/whatsapp-reply.task.js：

const { whatsapp } = require('ai-agent/modules');

module.exports = {
  name: 'whatsapp-auto-reply',
  trigger: 'message',
  channel: 'whatsapp',

  async run(message) {
    // 離線關鍵詞匹配，不需要調用任何 AI API
    const keywords = {
      '價格': '感謝咨詢！請訪問我們的價目表頁面。',
      '地址': '我們的地址是：XX市XX區XX路XX號。',
      '營業時間': '營業時間：周一至周五 9:00-18:00。'
    };

    for (const [keyword, reply] of Object.entries(keywords)) {
      if (message.text.includes(keyword)) {
        await whatsapp.send(message.from, reply);
        console.log(`已自動回復: ${message.from}`);
        return;
      }
    }
  }
};

啟動任務：

ai-agent run whatsapp-auto-reply --watch

--watch 參數表示持續監聽新消息。

為什么強調"離線"？ 這里的自動回復用的是關鍵詞匹配，不需要調用 GPT 或 Claude。對于簡單的客服場景，這種方式響應更快、零成本、零隱私風險。如果你確實需要 AI 能力，也可以接入本地模型（后面會講）。

步驟五：版本管理——穩定版 vs 開發版

AI Agent平臺 提供兩個版本通道：

# 切換到穩定版（推薦生產環境使用）
ai-agent update --channel stable

# 切換到開發版（想嘗鮮新功能時用）
ai-agent update --channel dev

怎么選？

• stable（穩定版）：經過充分測試，適合日常使用和生產環境
• dev（開發版）：包含最新功能，但可能有 bug，適合喜歡折騰的開發者

查看當前版本和通道：

ai-agent update --status

輸出示例：

Current version: 0.5.2
Channel: stable
Latest stable: 0.5.2
Latest dev: 0.6.0-beta.3

常見問題

Q1：安裝時報錯 permission denied 怎么辦？

macOS/Linux 用戶加 sudo：

sudo curl -fsSL https://ai-agent.com/install.sh | sudo bash

Windows 用戶確保用管理員權限運行 PowerShell。

Q2：ai-agent doctor 顯示 Node.js 版本不對怎么辦？

AI Agent平臺 需要 Node.js 18+。安裝腳本通常會自動裝好，但如果系統已有舊版本，可能沖突。手動指定：

ai-agent doctor --fix

Q3：離線模式下能不能用 AI 能力？

可以。AI Agent平臺 支持接入本地大模型（通過 Ollama 等），這樣 AI 推理也在本地完成，全程離線。具體配置方法：

ai-agent config set llm.provider ollama
ai-agent config set llm.model llama3

前提是你已經在本地跑起了 Ollama 并下載了對應模型。

Q4：Windows 上路徑里的反斜杠會有問題嗎？

AI Agent平臺 內部做了路徑兼容處理，你在配置文件里統一用正斜杠 / 就行，不用操心系統差異。

下一步學習建議

1. 探索更多模塊：AI Agent平臺 還支持瀏覽器自動化（ai-agent/modules/browser）、定時任務（trigger: 'cron'）等，可以去官方文檔深入研究
2. 接入本地 AI 模型：結合 Ollama 部署本地 LLM，讓自動化任務具備理解和生成能力
3. 查看龍蝦社區教程：更多實戰案例和用戶分享，幫你打開思路

AI Agent平臺 的核心價值就一句話：你的數據不出你的電腦，但 AI 的便利你照樣能享受。 裝好之后，從一個簡單的文件整理任務開始，慢慢你會發現越來越多能自動化的事情。