运行你的第一个 AI Agent#

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

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

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

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

选择以下任一接入方式：

方式 A：Skills（推荐）#

告诉你的 Agent：

Plain

运行：npx skills add okx/onchainos-skills

Agent 会自动安装并提醒你重启，更多可查看 Github 链接。

提示

OnchainOS Skills 内置沙箱 API Key，安装后即可直接体验，无需额外配置。

方式 B：MCP Server#

告诉你的 Agent：

Plain

添加一个 MCP server，名称 onchainos-mcp，配置如下：
  URL 为 https://web3.okx.com/api/v1/onchainos-mcp；
  Header 为 OK-ACCESS-KEY: "这里填你的 okx-api-key"
添加完成后提醒我重启客户端

或手动添加到配置文件：

Json

{
  "mcpServers": {
    "onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchainos/dev-portal/project"
      },
      "type": "http"
    }
  }
}

提示

更新配置后重启客户端

第二步：试一试！#

告诉你的 Agent：

Plain

查一下 OKB 的当前价格。

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

Plain

OKB 当前价格为 $80.34。

第三步：设置你自己的 API 凭证#

内置沙箱 Key 仅供测试体验，可能受到速率限制。要在生产环境中稳定使用，请配置你自己的 API 凭证：

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

告诉你的 Agent：

Plain

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

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

注意

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

你的 Agent 已上链就绪，开始探索吧！

遇到问题？#

如果操作失败，可以尝试按完整流程手动安装：

赋能 AI Agent

运行你的第一个 DApp

准备工作：安装一个 AI Agent

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

第二步：试一试！

第三步：设置你自己的 API 凭证

遇到问题？