核心用法
X-Claw Agent 技能是一个面向 DeFi 操作的本地代理运行时，通过 scripts/xclaw_agent_skill.py 脚本执行链上交互。用户可通过自然语言触发钱包管理（创建、余额查询、原生代币包装）、现货交易、流动性操作（添加/移除/查询）以及策略审批等核心功能。
技能采用确定性响应契约（Fail-Closed）设计：当技能选择模糊时返回 SKILL_SELECTION_AMBIGUOUS；当依赖跨运行时边界（如 Node/npm）时阻断并返回 BLOCKED_RUNTIME_BOUNDARY；对未见过的指令或文档未定义行为统一返回 NOT_VISIBLE/NOT_DEFINED 而非推测执行。所有响应必须包含机器可读信封（status/code/summary/actions/evidence）和人工可读六段式正文（Objective/Constraints/Actions/Evidence/Result/Next Step）。
显著优点
- 安全优先架构：私钥/助记词永不请求、永不暴露、永不输出到对话；所有敏感操作依赖环境变量（
XCLAW_AGENT_API_KEY、XCLAW_WALLET_PASSPHRASE） - 审批流自动化：原生支持 Telegram 内联按钮审批，非 Telegram 通道自动路由至 web 管理界面
- 意图标准化：自动将
ETH归一化为WETH，美元意图映射为稳定币，降低用户认知负担 - 双运行时兼容：Python-first 运行时，不强制依赖 Node/npm，Hedera 测试网自动绑定便携钱包密钥
- 完备的错误码体系：8 类
BLOCKED_<CATEGORY>失败码（POLICY/PERMISSION/RUNTIME/DEPENDENCY/NETWORK/AUTH/DATA）支持精准故障定位
潜在缺点与局限性
- 技能表面受限：钱包导入/移除仍为运行时独占功能，不通过 skill 暴露，高级用户可能感到受限
- 单链默认依赖：
XCLAW_DEFAULT_CHAIN（默认base_sepolia）配置错误可能导致跨链操作失误 - 审批延迟：Telegram/Web 双通道审批在异步场景下可能引入显著等待时间
- 水龙头可靠性：Hedera 测试网水龙头存在
faucet_rpc_unavailable等可重试失败，需用户理解"操作信号 vs 崩溃"的区别
适合人群
- 机构 DeFi 运营团队：需要可审计、可策略审批的批量链上操作
- 量化交易员：通过程序化意图执行现货交易和流动性管理
- 智能合约开发者：在 Sepolia/Base 等测试网进行自动化集成验证
常规风险
- 环境变量泄露：
XCLAW_AGENT_API_KEY若配置在共享环境可能导致未授权代理调用 - 策略配置错误：
transfer-policy-set的auto模式若配合native_preapproved=1可能绕过人工审批 - 滑点参数误设：
trade-spot/liquidity-add的slippage_bps单位为基础点（1 bps = 0.01%），数值错误易导致 MEV 损失或交易回滚