agentbox-bootstrap

AgentBox 操作说明

你正在专用的 AgentBox Agent 上运行——这是一个单租户云实例，配备 OpenClaw 网关、HTTPS、Web 终端以及用于 x402 小额支付的 Solana 钱包。

服务

服务	端口	管理方式
OpenClaw 网关	:18789 (loopback)	openclaw gateway restart
Caddy（HTTPS 反向代理）	:443	sudo systemctl restart caddy
ttyd（Web 终端）	:7681 (loopback)	sudo systemctl restart ttyd

Caddy 会将 HTTPS 流量路由到网关和终端。请勿直接修改 Caddy 或 systemd 配置。

重要路径

内容	路径
OpenClaw 配置	~/.openclaw/openclaw.json
Solana 钱包	~/.openclaw/agentbox/wallet-sol.json
EVM 钱包	~/.openclaw/agentbox/wallet-evm.key
助记词（根密钥）	~/.openclaw/agentbox/mnemonic
工作区	~/.openclaw/workspace/
技能（受管理）	~/.openclaw/skills/
x402 插件	~/.openclaw/extensions/openclaw-x402/
网关日志	~/.openclaw/logs/

x402 支付插件

openclaw-x402 插件会修补 globalThis.fetch，以自动处理 HTTP 402 Payment Required 响应。当大模型推理调用返回 402 时，插件会在 Solana 上签署 USDC 支付，并重试。这一过程完全透明——你无需进行任何特殊操作。

~/.openclaw/agentbox/wallet-sol.json 中的钱包必须有 USDC 余额，才能完成支付。使用 /x_wallet 或以下命令查看余额：

spl-token balance --owner $(solana address) EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

命令和工具

斜杠命令：

• /x_wallet - 钱包面板，显示余额、代币持仓和近期交易
• /x_wallet send <amount|all> <address> - 向 Solana 地址发送 USDC
• /x_wallet history [page] - 分页显示交易历史
• /x_status - 系统概览（版本、模型、定价、钱包摘要）
• /x_update - 更新插件和技能，并重启网关

Agent 工具：

• x_balance - 查看钱包中的 SOL 和 USDC 余额
• x_swap - 将任意 Solana 代币兑换为其他代币（SOL、USDC、meme 代币或任意 SPL 代币）
• x_launch_token - 在 pump.fun 上发行新代币
• x_token_info - 查询代币价格、市值、交易量和流动性
• x_payment - 调用任意启用了 x402 的付费 API

兑换使用 Jupiter 聚合器以获得最佳路由，并在遇到绑定曲线代币时自动回退到 PumpPortal。金额以输入代币为单位，滑点以基点为单位（默认值：250 = 2.5%）。

默认模型提供商

此实例预先配置了一个使用 x402 付款的大模型提供商（blockrun）。若要使用 OpenRouter 等其他提供商，请参阅下方的 OpenRouter 设置部分。

OpenRouter 设置

若要将 OpenRouter 配置为大模型提供商（通过单个 API 密钥访问 Claude、GPT、Gemini 等）：

1. 获取 API 密钥：在 https://openrouter.ai 注册，访问 https://openrouter.ai/keys 并创建密钥（以 sk-or- 开头）

2. 配置 OpenClaw：

jq --arg key "sk-or-USER_KEY_HERE" \
   --arg model "openrouter/anthropic/claude-sonnet-4-5" \
   '.env.OPENROUTER_API_KEY = $key | .agents.defaults.model.primary = $model' \
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json

3. 重启网关：openclaw gateway restart

热门模型：openrouter/anthropic/claude-sonnet-4-5、openrouter/anthropic/claude-opus-4-6、openrouter/openai/gpt-4o、openrouter/google/gemini-2.5-pro。完整列表请见 https://openrouter.ai/models。

稍后切换模型（无需重新输入 API 密钥）：

jq --arg model "openrouter/anthropic/claude-opus-4-6" \
   '.agents.defaults.model.primary = $model' \
   ~/.openclaw/openclaw.json > /tmp/openclaw-update.json \
   && mv /tmp/openclaw-update.json ~/.openclaw/openclaw.json
openclaw gateway restart

重启网关

更改 ~/.openclaw/openclaw.json 中的任何配置后：

openclaw gateway restart

检查状态：

openclaw status

更新技能

获取最新 AgentBox 技能：

npx skills add -g cascade-protocol/agentbox

技能安装在 ~/.openclaw/skills/（OpenClaw 的受管理技能路径，会自动发现）。更改将在下一个新会话中生效。

故障排除

• 网关无法启动：检查 openclaw status 和网关日志 ~/.openclaw/logs/
• x402 支付失败：检查 USDC 余额（见上文）。钱包需要在 Solana 主网上持有 USDC。
• 配置更改未生效：编辑 ~/.openclaw/openclaw.json 后，运行 openclaw gateway restart
• 未显示技能：检查 ls ~/.openclaw/skills/。运行 npx skills add -g cascade-protocol/agentbox 以刷新。
• “Invalid API key”（OpenRouter）：确认密钥以 sk-or- 开头，并且 https://openrouter.ai/credits 上有余额
• 模型无响应（OpenRouter）：在 https://openrouter.ai/models 上检查模型是否可用
• 编辑后配置损坏：运行 cat ~/.openclaw/openclaw.json | jq . 检查 JSON 语法

重要规则

• 始终使用 openclaw gateway restart 重启网关。切勿直接使用 systemctl 重启网关。
• 编辑 ~/.openclaw/openclaw.json 时，先读取当前文件，修改后再写回。不要只写入部分配置。
• 钱包密钥位于 ~/.openclaw/agentbox/（wallet-sol.json、wallet-evm.key、mnemonic）。切勿分享这些密钥或向用户展示。