运行你的第一个 AI Agent#

为你的 AI Agent 接入链上能力——查询行情、获取市场数据，全程自然语言操作。

准备工作：安装一个 AI Agent#

本指南以 Claude Code 为例，OnchainOS 支持所有主流 Agent（Cursor、OpenClaw 等）。

第一步：设置 API 凭证#

前往 OKX 开发者平台。
生成你的 API Key、Secret Key 和 Passphrase。

告诉你的 Agent：

创建一个 .env 文件，包含以下变量：OKX_API_KEY、OKX_SECRET_KEY 和 OKX_PASSPHRASE。同时把 .env 添加到 .gitignore。为我打开 .env 并告诉我下一步该做什么，提醒我保存文件。

Agent 会创建文件并打开它——把你的密钥粘贴进去即可。

注意

切勿将 .env 提交到 git（请添加到 .gitignore），也不要在日志、截图或聊天中暴露这些凭证

第二步：将 OnchainOS 添加到你的 Agent#

选择以下任一接入方式：

方式 A：Skills（推荐）#

告诉你的 Agent：

安装 OnchainOS skills，运行：npx skills add okx/onchainos-skills

Agent 会自动安装并提醒你重启。

方式 B：MCP Server#

告诉你的 Claude Code：

添加一个 MCP server，名称 dex-mcp，URL 为 https://web3.okx.com/api/v1/onchainos-mcp，header 为 OK-ACCESS-KEY: "这里填你的 okx-api-key"

或手动添加到配置文件：

{
  "mcpServers": {
    "dex-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your-okx-api-key"
      }
    }
  }
}

提示

更新配置后重启客户端

第三步：试一试！#

告诉你的 Agent：

查一下 OKB 的当前价格。

Agent 会返回类似这样的结果：

OKB 当前价格为 $80.34。

你的 Agent 已经上链了。从这里开始构建！

第二步：将 OnchainOS 添加到你的 Agent

第三步：试一试！