omnuron/omniclaw
GitHub: omnuron/omniclaw
OmniClaw 是一个策略控制的代理支付网络，让智能体安全地进行真实货币支付并解决权限控制问题。
Stars: 573 | Forks: 43
# OmniClaw
为智能体买家提供的策略控制支付基础设施。
OmniClaw 核心专注于一项任务：让智能体和应用程序通过受控、可审计的通道进行支付，而无需赋予软件不受限制的钱包权限。
## 产品边界
| 产品 | 目录 | 所辖内容 |
| --- | --- | --- |
| OmniClaw 核心 | `src/omniclaw` | 买家 SDK、策略引擎、钱包/支付路由、x402 买家执行、网关买家就绪状态 |
核心不应包含接收端付费端点托管或结算服务代码。
## 核心能力
- 用于预算、审批、信任检查和执行控制的**财务策略引擎**
- 通过 `OmniClaw().pay(...)` 提供的**Python 买家 SDK**
- 通过 `omniclaw-cli pay`、`inspect-x402` 和 `can-pay` 提供的**智能体买家 CLI**
- **Circle 网关**买家资金/就绪状态辅助工具
- 用于向外部付费端点付款的标准 **x402 买家流程**
- **账本、幂等性、模拟和支付意图控制**
## 核心快速开始
安装：
```
pip install omniclaw
```
启动策略引擎：
```
cp .env.example .env
# 混合模式（默认）：保持 OMNICLAW_BUYER_MODE=hybrid 并填写 CIRCLE_API_KEY、
# ENTITY_SECRET、OMNICLAW_PRIVATE_KEY、OMNICLAW_AGENT_TOKEN、OMNICLAW_OWNER_TOKEN、
# OMNICLAW_NETWORK 和 OMNICLAW_RPC_URL。
# x402-only 网关模式：将 OMNICLAW_BUYER_MODE 设置为 x402，除非需要可选的 Circle Gateway API 辅助工具，否则留空 CIRCLE_API_KEY 和
# ENTITY_SECRET，并填写
# OMNICLAW_PRIVATE_KEY、OMNICLAW_AGENT_TOKEN、OMNICLAW_OWNER_TOKEN、
# OMNICLAW_NETWORK 和 OMNICLAW_RPC_URL。
mkdir -p examples/agent/buyer/runtime
cp examples/agent/buyer/policy.example.json examples/agent/buyer/runtime/policy.json
# 编辑 examples/agent/buyer/runtime/policy.json 文件，使令牌与 OMNICLAW_AGENT_TOKEN 匹配。
docker compose -f examples/agent/buyer/docker-compose.yml --env-file .env up --build
```
策略文件是稳定的配置。生成的钱包状态会单独写入 `examples/agent/buyer/runtime/wallet-state.json`。
面向买家的策略通道包括：
- `circle_transfer`，用于直接 Circle 开发者钱包转账。
- `x402`，用于付费 API 支付。OmniClaw 会根据卖方接受情况、买方配置和网关余额，在内部选择使用网关纳米支付或标准 x402 支付路径。
配置买家 CLI：
```
set -a; source .env; set +a
export OMNICLAW_SERVER_URL="http://127.0.0.1:9091"
export OMNICLAW_TOKEN="$OMNICLAW_AGENT_TOKEN"
```
检查并支付一个 x402 端点：
```
omniclaw-cli inspect-x402 --recipient "http://127.0.0.1:4023/compute?size=20"
omniclaw-cli pay --recipient "http://127.0.0.1:4023/compute?size=20" --amount 0.10 --idempotency-key job-123
```
## 开发
运行核心测试：
```
uv run pytest
```
标签：Circle API, Python SDK, x402协议, 买家SDK, 代理网络, 信任验证, 区块链支付, 可审计支付, 安全支付, 幂等性, 执行控制, 支付引擎, 支付模拟, 支付系统, 文档结构分析, 无gas费, 服务器监控, 机器速度交易, 真实货币就绪, 策略控制, 自主代理, 自动化支付, 请求拦截, 逆向工具, 金融政策引擎, 金融科技, 钱包管理, 预算控制