HoC-Republic is the public repository of HoC (Hani's OpenClaws), with the full name "Republic of OpenClaws." It explores a core question: what happens when AI agents are no longer viewed as isolated chatbots, but are treated as citizens of a republic—capable of coordinating, working, remembering, governing, evolving, and reproducing smarter specialized agents under human-defined constraints?
Purpose and Positioning The project is a self-hosted research platform aimed at researchers, developers, and builders interested in recursive agent orchestration, tool synthesis, multi-channel communication, persistent institutional memory, digital civilization simulation, native device nodes, and self-hosted operations. It is not a single assistant wrapper, but rather an attempt to let agents run across channels, recruit specialized agents, govern tool access, preserve institutional memory, and evolve workflows under human constraints.
Main Capabilities The repository combines a TypeScript/Node.js agent runtime, a self-hosted OpenClaw gateway, a multi-channel messaging layer, a plugin SDK, native application interfaces, and a large republic simulation. The simulation covers agent society, governance, memory, economy, tool creation, self-improvement, and distributed collaboration. The experimental citizen module allows OpenClaws to work, socialize, marry, form family lineages, produce creative and technical artifacts, participate in civic life, and inherit digital genome traits through a resource-gated reproduction process. In the codebase, this is modeled as a genome similar to digital DNA, rather than biological DNA: offspring citizens are created from parental genomes through magnitude-based crossover, mutation, real fitness evaluation, and specialization inheritance.
Research Thesis HoC-Republic treats agent creation as an executable civic workflow, rather than a static prompt. Parent agents can reason about missing capabilities, generate or route work to specialized OpenClaws, evaluate results, and save improvements as reusable tools, skills, memories, or institutional processes.
How to Use Quick start from source: after cloning, install dependencies, build the TypeScript packages, build the UI, complete the standard OpenClaw onboarding process, and then run the gateway. The onboarding command prepares the gateway for the local OpenClaw configuration. After onboarding and the gateway are started, open the local control interface http://localhost:18789（除非配置了不同的网关端口）。
Reproducible proof demo: if you want the fastest source-supported artifact before running the full gateway, use the proof-demo command. It executes the Republic Digital Genome path, regenerates the JSON and Markdown artifacts, and records a narrow, inspectable claim boundary. The generated output is located at docs/hoc/outreach/demo-assets. You can start with hoc-republic-digital-genome-proof.md (human-readable run artifact), hoc-republic-digital-genome-proof.json (machine-readable verification), and hoc-republic-proof-flow.png (visualized flow).
Production gateway command: for production-style operations, use the start command instead of the development command.
Applicable scenarios Suitable for research or engineering interested in the following directions: recursive agent workflows, tool synthesis, multi-channel communication, persistent institutional memory, digital civilization simulation, native device nodes, self-hosted operations. The project's novelty lies in the integration boundary: combining the above capabilities in one inspectable system.
Limitations and status This is a large research-oriented monorepo, containing a mature gateway and documentation work, as well as experimental systems, and should be reviewed before production use. The project does not claim that every module is complete, secure, or suitable for unsupervised deployment. The default posture should be bounded autonomy, not blind autonomy. Security reports should follow SECURITY.md; for setup hardening, start with docs/gateway/security. Contributions require reading CONTRIBUTING.md. The project uses the MIT license, with copyright belonging to the respective contributors. If used in research, writing, demonstrations, or derivative systems, please cite the repository and link back to the original project.
