Solvea Chat
📖 技能介紹
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本技能來自小蔥技能站7w4.net。
手動修改配置
如需事後修改：
- 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：
| 場景 | 行為 |
|---|---|
| 新使用者首次訊息 | 服務端分配新 chat_id，自動儲存 |
| 老使用者繼續對話 | 讀取已有 chat_id，保持上下文 |
| session 失效 | 自動清除舊 chat_id，重建新 session 後重試 |
/reset 命令 |
清除 chat_id，下次對話從頭開始 |
錯誤處理
| 情況 | 輸出 |
|---|---|
| AI 正常回復 | stdout: AI 回覆內容 |
| 需要轉人工 | stdout: 轉人工提示語 |
| AI 無法回答 | stdout: 無法回答提示語 |
| 網路/認證/配置錯誤 | stderr: 錯誤詳情，exit code=1 |
參考
- API 詳細說明：
references/api-spec.md
🤖 AI 評測
這是一款質量較高的飛書/釘釘 AI 客服接入工具，安裝配置有嚮導指引，回覆內容完全由 AI 平臺生成轉發，能自動處理對話中斷和重連。不過 AI 回覆依賴外部 Solvea 平臺，網路不佳時可能出現暫時無響應；目前僅支援文字對話，暫不支援圖片、檔案等富媒體互動。總體來說作為客服場景使用已經相當完善。
