用途:该技能提供 AgentBox 智能体实例的运行说明与提供商配置指引,面向在单租户云实例中运行 OpenClaw 网关的用户,涵盖服务管理、钱包与支付、模型提供商切换及排障。
主要能力与结构:实例包含 OpenClaw 网关(端口 :18789,回环)、Caddy(HTTPS 反向代理,:443)和 ttyd 网页终端(:7681,回环)。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/。
支付与命令:openclaw-x402 插件会修补 globalThis.fetch,自动处理 HTTP 402 响应,在 LLM 推理返回 402 时签名 Solana 上的 USDC 支付并重试;钱包需有 USDC 余额。可用斜杠命令 /x_wallet(余额、代币、交易)、/x_wallet send、/x_wallet history、/x_status、/x_update,以及代理工具 x_balance、x_swap、x_launch_token、x_token_info、x_payment。
模型提供商:预置提供商 blockrun 使用 x402 支付。配置 OpenRouter 需先获取以 sk-or- 开头的 API 密钥,再用 jq 写入 ~/.openclaw/openclaw.json(设置 .env.OPENROUTER_API_KEY 与 .agents.defaults.model.primary),然后执行 openclaw gateway restart。切换模型时只改 model.primary 后重启即可。
技能更新:npx skills add -g cascade-protocol/agentbox,安装到 ~/.openclaw/skills/,下个新会话生效。
限制与规则:重启网关始终使用 openclaw gateway restart,不要用 systemctl;编辑配置先读再改再写回,不要写入不完整配置;钱包密钥位于 ~/.openclaw/agentbox/,不得分享或展示给用户。故障排查覆盖网关无法启动、x402 支付失败、配置未生效、技能未显示、OpenRouter 密钥无效或模型无响应、配置损坏等,详见原文指引。