OpenSenseNova/SenseNova-Skills / skills/sn-proactive-agent
sn-proactive-agent
Verified安装、启动和使用 Proactive Agent,记录项目进展并在合适时机提醒下一步。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| references/connectors/hermes.md | markdown | 7.5 KB |
| references/connectors/openclaw.md | markdown | 5.1 KB |
| references/install/macos.md | markdown | 3.6 KB |
| references/install/overview.md | markdown | 10.6 KB |
| references/install/windows.md | markdown | 5.7 KB |
references/connectors/openclaw.md
View on GitHub# OpenClaw 接入
用户继续在 OpenClaw 中聊天;插件把问答交给 Proactive Agent,在 Web 展示项目进展与建议。
用户接受后,插件在原会话执行一次,并回传结果。无需另开一套聊天窗口。
## 接入前提
- 先按 [通用流程](../install/overview.md) 安装并检查 `0.1.4` 运行包。
- 已安装且能够正常对话的 OpenClaw Gateway。真实闭环验收基线为 macOS、OpenClaw `2026.6.11`;其他版本和系统需单独验证。
- Core 当前仍使用已配置模型的 Hermes CLI 完成语义整理和判断。只监听 OpenClaw 时无需安装 Hermes Connector,但不能省略这个后台工作器。
- 确认实际 Gateway 实例、端口,以及其配置与状态目录;已有 `OPENCLAW_CONFIG_PATH`、`OPENCLAW_STATE_DIR` 或 profile 设置时,所有命令沿用同一实例。
- 模型由用户通过 Harness 配置入口设置,不读取或展示凭据。服务和 Gateway 默认仅绑定本机;保留已有 Gateway 鉴权,不为接入关闭鉴权。
```text
openclaw --version
openclaw plugins install --help
openclaw plugins list
openclaw gateway status
hermes --version
sn-proactive-agent --version
```
`sn-proactive-agent setup --harness openclaw` 尚未提供,不套用 Hermes 安装命令。
## 安装 Connector
在通用流程已确认的同一 Release 下载目录中取得插件,并按 `SHA256SUMS` 核对插件文件:
```text
gh release download v0.1.4 --repo OpenSenseNova/SenseNova-Skills-ProactiveAgent --pattern sn-proactive-agent-openclaw-0.1.4.tgz
```
校验成功且用户授权修改对应 Gateway 配置后:
```text
openclaw plugins install ./sn-proactive-agent-openclaw-0.1.4.tgz
openclaw plugins enable sn-proactive-agent
openclaw config set plugins.entries.sn-proactive-agent.hooks.allowConversationAccess true
openclaw config set plugins.entries.sn-proactive-agent.config.serviceUrl http://127.0.0.1:8080
```
安装到已有插件时先检查版本与本地修改,不直接 `--force` 覆盖。如果配置了 `plugins.allow`,
保留原列表并加入 `sn-proactive-agent`,不要用单个插件替换其他已信任插件。
只修改本插件对应配置;`allowConversationAccess` 允许插件读取接入后的问答,安装前向用户说明。
安全重启指定 Gateway 使插件生效。由服务管理器运行的实例使用:
```text
openclaw gateway restart
```
前台启动的实例由用户结束原进程,再按原启动方式启动;不要同时启动第二个 Gateway。
## 启动与启用监听
先确认没有同地址运行中的 Proactive Agent 实例。以下默认 Gateway 地址须与实际实例一致:
```text
sn-proactive-agent serve --web-only --openclaw-gateway-url http://127.0.0.1:18789
```
如 Gateway 使用 Token 鉴权,由用户在启动服务的环境中提供
`SN_PROACTIVE_AGENT_OPENCLAW_GATEWAY_TOKEN`;不在命令参数、截图或日志里展示 Token。
其他鉴权模式需先确认兼容性,不能通过关闭鉴权来绕过。
打开 <http://127.0.0.1:8080/>,在“设置”中启用 OpenClaw;只监听 OpenClaw 时可关闭 Hermes。
开关控制对话是否进入 Core,不负责启动或连接 Gateway。当前设置中的状态不是实时健康探测,
显示可用或已启用不代表问答采集和续跑已验证。
## 真实对话验收
在用户授权的模型服务上使用一条合成任务,逐项确认:
1. 从用户正常使用的 OpenClaw 界面发消息,回答完成后 Web 出现对应 Project / Item / Event;核对问答和会话标识。
2. 同一会话继续聊天,后续 Event 保持关联。当前插件采集文本 QA;不把附件文件或工具轨迹当作完整采集已验收。
3. 有价值时生成建议,无价值时静默;从 Web 接受建议后回到 OpenClaw,确认原会话执行且未重复提交。
4. 确认实际工作结果和状态更新,回流 Event 包含对应 `source_suggestion_id`,建议变为已执行;该轮不再连续生成新建议。
`doctor --url` 只证明服务健康;当前没有 OpenClaw 专用的 Session doctor,不能将 Hermes 的检查结果当作 OpenClaw 验收。
单个文本字段当前上限为 120,000 字符,超长内容会截断;验收报告不要声称任意长度或所有附件都完整保留。
Gateway 重启会丢失内存中的续跑去重状态;结果不确定时先核对原会话和日志,不自动重发动作。
## 升级与卸载
升级运行包后还需升级已复制的插件。确认当前无运行任务、备份本插件配置与目录,
校验新版插件包后使用 `openclaw plugins install` 的升级方式;只有确认没有需要保留的本地修改时才使用 `--force`,然后重启与复验。
用户要求停用或卸载时,在 Web 设置关闭 OpenClaw,并对原 Gateway 实例执行:
```text
openclaw plugins disable sn-proactive-agent
openclaw plugins uninstall sn-proactive-agent
```
按原方式重启 Gateway,核对本插件配置和信任列表残留。保留用户会话、项目数据和其他插件,
再按通用流程卸载 Proactive Agent 运行包。`sn-proactive-agent uninstall` 当前只管理 Hermes,不能代替上述 OpenClaw 插件卸载。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |