Solvea Chat

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")...

Security Scan

The skill's code, required env vars, and runtime instructions are consistent with its stated purpose (forwarding messages to a Solvea chat API); it modifies OpenClaw configuration and writes files in the agent workspace, which is expected for this kind of integration.

Purpose & Capability

Name/description (Solvea chat for customer-service replies) match the code and SKILL.md: scripts send user messages to a Solvea API, manage per-peer session IDs, and return API replies. Required binaries (python3) and env vars (SOLVEA_API_KEY, SOLVEA_AGENT_ID) are appropriate for this purpose.

Instruction Scope

Runtime instructions restrict the agent to calling the local chat script and forwarding its stdout. The scripts do read/write local workspace files (memory/solvea-sessions.json, reset marker, logs) and load a .env from the skill directory; setup.sh edits ~/.openclaw/openclaw.json and creates workspace files. These behaviors are within expected scope but worth noting because installation changes OpenClaw configuration and stores the API key in plaintext .env.

Install Mechanism

No remote arbitrary downloads or obfuscated installers. setup.sh copies files into the agent workspace, creates a Python venv and installs two PyPI packages (httpx, python-dotenv) — a standard, moderate-risk pattern for Python skills. No URL shorteners or external binary downloads were used.

Credentials

Required env vars (SOLVEA_API_KEY as primary credential and SOLVEA_AGENT_ID) are proportional to a chat integration. Minor inconsistencies: a reference file mentions SOLVEA_BOT_ID (references/api-spec.md) while code and SKILL.md use SOLVEA_AGENT_ID; default API base URL in code is https://apps.voc.ai while SKILL.md links to solvea.cn — these are likely benign (alternate domains/legacy docs) but should be confirmed by the user.

Persistence & Privilege

The skill is not force-enabled (always: false). It modifies OpenClaw configuration (openclaw.json) and writes files under the selected agent workspace — expected for an integration that binds a channel to an agent. It does not request system-level privileges or access other skills' credentials.

Assessment

This skill appears to do what it says: it forwards channel messages to a Solvea chat API and returns the platform reply. Before installing, review and accept that setup.sh will: (1) modify your ~/.openclaw/openclaw.json (adding an agent and a binding) and may copy the skill into an agent workspace; (2) create a Python virtualenv and pip-install httpx and python-dotenv; (3) write a plaintext .env containing SOLVEA_API_KEY and SOLVEA_AGENT_ID in the skill directory/workspace. Confirm the API base URL (code defaults to https://apps.voc.ai while docs link to solvea.cn) and that the API key you provide is scoped appropriately (avoid using highly privileged keys). If you are unsure, run setup.sh in --dry-run mode first, back up ~/.openclaw/openclaw.json, and inspect the created .env and log files after installation. Finally, note small inconsistencies in docs (SOLVEA_BOT_ID vs SOLVEA_AGENT_ID and version string differences); ask the publisher to clarify if you need strict alignment.

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 参考）

发送客服消息：

SKILL=<skill目录>
$SKILL/.venv/bin/python $SKILL/scripts/chat.py \
  --peer-id "feishu:<用户open_id>" \
  --message "<用户消息内容>"

session 启动时记录 reset 标记（boot 消息时调用，无需 peer-id）：

$SKILL/.venv/bin/python $SKILL/scripts/chat.py --mark-reset

重置指定用户 session：

$SKILL/.venv/bin/python $SKILL/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