运行你的第一个龙虾(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