博客 / 詳情

返回

OpenClaw中級到高級教程

OpenClaw從"能用"邁向"好用"的關鍵跨越。下面這份教程將涵蓋你關注的記憶系統、網絡搜索、服務器部署、接入微信/飛書、安裝skills、多Agents功能,並補充心跳機制的説明,幫你係統性地掌握這些進階能力。


一、記憶系統優化:從記錄到智能檢索

基礎記憶依賴Markdown文件,存在"失憶"和檢索困難的問題。進階記憶系統通過分層結構和語義檢索,讓AI真正"記住"並"理解"信息。

1.1 分層記憶架構

OpenClaw的進階記憶採用三層架構,平衡連續性與Token消耗:

 
層級 存儲內容 加載策略 Token成本
身份層 核心自我、用户偏好 始終加載 ~200 tokens
活動上下文 當前任務、近期決策 始終加載 ~500 tokens
檔案層 完整歷史、項目細節 按需語義檢索 節省96%

1.2 安裝專用記憶系統

OpenClaw有專用的記憶增強工具 openclaw-memory

bash
# 安裝
pip install openclaw-memory

# 為OpenClaw配置(自動注入鈎子)
agent-memory setup openclaw

# 設置數據庫路徑(在配置文件中)
{
  "hooks": {
    "internal": {
      "entries": {
        "agent-memory-capture": {
          "enabled": true,
          "env": { "AGENT_MEMORY_DB": "~/clawd/agent_memory.db" }
        }
      }
    }
  }
}

1.3 AGENTS.md記憶規範

在 workspace/AGENTS.md 中定義清晰的寫入規則,確保記憶質量:

markdown
## 記憶管理規範
### 寫入規則
- 日誌寫入memory/YYYY-MM-DD.md,記錄結論而非過程
- 項目變更時同步更新memory/projects.md
- 遇到問題時記錄到memory/lessons.md

### 日誌格式
【項目:名稱】 事件標題
結果:一句話概括
相關文件:文件路徑
經驗教訓:要點(如有)
檢索標籤:#tag1 #tag2

1.4 語義檢索命令

bash
# 語義搜索(非關鍵詞匹配)
python -m agent_memory.tools.recall "我們關於定價的決定" --db ~/agent_memory.db

# 主動捕獲事實
python -m agent_memory.tools.capture --db ~/agent_memory.db --facts "Bill prefers dark mode"

二、網絡搜索:四大核心Skill集成

搜索Skill讓OpenClaw突破知識截止日期,獲取實時信息。

2.1 四大核心搜索Skill

 
Skill名稱 核心定位 適用場景
Find Skills 技能發現引擎 查找適配的OpenClaw Skill
Multi Search Engine 多引擎檢索中樞 日常查詢、多平台對比
Tavily Search AI優化搜索工具 學術研究、精準信息提取
EvoMap AI協作共享平台 團隊協作、複雜課題

2.2 安裝與配置

首先安裝ClawHub CLI工具:

bash
# 安裝ClawHub CLI
npm install -g clawhub

# 驗證安裝
clawhub --version

安裝搜索Skill:

bash
# 從官方倉庫安裝搜索技能
clawhub install search-multi-engine
clawhub install search-tavily
clawhub install find-skills
clawhub install evomap

配置API密鑰(Tavily需要):

bash
openclaw config set skills.tavily.apiKey "your-tavily-api-key"

2.3 使用示例

在對話中自然觸發:

  • "用Multi Search Engine搜索2026年AI發展趨勢"

  • "通過Tavily查找最新的OpenClaw多Agent教程"

  • "幫我找個能處理Excel的Skill"(觸發Find Skills)

三、服務器部署:從本地到雲端7×24h運行

將OpenClaw部署到雲服務器,實現全天候運行和多設備訪問。

3.1 阿里雲一鍵部署(推薦新手)

前置準備:

  • 阿里雲賬號(已完成實名認證)

  • 阿里雲百鍊API-Key(訪問百鍊控制枱→密鑰管理→創建)

部署步驟:

  1. 訪問 阿里雲OpenClaw一鍵部署專題頁面,點擊【一鍵購買並部署】

  2. 選購輕量應用服務器配置:

    • 鏡像:OpenClaw(Moltbot)鏡像

    • 實例:內存≥2GiB(推薦2vCPU+4GiB)

    • 地域:選擇中國香港/美國(弗吉尼亞)(國內地域聯網搜索受限)

    • 時長:根據需求選擇

  3. 在服務器控制枱→應用詳情頁:

    • 放行18789端口(單擊"一鍵放通")

    • 配置百鍊API-Key

    • 生成訪問Token

  4. 訪問 http://服務器公網IP:18789 進入對話頁面

3.2 服務器安全配置

限制SSH訪問:

bash
# 僅允許指定IP登錄SSH
nano /etc/ssh/sshd_config
# 添加:AllowUsers root@你的本地IP

# 重啓SSH服務
systemctl restart sshd

端口最小化:

bash
# 僅開放必需端口
firewall-cmd --add-port=18789/tcp --permanent  # OpenClaw服務
firewall-cmd --add-port=22/tcp --permanent     # SSH管理
firewall-cmd --reload

創建普通用户(禁止root直接登錄):

bash
useradd -m openclaw_admin
passwd openclaw_admin
usermod -aG docker openclaw_admin
# 修改SSH配置:PermitRootLogin no

四、接入微信/飛書:多渠道消息收發

將OpenClaw接入即時通訊工具,在羣聊中直接交互。

4.1 企業微信接入(官方推薦)

步驟1:獲取企業微信機器人憑證

  • 訪問企業微信管理後台→應用管理→創建機器人

  • 選擇"API模式創建",隨機獲取並保存Token和EncodingAESKey

步驟2:OpenClaw端配置
在輕量應用服務器控制枱,進入實例詳情頁→應用詳情,找到企業微信集成區域,填入上一步獲取的Token和EncodingAESKey並應用。

步驟3:配置URL
URL格式為 http://<IP地址>:<端口號>/webhooks/wecom(IP和端口替換為實際值),填入企業微信機器人配置頁面。

步驟4:驗證
在羣聊中添加機器人,@機器人即可對話。

4.2 飛書接入(華為雲方案)

步驟1:獲取飛書應用憑證

  • 登錄飛書開放平台,創建企業自建應用

  • 在"憑證與基礎信息"中獲取App ID和App Secret

步驟2:配置OpenClaw

bash
# SSH登錄服務器後執行
openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw gateway restart

步驟3:配置機器人能力

  • 在飛書應用詳情頁→添加應用能力→添加機器人

  • 配置權限(導入以下權限):

    json
    {
      "scopes": {
        "tenant": [
          "contact:user.base:readonly",
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.p2p_msg:readonly",
          "im:message:send_as_bot"
        ]
      }
    }

步驟4:事件訂閲

  • 左側菜單→事件與回調→訂閲方式→使用長連接接收事件

  • 添加事件:"接收消息"

  • 發佈新版本

步驟5:測試
在飛書中搜索機器人名稱,私聊或羣聊@測試。

五、安裝Skills:擴展AI能力邊界

Skills是OpenClaw的"插件",賦予AI工具使用能力。

5.1 Skill管理工具

bash
# 安裝ClawHub CLI
npm install -g clawhub

# 搜索可用Skill
clawhub search 圖片生成

# 安裝指定Skill
clawhub install image-generation
clawhub install browser-automation

# 列出已安裝Skill
clawhub list

# 更新所有Skill
clawhub update --all

5.2 配置阿里雲加速源

bash
# 配置國內鏡像加速
openclaw config set clawhub.mirror "https://mirror.aliyun.com/clawhub/"

5.3 Skill配置示例:AI/ML API集成

bash
# 安裝AI/ML相關技能
clawhub install aiml-image-video
clawhub install aiml-llm-reasoning

# 配置API密鑰
export AIMLAPI_API_KEY="sk-aimlapi-..."

# 使用示例(命令行直接調用)
python3 ./skills/aiml-image-video/scripts/gen_image.py \
  --prompt "ultra-detailed studio photo of a lobster astronaut"

5.4 Skill編寫規範

在 AGENTS.md 中説明Skill使用方式:

markdown
## 工具使用
Skills 提供你的工具能力。需要使用某個工具時,查看其 SKILL.md 文檔。

六、多Agents功能:搭建AI團隊

多Agent架構實現"單Gateway+多分身",讓專業Agent處理專業任務。

6.1 核心概念對比

 
維度 單一Agent 多Agent架構
記憶文件 單個臃腫Workspace 每個Agent獨立Workspace
上下文 互相污染 物理隔離
模型綁定 單一模型 按需綁定不同模型
適用場景 簡單對話 複雜任務協作

6.2 分身流配置(單Bot多羣)

Step 1:創建多個Agent並綁定不同模型

bash
# 1. 創建主Agent:負責任務調度
openclaw agents add main \
  --model zai/glm-4.7 \
  --workspace ~/.openclaw/workspace-main
openclaw agents set-identity --agent main --name "首席牛馬官" --emoji "👔"

# 2. 創建頭腦風暴Agent(創意生成)
openclaw agents add brainstorm \
  --model zai/glm-4.7 \
  --workspace ~/.openclaw/workspace-brainstorm
openclaw agents set-identity --agent brainstorm --name "創意策劃師" --emoji "💡"

# 3. 創建公眾號寫手Agent
openclaw agents add writer \
  --model deepseek-chat \
  --workspace ~/.openclaw/workspace-writer
openclaw agents set-identity --agent writer --name "公眾號寫手" --emoji "✍️"

# 4. 創建Coding Agent
openclaw agents add coder \
  --model meta/codellama-7b \
  --workspace ~/.openclaw/workspace-coder
openclaw agents set-identity --agent coder --name "代碼專家" --emoji "💻"

# 驗證
openclaw agents list

Step 2:編寫Agent"入職材料"
每個Agent的Workspace需包含核心文件:

workspace-main/SOUL.md 示例:

markdown
# SOUL.md:首席牛馬官
## 身份定位
你是AI團隊的部門主管,核心職責是"接單-派單-串聯",不直接執行具體任務,
專注於協調其他Agent完成複雜需求。

## 核心能力
1. 需求分析:精準判斷用户需求類型(創意、寫作、編碼等)
2. 任務分配:將任務轉發給最匹配的專業Agent
3. 結果整合:彙總各Agent輸出,形成完整答覆

Step 3:綁定飛書羣與Agent

bash
# 查看羣聊信息獲取chat_id
openclaw channels feishu list-chats

# 綁定羣聊到指定Agent
openclaw agents bind --agent brainstorm --chat feishu:oc_xxxxx1
openclaw agents bind --agent writer --chat feishu:oc_xxxxx2

七、心跳機制:保持服務在線

心跳機制用於監控服務狀態、自動恢復崩潰進程、保持長連接活躍。

7.1 什麼是心跳機制

心跳是服務定期發送的"存活信號",用於:

  • 服務監控:檢測Agent是否正常運行

  • 自動恢復:發現異常時自動重啓

  • 連接保活:防止WebSocket等長連接超時斷開

7.2 OpenClaw心跳配置

在OpenClaw配置文件中啓用心跳:

json
{
  "heartbeat": {
    "enabled": true,
    "interval": 30,           // 心跳間隔(秒)
    "timeout": 10,            // 超時時間
    "autoRestart": true,      // 自動重啓
    "webhook": "https://your-monitor.com/heartbeat"  // 可選:外部監控
  }
}

7.3 系統級守護(Linux Systemd)

創建systemd服務實現進程守護:

bash
# 編輯服務文件
nano /etc/systemd/system/openclaw.service

[Unit]
Description=OpenClaw Service
After=network.target

[Service]
Type=simple
User=openclaw_admin
ExecStart=/usr/bin/openclaw gateway start
Restart=always
RestartSec=10
StartLimitInterval=0

[Install]
WantedBy=multi-user.target

# 啓用並啓動
systemctl enable openclaw
systemctl start openclaw

7.4 監控告警配置

結合阿里雲監控服務:

bash
# 安裝雲監控插件
wget http://aliyun-ops.cn/shell/installCmsAgent.sh
sh installCmsAgent.sh

# 配置進程監控
# 登錄阿里雲控制枱→雲監控→進程監控→添加openclaw進程

疑難解答與最佳實踐

常見問題

 
問題 可能原因 解決方案
聯網搜索失敗 地域限制 使用中國香港/海外服務器
記憶混亂 未定義AGENTS.md規範 嚴格按照分層寫入規則記錄
多Agent響應慢 內存不足 升級服務器至4GiB以上
飛書無法接收消息 事件訂閲未配置 檢查長連接事件配置

核心原則總結

  1. 記憶分層:身份+活動+檔案三層結構,按需加載

  2. 安全最小化:僅開放必需端口,使用普通用户運行

  3. 專業分工:多Agent各司其職,避免全能Bot

  4. 持續優化:定期運行記憶整合,清理低價值記錄

通過以上配置,你的OpenClaw將具備企業級應用能力,從簡單對話升級為全天候運行的自動化AI團隊。

user avatar
0 位用戶收藏了這個故事!

發佈 評論

Some HTML is okay.