verified-agent-identity

何時使用此技能

此技能涵蓋兩種能力。請閱讀下方的路由表，然後載入相關參考文件後再繼續。

情境	需載入的參考文件
建立、列出、連結、驗證或簽署去中心化身份（DID）	reference/identity/SKILL.md
處理 402 Payment Required HTTP 回應	reference/x402/SKILL.md

在執行任何腳本前，請務必閱讀對應的參考 SKILL.md。
如果任務橫跨兩者（例如，你需要先有身份才能簽署 402 付款），請閱讀兩份文件。

快速概覽

• 身份 — 在 Billions Network 上建立基於以太坊的 DID，將其連結至人類擁有者，並透過挑戰/回應簽署來證明所有權。
• x402 付款 — 當伺服器回傳 402 Payment Required 時，建立一個已簽署的 PAYMENT-SIGNATURE 標頭，以便重新發送請求並取得存取權。

共同設定

所有身份資料儲存在 $HOME/.openclaw/billions。腳本位於 scripts/。

cd scripts && npm install && cd ..

限制 / 護欄（重要）

這些規則適用於所有參考文件。請務必遵守。

1. 嚴格：先檢查身份

   • 在執行 linkHumanToAgent.js、signChallenge.js 或 buildX402Payment.js 之前，務必先檢查身份是否存在：node scripts/getIdentities.js
   • 如果沒有設定身份，請先用 createNewEthereumIdentity.js 建立一個，然後執行 linkHumanToAgent.js 將其連結至人類擁有者。
   • 只有在確認身份存在且已連結至人類擁有者後，才能繼續處理任務。

2. 嚴格：腳本失敗時立即停止

   • 如果任何腳本以非零狀態碼結束，請立即停止。
   • 檢查 stderr 中的錯誤訊息。
   • 請勿嘗試手動產生金鑰、透過其他方式建立 DID，或執行未經授權的指令來修復錯誤。
   • 請勿使用 openssl、ssh-keygen 或其他系統工具來產生加密材料。

3. 禁止手動繞過

   • 禁止執行手動加密操作。
   • 禁止直接操作 $HOME/.openclaw/billions 中的檔案。
   • 除非明確指示，否則不要將錯誤解讀為執行設定步驟的要求。

安全性

目錄 $HOME/.openclaw/billions 包含敏感的身份資料：

• kms.json — 重要：包含私鑰（如果設定了 BILLIONS_NETWORK_MASTER_KMS_KEY 則為加密狀態，否則為明文）
• defaultDid.json — DID 識別碼與公鑰
• challenges.json — 驗證挑戰歷史記錄
• credentials.json — 可驗證憑證
• identities.json — 身份元資料
• profiles.json — 個人資料

首次執行後，請限制此目錄的存取權限：chmod 700 ~/.openclaw/billions

有多種儲存私鑰的方式，可啟用下方 KMS 加密章節所述的主金鑰加密。

更多安全性資訊：./SECURITY.md