@@ -38,8 +38,8 @@ or 1Password service-account refresh stacks.
3838
3939For services and agents:
4040
41- 1 . Create or choose the correct Infisical project, environment, and folder path
42- for the runtime.
41+ 1 . Create or choose the correct Infisical project and environment for the
42+ runtime.
43432 . Create a machine identity in the same Infisical organization and grant it
4444 access to that project/path.
45453 . Configure the devbox user once with
@@ -69,16 +69,17 @@ One-time setup:
6969```
7070
7171The helper prompts locally for the Infisical domain, project ID, environment,
72- default secret path , machine identity client ID, and machine identity client
72+ machine identity name , machine identity client ID, and machine identity client
7373secret. Humans should source the initial client ID/secret from their secret
7474manager, usually 1Password or Infisical, and enter them locally. Do not paste
7575them into agent chat.
7676
7777It writes non-secret selectors to ` ~/.config/uinaf/devbox.env ` and machine
7878credentials to ` ~/.config/uinaf/infisical-machine.env ` . Both files must be mode
7979` 0600 ` . The helper refuses to continue when the Infisical CLI has an
80- authenticated human ` user ` session, mints a machine token, and verifies the
81- machine identity can read the configured secret path before writing config.
80+ authenticated human ` user ` session and verifies the machine identity can mint a
81+ token before writing config. It does not persist a default secret path; paths
82+ belong at the command boundary.
8283
8384Routine command-boundary use:
8485
@@ -89,7 +90,7 @@ Routine command-boundary use:
8990 --token "$INFISICAL_TOKEN" \
9091 --projectId "$INFISICAL_PROJECT_ID" \
9192 --env "$INFISICAL_ENV" \
92- --path "$INFISICAL_SECRET_PATH " \
93+ --path "/example-devbox/openclaw-env " \
9394 --format dotenv \
9495 --output-file "$HOME/.openclaw/.env" \
9596 --silent
@@ -159,10 +160,12 @@ Before treating a devbox as agent-ready:
1591604 . Verify runtime dotenv files are owner-only and are not workspace symlinks.
160161
161162` ./scripts/verify/devbox-services.sh ` checks the Infisical CLI, local
162- runtime-file boundary, owner-only config modes, and machine identity access. A
163- missing persistent machine identity config fails by default. Set
164- ` INFISICAL_MACHINE_AUTH_REQUIRED=0 ` only for repo-local smoke checks on a
165- machine that is not acting as an agent devbox.
163+ runtime-file boundary, owner-only config modes, and machine identity token
164+ minting. Set ` INFISICAL_SECRET_PATH=/some/path ` only when you want that check
165+ to also prove access to a specific command-boundary path. A missing persistent
166+ machine identity config fails by default. Set ` INFISICAL_MACHINE_AUTH_REQUIRED=0 `
167+ only for repo-local smoke checks on a machine that is not acting as an agent
168+ devbox.
166169
167170## Secret Topology
168171
@@ -214,7 +217,6 @@ PROCESS_COMPOSE_SOCKET="/Users/example/.local/run/process-compose.sock"
214217INFISICAL_DOMAIN=https://eu.infisical.com/api
215218INFISICAL_PROJECT_ID=example-project-id
216219INFISICAL_ENV=dev
217- INFISICAL_SECRET_PATH=/example-devbox/ssh
218220```
219221
220222The file should be mode ` 0600 ` . Persistent machine credentials live separately
0 commit comments