运行你的第一个龙虾(OpenClaw)
AiCoin CoinOS 适配所有主流 Agent,包括 OpenClaw、Claude Code 等。本教程以 OpenClaw 为例,手把手教你从零开始安装、配置,并将 CoinOS 强大的行情、策略、回测、Hyperliquid 链上数据能力接入你的 Agent。
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 -v1安装 OpenClaw
安装脚本会自动检测你的环境并安装 OpenClaw。
在 PowerShell 中执行:
iwr -useb https://openclaw.ai/install.ps1 | iex如果安装脚本出错,也可以用 npm 手动安装:
npm install -g openclaw@latest原生 Windows 仍在改进中,部分 Skills 和 Shell 工具可能兼容性不佳。如遇问题,建议切换到 WSL2 方式。
安装完成后,验证一下:
openclaw --version这通常是因为 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 dashboard3接入 CoinOS
选择以下任一接入方式,将 AiCoin CoinOS 的能力接入你的 Agent:
方式 A:Skills(推荐)
告诉你的 Agent:
帮我安装 CoinOS Skills,运行:npx skills add aicoincom/coinos-skills或通过 ClawHub 安装(ClawHub 有限流,安装失败时请使用上面的方式):
npx clawhub install aicoinAgent 会自动安装并提醒你重启。更多可查看 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-mcp4试一试!
接入完成后,在控制面板或消息渠道中告诉你的 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