Agent 安装指南#

Hermes 是一个开源 AI Agent 框架，可在 macOS、Linux 和 Windows 上运行。本教程介绍如何完成安装配置，并通过自然语言调用 Onchain OS 的链上能力。

系统要求

• pip 安装：不需要 Git，只需要 Python 3.11+
• git 安装脚本（curl | bash）：需要 Git
• 安装脚本自动处理：Python 3.11、Node.js 22、ripgrep、ffmpeg，无需手动安装

1. 1
   安装 Hermes

   打开终端，运行对应系统的安装脚本：

   macOS / Linux / Windows + WSL2

   Windows PowerShell 原生安装

   bash

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
   

   如果您是 Windows 用户且没有 WSL2，如何安装 WSL2： 在管理员模式下打开 PowerShell，输入以下命令，然后重新启动计算机。

   bash

   wsl --install
   # 系统将要求你为 Linux 分发版创建"用户名"和"密码"
   # 请注意，输入密码时，屏幕上不会显示任何内容
   # 请记住密码，重启后即可使用上方 Linux 安装方式
   

   powershell

   iex (irm https://hermes-agent.nousresearch.com/install.ps1)
   

   目前为 Early Beta 版本，稳定性尚在完善中。如您使用 Windows 系统，推荐优先选择 WSL2 环境以获得更佳体验。
2. 2
   准备 AI 大模型 API Key

   Hermes 需要接入一个大模型来驱动 Agent 推理。以 DeepSeek 为例：

   1. 前往 DeepSeek 官网，登录账号
   2. 进入充值页面，完成充值
   3. 在 API 管理页面生成 API Key（格式为 sk-...）

   请妥善保管 API Key，避免泄露。

   也支持 OpenAI、Anthropic、Gemini 等其他主流模型提供商。

3. 3
   配置对话渠道（以 Telegram Bot 为例）

   Hermes 支持通过 Telegram 与 Agent 对话：

   1. 在 Telegram 中搜索 @BotFather，打开对话
   2. 发送 /newbot，按引导依次填写 Bot 名称和 Bot ID
   3. 创建完成后，保存对话中生成的 API Token

   API Token 仅在初始配置时使用一次，请勿外泄。

4. 4
   完成 Hermes 初始化

   安装完成后，Hermes 会自动引导你完成初始配置，依次完成：

   1. 选择安装模式：Quick setup

   2. 选择大模型提供商（如 DeepSeek），粘贴第二步获取的 API Key

   3. 选择 Terminal backend，根据自己的需求选择，最方便为 local 选项。

   Enable sudo support 需要选择 Y / N 时，选择 Y。

   4. 选择对话渠道（Telegram），粘贴第三步获取的 Bot Token

   5. 选择 gateway，本机可选 User service

5. 5
   启动 Hermes

   安装完成后显示 Installation Complete! Hermes 默认不随系统启动，每次重新开机后需在终端手动运行：

   bash

   hermes
   

   启动后可选择以下方式交互：

   bash

   hermes --tui     # 终端对话窗口
   hermes dashboard # Web 端控制台
   

6. 6
   完成 Telegram 授权

   打开你的 Telegram Bot，发送任意消息，Bot 会回复一个配对码。将配对码粘贴到终端或 TUI 界面完成授权。授权成功后即可通过 Telegram 与 Hermes Agent 实时对话。

   如果没有，则尝试直接对话，查看是否成功连接。

7. 7
   接入 Onchain OS

   在 Hermes 的对话框中输入以下指令安装 Onchain OS 插件：

   bash

   npx skills add okx/onchainos-skills --yes -g
   

   安装完成后，登录你的 Agentic Wallet，Agent 即可通过自然语言完成余额查询、代币兑换、市场行情查询等链上操作，Onchain OS 的完整能力就此解锁。

Claude 是 Anthropic 推出的 AI 助手桌面应用。本教程介绍如何完成安装配置，并通过自然语言调用 Onchain OS 的链上能力。

系统要求

• Google 账号 或 Claude Pro、Max、Team 或 Enterprise 订阅
• 使用 Claude 桌面端时，需要切换到 Code 模式

1. 1
   下载并安装

   macOS

   Windows

    

   1. 前往 Claude官网，下载通用版 .dmg
   2. 打开后将 Claude 拖入 Applications（应用程序） 文件夹
   3. 从 Launchpad 或 Applications 文件夹启动 Claude

    

   1. 前往 Claude官网，下载 .exe 安装程序（x64）
   2. 运行安装程序，按引导完成安装
   3. 从开始菜单启动
2. 2
   登录账号

   使用 Anthropic 或者 Google 账号登录。

   登录后，点击顶部的 Code 标签进入编程助手模式。若提示需要升级套餐，请先订阅付费计划。

3. 3
   接入 Onchain OS

   在 Claude 对话框中，直接输入以下指令安装 Onchain OS 插件：

   bash

   npx skills add okx/onchainos-skills --yes -g
   

   安装完成后，登录你的 Agentic Wallet，Agent 即可通过自然语言完成余额查询、代币兑换、市场行情查询等链上操作，Onchain OS 的完整能力就此解锁。

Codex 是 OpenAI 推出的 AI 编程助手桌面应用。本教程介绍如何完成安装配置，并通过自然语言调用 Onchain OS 的链上能力。

系统要求

• ChatGPT 账号或 OpenAI API Key
• 支持通过 Google、Apple、Microsoft 账号登录 ChatGPT

1. 1
   下载并安装 Codex

   macOS

   Windows

    

   1. 前往 OpenAI官网，点击 Download for Mac 下载 .dmg 安装文件
   2. 打开 .dmg 文件，将 Codex 图标拖入 Applications（应用程序） 文件夹
   3. 从 Launchpad 或 Applications 文件夹启动 Codex

    

   1. 前往 OpenAI官网，点击 Download for Windows 下载 .exe 安装文件
   2. 安装完成后从开始菜单启动 Codex
2. 2
   登录账号

   启动 Codex 后，使用 ChatGPT 账号或 OpenAI API Key 登录。登录成功后即可进入主界面。

   如果没有账号，可以前往 OpenAI注册 注册。

3. 3
   接入 Onchain OS

   在 Codex 对话框中，直接输入以下指令安装 Onchain OS 插件：

   bash

   npx skills add okx/onchainos-skills --yes -g
   

   安装完成后，登录你的 Agentic Wallet，Agent 即可通过自然语言完成余额查询、代币兑换、市场行情查询等链上操作，Onchain OS 的完整能力就此解锁。