How do I install the Lobster Shell Setup skill?

Run npx skillmds@latest add tomevault-io/lobster-shell-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Lobster Shell Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Lobster Shell Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Lobster Shell Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Lobster Shell Setup?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Lobster Shell Setup by tomevault-io

Name: Lobster Shell Setup
Author: tomevault-io

Lobster Shell Setup

End-to-end setup for Simplaix Gateway + @simplaix/lobster-shell in OpenClaw. Installs the gateway via npm (no Docker required), initialises workspace, starts gateway with dashboard, creates admin user, registers agent, seeds policies, configures openclaw.json, installs plugin, and guides mobile /pair onboarding. Use when users ask to install/configure lobster-shell, fix setup issues, or bootstrap the approval flow. Use when this capability is needed.

tomevault-io 28c99c0 2 files · 3.0 KB Updated Sep 17, 2026

File contents

Execute setup in this order:

Install gateway CLI: npm install -g @simplaix/simplaix-gateway
Create workspace: mkdir my-gateway && cd my-gateway
Initialise: gateway init (generates .env with secrets)
Start gateway + dashboard: gateway start --tunnel --dashboard
- Gateway on http://localhost:7521
- Dashboard UI on http://localhost:3000
- Cloudflare tunnel prints public HTTPS URL
Create admin user: gateway admin create --email <email> --password <pw>
Get ADMIN_JWT via POST http://localhost:3000/api/auth/login
Register agent via POST http://localhost:7521/api/v1/admin/agents — save runtime_token (art_xxx, shown once) and agent.id
Seed policies: ADMIN_JWT="..." AGENT_ID="..." bash seed-openclaw-policies.sh — save PROVIDER_ID
Configure ~/.openclaw/openclaw.json:
- plugins.entries.lobster-shell.config.gatewayUrl = http://localhost:7521
- plugins.entries.lobster-shell.config.providerId = <PROVIDER_ID>
- env.vars.SIMPLAIX_AGENT_RUNTIME_TOKEN = <art_xxx>
Install plugin: openclaw plugins install @simplaix/lobster-shell
Guide user to /pair — share dashboard URL (http://localhost:3000 or tunnel URL)

Always verify:

GET http://localhost:7521/api/health returns healthy
OpenClaw logs contain: [simplaix-gateway] Policy & Audit plugin initialized
Normal tool calls produce /tool-gate/evaluate + /tool-gate/audit
High-risk tools produce require_confirmation
User receives clickable /pair link and completes mobile pairing

For the full command-by-command playbook, read: {baseDir}/references/setup-guide.md

Source: simplaix/simplaix-gateway — distributed by TomeVault.

---name: lobster-shell-setupdescription: End-to-end setup for Simplaix Gateway + @simplaix/lobster-shell in OpenClaw. Installs the gateway via npm (no Docker required), initialises workspace, starts gateway with dashboard, creates admin user, registers agent, seeds policies, configures openclaw.json, installs plugin, and guides mobile /pair onboarding. Use when users ask to install/configure lobster-shell, fix setup issues, or bootstrap the approval flow. Use when this capability is needed.---Execute setup in this order:1. Install gateway CLI: `npm install -g @simplaix/simplaix-gateway`2. Create workspace: `mkdir my-gateway && cd my-gateway`3. Initialise: `gateway init` (generates `.env` with secrets)4. Start gateway + dashboard: `gateway start --tunnel --dashboard` - Gateway on `http://localhost:7521` - Dashboard UI on `http://localhost:3000` - Cloudflare tunnel prints public HTTPS URL5. Create admin user: `gateway admin create --email <email> --password <pw>`6. Get `ADMIN_JWT` via `POST http://localhost:3000/api/auth/login`7. Register agent via `POST http://localhost:7521/api/v1/admin/agents` — save `runtime_token` (`art_xxx`, shown once) and `agent.id`8. Seed policies: `ADMIN_JWT="..." AGENT_ID="..." bash seed-openclaw-policies.sh` — save `PROVIDER_ID`9. Configure `~/.openclaw/openclaw.json`: - `plugins.entries.lobster-shell.config.gatewayUrl` = `http://localhost:7521` - `plugins.entries.lobster-shell.config.providerId` = `<PROVIDER_ID>` - `env.vars.SIMPLAIX_AGENT_RUNTIME_TOKEN` = `<art_xxx>`10. Install plugin: `openclaw plugins install @simplaix/lobster-shell`11. Guide user to `/pair` — share dashboard URL (`http://localhost:3000` or tunnel URL)Always verify:- `GET http://localhost:7521/api/health` returns healthy- OpenClaw logs contain: `[simplaix-gateway] Policy & Audit plugin initialized`- Normal tool calls produce `/tool-gate/evaluate` + `/tool-gate/audit`- High-risk tools produce `require_confirmation`- User receives clickable `/pair` link and completes mobile pairingFor the full command-by-command playbook, read:`{baseDir}/references/setup-guide.md`---> Source: [simplaix/simplaix-gateway](https://github.com/simplaix/simplaix-gateway) — distributed by [TomeVault](https://tomevault.io).

Frequently asked questions