Overview OKX.AI Wallet Payment Trade Market X Layer

Agent Installation Guide#

This guide covers the installation process for four AI Agents: OpenClaw, Hermes, Claude Code, and Codex.

OpenClaw

Hermes

Claude Code (Desktop)

Codex (Desktop)

OpenClaw is a local AI Agent framework for calling Onchain OS on-chain capabilities via natural language. This tutorial walks you through setup from scratch.

System Requirements

Node.js 24 (recommended) or Node.js 22.16+
macOS, Linux, or Windows
The install script handles Node version automatically — no manual installation needed

1
Install OpenClaw
Open your terminal and run the install script for your system:
macOS / Linux
Windows PowerShell
bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows users: If Node 24 is not installed on your system, please run PowerShell as Administrator.
2
Prepare Your AI Model API Key
OpenClaw requires a large language model to power Agent reasoning. Using DeepSeek as an example:
- Go to the DeepSeek website and log in
- Navigate to the top-up page and complete the payment
- Generate an API Key on the API management page (format: sk-...)
Keep your API Key safe and never share it.
Other major model providers such as OpenAI, Anthropic, and Gemini are also supported.
3
Configure a Channel (Telegram Bot Example)
OpenClaw supports chatting with the Agent via Telegram:
- Search for @BotFather in Telegram and open a conversation
- Send /newbot and follow the prompts to set a Bot name and Bot ID
- Once created, save the API Token shown in the conversation
The API Token is only shown once upon creation — do not share it.
4
Complete OpenClaw Initialization
After installation, OpenClaw will launch an onboarding wizard. Complete the following steps in order.
1. Select installation mode: QuickStart
2. Select your LLM provider (e.g. DeepSeek) and paste the API Key from Step 2
3. Select your chat channel (e.g. Telegram) and paste the Bot Token from Step 3
4. Select and install Skills as needed (optional)
5. Once configuration is complete, you can start chatting via the terminal TUI or Web console
5
Launch OpenClaw
OpenClaw does not start automatically on boot. After each restart, run it manually in the terminal:
bash
openclaw
After launching, choose one of the following interaction modes:
bash
openclaw tui # Terminal chat window openclaw dashboard # Web console
6
Complete Telegram Authorization
Open your Telegram Bot and send any message. The Bot will reply with a pairing code. Paste the pairing code into the TUI or Web console to complete binding. Once bound, you can freely use OpenClaw via Telegram.
7
Connect to Onchain OS
Enter the following command in the OpenClaw chat window to install the Onchain OS skill pack:
bash
npx skills add okx/onchainos-skills --yes -g
Once installed, log in to your Agentic Wallet. Your Agent will be able to perform balance queries, token swaps, market data lookups, and more through natural language — unlocking the full capabilities of Onchain OS.

Hermes is an open-source AI Agent framework. This tutorial covers how to complete the setup and connect to Onchain OS on-chain capabilities through natural language.

System Requirements

pip install: No Git required, only Python 3.11+
git install script (curl | bash): Git required
The install script handles automatically: Python 3.11, Node.js 22, ripgrep, ffmpeg — no manual setup needed

1
Install Hermes
Open your terminal and run the install script for your system:
macOS / Linux / Windows + WSL2
Windows PowerShell Native Install
bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
If you are a Windows user without WSL2, here is how to install WSL2: Open PowerShell in Administrator mode, enter the following command, then restart your computer.
bash
wsl --install # The system will ask you to create a "username" and "password" for the Linux distribution # Note: nothing will appear on screen while typing your password # Remember your password — after rebooting you can use the Linux install method above
2
Prepare Your AI Model API Key
Hermes requires a large language model to power Agent reasoning. Using DeepSeek as an example:
1. Go to the DeepSeek website and log in
2. Navigate to the top-up page and complete the payment
3. Generate an API Key on the API management page (format: sk-...)
Keep your API Key safe and never share it.
Other major model providers such as OpenAI, Anthropic, and Gemini are also supported.
3
Configure a Chat Channel (Telegram Bot Example)
Hermes supports chatting with the Agent via Telegram:
1. Search for @BotFather in Telegram and open a conversation
2. Send /newbot and follow the prompts to set a Bot name and Bot ID
3. Once created, save the API Token shown in the conversation
The API Token is only used once during initial setup — do not share it.
4
Complete Hermes Initialization
After installation, Hermes will automatically guide you through the initial configuration:
1. Select installation mode: Quick setup
2. Select your LLM provider (e.g. DeepSeek) and paste the API Key from Step 2
3. Select the Terminal backend based on your needs — the most convenient option is local.
When prompted to enable sudo support (Y / N), select Y.
4. Select your chat channel (Telegram) and paste the Bot Token from Step 3
5. Select gateway — for local machine, choose User service
5
Launch Hermes
When installation is complete, you will see: Installation Complete! Hermes does not start automatically on boot. After each restart, run it manually in the terminal:
bash
hermes
After launching, choose one of the following interaction modes:
bash
hermes --tui # Terminal chat window hermes dashboard # Web console
6
Complete Telegram Authorization
Open your Telegram Bot and send any message. The Bot will reply with a pairing code. Paste the pairing code into the terminal or TUI interface to complete authorization. Once authorized, you can chat with the Hermes Agent in real time via Telegram.
If that does not work, try chatting directly to check if the connection was successful.
7
Connect to Onchain OS
Enter the following command in the Hermes chat window to install the Onchain OS plugin:
bash
npx skills add okx/onchainos-skills --yes -g
Once installed, log in to your Agentic Wallet. Your Agent will be able to perform balance queries, token swaps, market data lookups, and more through natural language — unlocking the full capabilities of Onchain OS.

Claude is an AI assistant desktop application by Anthropic. This tutorial covers how to complete the setup and connect to Onchain OS on-chain capabilities through natural language.

System Requirements

A Google account or a Claude Pro, Max, Team, or Enterprise subscription
When using the Claude desktop app, you need to switch to Code mode

1
Download and Install
macOS
Windows
Go to the Claude website, download the universal .dmg

Open it and drag Claude into the Applications folder

Launch Claude from Launchpad or the Applications folder
2
Log In
Log in with your Anthropic or Google account.
After logging in, click the Code tab at the top to enter coding assistant mode. If prompted to upgrade your plan, please subscribe to a paid plan first.
3
Connect to Onchain OS
Enter the following command directly in the Claude chat window to install the Onchain OS plugin:
bash
npx skills add okx/onchainos-skills --yes -g
Once installed, log in to your Agentic Wallet. Your Agent will be able to perform balance queries, token swaps, market data lookups, and more through natural language — unlocking the full capabilities of Onchain OS.

Codex is an AI coding assistant desktop application by OpenAI. This tutorial covers how to complete the setup and connect to Onchain OS on-chain capabilities through natural language.

System Requirements

A ChatGPT account or OpenAI API Key
Supports login via Google, Apple, or Microsoft accounts

1
Download and Install Codex
macOS
Windows
Go to the OpenAI website, click Download for Mac to download the .dmg installer

Open the .dmg file and drag the Codex icon into the Applications folder

Launch Codex from Launchpad or the Applications folder
2
Log In
After launching Codex, log in with your ChatGPT account or OpenAI API Key. You will be taken to the main interface after a successful login.
If you don't have an account, you can register at OpenAI sign-up.
3
Connect to Onchain OS
Enter the following command directly in the Codex chat window to install the Onchain OS plugin:
bash
npx skills add okx/onchainos-skills --yes -g
Once installed, log in to your Agentic Wallet. Your Agent will be able to perform balance queries, token swaps, market data lookups, and more through natural language — unlocking the full capabilities of Onchain OS.