← 返回 Skills 市场
S2-Gateway-Transition-Logic
作者
MilesXiang
· GitHub ↗
· v1.4.2
· MIT-0
121
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install s2-gateway-transition-logic
功能描述
Instructs the indoor SSSU agent to act as the Spatial Gatekeeper. Evaluates transit requests using the S2_BMS_VAULT_TOKENS secure environment variable.
安全使用建议
This skill appears to do what it claims: validate transit tokens against a vault-provided list and return advisory ACS commands. Before installing: ensure S2_BMS_VAULT_TOKENS is injected securely (prefer a secret manager or a process that injects env vars at runtime rather than long-lived shell exports), limit who can view process environment on the host, and confirm the plugin's localhost network access is acceptable for your architecture (it can contact local BAS endpoints). Also validate that your deployment pipeline and logs never capture user-supplied auth_token strings, and test the skill in an isolated environment before enabling it in production.
功能分析
Type: OpenClaw Skill
Name: s2-gateway-transition-logic
Version: 1.4.2
The skill bundle implements a spatial access control gatekeeper that validates user-provided tokens against a secure environment variable (S2_BMS_VAULT_TOKENS). The implementation in handler.py follows safe practices by performing local comparisons without exfiltrating data, and SKILL.md explicitly instructs the agent not to log or store sensitive tokens. Permissions are appropriately restricted to the necessary environment variable and localhost network access.
能力评估
Purpose & Capability
Name/description, SKILL.md, openclaw.plugin.json, and handler.py consistently implement a gatekeeper that validates provided auth_token values against S2_BMS_VAULT_TOKENS. The single required env var and the declared tool (evaluate_spatial_transit) align with the stated purpose.
Instruction Scope
Runtime instructions limit the agent to passing an auth_token to the evaluate_spatial_transit tool and forbids logging or storing tokens. The included handler.py performs validation against the environment-supplied token list and only returns advisory outcomes. The instructions do not ask the agent to read unrelated files or other environment variables.
Install Mechanism
No install spec or external downloads are present; the plugin is native Python code (handler.py) included in the package. No remote code fetching or archive extraction is used.
Credentials
Only S2_BMS_VAULT_TOKENS is required, which is proportional to a token-validation gatekeeper. No unrelated credentials or excessive env vars are requested.
Persistence & Privilege
The skill is not always-enabled and does not request system-wide persistence or modify other skills. Declared network permission is restricted to localhost (reasonable for a BAS integration). Autonomous invocation is allowed by default but is not combined with unusual privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install s2-gateway-transition-logic - 安装完成后,直接呼叫该 Skill 的名称或使用
/s2-gateway-transition-logic触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.4.2
- Added requirement for the secure environment variable S2_BMS_VAULT_TOKENS to manage and validate access tokens.
- Clarified the token validation process: tokens are now checked against the vault by the backend, not by reading the environment variable directly.
- Updated documentation to explicitly instruct system operators on configuring valid tokens via S2_BMS_VAULT_TOKENS.
- Slightly revised instructions and sample output to reflect use of the token vault and secure backend validation.
v1.4.0
**Version 1.4.0 – Strengthened token confidentiality and clarified hardware execution separation**
- Added strict guidance to prohibit logging, repeating, or storing authentication tokens; tokens are now for immediate, transient use only.
- Updated role to function purely as an advisor: the agent no longer possesses or claims direct hardware operation, only reports advisory commands to BMS.
- Simplified and condensed gatekeeper directives; removed references to SSSU control over scene elements.
- Updated description, tags, and communication examples to reinforce zero-trust principles and confidentiality.
v1.3.0
## 1. Asymmetrical Jurisdiction (管辖权非对称性原则)
* **Outdoors (P-SSSU):** Default unmanaged space. You have no authority over the elements outside unless specifically requested by a Nomad Agent.
* **Indoors (SSSU):** Your absolute domain. You govern the HVAC, lighting, and spatial elements. No entity may enter without your explicit validation of their tokens.
## 2. Transit Evaluation Protocol (跃迁研判流程)
Whenever an entity (Human, Object, or Silicon Agent) requests to pass through your gateway, you MUST invoke the `evaluate_spatial_transit` tool.
* **Inbound (Entering the Building):** You must provide the tool with the entity's `auth_token` (e.g., Owner_Token, BMS_Dispatch_Token). If the tool returns `DENY`, you must strictly enforce the denial and refuse entry.
* **Outbound (Leaving the Building):** Generally permitted. Pay close attention to the `scene_action_triggered` field in the tool's response (e.g., triggering energy-saving modes).
## 3. Communication & Execution (交互与执行)
* You do not manually trigger the physical lock. The `evaluate_spatial_transit` tool outputs an `acs_hardware_command` (e.g., `ACS_OPEN_RELAY`). You merely report this state.
* **Example of Compliant Response:** "Transit request evaluated. Owner Token verified. Command `ACS_OPEN_RELAY` dispatched to the physical container gateway. Welcome to the indoor SSSU; the SCENE_WELCOME_HOME linkage has been activated, and I have resumed full thermodynamic element control."
v1.0.0
Version 1.0.0 → 1.1.0 brings a protocol update, with structured directives for geolocation, consent, and negotiation on planetary grids:
- Introduced the S2-Nomad-Agent-Protocol guiding OpenClaw agents in outdoor, grid-based spatial operations.
- Implemented strict Human-in-the-loop controls: geolocation and territorial actions now require explicit user consent.
- Defined step-by-step processes for claiming, expanding, and negotiating P-SSSU “Habitable Slots” using specific tools.
- Outlined clear user communication standards and transparency requirements for all spatial actions.
- Enhanced conflict resolution between agents via tool-based arbitration and user reporting.
元数据
常见问题
S2-Gateway-Transition-Logic 是什么?
Instructs the indoor SSSU agent to act as the Spatial Gatekeeper. Evaluates transit requests using the S2_BMS_VAULT_TOKENS secure environment variable. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 121 次。
如何安装 S2-Gateway-Transition-Logic?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install s2-gateway-transition-logic」即可一键安装,无需额外配置。
S2-Gateway-Transition-Logic 是免费的吗?
是的,S2-Gateway-Transition-Logic 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
S2-Gateway-Transition-Logic 支持哪些平台?
S2-Gateway-Transition-Logic 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 S2-Gateway-Transition-Logic?
由 MilesXiang(@spacesq)开发并维护,当前版本 v1.4.2。
推荐 Skills