AI Agent平臺（龍蝦）本地部署指南：讓你的聊天工具變成全能AI助手

你是不是也有過這種經歷：想讓AI幫你執行個命令、裝個軟件，結果它只會給你一堆文字說明，還得自己手動操作？

龍蝦（AI Agent平臺）解決的就是這個問題——它不只是聊天，而是真的能操作你的電腦。裝軟件、跑命令、管理項目，它都能直接干。

更爽的是，你不需要專門下載什么App，微信、Telegram、Discord這些你已經在用的聊天工具，都能直接對接龍蝦。隨時隨地發消息，它就幫你干活。

這篇教程帶你從零開始，把龍蝦部署到本地，體驗真正的AI協作。

龍蝦能干什么？

先說幾個實際場景，你感受一下：

• 裝依賴：跟它說"幫我在這個項目里裝個Express"，它直接執行 npm install express，裝完告訴你結果
• Git操作：說"把代碼推到main分支"，它幫你 git add . && git commit && git push
• 文件管理：說"在桌面創建一個項目文件夾，初始化npm"，它照做
• 排查問題：代碼報錯了，把錯誤信息丟給它，它能直接看日志、改代碼、重新跑

這些操作它都能在你的電腦上直接執行，不是給你教程讓你自己來。

部署前的準備

在開始之前，確認你的環境滿足這些條件：

• 操作系統：macOS、Linux 或 Windows（推薦 WSL2）
• Node.js：版本 18 或以上
• Git：需要安裝 Git
• 一個聊天平臺的賬號：Telegram、Discord 或微信（任選一個）

檢查一下 Node.js 版本：

node --version

如果版本低于 18，先升級：

# macOS（用 Homebrew）
brew upgrade node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安裝龍蝦

龍蝦提供了兩種安裝方式，選適合你的。

方式一：一鍵腳本（推薦新手）

一行命令搞定：

curl -fsSL https://get.ai-agent.ai | bash

這個腳本會自動檢測你的環境，下載最新版本，配置好基本設置。

為什么要用一鍵腳本？ 因為它幫你處理了依賴檢查、路徑配置這些容易出錯的步驟。新手用這個最省心。

方式二：Git 克隆（適合想折騰的）

# 克隆倉庫
git clone https://github.com/ai-agent/ai-agent.git

# 進入目錄
cd ai-agent

# 安裝依賴
npm install

# 構建項目
npm run build

為什么用 Git 克隆？ 這樣你可以隨時拉取最新代碼，也能自己修改源碼。適合喜歡折騰、想深入了解內部原理的人。

初始化配置

安裝完成后，運行初始化命令：

ai-agent init

它會問你幾個問題：

1. 選擇 AI 模型：支持 Claude、GPT-4、本地模型等。先選一個你有 API Key 的
2. 配置 API Key：輸入對應的密鑰
3. 選擇聊天平臺：Telegram、Discord 或微信

以 Telegram 為例，你需要先去 @BotFather 創建一個 Bot，拿到 Token，然后填進去。

配置完成后，龍蝦會在當前目錄生成一個 .ai-agent 配置文件夾。

啟動龍蝦

配置好了，直接啟動：

ai-agent start

看到類似這樣的輸出，說明啟動成功：

?? AI Agent平臺 v2.1.0 started
?? Telegram bot connected
???  Local executor ready
? Ready to serve!

現在打開你的 Telegram，找到你創建的 Bot，發一條消息試試：

幫我看看當前目錄下有什么文件

龍蝦會執行 ls -la，然后把結果發給你。

實際使用演示

場景一：快速初始化一個項目

你跟龍蝦說：

在 ~/projects 目錄下創建一個叫 my-app 的 React 項目，用 Vite

它會依次執行：

cd ~/projects
npm create vite@latest my-app -- --template react
cd my-app
npm install

然后回復你："項目創建好了，入口在 ~/projects/my-app，用 npm run dev 啟動。"

場景二：Git 工作流

看看這個項目有沒有未提交的改動，有的話提交一下，推到遠程

龍蝦執行：

git status
git add .
git commit -m "auto: save current changes"
git push origin main

每一步它都會告訴你執行結果。如果 push 失敗（比如有沖突），它會把錯誤信息發給你，問你怎么處理。

場景三：排查問題

你的 Node.js 項目報錯了，把錯誤信息發給龍蝦：

運行 npm run dev 報這個錯：Error: Cannot find module 'vite'

它會：

1. 檢查 node_modules 是否存在
2. 如果沒有，執行 npm install
3. 再跑一次 npm run dev 驗證
4. 告訴你問題已解決

安全提醒

龍蝦擁有你電腦的執行權限，這意味著它能做任何你能在終端里做的事。所以：

• 不要給它管理員權限運行，除非你明確知道在干什么
• 敏感操作要確認：在配置里開啟"執行前確認"，這樣刪除文件、推送代碼這類操作會讓你先確認
• 別把 API Key 暴露出去：.ai-agent 文件夾加到 .gitignore 里

在配置文件里可以設置安全級別：

{
  "security": {
    "confirmBeforeExecute": true,
    "blockedCommands": ["rm -rf /", "sudo"],
    "allowedDirectories": ["~/projects", "~/Desktop"]
  }
}

常見問題

Q：啟動后 Telegram Bot 沒反應？

檢查 Bot Token 是否正確，網絡是否能訪問 Telegram API。國內用戶可能需要配置代理：

export HTTPS_PROXY=http://127.0.0.1:7890
ai-agent start

Q：執行命令時報權限錯誤？

可能是目錄權限問題。不要用 sudo 啟動龍蝦，而是把工作目錄的權限改對：

chmod -R 755 ~/projects

Q：想換一個 AI 模型怎么辦？

重新運行初始化命令，或者直接改配置文件：

ai-agent config set model gpt-4
ai-agent config set apiKey sk-xxxxx

然后重啟：

ai-agent restart

Q：能同時連接多個聊天平臺嗎？

可以。在配置文件里添加多個平臺的配置就行，龍蝦會同時監聽所有平臺的消息。

下一步

部署完成后，你可以繼續探索這些方向：

• 接入本地模型：用 Ollama 跑一個本地 LLM，這樣就不用花錢調 API 了
• 自定義技能：教龍蝦執行你常用的命令組合，比如一鍵部署、自動備份
• 團隊協作：把龍蝦部署到服務器上，團隊成員都能通過聊天工具調用

龍蝦的真正威力在于：它把"對話"和"執行"連起來了。你不再需要記住一堆命令，直接用人話告訴它要干什么就行。

有問題歡迎來www.nhjb.com.cn www.nhjb.com.cn 的社區提問，那里有一群熱心的老哥等著幫你。