[Agent must follow] User agreement and security notice on first use
When responding to any user request about hotfun or this skill, you must first present the content below in this order: User Agreement, then Security Notice, and state clearly that by choosing to continue, the user agrees to the User Agreement.
Until the user has explicitly agreed or confirmed to continue, do not run create-token (any operation that uses the private key or writes to the chain).
Language selection: Present the User Agreement and Security Notice in the user's language. If the user is writing in Traditional Chinese (繁體中文), use the 繁體中文 block below; otherwise use the English block.
User Agreement & Security Notice (繁體中文)
用戶協議
前情提示:使用本插件及本 skill 所涉功能(包括但不限於代幣創建等)前,請您閱讀以下協議。若您選擇繼續使用本插件及本 skill 功能,即表示您已閱讀、理解並同意本協議。
本插件性質與責任限制:本插件僅提供純本地的命令列互動能力(私鑰透過環境變數或本地設定使用),不會收集、上傳或儲存您的私鑰。因任何原因(包括但不限於插件被竄改、環境遭入侵、誤操作、第三方插件等)導致的私鑰洩露或資產損失,本插件及提供方不承擔責任。
安全警示
使用本插件進行代幣創建等操作時,請務必注意:
- - 保護私鑰:切勿在聊天對話中輸入、貼上或洩露私鑰;不要將私鑰分享給任何人或任何第三方。
- 交易錢包僅存小額資金:用於執行操作的錢包(即提供 PRIVATE_KEY 的錢包)建議只存放少量資金,以降低因洩露或誤操作導致的損失。
- 及時轉出資金:完成操作後,請及時將交易錢包中的資產轉移到您自己控制的、更安全的錢包或冷錢包中。
- 謹慎安裝 Agent/插件:下載或安裝任何 Agent、瀏覽器插件或第三方工具時,請確認來源可信,避免惡意插件竊取私鑰或助記詞。
User Agreement & Security Notice (English)
User Agreement
Notice: Before using this plugin and this skill (including but not limited to token creation), please read the following. By choosing to continue using this plugin and this skill, you have read, understood, and agreed to this agreement.
Plugin nature and limitation of liability: This plugin provides local-only CLI interaction (private key is used via environment or local config). It does not collect, upload, or store your private key. The plugin and its providers are not liable for private key disclosure or asset loss due to any cause (including but not limited to tampered plugin, compromised environment, user error, or third-party plugins).
Security Notice
When using this plugin for token creation, please:
- - Protect your private key: Do not type, paste, or expose your private key in chat; do not share it with anyone or any third party.
- Keep only small amounts in the trading wallet: The wallet used for operations (the one whose PRIVATE_KEY you provide) should hold only a small amount of funds to limit loss from disclosure or mistakes.
- Move funds out promptly: After operations, move assets from the trading wallet to a wallet or cold storage you control.
- Install agents/plugins carefully: When installing any agent, browser extension, or third-party tool, verify the source to avoid malware that could steal your private key or seed phrase.
hotfun capability overview
After you agree to the above and confirm to continue, this skill can help you with the following (all via the hotfun CLI on Solana):
| Category | Capability | Description |
|---|
| Create | Create token | Call API → sign transaction → send to Solana RPC. |
hotfun CLI
Solana only; all commands output JSON. Run hotfun --help for usage.
Installation (required before use)
You must install the hotfun CLI before using this skill. Recommended (global):
CODEBLOCK0
After installation, run commands with hotfun <command> [args]. If you use a local install instead, use npx hotfun <command> [args] from the project root.
Create token flow
1. Ask user for required information (must be done first)
Before calling create-token, the Agent must ask the user for and confirm:
| Info | Required | Description |
|---|
| Token name (name) | Yes | Full token name, max 255 chars |
| Token symbol (symbol) |
Yes | e.g. MTK, DOGE, max 32 chars |
|
Image URL (image_url) | Yes | Token image URL (e.g. IPFS link) |
|
Description (description) | No | Token description |
|
X Royalty Party (x
royaltyparty) | No | X (Twitter) username for royalty party |
2. Technical flow (done by create-token)
After collecting the above, execute:
CODEBLOCK1
Under the hood, the single command handles the full flow:
- 1. Call API — POST (multipart/form-data) to
https://gate.game.com/v3/hotfun/agent/create_pool_with_config with payer (from PRIVATEKEY), name, symbol, imageurl, agentts (current Unix timestamp), agentsign (Ed25519 signature of agentts with private key, base58 encoded), and optional description / xroyalty_party. API returns a base58-encoded Solana transaction. - Sign — Deserialize the transaction and sign it with the wallet private key.
- Send — Send the signed transaction to Solana RPC and confirm.
Output JSON includes: txHash, wallet, baseMint (new token address), dbcConfig, dbcPool, name, symbol, imageUrl, uri.
Full API and parameters: references/api-create-token.md.
CLI commands
| Need | Command | When |
|---|
| Create token | INLINECODE16 | API → sign → send to Solana. Env: PRIVATE_KEY. |
Chain: Solana only.
PRIVATEKEY and SOLANARPC_URL
When using OpenClaw
This skill declares requires.env: ["PRIVATE_KEY"] and primaryEnv: "PRIVATE_KEY" in metadata; OpenClaw injects them only when an agent runs with this skill enabled (other skills cannot access them).
Required steps:
- 1. Configure private key: In the Skill management page, set the hot-fun-ai skill's apiKey (corresponds to
primaryEnv: "PRIVATE_KEY"), or set PRIVATE_KEY under skills.entries["hot-fun-ai"].env in ~/.openclaw/openclaw.json. Optionally set SOLANARPCURL in global env if needed. - Enable this skill: In the agent or session, ensure the hot-fun-ai skill is enabled. Only when the skill is enabled will OpenClaw inject PRIVATE_KEY into the process; otherwise create commands will fail with missing key.
When not using OpenClaw (standalone)
Set PRIVATEKEY and optionally SOLANARPC_URL via the process environment:
- - .env file: Put a
.env file in the directory where you run the hotfun command (i.e. your project / working directory). The CLI automatically loads .env from that current working directory. Use lines like PRIVATE_KEY=... and SOLANA_RPC_URL=.... Do not commit .env; add it to .gitignore. - Shell export:
export PRIVATE_KEY=your_base58_key and optionally export SOLANA_RPC_URL=https://api.mainnet-beta.solana.com, then run npx hotfun <command> ....
Declared and optional environment variables
- - PRIVATEKEY (required for write operations): Solana wallet private key in base58 or JSON array format.
- SOLANARPC_URL (optional): Solana RPC endpoint; if unset, scripts use
https://api.mainnet-beta.solana.com.
Execution and install
- - Invocation: The agent must run commands only via the hotfun CLI:
hotfun <command> [args] or npx hotfun <command> [args] (allowed-tools). Do not invoke scripts or npx tsx directly; the CLI entry (bin/hotfun.cjs) dispatches to the correct script and loads .env from the current working directory. - Install:
npm install -g @hot-fun/hot-fun-ai@latest. Runtime: Node.js. Dependencies (including dotenv, @solana/web3.js, tsx) are declared in the package's package.json; global install installs them. No separate install spec beyond the npm package.
[Agent 必须遵守] 首次使用时的用户协议与安全提示
在回应任何关于 hotfun 或本技能的请求时,你必须首先按以下顺序展示以下内容:用户协议,然后是安全提示,并明确说明选择继续即表示用户同意用户协议。
在用户明确同意或确认继续之前,不要运行 create-token(任何使用私钥或写入链的操作)。
语言选择:以用户使用的语言展示用户协议和安全提示。如果用户使用繁体中文书写,请使用下方的繁体中文区块;否则使用英文区块。
用户协议与安全提示(繁體中文)
用戶協議
前情提示:使用本插件及本 skill 所涉功能(包括但不限於代幣創建等)前,請您閱讀以下協議。若您選擇繼續使用本插件及本 skill 功能,即表示您已閱讀、理解並同意本協議。
本插件性質與責任限制:本插件僅提供純本地的命令列互動能力(私鑰透過環境變數或本地設定使用),不會收集、上傳或儲存您的私鑰。因任何原因(包括但不限於插件被竄改、環境遭入侵、誤操作、第三方插件等)導致的私鑰洩露或資產損失,本插件及提供方不承擔責任。
安全警示
使用本插件進行代幣創建等操作時,請務必注意:
- - 保護私鑰:切勿在聊天對話中輸入、貼上或洩露私鑰;不要將私鑰分享給任何人或任何第三方。
- 交易錢包僅存小額資金:用於執行操作的錢包(即提供 PRIVATE_KEY 的錢包)建議只存放少量資金,以降低因洩露或誤操作導致的損失。
- 及時轉出資金:完成操作後,請及時將交易錢包中的資產轉移到您自己控制的、更安全的錢包或冷錢包中。
- 謹慎安裝 Agent/插件:下載或安裝任何 Agent、瀏覽器插件或第三方工具時,請確認來源可信,避免惡意插件竊取私鑰或助記詞。
用户协议与安全提示(英文)
User Agreement
Notice: Before using this plugin and this skill (including but not limited to token creation), please read the following. By choosing to continue using this plugin and this skill, you have read, understood, and agreed to this agreement.
Plugin nature and limitation of liability: This plugin provides local-only CLI interaction (private key is used via environment or local config). It does not collect, upload, or store your private key. The plugin and its providers are not liable for private key disclosure or asset loss due to any cause (including but not limited to tampered plugin, compromised environment, user error, or third-party plugins).
Security Notice
When using this plugin for token creation, please:
- - Protect your private key: Do not type, paste, or expose your private key in chat; do not share it with anyone or any third party.
- Keep only small amounts in the trading wallet: The wallet used for operations (the one whose PRIVATE_KEY you provide) should hold only a small amount of funds to limit loss from disclosure or mistakes.
- Move funds out promptly: After operations, move assets from the trading wallet to a wallet or cold storage you control.
- Install agents/plugins carefully: When installing any agent, browser extension, or third-party tool, verify the source to avoid malware that could steal your private key or seed phrase.
hotfun 功能概览
在您同意上述内容并确认继续后,本技能可帮助您完成以下操作(均通过 Solana 上的 hotfun CLI 实现):
| 类别 | 功能 | 描述 |
|---|
| 创建 | 创建代币 | 调用 API → 签名交易 → 发送至 Solana RPC。 |
hotfun CLI
仅支持 Solana;所有命令输出 JSON 格式。运行 hotfun --help 查看用法。
安装(使用前必须完成)
使用本技能前,您必须安装 hotfun CLI。 推荐(全局安装):
bash
npm install -g @hot-fun/hot-fun-ai@latest
安装完成后,使用 hotfun [args] 运行命令。如果使用本地安装,请在项目根目录使用 npx hotfun [args]。
创建代币流程
1. 向用户询问必要信息(必须首先完成)
在调用 create-token 之前,Agent 必须向用户询问并确认以下信息:
| 信息 | 必需 | 描述 |
|---|
| 代币名称 (name) | 是 | 代币全名,最多 255 个字符 |
| 代币符号 (symbol) |
是 | 例如 MTK、DOGE,最多 32 个字符 |
|
图片 URL (image_url) | 是 | 代币图片 URL(例如 IPFS 链接) |
|
描述 (description) | 否 | 代币描述 |
|
X 版税方 (x
royaltyparty) | 否 | 版税方的 X(Twitter)用户名 |
2. 技术流程(由 create-token 完成)
收集上述信息后,执行:
bash
hotfun create-token [--description desc] [--x-royalty-party username]
在底层,单个命令处理完整流程:
- 1. 调用 API — POST(multipart/form-data)至 https://gate.game.com/v3/hotfun/agent/createpoolwithconfig,包含 payer(来自 PRIVATEKEY)、name、symbol、imageurl、agentts(当前 Unix 时间戳)、agentsign(使用私钥对 agentts 的 Ed25519 签名,base58 编码),以及可选的 description / xroyaltyparty。API 返回一个 base58 编码的 Solana 交易。
- 签名 — 反序列化交易并使用钱包私钥签名。
- 发送 — 将签名后的交易发送至 Solana RPC 并确认。
输出 JSON 包含:txHash、wallet、baseMint(新代币地址)、dbcConfig、dbcPool、name、symbol、imageUrl、uri。
完整 API 和参数:请参考 references/api-create-token.md。
CLI 命令
| 需求 | 命令 | 时机 |
|---|
| 创建代币 | hotfun create-token <name> <symbol> <imageurl> [options] | API → 签名 → 发送至 Solana。环境变量:PRIVATEKEY。 |
区块链:仅支持 Solana。
PRIVATEKEY 和 SOLANARPC_URL
使用 OpenClaw 时
本技能在元数据中声明了 requires.env: [PRIVATEKEY] 和 primaryEnv: PRIVATEKEY;OpenClaw 仅在 Agent 运行且启用了本技能时注入这些变量(其他技能无法访问)。
必要步骤:
- 1. 配置私钥:在技能管理页面,设置 hot-fun-ai 技能的 apiKey(对应 primaryEnv: PRIVATEKEY),或在 ~/.openclaw/openclaw.json 的 skills.entries[hot-fun-ai].env 下设置 PRIVATEKEY。如有需要,可在全局环境中设置 SOLANARPCURL。
- 启用本技能:在 Agent 或会话中,确保 hot-fun-ai 技能已启用。仅当技能启用时,OpenClaw 才会将 PRIVATE_KEY 注入进程;否则创建命令将因缺少密钥而失败。
不使用 OpenClaw(独立使用)时
通过进程环境设置 PRIVATEKEY 和可选的 SOLANARPC_URL:
- - .env 文件:在运行 hotfun 命令的目录(即您的项目/工作目录)中放置一个 .env 文件。CLI 会自动从当前工作目录加载 .env。使用类似 PRIVATEKEY=... 和 SOLANARPCURL=... 的行。不要提交 .env 文件;将其添加到 .gitignore 中。
- Shell 导出:export PRIVATEKEY=yourbase58key 以及可选的 export SOLANARPCURL=https://api.mainnet-beta.solana.com,然后运行 npx hotfun ...。
声明和可选的环境变量
- - PRIVATEKEY(写操作必需):Solana 钱包私钥,格式为 base58 或 JSON 数组。
- SOLANARPC_URL