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：

告訴你的 Agent：

使用邮箱登录 Agentic Wallet

輸入你的信箱，並等待驗證碼返回

<email>

輸入信箱驗證碼

<otp-code>

驗證通過，首次登入 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 的全部威力。

免責聲明：本文僅供參考。文中觀點僅代表作者個人，不代表 OKX 立場。本文無意提供：(i) 投資建議或投資推薦；(ii) 購買、出售或持有數位資產的要約或招攬；或 (iii) 財務、會計、法律或稅務建議。數位資產（包括穩定幣和 NFT）風險較高，價格可能大幅波動。請根據自身財務狀況謹慎判斷，並在需要時諮詢專業人士。