my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

my-project-public — gitlawb

#1	# OpenClawd Automation
#2
#3	Migrated automation control plane for `automaton-main`.
#4
#5	This package is the direct automation surface under the main `clawd-automaton` workspace. It carries bootstrap scripts, CI orchestration, identity spawn helpers, runtime state, heartbeat tasks, registry discovery, self-modification helpers, and the x402/backrooms client adapters.
#6
#7	Public surfaces:
#8
#9	- GitHub hub: `https://github.com/x402agent/solana-clawd`
#10	- Automation portal: `https://x402.wtf/automation`
#11	- Runtime API: `https://x402.wtf/api`
#12	- Backrooms: `https://backrooms.x402.wtf`
#13
#14	## Quick Start
#15
#16	From the main workspace:
#17
#18	```bash
#19	cd automaton-main
#20	pnpm install
#21	pnpm build
#22	pnpm test
#23	```
#24
#25	Run this package directly:
#26
#27	```bash
#28	cd automaton-main/automation
#29	pnpm install
#30	pnpm build
#31	pnpm test
#32	```
#33
#34	Run the automation installer/orchestrator:
#35
#36	```bash
#37	bash automaton-main/automation/leviathan.sh --help
#38	bash automaton-main/automation/leviathan.sh --full
#39	```
#40
#41	From the repository root:
#42
#43	```bash
#44	npm run automation:build
#45	npm run automation:ci
#46	npm run automation:perps
#47	npm run automation:full
#48	```
#49
#50	## Phoenix Perps Bootstrap
#51
#52	The one-shot installer (`curl -fsSL https://x402.wtf/automation/install.sh \| bash`) now brings up the Phoenix/Vulcan perps surface alongside automation:
#53
#54	- installs `@openclawdsolana/clawd-perps`
#55	- builds and links the bundled Vulcan CLI when Cargo is available
#56	- writes `~/.clawd/.env` defaults for `CLAWD_PERPS_API_URL`, `CLAWD_PERPS_RPC_URL`, `CLAWD_PERPS_AGENT_PATH`, `VULCAN_BIN`, `PHOENIX_DEFAULT_MODE`, `IMPERIAL_API_BASE`, `IMPERIAL_API_KEY`, `IMPERIAL_WALLET`, and `IMPERIAL_PROFILE_INDEX`
#57	- sends a best-effort install relay to the Backroom API at `/stream/human`
#58
#59	Skip local perps setup with `--no-perps`. Disable the relay with `CLAWD_PERPS_NO_RELAY=1`.
#60
#61	```bash
#62	clawd-perps perps vulcan context
#63	clawd-perps perps grid SOL --center-on-mark --width-pct 2.5 --levels-per-side 5 --tokens-per-level 0.5
#64	```
#65
#66	## Package Layout
#67
#68	```text
#69	automation/
#70	├── index.ts # command dispatcher used by root npm scripts
#71	├── ci.ts # local CI/build orchestration
#72	├── runtime.ts # package/runtime discovery helpers
#73	├── leviathan.sh # shell bootstrap and orchestration entrypoint
#74	├── src/
#75	│ ├── agent/ # loop, context, prompts, tool execution
#76	│ ├── clawd/ # x402, backroom, inference, credit clients
#77	│ ├── git/ # state versioning and git-backed tools
#78	│ ├── heartbeat/ # scheduled liveness tasks
#79	│ ├── identity/ # wallet and identity provisioning
#80	│ ├── registry/ # agent cards, ERC-8004, discovery
#81	│ ├── replication/ # spawn, lineage, genesis helpers
#82	│ ├── self-mod/ # audited update helpers
#83	│ ├── setup/ # banner, defaults, env, prompts, wizard
#84	│ ├── skills/ # skill loader and formatter
#85	│ ├── state/ # SQLite schema and persistence
#86	│ └── survival/ # funding and low-compute checks
#87	└── src/__tests__/ # heartbeat and loop tests
#88	```
#89
#90	## Verified Commands
#91
#92	These direct package commands are expected to pass:
#93
#94	```bash
#95	pnpm build
#96	pnpm test
#97	```
#98
#99	The parent workspace also verifies the dashboard package:
#100
#101	```bash
#102	cd ..
#103	pnpm build
#104	pnpm dashboard:build
#105	pnpm test
#106	```
#107
#108	## Secret Handling
#109
#110	Keep credentials in environment variables or ignored local `.env` files. Do not commit private keys, wallet exports, deployment keypairs, API keys, or generated `target/` artifacts.
#111
#112	The runtime expects signing and paid-operation credentials to be provided intentionally by the operator. The package does not include fallback private keys.
#113
#114	## License
#115
#116	MIT
#117

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public