Skip to content

在 OpenCode 中安装 ATX 技能 ​

OpenCode 会从磁盘上固定路径里的 SKILL.md 发现智能体技能。这与 ClawHub / OpenClaw(从注册表安装)或 Claude Code 的安装方式不同:需要你自己把技能目录放到指定位置,再由 OpenCode 在需要时通过 skill 工具加载。目录结构、发现规则与 frontmatter 约定以 OpenCode 官方文档 Agent Skills | OpenCode 为准。

OpenCode 会搜索哪些路径 ​

按 OpenCode 技能文档,每个技能一个目录,目录内放 SKILL.md。OpenCode 会在以下位置查找:

范围路径
项目(OpenCode).opencode/skills/<name>/SKILL.md
全局(OpenCode)~/.config/opencode/skills/<name>/SKILL.md
项目(兼容 Claude).claude/skills/<name>/SKILL.md
全局(兼容 Claude)~/.claude/skills/<name>/SKILL.md
项目(兼容 agent).agents/skills/<name>/SKILL.md
全局(兼容 agent)~/.agents/skills/<name>/SKILL.md

对项目内路径,OpenCode 会从当前工作目录向上遍历到 git 工作区根目录,并加载路径上匹配的 skills/*/SKILL.md。

安装 atxswap 技能 ​

  1. 选定目录 — 若只给当前仓库用,常用:

    text
    <项目根>/.opencode/skills/atxswap/SKILL.md

    若本机所有项目共用:

    text
    ~/.config/opencode/skills/atxswap/SKILL.md
  2. 复制或克隆技能内容,保证目录名正好为 atxswap(与 SKILL.md 里 frontmatter 的 name: atxswap 一致):

    bash
    mkdir -p .opencode/skills
    git clone --depth 1 https://github.com/agentswapx/skills.git /tmp/agentswapx-skills
    cp -R /tmp/agentswapx-skills/atxswap .opencode/skills/atxswap
    rm -rf /tmp/agentswapx-skills
  3. 安装 Node 依赖(技能内脚本需要):

    bash
    cd .opencode/skills/atxswap && npm install
  4. 如有需要,重启或重载 OpenCode。智能体通过 OpenCode 自带的 skill 工具按需加载技能;说明见官方文档中的 Recognize tool description。

试一试 ​

当 atxswap 已放在 OpenCode 能发现的路径下、且已在技能目录完成 npm install 后,在 OpenCode 里用自然语言对智能体提需求即可;示例话术与 在 OpenClaw 中安装 ATX 技能 相同,底层脚本一致。

查看价格 ​

"帮我查一下 ATX 当前价格"

创建钱包 ​

"帮我创建一个新钱包"

智能体会要求你设置密码,然后创建加密钱包。密码自动保存到系统安全存储(或 headless 环境下的本机 file backend,取决于运行环境)。

买入代币 ​

"用 10 USDT 买入 ATX"

智能体会先查询报价,展示预览,等你确认后再执行。

查看余额 ​

"查看我的钱包余额"

转账 ​

"把 50 ATX 转给 0xABC...123"

口令速查 ​

下表与 在 OpenClaw 中安装 ATX 技能 的表格一致。第一列是可以对智能体说的例句(口令),第二列为底层命令,第三列是说明。智能体在需要时会从技能根目录(例如 .opencode/skills/atxswap/)调起 scripts/ 下脚本,你一般不需要自己进终端手敲这些命令。

钱包管理 ​

口令命令说明
「帮我创建一个新钱包」wallet.js create [name] --password <pwd>创建新钱包
「列出我所有的钱包」wallet.js list列出所有钱包及余额
「把钱包的 keystore 导出来备份」wallet.js export <address> [--out <file>]导出钱包对应的加密 keystore JSON(不会暴露原始私钥)

查询 ​

口令命令说明
「查一下 ATX 现在多少钱」query.js price查询 ATX/USDT 价格
「这个地址 0x… 的余额多少」query.js balance <address>查询(指定地址)余额
「用 10 USDT 买入能换多少 ATX」query.js quote <buy|sell> <amount>买卖报价预览
「我有哪些流动性仓位」query.js positions <address>查看 LP 仓位

交换 ​

口令命令说明
「用 10 USDT 买 ATX」swap.js buy <usdtAmount>用 USDT 买入 ATX
「卖 5 ATX 换 USDT」swap.js sell <atxAmount>卖出 ATX 换 USDT

流动性 ​

口令命令说明
「加 100 ATX 和 10 USDT 的流动性」liquidity.js add <atx> <usdt>添加流动性
「把 123 号仓位撤掉 50%」liquidity.js remove <tokenId> <percent>按百分比移除流动性
「收取 123 号仓位的费」liquidity.js collect <tokenId>收取 LP 累计手续费

liquidity.js remove <tokenId> <percent> 现在本身就会发起一笔链上 multicall: decreaseLiquidity -> collect -> 且当 percent = 100 时再 burn。 因此 100% 移除会在销毁 LP NFT 前自动收走当前可提取资金。若 remove ... 100 已成功,再对同一个 tokenId 执行 collect 报错是预期行为,因为该头寸已不存在。

转账 ​

口令命令说明
「转 0.01 BNB 给 0x…」transfer.js bnb <to> <amount>发送 BNB
「转 50 ATX 给 0x…」transfer.js atx <to> <amount>发送 ATX
「转 100 USDT 给 0x…」transfer.js usdt <to> <amount>发送 USDT

备注

  • 上表口令仅为示例,用相近说法、换种说法通常也可以,以你的意图为主,不必照抄原句。

  • 上表命令是技能包内的脚本文本,由智能体在需要时调起;你一般不必自己在终端里执行。

  • 上表说明概括该行为或底层命令的大致作用,与口令一样可做理解用,不限制你必须怎么说。

  • 本技能不支持导入已有私钥——既不能通过对话口令导入,命令行也未提供该入口。智能体只会新建一个属于该技能实例的钱包;如需使用现有私钥,请使用你常用的钱包工具自行管理。

安全说明 ​

  • 智能体永远不会在对话中显示你的私钥或密码
  • 所有交易前,智能体会先展示报价/余额预览,等你确认后才执行
  • 大额交易需要你明确说"确认"或"执行"
  • 私钥以加密形式存储在本地 keystore 文件中
  • 密码保存在系统安全存储中(无桌面会话时可能为本机 file backend,见 SDK 说明)
  • 备份钱包时,技能只能产出加密后的 keystore JSON(例如 wallet.js export <address> --out wallet.json),技能与底层 SDK 都不会输出原始私钥

另见 ​

基于 MIT 协议发布。