首页 › 龙虾技能列表 › Solvea Chat — AI 客服对话

Solvea Chat — AI 客服对话

v0.5.7

调用 Solvea Web App 聊天 API，获取 AI 客服回复。适用于真实客户服务问题。会话启动时发送“新会话已启动”消息。

0· 303·1 当前·1 累计
by @airoucat233 (Airoucat233)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/17
安全扫描
VirusTotal
Pending
查看报告
OpenClaw
可疑
medium confidence
该技能实现了 Solvea 聊天代理，基本符合描述，但发布的元数据声称无需环境变量，而代码和安装程序却需要并持久存储 Solvea 凭据——值得在安装前审查。
评估建议
该技能的代码和安装程序与 Solvea 聊天代理一致，但包元数据错误地声称无需环境变量——然而，代码需要并将在明文 `.env` 中持久存储 `SOLVEA_API_KEY` 和 `SOLVEA_AGENT_ID`。安装前：（1）审查 `setup.sh` 和脚本（它们将修改 `~/.openclaw/openclaw.json` 和复制文件到代理工作空间），（2）首先以 `--dry-run` 运行 `setup.sh`，（3）验证正确的 Solvea API 基础 URL（`apps.voc.ai` vs `solvea.cx`）和提供的令牌是否有范围/可轮换，（4）考虑为该技能创建专用、最低特权令牌并避免在那里放置其他敏感凭据，（5）备份 `openclaw.json` 以防需要恢复更改。主要问题是元数据不一致——如果您依赖注册表声明，请要求发布者更正所需环境变量声明或在继续之前自己检查代码。...
详细分析 ▾
ℹ 用途与能力
技能名称、README 和脚本一致地实现了 Solvea Web App 聊天客户端（chat.py + solvea_client.py + setup.sh）。要求 API 令牌和代理 ID 适用于此目的。然而，注册表元数据声明“无需环境变量”，而代码强制执行 `SOLVEA_API_KEY` 和 `SOLVEA_AGENT_ID`，安装程序写入 `.env` —— 这种不一致性是一个不一致。
✓ 指令范围
运行时指令和模板将行为限制为向 Solvea API 转发用户消息和在内存/`solvea-sessions.json` 中管理每用户聊天 ID。安装程序编辑 OpenClaw 配置（`openclaw.json`）以添加绑定/代理，这对于安装通道绑定代理是预期的。没有指令尝试读取无关机密或将数据泄漏到意外端点。
✓ 安装机制
无远程下载；包含的 `setup.sh` 将技能复制到代理工作空间，创建 Python 虚拟环境并安装两个 PyPI 依赖项（httpx，python-dotenv）。该安装机制对于 Python CLI 技能是标准且合理的。`setup.sh` 将写入文件到工作空间和 `openclaw.json` —— 对于技能安装程序是正常的，但需要本地配置更改。
⚠ 凭证需求
技能合理地需要 `SOLVEA_API_KEY`（X-Token）和 `SOLVEA_AGENT_ID`；如果缺少这些，代码将中止。注册表元数据错误地列出无需环境变量或主凭据，这不一致且可能误导用户。安装程序默认将这些凭据写入技能目录中的明文 `.env` —— 用户应了解本地持久性。此外，代码和 `.env` 中的默认 `SOLVEA_BASE_URL` 为 `https://apps.voc.ai`，而 `SKILL.md` 链接到 `https://solvea.cx`；此域名不匹配应进行验证。
ℹ 持久化与权限
技能不请求“always: true”并遵循正常安装行为。`setup.sh` 将添加代理条目和通道绑定到 `~/.openclaw/openclaw.json`，复制文件到代理工作空间，创建 `.venv`，并保存包含凭据的 `.env`。这些是预期的，但是对 OpenClaw 配置和本地磁盘的持久性更改。
安装前注意事项
  1. 审查 `setup.sh` 和脚本（它们将修改 `~/.openclaw/openclaw.json` 和复制文件到代理工作空间）
  2. 首先以 `--dry-run` 运行 `setup.sh`
  3. 验证正确的 Solvea API 基础 URL（`apps.voc.ai` vs `solvea.cx`）和提供的令牌是否有范围/可轮换
  4. 考虑为该技能创建专用、最低特权令牌并避免在那里放置其他敏感凭据
  5. 备份 `openclaw.json` 以防需要恢复更改。主要问题是元数据不一致——如果您依赖注册表声明，请要求发布者更正所需环境变量声明或在继续之前自己检查代码。
安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

运行时依赖

无特殊依赖

版本

latestv0.5.72026/3/16

solvea-chat 0.5.7 - 更新了 `scripts/solvea_client.py`。- 无用户面向文档或 API 改变。- 内部/实现级别改进或 bug 修复。

● Pending

安装命令 点击复制

官方npx clawhub@latest install solvea-chat
镜像加速npx clawhub@latest install solvea-chat --registry https://cn.clawhub-mirror.com

技能文档

将 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 配置：编辑 <技能目录>/.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:" \
  --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:" \
  --reset
参数说明：
  • --mark-reset：记录 reset 标记，下次 chat 时自动先清除 session
  • --peer-id：用户唯一标识，飞书用户使用 feishu: 格式
  • --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
数据来源：ClawHub ↗ · 中文优化：龙虾技能库
OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务