配置与架构
分层
| 文件 / 目录 | 职责 |
|---|---|
src/worker.ts | Cloudflare HTTP 与 x402 中间件 |
src/api.ts、src/server.ts | 另一套服务构造与本地入口 |
src/manager.ts | 沙箱生命周期和记录协调 |
src/driver/e2b-driver.ts | E2B 交互 |
src/db.ts、schema.sql | 记录与事件存储 |
src/config.ts | 环境配置 |
dashboard/ | React Dashboard |
主要配置
| 名称 | 当前用途 |
|---|---|
E2B_API_KEY | E2B 凭据 |
SANDBOX_DEFAULT_TEMPLATE | 模板；默认 openclaw |
SANDBOX_DEFAULT_TIMEOUT_MS | 超时；默认 3600000 |
OPENAI_API_KEY、OPENCLAW_MODEL | OpenClaw 模型配置 |
OPENCLAW_APP_TOKEN | OpenClaw 应用令牌 |
X402_PAY_TO | 支付收款地址；空值会跳过 Worker 的支付中间件 |
X402_NETWORK | 支付网络；必须显式核对 |
X402_CREATE_PRICE、X402_RENEW_PRICE | 创建与续期价格配置 |
BSC_RPC_URL | 自己的 RPC 配置；带凭据的 URL 不应写入公开文档 |
已知配置差异
loadConfig 默认网络为 eip155:8453，但 Worker 内的自定义稳定币解析表只列出
eip155:56 和 eip155:97。部署前需要明确网络、资产、精度和 facilitator 支持，
不能直接沿用默认值并声称 BSC USDT 支付已经可用。
Worker 的 facilitator 调用使用 FACILITATOR 服务绑定。
X402_FACILITATOR_URL 虽在配置中存在，不会替代这一入口的服务绑定。
文档开发
公开文档在 docs/site/content/。在 docs/site/ 执行
npm ci && npm run build 会生成独立静态站到 build/，无需 E2B、D1 或支付密钥。
文档部署不会运行沙箱、执行命令、迁移数据库或启用付费服务；发布和回滚见同目录 README.md。