sightflow-agent

name	sightflow_agent
description	控制 SightFlow 桌面智能体的启动、暂停和状态查询。 当用户需要启动 / 暂停 SightFlow 消息自动回复智能体，或查询其运行状态时使用此 skill。 智能体应用需要提前启动并保持运行。
metadata	{"openclaw":{"emoji":"👁️","requires":{"os":["macos","windows"]}}}

SightFlow Agent 控制 Skill

本 skill 通过本地 HTTP API 控制 SightFlow 桌面智能体。API 仅监听 127.0.0.1:12680。

前置条件

• SightFlow 桌面客户端必须已经启动并运行
• 已在「设置」中填写视觉接口密钥 (Vision API Key)
• 已安装并配置好聊天 Provider（如火山方舟）

API 端点

查询状态

curl -s http://127.0.0.1:12680/skill/status

响应：

• { "ok": true, "status": "running" } — 智能体正在运行
• { "ok": true, "status": "stopped" } — 智能体已停止

启动智能体

curl -s -X POST http://127.0.0.1:12680/skill/start

响应：

• { "ok": true } — 启动成功
• { "ok": false, "error": "<error_code>", "message": "<details>" } — 启动失败

错误码：

error_code	含义
no_vision_key	未配置视觉接口密钥，请先在设置中填写
no_provider	未安装聊天 Provider，请先安装
missing_required_field	Provider 必填配置缺失（如 apiKey）
engine_failed	引擎启动失败
already_running	智能体已在运行中
operation_in_progress	有其他启动 / 暂停操作正在执行

暂停智能体

curl -s -X POST http://127.0.0.1:12680/skill/pause

响应：

• { "ok": true } — 暂停成功
• { "ok": false, "error": "<error_code>", "message": "<details>" } — 暂停失败

错误码：

error_code	含义
not_running	智能体未在运行
operation_in_progress	有其他启动 / 暂停操作正在执行
pause_failed	内部停止流程异常

使用流程

1. 先查询状态确认应用是否在线：调用 GET /skill/status
2. 根据需要调用 POST /skill/start 或 POST /skill/pause
3. 操作后再次查询状态确认结果

注意事项

• 所有请求都是本地请求（127.0.0.1），无需网络
• 启动 / 暂停操作有并发保护，同一时间只能执行一个操作
• 远程启动 / 暂停后，桌面客户端 UI 会同步切换到对应状态
• 如果返回 no_vision_key / no_provider / missing_required_field，需要用户在桌面客户端「设置」中补全配置
• 端口 12680 如果被占用，应用会 fallback 到 12681