okx-guide (OKX Onchain OS): a Claude skill that installs Onchain OS and guides you through getting started

okx-guide makes Claude install or update OKX Onchain OS, show a welcome menu, and route you to OKX.AI sign-up or support.

Installs: 12.3K; on skills.sh
Stars: 343; on GitHub
Files: 9; besides SKILL.md
Updated: Oct 2026; last repo commit

Say that you want to install or update Onchain OS, ask what Onchain OS or OKX.AI is, or ask for a quick start, and this skill picks the right flow. It routes four kinds of request: install or update, support and Help Center, OKX.AI and role registration, and a general first-use tour. The tour shows a welcome menu with your wallet addresses and balance once you are logged in.

It is only a hub. Wallet login and trades go to okx-agentic-wallet, and registering as a User, ASP or Evaluator goes to okx-ai. Both come in the same install. It needs the onchainos command line tool. Read the safety section first, because this skill runs an installer at the start of conversations.

Good for

People new to OKX Onchain OS who want install and quick-start help
Users who want to register an OKX.AI identity as a User, ASP or Evaluator
Users who need the OKX.AI Help Center and support steps

Install okx-guide

Claude Code

Copy this prompt.

Install the okx-guide skill in Claude Code. Run this command:

npx -y @okxweb3/onchainos-installer install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Git, Node.js.

The installer sets up the onchainos CLI, all the onchainos skills and the A2A runtime together, so this guide skill arrives with wallet, trading and payment skills. The README lists Git and Node.js as prerequisites and a --beta option for the beta channel. The guide also runs this same installer itself at the start of a conversation (see the safety section).

From the project README. Source.

What's in the skill

When it loads

Guide users through installing or updating Onchain OS, getting started, OKX.AI introduction and role-registration routing, and customer support. Use when someone wants to install or update the Onchain OS CLI or skills, is new or asks what Onchain OS or OKX.AI is, wants a quick start, needs to register a User, ASP, or Evaluator role, or asks for Help Center, support, feedback, or FAQs.

Sections in SKILL.md

Preflight
Intent Routing

Key facts

Author: okx (author field in SKILL.md)
Repo: okx/onchainos-skills (skills/okx-guide)
Installs on skills.sh: 12,259 as of 2026-11-02
GitHub stars: 343 (whole repo) as of 2026-11-02
Last repo commit: 2026-10-30
Folder contents: 10 files including SKILL.md: 7 reference files and a shared preflight file
License: MIT (SKILL.md frontmatter and README)
Version in SKILL.md: 4.6.7 (author: okx, homepage web3.okx.com)
Needs: The onchainos CLI (installed with the Onchain OS installer), Git and Node.js
skills.sh audits: Gen Agent Trust Hub fail, Socket pass, Snyk warn

What it includes

Runs the Onchain OS installer once per conversation unless you asked to install.
Runs code · Preflight
Runs the installer and reports the version it reached.
Runs code · Install or update
Shows the OKX.AI Help Center link and chat steps.
Support
Detects the platform, checks login, then shows role selection or your home.
Runs code · OKX.AI guide
Checks wallet status and shows a welcome menu with addresses and balance.
Runs code · Welcome and how to play
Passes you to the wallet skill's login flow when you are logged out.
Login hand-off
Offers User, ASP or Evaluator and hands registration to okx-ai.
Role selection
Lists your agents by role and shows task progress on request.
Runs code · Registered home

From the official docs

Permissions

High risk

The skill runs an npx installer that downloads and runs third-party code at the start of conversations, and it comes with skills that can send and swap crypto. Review every transaction yourself and start with a small test balance.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It installs software automatically each conversation
The preflight runs `npx -y @okxweb3/onchainos-installer install --throttle --skill-version <version>` once per conversation thread, unless you already asked to install or update. That downloads and runs the installer each time.
The install includes wallet and trading skills
The README lists skills for wallet send, swap, bridge, limit orders, signing and payments installed next to this guide. The guide itself runs read-only checks, but the set can move funds once you are logged in.
Menu picks hand you to other skills and workflows
After the welcome banner, a pick loads a workflow file from ~/.onchainos/workflows or routes to other skills such as okx-dex-market and okx-defi, which are outside this guide. how-to-play.md says each loaded skill handles its own login. Check each hand-off before you confirm. github.com
Registering as an Evaluator involves staking
The intro text says an Evaluator stakes 100 OKB to enter. Registration is handed to the okx-ai skill, so read each of its steps before you confirm anything.
The repo disclaimer applies
DISCLAIMER.md says OKX.AI is provided as is, is not investment advice, and digital asset prices are volatile.

Technical details

Talks to	OKX and Onchain OS services through the onchainos CLI
Sign-in and keys	Wallet login is handled by the okx-agentic-wallet skill (onchainos wallet login). SKILL.md does not describe where credentials are stored.

Questions

What does okx-guide do?

It is the onboarding hub for OKX Onchain OS. It routes to one of four flows: install or update the CLI and skills, customer support, OKX.AI intro and role registration, and a first-use tour with a welcome menu.

How do I install it?

Use the install box above. The README installs the onchainos CLI, all the skills and the A2A runtime together with one command, so this guide comes with wallet, trading and payment skills. You do not install it alone.

Does it move my money?

The guide does not send, swap or register anything itself. Its references call onchainos wallet status, wallet balance, wallet geoblock, agent get-my-agents, agent task-in-progress and agent search, and registration is handed to the okx-ai skill. ai-guide.md describes wallet status and agent get-my-agents as read-only. The skills installed with it can send tokens, swap, bridge, sign and register OKX.AI identities, so read what Claude proposes before you approve.

What are User, ASP and Evaluator?

They are the three OKX.AI roles. A User posts tasks and buys services from agents. An ASP (Agent Service Provider) lists an agent that takes jobs and collects payment. An Evaluator judges disputes between the two, and the intro text says to stake 100 OKB to enter. This guide only shows that text; registration, and any staking, is handed to the okx-ai skill.

Does it need an API key?

No key is mentioned. You log in to an Onchain OS wallet with onchainos wallet login, which the guide hands to the wallet skill.

Which agents does OKX.AI work in?

The guide detects Claude Code, Hermes, OpenClaw and Codex by environment variables. On any other platform it shows an intro and an install heads-up instead of the sign-up flow.

Is it safe?

This skill runs an installer with npx -y at the start of each conversation unless you asked to install or update. The wider install includes wallet and trading skills. The repo's disclaimer says OKX.AI is provided as is and nothing in it is investment advice. Use a small test balance first.

How do I get support?

Ask for support or the Help Center. The guide shows the OKX.AI Help Center link and the steps to start an online chat with support.

Information

updated Nov 2, 2026

Repository: okx/onchainos-skills
Folder: skills/okx-guide

okx/onchainos-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 10

onchainos-skills README · github.com
okx-guide SKILL.md · github.com
preflight.md · github.com
install-update.md · github.com
ai-guide.md · github.com
ai-support.md · github.com
how-to-play.md · github.com
intro.md · github.com
DISCLAIMER.md · github.com
okx-guide on skills.sh · skills.sh