執行你的第一隻龍蝦（OpenClaw）

AiCoin CoinOS 適配所有主流 Agent，包括 OpenClaw、Claude Code 等。本教學以 OpenClaw 為例，手把手教你從零開始安裝、設定，並將 CoinOS 強大的行情、策略、回測、Hyperliquid 鏈上資料能力接入你的 Agent。

本教學面向零基礎使用者。請根據你的作業系統切換對應的 Tab，按步驟操作即可。整個過程大約需要 5-10 分鐘。

0環境準備

OpenClaw 需要 Node.js 22.16+ 執行環境（推薦 Node 24）。如果你已經裝好了 Node.js，可以跳過這一步。

推薦使用 winget 安裝（Windows 10 1709+ 內建）：

winget install OpenJS.NodeJS.LTS

或使用 Chocolatey：

choco install nodejs-lts

也可以從 nodejs.org 下載安裝包直接安裝。

驗證安裝是否成功（應顯示 v22.x 或 v24.x）：

node -v

1安裝 OpenClaw

安裝腳本會自動偵測你的環境並安裝 OpenClaw。

在 PowerShell 中執行：

iwr -useb https://openclaw.ai/install.ps1 | iex

如果安裝腳本出錯，也可以用 npm 手動安裝：

npm install -g openclaw@latest

注意

原生 Windows 仍在改進中，部分 Skills 和 Shell 工具可能相容性不佳。如遇問題，建議切換到 WSL2 方式。

安裝完成後，驗證一下：

openclaw --version

openclaw 命令找不到？

這通常是因為 npm 全域安裝目錄不在 PATH 中。執行以下命令排查：

npm prefix -g
echo "$PATH"

2初始化設定（Onboard）

執行 onboard 精靈，它會引導你完成所有基礎設定：

openclaw onboard --install-daemon

精靈會依次引導你完成以下設定：

選擇 AI 模型供應商（Anthropic / OpenAI / Ollama 等）並設定 API Key
設定工作空間路徑（預設 ~/.openclaw/workspace/）
設定 Gateway 連接埠和驗證方式
可選：設定訊息頻道（WhatsApp / Telegram / Discord 等）
安裝背景守護程序，讓 Gateway 開機自動啟動

完成後，檢查 Gateway 是否正常執行：

openclaw gateway status

開啟控制面板（瀏覽器會自動開啟 http://127.0.0.1:18789）：

openclaw dashboard

3接入 CoinOS

選擇以下任一接入方式，將 AiCoin CoinOS 的能力接入你的 Agent：

方式 A：Skills（推薦）

告訴你的 Agent：

幫我安裝 CoinOS Skills，運行：npx skills add aicoincom/coinos-skills

或透過 ClawHub 安裝（ClawHub 有限流，安裝失敗時請使用上面的方式）：

npx clawhub install aicoin

Agent 會自動安裝並提醒你重啟。更多可查看 GitHub | ClawHub

方式 B：MCP Server（可選）

告訴你的 Agent：

新增一個 MCP server，名稱 aicoin，指令為 npx，參數為 -y @aicoin/aicoin-mcp。
新增完成後提醒我重啟。

或手動新增：

npx mcporter config add aicoin --command npx --arg -y --arg @aicoin/aicoin-mcp

4試試看！

接入完成後，在控制面板或訊息頻道中告訴你的 Agent：

查一下 BTC 目前的價格。

Agent 會回傳類似這樣的結果：

BTC 目前價格為 $104,250.00。

更多範例：

分析一下 ETH 的多空情緒
Hyperliquid 上 BTC 的鯨魚持倉情況
幫我在 Binance 以 2800 的價格掛單 0.1 個 ETH

5設定 API 憑證（可選）

內建免費 Key 可直接使用（15 次/分鐘）。如需更高頻率，可取得自己的 Key。

前往 AiCoin OpenData 平台註冊並建立 API Key，然後告訴你的 Agent：

告訴你的 Agent：

我的 AiCoin API Key 是 xxx，Secret 是 yyy，幫我設定好。

Agent 會自動把金鑰寫入 .env 檔案並驗證是否生效。

金鑰儲存位置：~/.openclaw/workspace/.env

6連接交易平台（可選）

如需操作交易平台帳戶（下單、查餘額、管理倉位），直接告訴你的 Agent：

告訴你的 Agent：

我要連接我的 OKX 帳戶。

Agent 會引導你提供平台 API Key，並自動寫入 .env 檔案。

支援的平台：Binance、OKX、Bybit、Bitget、Gate、HTX、KuCoin、MEXC、Coinbase、Hyperliquid

安全提示

不要在聊天紀錄、截圖或社群媒體中暴露你的 API Key 和 Secret。如果懷疑洩露，立即到對應平台重新產生金鑰。

你的龍蝦已就緒，開始探索吧！

遇到問題？

如果操作失敗，可以嘗試按完整流程手動設定：身份驗證指南

常用命令速查

openclaw doctor          # 診斷環境問題
openclaw status          # 查看 Gateway 狀態
openclaw dashboard       # 開啟控制面板
openclaw configure       # 重新設定
openclaw gateway run     # 前台啟動 Gateway