SatGate CLI

SatGate CLI 用于管理 API 访问权限、预算及代理经济（agent economy）中的变现机制。当您需要控制哪些代理可访问资源、以及它们可消耗的额度时，请使用该工具。

它们是钱包，我们是收银台。

若代理需为 L402 API 付费，请从 Lightning Labs 安装 lnget。SatGate 面向 服务端 —— 负责执行策略、归属归因与治理管控。

初始化配置

若不存在 ~/.satgate/config.yaml 文件，请运行 scripts/configure.sh；或直接设置环境变量：

# 自托管网关
export SATGATE_GATEWAY=http://localhost:9090
export SATGATE_ADMIN_TOKEN=sgk_your_token

# SatGate Cloud
export SATGATE_SURFACE=cloud
export SATGATE_GATEWAY=https://satgate-gateway.fly.dev
export SATGATE_BEARER_TOKEN=sg_your_api_key
export SATGATE_TENANT=your-tenant-slug

所有操作前，请始终先运行 satgate status，以确认当前目标网关正确无误。

安全准则

1. 首次操作前务必确认目标 —— 运行 satgate status 验证网关地址与部署形态（surface）。
2. 对破坏性操作启用 --dry-run（例如 revoke、大额预算的 mint）。
3. 切勿在未经明确用户授权的情况下使用 --yes。
4. 吊销操作不可逆 —— 吊销前务必再次核对令牌名称。

命令列表

检查网关健康状态

satgate status    # 完整状态信息（版本、部署形态、正常运行时间）
satgate ping      # 快速存活检测（返回退出码 0 或 1）

为新代理发行令牌

# 交互式（提示输入全部字段）
satgate mint

# 非交互式
satgate mint --agent "my-bot" --budget 500 --expiry 30d --routes "/api/openai/*"

# 指定父级令牌（在已有令牌下进行委托）
satgate mint --agent "child-bot" --budget 100 --parent "parent-token-id"

# 预览执行效果（不实际执行）
satgate mint --agent "my-bot" --budget 500 --dry-run

查看代理消费情况

satgate spend                   # 组织级成本中心汇总
satgate spend --agent "cs-bot"  # 单个代理明细分解
satgate spend --period 7d       # 指定时间范围（如最近 7 天）

列出并检查令牌

satgate tokens                  # 列出全部令牌及其状态、已消费额与预算
satgate token               # 查看详情：作用域、委托链路、已消费额

吊销遭入侵的代理

satgate revoke            # 交互式确认
satgate revoke  --dry-run # 仅预览操作影响

查看安全威胁事件

satgate report threats          # 被拦截请求、异常行为等

查看策略模式

satgate mode                    # 当前各路由的策略模式（只读模式）

常用工作流

“新代理需要接入 API”
→ satgate mint --agent "agent-name" --budget 500 --routes "/api/openai/*"

“代理当前花了多少钱？”
→ satgate spend

“某个代理行为异常”
→ satgate revoke

“董事会需要 AI 支出报表”
→ satgate spend --json > report.json

“网关是否运行正常？”
→ satgate ping

输出格式

所有命令均支持 --json 参数，以提供机器可读的结构化输出：

satgate tokens --json | jq '.[] | select(.status == "active")'
satgate spend --json > monthly-report.json

与 lnget 配合使用

SatGate（服务端） + lnget（客户端） = 完整的代理商业栈（agent commerce stack）。

• lnget：代理自动为受 L402 保护的 API 支付费用
• SatGate CLI：运维人员发行令牌、设定预算、吊销访问权限、查看消费明细

使用 lnget 的代理调用您受 SatGate 保护的端点 → SatGate 执行预算限制并完成消费归属归因 → 您可在 satgate spend 中查看对应记录。

安装 lnget：claude plugin marketplace add lightninglabs/lightning-agent-tools