3-2 连接你的 AI 与链上世界

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

🎬一键安装 Onchain OS Skills 全流程（以OpenClaw 为例）

钱包基础与准备

链上操作和交易所不同——你需要一个链上钱包。快速回顾三个核心概念：

• 公钥/地址：你的"银行账号"，可以公开，别人用它给你转账

• 私钥：你的"银行密码"，拥有它就拥有一切。绝对不能泄露。

• 助记词：私钥的人类可读版本，12 或 24 个英文单词

还没有钱包？创建 Onchain OS 的 API Key 时，需要连接钱包并验证地址。如果你还没有链上钱包，推荐使用 OKX Web3 钱包（内置在 OKX App 中）或 MetaMask（浏览器插件钱包）。安装后按提示创建钱包、备份助记词即可，整个过程约 2 分钟。

铁律：任何人、任何网站、任何 AI 都不应该要求你提供私钥或助记词。如果有人要求，100%是骗局。

五步完成安装

第一步：进入 API Key 管理

访问 OKX Wallet 主页，点击顶部导航栏 Onchain OS → 开发者中心 → API Key 管理。

第二步：连接钱包并验证地址

点击"连接钱包"，选择你的钱包（OKX Web3 钱包 或 MetaMask 等），完成钱包地址验证。

第三步：绑定邮箱和手机号，创建 API Key

进入账号设置，绑定邮箱地址和手机号，然后创建 API Key。创建时需要设置：

• API Key 名称

• 密码（8-32 个字符，需包含大小写字母、数字和符号）

注意：创建后请妥善保管你的 API 密钥（API Key、Secret Key、Passphrase），切勿将其透露给任何人。不要在日志、截图或聊天中暴露密钥信息。

第四步：配置密钥文件

创建好 API Key 后，告诉你的 Agent 以下内容，它会自动帮你创建配置文件：

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

第五步：将 Onchain OS 添加到你的 Agent

打开你所使用的 AI Agent，选择以下任一接入方式：

方式 A：Skills（推荐）

告诉你的 Agent：

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

Agent 会自动安装并提醒你重启。更多详情可查看 GitHub - okx/onchainos-skills

方式 B：MCP Server告诉你的 Agent：

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

安装完成！现在你可以用自然语言让 Agent 调用 Onchain OS 的全部能力了，例如： - "构建一笔兑换交易：100 USDT → OKB，钱包地址 0xd8dA...，滑点 0.5%"

Agentic Wallet（可选进阶）

如果你希望 Agent 能在预设规则内自主执行链上操作（无需逐笔手动确认），可以配置 Agentic Wallet：

1. 告诉你的 Agent：

使用邮箱登录 Agentic Wallet

2. 输入你的邮箱，并等待验证码返回

<email>

3.输入邮箱验证码

<otp-code>

4.验证通过，首次登录 Agent 会自动创建钱包：

钱包创建成功！
EVM 地址:    <evm-address>
Solana 地址: <solana-address>

说明：私钥在 TEE 环境中生成和保管，不会暴露给任何人，包括你的 Agent。同一邮箱再次登录将恢复已有钱包，无需重新创建。

第一次链上查询

连接成功后，试试这些指令感受 Onchain OS 的能力：

# 查询钱包余额
"请查询地址 0x1234...abcd 在以太坊上的 ETH 和 USDT 余额"

# 查询代币信息
"帮我查一下 UNI 代币的链上数据：持有者数量、流动性、前 10 大持仓"

# 查询 Gas 费用
"以太坊当前的 Gas 价格是多少？"

链上安全注意事项

链上操作不可逆，请务必关注以下安全要点：

• 启用官方安全 Skills：OKX 已提供完备的安全 Skills。请告知 Agent 在交易、访问网站或交互代币前，必须调用对应的 安全检测 Skills 评估风险，并使用 授权管理 Skill 定期清理多余授权。

• 授权与合约验证：设置精确额度而非“无限授权”；交互前确认合约地址正确且已通过审计

• 资产隔离与测试：为 Agent 创建专属钱包并仅存少量测试资金，严禁连接大额资产主钱包。建议先在测试网上练习。

下一步

AI 已经成功"上链"！下一课我们进入实战——研究代币、完成链上 Swap、追踪聪明钱，体验 Onchain OS 的全部威力。