Skip to content

OneCLI gateway installer

Installs and wires OneCLI as NanoClaw's secure credential and approval gateway for agent calls.

Stars
31,072
Licence
MIT
Files
15 files

What it does

This skill sets up OneCLI, a gateway that sits between NanoClaw's AI agents and the outside services they call, so API keys and model logins are kept out of agent containers. Once installed, the agent's requests to model providers go through OneCLI, which injects credentials and handles approval prompts. It also copies adapter code, tests, and agent guidance into the NanoClaw project and records which model credentials belong to which agent group.

Great for

  • Developers running NanoClaw who want model credentials kept out of agent containers
  • Teams moving an existing OneCLI-backed NanoClaw install onto the newer gateway seam
  • Operators who connect NanoClaw to a remote OneCLI gateway using an API host and token

Skip it if

  • People who only want a simple chat assistant with no gateway; this adds infrastructure and setup steps that can break an install (setup can reuse an existing gateway without checking its version).
  • Anyone using OneCLI 2.x, which the skill states is not supported.
  • Unattended ChatGPT login setups, since token refresh is stated as not yet verified on the pinned gateway and needs manual reauthentication.

Try asking

  • “Install OneCLI as the gateway provider for my NanoClaw setup”
  • “Upgrade my existing OneCLI-backed NanoClaw install to the gateway seam and check the gateway version”
  • “Grant the Shopify secret to only one agent group using the OneCLI grants command”
  • “Run the OneCLI build and test checks after installing the provider”
Step-by-step guide: how to use OneCLI gateway installerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the MIT licence and an attribution note.

    add-onecli.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip add-onecli.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip add-onecli.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Read docs/onecli-upgrades.md before reusing an existing gateway, because setup does not check its version.
  • Keep API keys out of .env and command arguments; use the OneCLI grants commands to attach secrets to specific groups.
  • Review the copied files and the setup script in .claude/skills/add-onecli/scripts before running, since the skill executes them.

What's inside

  • gateway.json
  • payload/container/skills/onecli-gateway/instructions.md
  • payload/container/skills/onecli-gateway/SKILL.md
  • payload/docs/onecli-upgrades.md
  • payload/src/gateway-providers/onecli-chatgpt-stub.test.ts
  • payload/src/gateway-providers/onecli-chatgpt-stub.ts
  • payload/src/gateway-providers/onecli-files.test.ts
  • payload/src/gateway-providers/onecli-files.ts
  • payload/src/gateway-providers/onecli-install.test.ts
  • payload/src/gateway-providers/onecli-provider-credentials.test.ts
  • payload/src/gateway-providers/onecli-provider-credentials.ts
  • payload/src/gateway-providers/onecli.test.ts
  • payload/src/gateway-providers/onecli.ts
  • REMOVE.md
  • SKILL.md

Redistributed unmodified from nanocoai/nanoclaw under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.