UKong

这份教程专为零基础用户设计，每一步都标注操作目的和避坑要点，确保新手能看懂、能操作、能成功。
一、准备工作（搭建基础运行环境）
1. 检查系统环境（目的：确认兼容性，避免白忙活）
系统要求：Windows 10/11 64 位（32 位系统不支持 OpenClaw 核心依赖）临时操作：关闭杀毒软件 / 防火墙（避免拦截安装包、网络请求或脚本运行）
2. 安装 Python（核心引擎，必装）

为什么装：OpenClaw 本身是 Python 开发的工具，币安 square-post 技能的代码也基于 Python 编写，没有 Python 无法运行任何命令。

安装步骤：
下载python（选 3.10~3.12 版本，兼容性最好）安装操作：a.勾选 Add Python to PATH（关键！否则命令行找不到 Python）b.点击「Customize installation」→ 全部默认勾选 → 安装路径建议 C:\Python311（避免中文 / 空格）c.验证是否成功：打开「Windows 开始菜单」→ 搜索「PowerShell」→ 打开后输入：
python --version
显示 Python 3.11.x 即成功（x 是具体版本号）。
3. 安装 Git（目的：克隆币安官方技能代码）

为什么装：Git 是代码版本管理工具，能快速从 GitHub 下载币安 square-post 技能的完整代码，比手动下载压缩包更方便、不易出错。

安装步骤：
下载地址：https://git-scm.com/download/win安装操作：一路点击「Next」默认安装，路径建议 C:\Git验证是否成功：PowerShell 中输入：
git --version
显示 git version x.x.x.windows.x 即成功。
4. 提前准备关键密钥（目的：让机器人能 “说话” 和 “调用模型”）

✅ 避坑：所有密钥复制到记事本备用，不要泄露；Gemini API Key 无需付费，免费额度足够测试。
二、安装 OpenClaw 核心程序（搭建机器人主体）
1. 安装 OpenClaw（目的：获取机器人核心功能）

PowerShell 中输入以下命令（管理员身份）：
# 安装 OpenClaw 核心包
pip install openclaw
# 升级 pip（避免安装时版本兼容问题）
python -m pip install --upgrade pip

验证是否成功：
openclaw --version
显示版本号（如 0.x.x）即成功；若提示 “不是内部命令”，重启 PowerShell 重试（Python PATH 生效需要重启）。
2. 初始化配置（目的：给机器人配置 “大脑” 和 “消息通道”）

运行配置向导，全程按提示操作，每一步都标注选择要点：
PowerShell 中输入以下命令（管理员身份）：
openclaw onboard

3. 启动网关（目的：让机器人 “在线运行”）
PowerShell 中输入以下命令（管理员身份）：
openclaw gateway
观察日志，出现以下内容即成功：
gateway listening on ws://127.0.0.1:18789（网关启动，机器人核心运行）telegram [default] starting provider（Telegram 机器人上线）
agent model: google/gemini-2.0-flash（模型加载成功）
✅ 注意：这个网关窗口要一直开着，关闭则机器人离线。
三、安装币安 square-post 技能（给机器人加 “币安广场功能”）
1. 克隆技能代码（目的：获取币安广场功能的代码文件）

新开一个 PowerShell 窗口（网关窗口不要关），输入：
# 创建技能存放目录（确保路径无中文/空格）
mkdir -Force C:\Users\$env:USERNAME\.openclaw\skills\square-post

# 从 GitHub 克隆币安技能仓库到临时目录
git clone https://github.com/binance/binance-skills-hub.git C:\Users\$env:USERNAME\.openclaw\skills\temp

# 把 square-post 技能移动到正确目录
Copy-Item -Recurse C:\Users\$env:USERNAME\.openclaw\skills\temp\skills\binance\square-post\* C:\Users\$env:USERNAME\.openclaw\skills\square-post\

# 删除临时文件（清理冗余）
Remove-Item -Recurse C:\Users\$env:USERNAME\.openclaw\skills\temp
2. 安装技能依赖（目的：让技能能正常运行）
PowerShell 中输入以下命令（管理员身份）：
# 进入技能目录
cd C:\Users\$env:USERNAME\.openclaw\skills\square-post

# 安装技能需要的基础依赖（查询行情、调用接口用）
pip install python-binance requests
3. 配置技能（目的：适配 “仅查询 / 发布广场内容” 的需求）
PowerShell 中输入以下命令（管理员身份）：
# 打开配置文件（自动创建新文件）
notepad C:\Users\$env:USERNAME\.openclaw\skills\square-post\config.json

粘贴以下内容（仅查询行情无需填币安 API Key）：
{
"testnet": true, // 测试环境，避免误操作
"timeout": 10, // 网络超时时间，防止卡住
"use_public_api": true // 强制使用公开接口，无需币安密钥
}
保存并关闭记事本即可。
4. 加载技能并验证（目的：确认技能安装成功）
回到网关窗口，按 Ctrl+C 停止网关；重启网关加载新技能：
PowerShell 中输入以下命令（管理员身份）：
openclaw gateway
验证技能状态：
PowerShell 中输入以下命令（管理员身份）：
openclaw skills list
输出中看到 square-post → Eligible 即成功（Eligible 表示 “可用”）；若显示 Missing requirements，重新运行 pip install python-binance 即可。
四、测试使用（验证所有功能是否正常）
1. 启动监控界面（可选，目的：看机器人处理指令的过程）

新开 PowerShell 运行：
openclaw tui
界面显示 gateway connected | idle 即连接成功。
2. Telegram 测试技能（核心验证）

打开 Telegram，给你的机器人发送以下指令：
使用square-post查询BTC/USDT的价格
或
square-post: 帮我查一下ETH/USDT的最新行情
机器人回复价格信息 → 所有配置成功；无回复：检查网关日志，若提示 “模型超时”，等待 5 分钟重试（Gemini 冷启动慢）。
总结
核心步骤回顾
环境准备：装 Python（运行引擎）、Git（下代码），准备 Telegram/Gemini 密钥；装 OpenClaw：用 pip 安装核心包，通过 onboard 配置模型和 Telegram；装 square-post 技能：克隆代码 → 装依赖 → 配置公开接口 → 重启网关；测试：Telegram 发查询指令，验证回复。
避坑关键点
Python 必须勾选 Add to PATH，否则命令行找不到；Gemini 模型选 2.0-flash，避免配额超限；square-post 配置文件无需填币安密钥，仅查询行情足够用。