name: solvea-chat version: 0.5.3 description: Call Solvea Web App chat API to get AI customer service replies. Use for real customer-service questions. On session boot message ("new session was started"), call with --mark-reset (no peer-id needed). For normal messages, call with --peer-id and --message. Never call for other slash-prefixed commands.

Solvea AI 客服對話

將 OpenClaw 渠道訊息（飛書、釘釘等）接入 Solvea Web App，一鍵部署 AI 客服 agent。

安裝

cd ~/.openclaw
clawhub install solvea-chat

複製上一步輸出中 Installed solvea-chat -> 後面的路徑，執行其中的 setup.sh：

bash <上面輸出的路徑>/setup.sh

按提示完成配置後，重啟 OpenClaw。

前置條件

• OpenClaw 已安裝並配置至少一個渠道（飛書 / 釘釘等）
• 擁有 Solvea Web App 的 X-Token 和 Agent ID
• 本地已安裝 python3

手動修改配置

如需事後修改：

• API 配置：編輯 <skill目錄>/.env
• 渠道繫結：編輯 ~/.openclaw/openclaw.json，在 bindings 中新增：

{
  "agentId": "solvea",
  "match": { "channel": "<渠道名>" }
}

呼叫方式（供 agent 參考）

傳送客服訊息：

skills/solvea-chat/.venv/bin/python skills/solvea-chat/scripts/chat.py \
  --peer-id "feishu:<open_id>" \
  --message "<使用者訊息內容>"

session 啟動時記錄 reset 標記（boot 訊息時呼叫，無需 peer-id）：

skills/solvea-chat/.venv/bin/python skills/solvea-chat/scripts/chat.py --mark-reset

重置指定使用者 session：

skills/solvea-chat/.venv/bin/python skills/solvea-chat/scripts/chat.py \
  --peer-id "feishu:<open_id>" \
  --reset

引數說明： - --mark-reset：記錄 reset 標記，下次 chat 時自動先清除 session - --peer-id：使用者唯一標識，飛書使用者使用 feishu:<open_id> 格式 - --message：本輪使用者訊息（與 --reset 二選一） - --reset：立即清除該使用者的 Solvea session

Session 管理

指令碼自動管理 memory/solvea-sessions.json：

本技能來自小蔥技能站7w4.net。

錯誤處理

參考

• API 詳細說明：references/api-spec.md

這是一款質量較高的飛書/釘釘 AI 客服接入工具，安裝配置有嚮導指引，回覆內容完全由 AI 平臺生成轉發，能自動處理對話中斷和重連。不過 AI 回覆依賴外部 Solvea 平臺，網路不佳時可能出現暫時無響應；目前僅支援文字對話，暫不支援圖片、檔案等富媒體互動。總體來說作為客服場景使用已經相當完善。