{"id":49111171,"url":"https://github.com/teodorarg/openclaw-automation-tools","last_synced_at":"2026-04-21T05:01:35.564Z","repository":{"id":352448372,"uuid":"1209394140","full_name":"TeodorArg/openclaw-automation-tools","owner":"TeodorArg","description":"OpenClaw plugin monorepo for host git workflow, workflow planning, canon, and session compaction warnings.","archived":false,"fork":false,"pushed_at":"2026-04-19T17:32:49.000Z","size":635,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T17:36:53.318Z","etag":null,"topics":["git-workflow-automation","openclaw","openclaw-plugin","openclaw-skills","workflow-planning"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TeodorArg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-13T11:38:41.000Z","updated_at":"2026-04-19T17:32:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/TeodorArg/openclaw-automation-tools","commit_stats":null,"previous_names":["teodorarg/openclaw-automation-tools"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/TeodorArg/openclaw-automation-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeodorArg%2Fopenclaw-automation-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeodorArg%2Fopenclaw-automation-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeodorArg%2Fopenclaw-automation-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeodorArg%2Fopenclaw-automation-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TeodorArg","download_url":"https://codeload.github.com/TeodorArg/openclaw-automation-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TeodorArg%2Fopenclaw-automation-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32077837,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T02:38:07.213Z","status":"ssl_error","status_checked_at":"2026-04-21T02:38:06.559Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git-workflow-automation","openclaw","openclaw-plugin","openclaw-skills","workflow-planning"],"created_at":"2026-04-21T05:01:02.860Z","updated_at":"2026-04-21T05:01:35.549Z","avatar_url":"https://github.com/TeodorArg.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openclaw-automation-tools\n\nMulti-package OpenClaw repository for five active publishable plugin packages.\n\n## Repo Docs\n\nCore canon:\n\n- [docs/PLUGIN_PACKAGE_CANON.md](docs/PLUGIN_PACKAGE_CANON.md)\n- [docs/PLUGIN_STYLE_CANON.md](docs/PLUGIN_STYLE_CANON.md)\n\nOperational canon:\n\n- [docs/OPENCLAW_NODE_INSTALL_AND_IDENTITY_CONTRACT.md](docs/OPENCLAW_NODE_INSTALL_AND_IDENTITY_CONTRACT.md)\n- [docs/CLAWHUB_PUBLISH_PREFLIGHT.md](docs/CLAWHUB_PUBLISH_PREFLIGHT.md)\n\nTogether these documents define the active repo-level package, style, node-boundary, and publish-preflight canon.\nThe live plugin packages now match the current runtime/test layout canon.\nThe package-shape canon is broader than runtime/test layout alone, and the style canon is active policy even though some enforcement still remains review/script-driven until repo tooling converges further.\n\n## Current Repo Map\n\n| Path | Current shape | Purpose |\n| --- | --- | --- |\n| [openclaw-host-git-workflow/README.md](openclaw-host-git-workflow/README.md) | publishable plugin-plus-skill package | Active bounded host-backed git/GitHub workflow package |\n| [openclaw-workflow-planner/README.md](openclaw-workflow-planner/README.md) | publishable plugin-plus-skill package | Planning-first workflow planner package with file-backed idea and plan lifecycle |\n| [openclaw-canon/README.md](openclaw-canon/README.md) | publishable plugin-plus-skill package | Operational canon package for typed status, drift diagnosis, and preview-first memory and bounded sync fixes |\n| [openclaw-session-bloat-warning/README.md](openclaw-session-bloat-warning/README.md) | publishable plugin-plus-skill package | Compaction-warning package for calm pre/post compaction session-bloat notices |\n| [openclaw-url-tailwind-scaffold/README.md](openclaw-url-tailwind-scaffold/README.md) | publishable plugin-plus-skill package | URL-driven package for bounded scaffold normalization/synthesis and Tailwind CSS v4 scaffold summaries |\n\n## Plugin Packages\n\n`openclaw-host-git-workflow/` is the active host-backed execution package in this repo.\nIts bundled skill surface is intentionally collapsed to one primary user-facing entrypoint: `send_to_git` / `отправь в гит`.\n\nIts current shipped slice covers:\n- setup doctor for repo targeting, node binding, and host readiness\n- repo-aware planning\n- branch-aware planning\n- explicit commit prep for ownership grouping, branch naming, and commit bodies\n- repo resolution\n- live host node binding\n- host preflight\n- bounded branch entry from `main` or another clean local branch into a requested non-main working branch\n- confirmed-plan validation\n- bounded push of the current non-main branch to `origin`\n- bounded PR creation into `main`\n- bounded wait for required checks\n- bounded merge of the current branch PR into `main`\n- bounded sync of local `main` from `origin/main`\n\nThe runtime now binds to a concrete host node and executes shell steps through `node.invoke` `system.run.prepare` / `system.run`, instead of treating node selection as an unbound placeholder.\nBranch-aware planning output now emits package-aware branch suggestions and commit titles, so merge-visible PR titles identify the owning package or explicit repo surface instead of a generic workflow label.\nThe package now also exposes a recommended short-session choreography of `doctor -\u003e plan_with_branches -\u003e commit_prep -\u003e bounded execution flow`, where the execution flow is the canonical push/PR/checks/merge/main-sync path and docs sync stays a separate follow-up when shipped truth changed.\n\nIts runtime layout is currently grouped under `src/runtime/host/`, `src/runtime/node/`, `src/runtime/planning/`, and `src/runtime/repo/`, with flat default tests under `src/test/`.\n\n`openclaw-workflow-planner/` is the active planning-first plugin package in this repo.\nIts shipped surface centers on file-backed `WORKFLOW_PLAN.md` state plus typed planner actions for:\n- idea creation and listing\n- typed research attachment\n- explicit `Idea Gate` decisions\n- accepted-plan creation and refresh\n- persisted plan snapshots and idea reads\n- manual task add / done / remove / reopen tracking\n- bounded implementation brief generation\n- explicit idea closure\n\nIts concrete planner entry surfaces are the bundled skills `openclaw-workflow-planner`, `openclaw-workflow-research`, and `openclaw-workflow-implementer`, plus the typed tool `workflow_planner_action`.\n\nIts runtime layout is currently grouped under `src/runtime/planning/` and `src/runtime/state/`, with flat default tests under `src/test/`.\n\n`openclaw-canon/` is the active operational-canon plugin package in this repo.\nIts shipped surface centers on a compact typed runtime contract:\n- `canon_status` for latest-known summary snapshots plus optional light refresh\n- `canon_doctor` for bounded `source`, `memory`, and `sync` diagnosis\n- `canon_fix` for preview-first `memory` and bounded `sync` fixes with confirm-token gated apply\n\nIts bundled skills are `canon-memory-hygiene` and `canon-source-of-truth-fix`, but those remain instruction layers on top of the typed tool surface rather than replacing it.\nThe plugin keeps only minimal file-backed domain state for latest summaries, doctor reports, and short-lived preview tokens.\n\nIts runtime layout is currently grouped under `src/runtime/doctor/`, `src/runtime/fix/`, `src/runtime/report/`, `src/runtime/state/`, and `src/runtime/status/`, with flat default tests under `src/test/`.\n\n`openclaw-session-bloat-warning/` is the active compaction-warning plugin package in this repo.\nIts shipped surface combines the official compaction lifecycle with bounded visible early-warning delivery:\n- `before_compaction` for a calm warning before compaction starts\n- `after_compaction` for a short continuation note after compaction finishes when the hook payload exposes a writable `messages` array\n- observe-only `llm_input` and `llm_output` signal capture\n- visible early-warning delivery on `before_agent_reply`\n- plugin-owned dedupe plus cooldown state for per-session warning ceilings\n\nIts bundled skill surface currently centers on `session-bloat-warning`.\nThe live slice stays bounded to calm warning copy, visible early warning, persisted dedupe/cooldown state, and timeout/lane-pressure/no-reply runtime-risk signal reuse rather than runtime-owned recovery or bounded handoff summarization.\n\nIts runtime layout is currently grouped under `src/runtime/config/`, `src/runtime/hooks/`, `src/runtime/state/`, and `src/runtime/text/`, with flat default tests under `src/test/`.\n\n`openclaw-url-tailwind-scaffold/` is the active URL-analysis plugin-plus-skill package in this repo.\nIts shipped surface centers on one typed tool and one bundled skill:\n- `url_tailwind_scaffold_action`\n- bundled skill `openclaw-url-tailwind-scaffold`\n- working action `analyze_reference_page`\n\nIts current shipped slice covers:\n- reference-URL-driven scaffold synthesis without live page fetch or inspection\n- bounded declared acquisition metadata from the request contract\n- normalized shell regions for `app-shell`, `sidebar`, `header`, `content`, and `footer`\n- explicit synthetic `sourceBacked` versus `inferred` status fields derived from request mode\n- Tailwind CSS v4 scaffold summary output with a generated file-tree suggestion\n- raw slash-command dispatch through either a plain URL or a small JSON payload\n\nIts runtime layout is currently grouped under `src/runtime/analysis/` and `src/runtime/contract/`, with flat default tests under `src/test/`.\n\n## Gateway Vs Node Host\n\nIn this repo the canonical baseline is the Gateway, not a repo-owned node-host package.\n\n- `openclaw-gateway` in Docker is the always-on Gateway/WebSocket runtime for OpenClaw\n- `node host` is a separate headless OpenClaw node running on the machine where `system.run` / `system.which` must execute for real\n- if you need local repos, host git, `ssh`, `gh`, push, PR creation, or required-check polling, run that node on the corresponding host machine instead of trying to make baseline `openclaw-gateway` own those capabilities\n\nThis split matters:\n- the gateway accepts operator and node connections, stores pairing state, and coordinates runtime\n- the node host connects to the gateway and exposes the command surface of its own machine\n- this repo's baseline is intentionally narrow and does not treat container-runtime `git push` or `PR creation` as the canonical path\n\nFor the full host-node install, pairing, Windows, and remote-loopback/SSH-tunnel contract, see [docs/OPENCLAW_NODE_INSTALL_AND_IDENTITY_CONTRACT.md](docs/OPENCLAW_NODE_INSTALL_AND_IDENTITY_CONTRACT.md).\n\n## Install\n\nLocal development install:\n\n```bash\nnvm use || nvm install\ncd openclaw-host-git-workflow\npnpm install\npnpm build\ncd ..\nopenclaw plugins install -l ./openclaw-host-git-workflow\n```\n\nRepeat the same package-local `pnpm install`, `pnpm build`, and `openclaw plugins install -l ...` flow for `openclaw-workflow-planner/` when working on the planner package.\nRepeat the same package-local `pnpm install`, `pnpm build`, and `openclaw plugins install -l ...` flow for `openclaw-canon/` when working on the canon package.\nRepeat the same package-local `pnpm install`, `pnpm build`, and `openclaw plugins install -l ...` flow for `openclaw-session-bloat-warning/` when working on the compaction-warning package.\nRepeat the same package-local `pnpm install`, `pnpm build`, and `openclaw plugins install -l ...` flow for `openclaw-url-tailwind-scaffold/` when working on the URL-driven scaffold package.\n\nFor a Docker gateway with local plugin directories mounted into `/home/node/tools`, do not batch multiple linked installs inside one long-lived `docker exec ... sh -lc '...'` shell. A config-changing `openclaw plugins install -l ...` can trigger gateway reload and kill that shell after the first install.\n\nTreat the batch reinstall flow as runtime-repo orchestration, not plugin-package canon. Use the helper or equivalent install/wait/verify loop from the Docker/OpenClaw runtime repo that owns the live `openclaw-gateway` container.\n\nFor a same-machine `Docker Gateway on macOS -\u003e macOS host node -\u003e local plugin path` setup, do not treat plugin install as the first step. The practical order is:\n\n1. configure the local CLI profile with `gateway.remote.url`\n2. set node-host auth with `OPENCLAW_GATEWAY_TOKEN` or `gateway.auth.token` for local-mode node install/run\n3. approve the local CLI/operator pairing request on the gateway\n4. install and connect the dedicated host node\n5. build and install `openclaw-host-git-workflow`\n6. enable the plugin and set `nodeSelector` when multiple eligible nodes exist\n\nToken auth and pairing approval are separate gates in this flow. A valid token does not replace operator pairing approval, and host-node pairing can still require its own approval step after install/run.\n\nMinimal same-machine Docker gateway bootstrap:\n\n```bash\nopenclaw config set gateway.remote.url ws://127.0.0.1:18789\nexport OPENCLAW_GATEWAY_TOKEN=\"\u003cgateway-token\u003e\"\nopenclaw devices list\nopenclaw devices approve \u003crequestId\u003e\nopenclaw node install --host 127.0.0.1 --port 18789 --display-name \"openclaw-docker-host-git\"\n```\n\nRecommended macOS hardening before routine use:\n\n```bash\nnode -e 'const fs=require(\"fs\"); const p=process.env.HOME+\"/.openclaw/openclaw.json\"; const raw=JSON.parse(fs.readFileSync(p,\"utf8\")); raw.browser ??= {}; raw.browser.enabled = false; raw.gateway ??= {}; raw.gateway.nodes ??= {}; raw.gateway.nodes.browser = { ...(raw.gateway.nodes.browser ?? {}), mode: \"off\" }; raw.nodeHost ??= {}; raw.nodeHost.browserProxy = { ...(raw.nodeHost.browserProxy ?? {}), enabled: false }; fs.writeFileSync(p, JSON.stringify(raw,null,2)+\"\\n\");'\nopenclaw node restart\n```\n\nThis reduces browser-related surface area, but it does not fully convert the generic `node` host into a strict system-only process from the perspective of macOS privacy prompts.\n\nRegistry install:\n\n```bash\nopenclaw plugins install clawhub:@openclaw/openclaw-host-git-workflow\nopenclaw plugins install clawhub:@openclaw/openclaw-workflow-planner\nopenclaw plugins install clawhub:@openclaw/openclaw-canon\nopenclaw plugins install clawhub:@openclaw/openclaw-session-bloat-warning\nopenclaw plugins install clawhub:@openclaw/openclaw-url-tailwind-scaffold\n```\n\n## Verification\n\nFor `openclaw-host-git-workflow/`:\n\n```bash\ncd openclaw-host-git-workflow\npnpm lint\npnpm typecheck\npnpm build\npnpm test\npnpm pack:smoke\n```\n\nFor `openclaw-workflow-planner/`:\n\n```bash\ncd openclaw-workflow-planner\npnpm lint\npnpm typecheck\npnpm build\npnpm test\npnpm pack:smoke\n```\n\nFor `openclaw-canon/`:\n\n```bash\ncd openclaw-canon\npnpm lint\npnpm typecheck\npnpm build\npnpm test\npnpm pack:smoke\n```\n\nFor `openclaw-session-bloat-warning/`:\n\n```bash\ncd openclaw-session-bloat-warning\npnpm lint\npnpm typecheck\npnpm build\npnpm test\npnpm pack:smoke\n```\n\nFor `openclaw-url-tailwind-scaffold/`:\n\n```bash\ncd openclaw-url-tailwind-scaffold\npnpm lint\npnpm typecheck\npnpm build\npnpm test\npnpm pack:smoke\n```\n\nFor publish workflow details and the manual pre-publish gate beyond CI minimum, use [docs/CLAWHUB_PUBLISH_PREFLIGHT.md](docs/CLAWHUB_PUBLISH_PREFLIGHT.md).\n\n## Repo Facts\n\n- The repo root does not ship a `package.json`, `pnpm-workspace.yaml`, or `openclaw.plugin.json`.\n- Local development is pinned to Node `24.13.0` via `.nvmrc`.\n- Repo-local planning scratch files belong only under ignored `.local-planning/`.\n- The repo currently ships five publishable plugin packages: `openclaw-host-git-workflow/`, `openclaw-workflow-planner/`, `openclaw-canon/`, `openclaw-session-bloat-warning/`, and `openclaw-url-tailwind-scaffold/`.\n- Product-level `openclaw node` install/runtime ownership belongs to OpenClaw product docs, not to an invented repo-local package surface.\n- Package-structure and code-style canon now live in `docs/PLUGIN_PACKAGE_CANON.md` and `docs/PLUGIN_STYLE_CANON.md`.\n- Repo-local host-lane boundary, node identity, and source-of-truth guidance now live directly in `docs/OPENCLAW_NODE_INSTALL_AND_IDENTITY_CONTRACT.md` plus the relevant live package docs.\n- Repo-local publish/preflight guidance now lives in `docs/CLAWHUB_PUBLISH_PREFLIGHT.md`.\n- The live plugin packages follow the broader local package canon, including domain-grouped runtime modules under `src/runtime/`, flat default tests under `src/test/`, required package docs/metadata, and package `files` allowlists that keep shipped `dist/**` artifacts in packed tarballs despite the repo-root `dist/` ignore; package-local `.npmignore` is optional rather than a required baseline.\n- In Docker-gateway setups, gateway token configuration and device pairing are separate gates; a valid `gateway.remote.token` does not replace CLI/operator pairing approval.\n- On macOS, config hardening can reduce browser-related node surface, but a generic `node` host can still trigger unrelated TCC prompts unless you isolate it by user/session/VM/host.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodorarg%2Fopenclaw-automation-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteodorarg%2Fopenclaw-automation-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteodorarg%2Fopenclaw-automation-tools/lists"}