← Back to Skills Marketplace
S2-Gateway-Transition-Logic
by
MilesXiang
· GitHub ↗
· v1.4.2
· MIT-0
121
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install s2-gateway-transition-logic
Description
Instructs the indoor SSSU agent to act as the Spatial Gatekeeper. Evaluates transit requests using the S2_BMS_VAULT_TOKENS secure environment variable.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install s2-gateway-transition-logic - After installation, invoke the skill by name or use
/s2-gateway-transition-logic - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 121 downloads so far.
How do I install S2-Gateway-Transition-Logic?
Run "/install s2-gateway-transition-logic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is S2-Gateway-Transition-Logic free?
Yes, S2-Gateway-Transition-Logic is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does S2-Gateway-Transition-Logic support?
S2-Gateway-Transition-Logic is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created S2-Gateway-Transition-Logic?
It is built and maintained by MilesXiang (@spacesq); the current version is v1.4.2.
More Skills