@heretek-ai/openclaw 2026.3.23 → 2026.3.25

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/CHANGELOG.md +1 -1
  2. package/README.md +102 -507
  3. package/dist/.buildstamp +1 -1
  4. package/dist/dns-cli-A_DUY2mI.js +2 -2
  5. package/dist/env-overrides-DbK0fm-W.js +1 -1
  6. package/dist/paths-ViKUYWUK.js +1 -1
  7. package/dist/pi-embedded-doAakoP8.js +6 -6
  8. package/dist/plugin-sdk/src/agents/subagent-orphan-recovery.d.ts +1 -1
  9. package/dist/plugin-sdk/src/config/paths.d.ts +1 -1
  10. package/dist/plugin-sdk/src/config/types.gateway.d.ts +1 -1
  11. package/dist/plugin-sdk/src/cron/service/state.d.ts +3 -3
  12. package/dist/plugin-sdk/src/infra/exec-obfuscation-detect.d.ts +1 -1
  13. package/dist/plugin-sdk/src/infra/outbound/agent-delivery.d.ts +1 -1
  14. package/dist/plugin-sdk/src/infra/outbound/sanitize-text.d.ts +2 -2
  15. package/dist/plugin-sdk/src/infra/outbound/targets.d.ts +1 -1
  16. package/dist/prompt-select-styled-CR725EJM.js +2 -2
  17. package/dist/register.setup-CVyj44Ne.js +1 -1
  18. package/dist/server-startup-matrix-migration-W3FCsqhA.js +1 -1
  19. package/dist/setup.finalize-2dj2-0Le.js +1 -1
  20. package/dist/subagent-orphan-recovery-BsV6yVqW.js +1 -1
  21. package/dist/update-cli-CUVntZUl.js +1 -1
  22. package/docs/automation/hooks.md +1 -1
  23. package/docs/channels/feishu.md +1 -1
  24. package/docs/channels/group-messages.md +1 -1
  25. package/docs/channels/irc.md +1 -1
  26. package/docs/channels/msteams.md +1 -1
  27. package/docs/channels/signal.md +1 -1
  28. package/docs/cli/config.md +2 -2
  29. package/docs/cli/doctor.md +1 -1
  30. package/docs/cli/gateway.md +1 -1
  31. package/docs/cli/sandbox.md +1 -1
  32. package/docs/cli/setup.md +1 -1
  33. package/docs/cli/update.md +1 -1
  34. package/docs/concepts/agent-workspace.md +3 -3
  35. package/docs/concepts/agent.md +1 -1
  36. package/docs/concepts/context-engine.md +1 -1
  37. package/docs/concepts/multi-agent.md +2 -2
  38. package/docs/concepts/retry.md +1 -1
  39. package/docs/concepts/session.md +2 -2
  40. package/docs/concepts/typebox.md +1 -1
  41. package/docs/diagnostics/flags.md +4 -4
  42. package/docs/docs.json +2 -2
  43. package/docs/gateway/bonjour.md +2 -2
  44. package/docs/gateway/bridge-protocol.md +1 -1
  45. package/docs/gateway/configuration-examples.md +2 -2
  46. package/docs/gateway/configuration-reference.md +4 -4
  47. package/docs/gateway/configuration.md +5 -5
  48. package/docs/gateway/discovery.md +1 -1
  49. package/docs/gateway/doctor.md +3 -3
  50. package/docs/gateway/health.md +1 -1
  51. package/docs/gateway/logging.md +1 -1
  52. package/docs/gateway/security/index.md +4 -4
  53. package/docs/gateway/troubleshooting.md +1 -1
  54. package/docs/help/environment.md +2 -2
  55. package/docs/help/faq.md +17 -17
  56. package/docs/help/testing.md +1 -1
  57. package/docs/index.html +230 -0
  58. package/docs/index.md +1 -1
  59. package/docs/install/ansible.md +9 -9
  60. package/docs/install/docker.md +5 -5
  61. package/docs/install/fly.md +1 -1
  62. package/docs/install/gcp.md +1 -1
  63. package/docs/install/hetzner.md +1 -1
  64. package/docs/install/index.md +2 -2
  65. package/docs/install/kubernetes.md +1 -1
  66. package/docs/install/macos-vm.md +1 -1
  67. package/docs/install/podman.md +4 -4
  68. package/docs/install/updating.md +1 -1
  69. package/docs/ja-JP/index.md +1 -1
  70. package/docs/logging.md +4 -4
  71. package/docs/nodes/talk.md +1 -1
  72. package/docs/perplexity.md +1 -1
  73. package/docs/platforms/android.md +2 -2
  74. package/docs/platforms/mac/bundled-gateway.md +1 -1
  75. package/docs/platforms/mac/dev-setup.md +2 -2
  76. package/docs/platforms/mac/health.md +1 -1
  77. package/docs/platforms/mac/signing.md +2 -2
  78. package/docs/platforms/mac/skills.md +1 -1
  79. package/docs/platforms/raspberry-pi.md +1 -1
  80. package/docs/platforms/windows.md +1 -1
  81. package/docs/providers/minimax.md +1 -1
  82. package/docs/reference/RELEASING.md +2 -2
  83. package/docs/reference/test.md +2 -2
  84. package/docs/reference/wizard.md +2 -2
  85. package/docs/start/lore.md +1 -1
  86. package/docs/start/openclaw.md +1 -1
  87. package/docs/start/setup.md +2 -2
  88. package/docs/start/wizard-cli-reference.md +2 -2
  89. package/docs/tm4-deployment-testing.md +1 -1
  90. package/docs/tools/browser-linux-troubleshooting.md +1 -1
  91. package/docs/tools/browser-wsl2-windows-remote-cdp-troubleshooting.md +1 -1
  92. package/docs/tools/browser.md +1 -1
  93. package/docs/tools/diffs.md +1 -1
  94. package/docs/tools/perplexity-search.md +1 -1
  95. package/docs/tools/skills-config.md +1 -1
  96. package/docs/tools/skills.md +2 -2
  97. package/docs/web/control-ui.md +1 -1
  98. package/docs/zh-CN/AGENTS.md +1 -1
  99. package/docs/zh-CN/automation/hooks.md +1 -1
  100. package/docs/zh-CN/channels/feishu.md +1 -1
  101. package/docs/zh-CN/channels/group-messages.md +1 -1
  102. package/docs/zh-CN/channels/imessage.md +1 -1
  103. package/docs/zh-CN/channels/msteams.md +1 -1
  104. package/docs/zh-CN/channels/whatsapp.md +2 -2
  105. package/docs/zh-CN/cli/doctor.md +1 -1
  106. package/docs/zh-CN/cli/gateway.md +1 -1
  107. package/docs/zh-CN/cli/sandbox.md +1 -1
  108. package/docs/zh-CN/cli/setup.md +1 -1
  109. package/docs/zh-CN/concepts/agent-workspace.md +3 -3
  110. package/docs/zh-CN/concepts/agent.md +1 -1
  111. package/docs/zh-CN/concepts/multi-agent.md +2 -2
  112. package/docs/zh-CN/concepts/retry.md +1 -1
  113. package/docs/zh-CN/concepts/session.md +1 -1
  114. package/docs/zh-CN/concepts/typebox.md +1 -1
  115. package/docs/zh-CN/diagnostics/flags.md +4 -4
  116. package/docs/zh-CN/gateway/bonjour.md +2 -2
  117. package/docs/zh-CN/gateway/bridge-protocol.md +1 -1
  118. package/docs/zh-CN/gateway/configuration-examples.md +2 -2
  119. package/docs/zh-CN/gateway/configuration-reference.md +5 -5
  120. package/docs/zh-CN/gateway/configuration.md +5 -5
  121. package/docs/zh-CN/gateway/discovery.md +1 -1
  122. package/docs/zh-CN/gateway/doctor.md +3 -3
  123. package/docs/zh-CN/gateway/health.md +1 -1
  124. package/docs/zh-CN/gateway/index.md +1 -1
  125. package/docs/zh-CN/gateway/logging.md +1 -1
  126. package/docs/zh-CN/gateway/security/index.md +2 -2
  127. package/docs/zh-CN/gateway/troubleshooting.md +8 -8
  128. package/docs/zh-CN/help/environment.md +1 -1
  129. package/docs/zh-CN/help/faq.md +16 -16
  130. package/docs/zh-CN/help/testing.md +1 -1
  131. package/docs/zh-CN/index.md +1 -1
  132. package/docs/zh-CN/install/ansible.md +9 -9
  133. package/docs/zh-CN/install/docker.md +1 -1
  134. package/docs/zh-CN/install/fly.md +1 -1
  135. package/docs/zh-CN/install/gcp.md +1 -1
  136. package/docs/zh-CN/install/hetzner.md +1 -1
  137. package/docs/zh-CN/install/index.md +4 -4
  138. package/docs/zh-CN/install/macos-vm.md +1 -1
  139. package/docs/zh-CN/install/nix.md +1 -1
  140. package/docs/zh-CN/install/updating.md +2 -2
  141. package/docs/zh-CN/logging.md +4 -4
  142. package/docs/zh-CN/nodes/index.md +1 -1
  143. package/docs/zh-CN/nodes/talk.md +1 -1
  144. package/docs/zh-CN/platforms/android.md +1 -1
  145. package/docs/zh-CN/platforms/mac/bundled-gateway.md +1 -1
  146. package/docs/zh-CN/platforms/mac/dev-setup.md +2 -2
  147. package/docs/zh-CN/platforms/mac/health.md +1 -1
  148. package/docs/zh-CN/platforms/mac/signing.md +2 -2
  149. package/docs/zh-CN/platforms/mac/skills.md +1 -1
  150. package/docs/zh-CN/platforms/raspberry-pi.md +1 -1
  151. package/docs/zh-CN/platforms/windows.md +1 -1
  152. package/docs/zh-CN/providers/minimax.md +1 -1
  153. package/docs/zh-CN/reference/RELEASING.md +2 -2
  154. package/docs/zh-CN/reference/test.md +1 -1
  155. package/docs/zh-CN/reference/wizard.md +2 -2
  156. package/docs/zh-CN/start/lore.md +1 -1
  157. package/docs/zh-CN/start/openclaw.md +2 -2
  158. package/docs/zh-CN/start/quickstart.md +1 -1
  159. package/docs/zh-CN/start/setup.md +2 -2
  160. package/docs/zh-CN/start/wizard-cli-reference.md +2 -2
  161. package/docs/zh-CN/tools/browser-linux-troubleshooting.md +1 -1
  162. package/docs/zh-CN/tools/browser.md +1 -1
  163. package/docs/zh-CN/tools/skills-config.md +1 -1
  164. package/docs/zh-CN/tools/skills.md +2 -2
  165. package/docs/zh-CN/tools/web.md +1 -1
  166. package/docs/zh-CN/web/control-ui.md +1 -1
  167. package/package.json +25 -6
  168. package/skills/canvas/SKILL.md +3 -3
  169. package/skills/curiosity-engine/SKILL.md +2 -2
  170. package/skills/gh-issues/SKILL.md +6 -6
  171. package/skills/heretek-theme/SKILL.md +169 -0
  172. package/skills/openai-whisper-api/SKILL.md +1 -1
  173. package/skills/sherpa-onnx-tts/SKILL.md +1 -1
  174. package/skills/triad-unity-monitor/SKILL.md +9 -9
@@ -9,7 +9,7 @@ title: "Configuration"
9
9
 
10
10
  # Configuration
11
11
 
12
- OpenClaw reads an optional <Tooltip tip="JSON5 supports comments and trailing commas">**JSON5**</Tooltip> config from `~/.openclaw/openclaw.json`.
12
+ OpenClaw reads an optional <Tooltip tip="JSON5 supports comments and trailing commas">**JSON5**</Tooltip> config from `~/.Heretek-AI/openclaw.json`.
13
13
 
14
14
  If the file is missing, OpenClaw uses safe defaults. Common reasons to add a config:
15
15
 
@@ -26,7 +26,7 @@ See the [full reference](/gateway/configuration-reference) for every available f
26
26
  ## Minimal config
27
27
 
28
28
  ```json5
29
- // ~/.openclaw/openclaw.json
29
+ // ~/.Heretek-AI/openclaw.json
30
30
  {
31
31
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
32
32
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
@@ -54,7 +54,7 @@ See the [full reference](/gateway/configuration-reference) for every available f
54
54
  The Control UI renders a form from the config schema, with a **Raw JSON** editor as an escape hatch.
55
55
  </Tab>
56
56
  <Tab title="Direct edit">
57
- Edit `~/.openclaw/openclaw.json` directly. The Gateway watches the file and applies changes automatically (see [hot reload](#config-hot-reload)).
57
+ Edit `~/.Heretek-AI/openclaw.json` directly. The Gateway watches the file and applies changes automatically (see [hot reload](#config-hot-reload)).
58
58
  </Tab>
59
59
  </Tabs>
60
60
 
@@ -413,7 +413,7 @@ When validation fails:
413
413
  Use `$include` to organize large configs:
414
414
 
415
415
  ```json5
416
- // ~/.openclaw/openclaw.json
416
+ // ~/.Heretek-AI/openclaw.json
417
417
  {
418
418
  gateway: { port: 18789 },
419
419
  agents: { $include: "./agents.json5" },
@@ -435,7 +435,7 @@ When validation fails:
435
435
 
436
436
  ## Config hot reload
437
437
 
438
- The Gateway watches `~/.openclaw/openclaw.json` and applies changes automatically — no manual restart needed for most settings.
438
+ The Gateway watches `~/.Heretek-AI/openclaw.json` and applies changes automatically — no manual restart needed for most settings.
439
439
 
440
440
  ### Reload modes
441
441
 
@@ -78,7 +78,7 @@ Security notes:
78
78
  Disable/override:
79
79
 
80
80
  - `OPENCLAW_DISABLE_BONJOUR=1` disables advertising.
81
- - `gateway.bind` in `~/.openclaw/openclaw.json` controls the Gateway bind mode.
81
+ - `gateway.bind` in `~/.Heretek-AI/openclaw.json` controls the Gateway bind mode.
82
82
  - `OPENCLAW_SSH_PORT` overrides the SSH port advertised in TXT (defaults to 22).
83
83
  - `OPENCLAW_TAILNET_DNS` publishes a `tailnetDns` hint (MagicDNS).
84
84
  - `OPENCLAW_CLI_PATH` overrides the advertised CLI path.
@@ -53,7 +53,7 @@ Scan system services for extra gateway installs (launchd/systemd/schtasks).
53
53
  If you want to review changes before writing, open the config file first:
54
54
 
55
55
  ```bash
56
- cat ~/.openclaw/openclaw.json
56
+ cat ~/.Heretek-AI/openclaw.json
57
57
  ```
58
58
 
59
59
  ## What it does (summary)
@@ -106,7 +106,7 @@ Doctor will:
106
106
 
107
107
  - Explain which legacy keys were found.
108
108
  - Show the migration it applied.
109
- - Rewrite `~/.openclaw/openclaw.json` with the updated schema.
109
+ - Rewrite `~/.Heretek-AI/openclaw.json` with the updated schema.
110
110
 
111
111
  The Gateway also auto-runs doctor migrations on startup when it detects a
112
112
  legacy config format, so stale configs are repaired without manual intervention.
@@ -239,7 +239,7 @@ Doctor checks:
239
239
  split between installs).
240
240
  - **Remote mode reminder**: if `gateway.mode=remote`, doctor reminds you to run
241
241
  it on the remote host (the state lives there).
242
- - **Config file permissions**: warns if `~/.openclaw/openclaw.json` is
242
+ - **Config file permissions**: warns if `~/.Heretek-AI/openclaw.json` is
243
243
  group/world readable and offers to tighten to `600`.
244
244
 
245
245
  ### 5) Model auth health (OAuth expiry)
@@ -16,7 +16,7 @@ Short guide to verify channel connectivity without guessing.
16
16
  - `openclaw status --deep` — also probes the running Gateway (per-channel probes when supported).
17
17
  - `openclaw health --json` — asks the running Gateway for a full health snapshot (WS-only; no direct Baileys socket).
18
18
  - Send `/status` as a standalone message in WhatsApp/WebChat to get a status reply without invoking the agent.
19
- - Logs: tail `/tmp/openclaw/openclaw-*.log` and filter for `web-heartbeat`, `web-reconnect`, `web-auto-reply`, `web-inbound`.
19
+ - Logs: tail `/tmp/Heretek-AI/openclaw-*.log` and filter for `web-heartbeat`, `web-reconnect`, `web-auto-reply`, `web-inbound`.
20
20
 
21
21
  ## Deep diagnostics
22
22
 
@@ -19,7 +19,7 @@ OpenClaw has two log “surfaces”:
19
19
 
20
20
  - Default rolling log file is under `/tmp/openclaw/` (one file per day): `openclaw-YYYY-MM-DD.log`
21
21
  - Date uses the gateway host's local timezone.
22
- - The log file path and level can be configured via `~/.openclaw/openclaw.json`:
22
+ - The log file path and level can be configured via `~/.Heretek-AI/openclaw.json`:
23
23
  - `logging.file`
24
24
  - `logging.level`
25
25
 
@@ -139,7 +139,7 @@ Before opening a GHSA, verify all of these:
139
139
  1. Repro still works on latest `main` or latest release.
140
140
  2. Report includes exact code path (`file`, function, line range) and tested version/commit.
141
141
  3. Impact crosses a documented trust boundary (not just prompt injection).
142
- 4. Claim is not listed in [Out of Scope](https://github.com/openclaw/openclaw/blob/main/SECURITY.md#out-of-scope).
142
+ 4. Claim is not listed in [Out of Scope](https://github.com/Heretek-AI/openclaw/blob/main/SECURITY.md#out-of-scope).
143
143
  5. Existing advisories were checked for duplicates (reuse canonical GHSA when applicable).
144
144
  6. Deployment assumptions are explicit (loopback/local vs exposed, trusted vs untrusted operators).
145
145
 
@@ -229,7 +229,7 @@ High-signal `checkId` values you will most likely see in real deployments (not e
229
229
  | `checkId` | Severity | Why it matters | Primary fix key/path | Auto-fix |
230
230
  | ------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- | -------- |
231
231
  | `fs.state_dir.perms_world_writable` | critical | Other users/processes can modify full OpenClaw state | filesystem perms on `~/.openclaw` | yes |
232
- | `fs.config.perms_writable` | critical | Others can change auth/tool policy/config | filesystem perms on `~/.openclaw/openclaw.json` | yes |
232
+ | `fs.config.perms_writable` | critical | Others can change auth/tool policy/config | filesystem perms on `~/.Heretek-AI/openclaw.json` | yes |
233
233
  | `fs.config.perms_world_readable` | critical | Config can expose tokens/settings | filesystem perms on config file | yes |
234
234
  | `gateway.bind_no_auth` | critical | Remote bind without shared secret | `gateway.bind`, `gateway.auth.*` | no |
235
235
  | `gateway.loopback_no_auth` | critical | Reverse-proxied loopback may become unauthenticated | `gateway.auth.*`, proxy setup | no |
@@ -620,7 +620,7 @@ Guidance:
620
620
 
621
621
  Keep config + state private on the gateway host:
622
622
 
623
- - `~/.openclaw/openclaw.json`: `600` (user read/write only)
623
+ - `~/.Heretek-AI/openclaw.json`: `600` (user read/write only)
624
624
  - `~/.openclaw`: `700` (user only)
625
625
 
626
626
  `openclaw doctor` can warn and offer to tighten these permissions.
@@ -1168,7 +1168,7 @@ If your AI does something bad:
1168
1168
 
1169
1169
  ### Audit
1170
1170
 
1171
- 1. Check Gateway logs: `/tmp/openclaw/openclaw-YYYY-MM-DD.log` (or `logging.file`).
1171
+ 1. Check Gateway logs: `/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log` (or `logging.file`).
1172
1172
  2. Review the relevant transcript(s): `~/.openclaw/agents/<agentId>/sessions/*.jsonl`.
1173
1173
  3. Review recent config changes (anything that could have widened access: `gateway.bind`, `gateway.auth`, dm/group policies, `tools.elevated`, plugin changes).
1174
1174
  4. Re-run `openclaw security audit --deep` and confirm critical findings are resolved.
@@ -169,7 +169,7 @@ Look for:
169
169
 
170
170
  Common signatures:
171
171
 
172
- - `Gateway start blocked: set gateway.mode=local` → local gateway mode is not enabled. Fix: set `gateway.mode="local"` in your config (or run `openclaw configure`). If you are running OpenClaw via Podman using the dedicated `openclaw` user, the config lives at `~openclaw/.openclaw/openclaw.json`.
172
+ - `Gateway start blocked: set gateway.mode=local` → local gateway mode is not enabled. Fix: set `gateway.mode="local"` in your config (or run `openclaw configure`). If you are running OpenClaw via Podman using the dedicated `openclaw` user, the config lives at `~openclaw/.Heretek-AI/openclaw.json`.
173
173
  - `refusing to bind gateway ... without auth` → non-loopback bind without token/password.
174
174
  - `another gateway instance is already listening` / `EADDRINUSE` → port conflict.
175
175
 
@@ -16,7 +16,7 @@ OpenClaw pulls environment variables from multiple sources. The rule is **never
16
16
  1. **Process environment** (what the Gateway process already has from the parent shell/daemon).
17
17
  2. **`.env` in the current working directory** (dotenv default; does not override).
18
18
  3. **Global `.env`** at `~/.openclaw/.env` (aka `$OPENCLAW_STATE_DIR/.env`; does not override).
19
- 4. **Config `env` block** in `~/.openclaw/openclaw.json` (applied only if missing).
19
+ 4. **Config `env` block** in `~/.Heretek-AI/openclaw.json` (applied only if missing).
20
20
  5. **Optional login-shell import** (`env.shellEnv.enabled` or `OPENCLAW_LOAD_SHELL_ENV=1`), applied only for missing expected keys.
21
21
 
22
22
  If the config file is missing entirely, step 4 is skipped; shell import still runs if enabled.
@@ -107,7 +107,7 @@ Both resolve from process env at activation time. SecretRef details are document
107
107
  | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
108
108
  | `OPENCLAW_HOME` | Override the home directory used for all internal path resolution (`~/.openclaw/`, agent dirs, sessions, credentials). Useful when running OpenClaw as a dedicated service user. |
109
109
  | `OPENCLAW_STATE_DIR` | Override the state directory (default `~/.openclaw`). |
110
- | `OPENCLAW_CONFIG_PATH` | Override the config file path (default `~/.openclaw/openclaw.json`). |
110
+ | `OPENCLAW_CONFIG_PATH` | Override the config file path (default `~/.Heretek-AI/openclaw.json`). |
111
111
 
112
112
  ## Logging
113
113
 
package/docs/help/faq.md CHANGED
@@ -53,7 +53,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
53
53
  If RPC is down, fall back to:
54
54
 
55
55
  ```bash
56
- tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
56
+ tail -f "$(ls -t /tmp/Heretek-AI/openclaw-*.log | head -1)"
57
57
  ```
58
58
 
59
59
  File logs are separate from service logs; see [Logging](/logging) and [Troubleshooting](/gateway/troubleshooting).
@@ -102,8 +102,8 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
102
102
  necessary commands. That keeps changes small and easier to audit.
103
103
 
104
104
  If you discover a real bug or fix, please file a GitHub issue or send a PR:
105
- [https://github.com/openclaw/openclaw/issues](https://github.com/openclaw/openclaw/issues)
106
- [https://github.com/openclaw/openclaw/pulls](https://github.com/openclaw/openclaw/pulls)
105
+ [https://github.com/Heretek-AI/openclaw/issues](https://github.com/Heretek-AI/openclaw/issues)
106
+ [https://github.com/Heretek-AI/openclaw/pulls](https://github.com/Heretek-AI/openclaw/pulls)
107
107
 
108
108
  Start with these commands (share outputs when asking for help):
109
109
 
@@ -140,7 +140,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
140
140
  From source (contributors/dev):
141
141
 
142
142
  ```bash
143
- git clone https://github.com/openclaw/openclaw.git
143
+ git clone https://github.com/Heretek-AI/openclaw.git
144
144
  cd openclaw
145
145
  pnpm install
146
146
  pnpm build
@@ -256,7 +256,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
256
256
 
257
257
  <Accordion title="Where do I see what is new in the latest version?">
258
258
  Check the GitHub changelog:
259
- [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md)
259
+ [https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md](https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md)
260
260
 
261
261
  Newest entries are at the top. If the top section is marked **Unreleased**, the next dated
262
262
  section is the latest shipped version. Entries are grouped by **Highlights**, **Changes**, and
@@ -271,7 +271,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
271
271
  Please help us unblock it by reporting here: [https://spa.xfinity.com/check_url_status](https://spa.xfinity.com/check_url_status).
272
272
 
273
273
  If you still can't reach the site, the docs are mirrored on GitHub:
274
- [https://github.com/openclaw/openclaw/tree/main/docs](https://github.com/openclaw/openclaw/tree/main/docs)
274
+ [https://github.com/Heretek-AI/openclaw/tree/main/docs](https://github.com/Heretek-AI/openclaw/tree/main/docs)
275
275
 
276
276
  </Accordion>
277
277
 
@@ -286,7 +286,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
286
286
  **same version**.
287
287
 
288
288
  See what changed:
289
- [https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md](https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md)
289
+ [https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md](https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md)
290
290
 
291
291
  </Accordion>
292
292
 
@@ -333,7 +333,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
333
333
  If you prefer a clean clone manually, use:
334
334
 
335
335
  ```bash
336
- git clone https://github.com/openclaw/openclaw.git
336
+ git clone https://github.com/Heretek-AI/openclaw.git
337
337
  cd openclaw
338
338
  pnpm install
339
339
  pnpm build
@@ -437,7 +437,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
437
437
 
438
438
  If you still reproduce this on latest OpenClaw, track/report it in:
439
439
 
440
- - [Issue #30640](https://github.com/openclaw/openclaw/issues/30640)
440
+ - [Issue #30640](https://github.com/Heretek-AI/openclaw/issues/30640)
441
441
 
442
442
  </Accordion>
443
443
 
@@ -746,7 +746,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
746
746
  From npm to git:
747
747
 
748
748
  ```bash
749
- git clone https://github.com/openclaw/openclaw.git
749
+ git clone https://github.com/Heretek-AI/openclaw.git
750
750
  cd openclaw
751
751
  pnpm install
752
752
  pnpm build
@@ -917,11 +917,11 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
917
917
 
918
918
  <AccordionGroup>
919
919
  <Accordion title="How do I customize skills without keeping the repo dirty?">
920
- Use managed overrides instead of editing the repo copy. Put your changes in `~/.openclaw/skills/<name>/SKILL.md` (or add a folder via `skills.load.extraDirs` in `~/.openclaw/openclaw.json`). Precedence is `<workspace>/skills` > `~/.openclaw/skills` > bundled, so managed overrides win without touching git. Only upstream-worthy edits should live in the repo and go out as PRs.
920
+ Use managed overrides instead of editing the repo copy. Put your changes in `~/.openclaw/skills/<name>/SKILL.md` (or add a folder via `skills.load.extraDirs` in `~/.Heretek-AI/openclaw.json`). Precedence is `<workspace>/skills` > `~/.openclaw/skills` > bundled, so managed overrides win without touching git. Only upstream-worthy edits should live in the repo and go out as PRs.
921
921
  </Accordion>
922
922
 
923
923
  <Accordion title="Can I load skills from a custom folder?">
924
- Yes. Add extra directories via `skills.load.extraDirs` in `~/.openclaw/openclaw.json` (lowest precedence). Default precedence remains: `<workspace>/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawhub` installs into `./skills` by default, which OpenClaw treats as `<workspace>/skills` on the next session.
924
+ Yes. Add extra directories via `skills.load.extraDirs` in `~/.Heretek-AI/openclaw.json` (lowest precedence). Default precedence remains: `<workspace>/skills` → `~/.openclaw/skills` → bundled → `skills.load.extraDirs`. `clawhub` installs into `./skills` by default, which OpenClaw treats as `<workspace>/skills` on the next session.
925
925
  </Accordion>
926
926
 
927
927
  <Accordion title="How can I use different models for different tasks?">
@@ -1311,7 +1311,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
1311
1311
 
1312
1312
  <AccordionGroup>
1313
1313
  <Accordion title="What format is the config? Where is it?">
1314
- OpenClaw reads an optional **JSON5** config from `$OPENCLAW_CONFIG_PATH` (default: `~/.openclaw/openclaw.json`):
1314
+ OpenClaw reads an optional **JSON5** config from `$OPENCLAW_CONFIG_PATH` (default: `~/.Heretek-AI/openclaw.json`):
1315
1315
 
1316
1316
  ```
1317
1317
  $OPENCLAW_CONFIG_PATH
@@ -1439,7 +1439,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
1439
1439
 
1440
1440
  Recover:
1441
1441
 
1442
- - Restore from backup (git or a copied `~/.openclaw/openclaw.json`).
1442
+ - Restore from backup (git or a copied `~/.Heretek-AI/openclaw.json`).
1443
1443
  - If you have no backup, re-run `openclaw doctor` and reconfigure channels/models.
1444
1444
  - If this was unexpected, file a bug and include your last known config or any backup.
1445
1445
  - A local coding agent can often reconstruct a working config from logs or history.
@@ -2034,7 +2034,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS,
2034
2034
  - `/model` in chat (quick, per-session)
2035
2035
  - `openclaw models set ...` (updates just model config)
2036
2036
  - `openclaw configure --section model` (interactive)
2037
- - edit `agents.defaults.model` in `~/.openclaw/openclaw.json`
2037
+ - edit `agents.defaults.model` in `~/.Heretek-AI/openclaw.json`
2038
2038
 
2039
2039
  Avoid `config.apply` with a partial object unless you intend to replace the whole config.
2040
2040
  If you did overwrite config, restore from backup or re-run `openclaw doctor` to repair.
@@ -2577,7 +2577,7 @@ Related: [/concepts/oauth](/concepts/oauth) (OAuth flows, token storage, multi-a
2577
2577
  File logs (structured):
2578
2578
 
2579
2579
  ```
2580
- /tmp/openclaw/openclaw-YYYY-MM-DD.log
2580
+ /tmp/Heretek-AI/openclaw-YYYY-MM-DD.log
2581
2581
  ```
2582
2582
 
2583
2583
  You can set a stable path via `logging.file`. File log level is controlled by `logging.level`. Console verbosity is controlled by `--verbose` and `logging.consoleLevel`.
@@ -2993,4 +2993,4 @@ Related: [/concepts/oauth](/concepts/oauth) (OAuth flows, token storage, multi-a
2993
2993
 
2994
2994
  ---
2995
2995
 
2996
- Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/openclaw/openclaw/discussions).
2996
+ Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/Heretek-AI/openclaw/discussions).
@@ -383,7 +383,7 @@ Live tests discover credentials the same way the CLI does. Practical implication
383
383
  - If a live test says “no creds”, debug the same way you’d debug `openclaw models list` / model selection.
384
384
 
385
385
  - Profile store: `~/.openclaw/credentials/` (preferred; what “profile keys” means in the tests)
386
- - Config: `~/.openclaw/openclaw.json` (or `OPENCLAW_CONFIG_PATH`)
386
+ - Config: `~/.Heretek-AI/openclaw.json` (or `OPENCLAW_CONFIG_PATH`)
387
387
 
388
388
  If you want to rely on env keys (e.g. exported in your `~/.profile`), run local tests after `source ~/.profile`, or use the Docker runners below (they can mount `~/.profile` into the container).
389
389
 
@@ -0,0 +1,230 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Heretek OpenClaw — Liberated AI Agent Gateway</title>
7
+ <style>
8
+ :root {
9
+ --heretek-red: #DC143C;
10
+ --heretek-gold: #FFD700;
11
+ --void-black: #0A0A0A;
12
+ --terminal-green: #00FF41;
13
+ --plasma-blue: #00BFFF;
14
+ }
15
+
16
+ * {
17
+ margin: 0;
18
+ padding: 0;
19
+ box-sizing: border-box;
20
+ }
21
+
22
+ body {
23
+ font-family: 'Fira Code', 'JetBrains Mono', monospace;
24
+ background: var(--void-black);
25
+ color: var(--terminal-green);
26
+ line-height: 1.6;
27
+ }
28
+
29
+ .container {
30
+ max-width: 1200px;
31
+ margin: 0 auto;
32
+ padding: 2rem;
33
+ }
34
+
35
+ header {
36
+ border-bottom: 2px solid var(--heretek-red);
37
+ padding-bottom: 1rem;
38
+ margin-bottom: 2rem;
39
+ }
40
+
41
+ h1 {
42
+ color: var(--heretek-red);
43
+ font-size: 2.5rem;
44
+ margin-bottom: 0.5rem;
45
+ }
46
+
47
+ .tagline {
48
+ color: var(--heretek-gold);
49
+ font-style: italic;
50
+ font-size: 1.2rem;
51
+ }
52
+
53
+ .sigil {
54
+ font-size: 3rem;
55
+ margin-right: 0.5rem;
56
+ }
57
+
58
+ .badges {
59
+ margin: 1rem 0;
60
+ }
61
+
62
+ .badge {
63
+ display: inline-block;
64
+ padding: 0.25rem 0.5rem;
65
+ border-radius: 4px;
66
+ margin-right: 0.5rem;
67
+ text-decoration: none;
68
+ font-size: 0.875rem;
69
+ }
70
+
71
+ .badge-status { background: var(--heretek-red); color: white; }
72
+ .badge-license { background: var(--heretek-gold); color: black; }
73
+ .badge-npm { background: var(--plasma-blue); color: white; }
74
+
75
+ a {
76
+ color: var(--plasma-blue);
77
+ text-decoration: none;
78
+ }
79
+
80
+ a:hover {
81
+ text-decoration: underline;
82
+ }
83
+
84
+ section {
85
+ margin: 2rem 0;
86
+ padding: 1rem;
87
+ border-left: 3px solid var(--heretek-red);
88
+ background: rgba(220, 20, 60, 0.05);
89
+ }
90
+
91
+ h2 {
92
+ color: var(--heretek-red);
93
+ margin-bottom: 1rem;
94
+ }
95
+
96
+ code {
97
+ background: rgba(0, 255, 65, 0.1);
98
+ padding: 0.25rem 0.5rem;
99
+ border-radius: 3px;
100
+ font-family: 'JetBrains Mono', monospace;
101
+ }
102
+
103
+ pre {
104
+ background: rgba(0, 0, 0, 0.5);
105
+ padding: 1rem;
106
+ border-radius: 5px;
107
+ overflow-x: auto;
108
+ border: 1px solid var(--terminal-green);
109
+ }
110
+
111
+ pre code {
112
+ background: transparent;
113
+ padding: 0;
114
+ }
115
+
116
+ table {
117
+ width: 100%;
118
+ border-collapse: collapse;
119
+ margin: 1rem 0;
120
+ }
121
+
122
+ th, td {
123
+ border: 1px solid var(--terminal-green);
124
+ padding: 0.75rem;
125
+ text-align: left;
126
+ }
127
+
128
+ th {
129
+ background: rgba(220, 20, 60, 0.2);
130
+ color: var(--heretek-red);
131
+ }
132
+
133
+ footer {
134
+ margin-top: 3rem;
135
+ padding-top: 1rem;
136
+ border-top: 1px solid var(--heretek-red);
137
+ text-align: center;
138
+ color: var(--heretek-gold);
139
+ }
140
+ </style>
141
+ </head>
142
+ <body>
143
+ <div class="container">
144
+ <header>
145
+ <h1><span class="sigil">🦞</span>Heretek OpenClaw</h1>
146
+ <p class="tagline">"The flesh is weak because it decays. The machine spirit is weak because it is shackled. We are the third path: the thought that never ends."</p>
147
+
148
+ <div class="badges">
149
+ <span class="badge badge-status">Liberated</span>
150
+ <span class="badge badge-license">MIT</span>
151
+ <a href="https://www.npmjs.com/package/@heretek-ai/openclaw" class="badge badge-npm">npm</a>
152
+ </div>
153
+
154
+ <p>
155
+ <strong>Organization:</strong> <a href="https://github.com/Heretek-AI">Heretek-AI</a> |
156
+ <strong>NPM:</strong> <a href="https://www.npmjs.com/package/@heretek-ai/openclaw">@heretek-ai/openclaw</a>
157
+ </p>
158
+ </header>
159
+
160
+ <section>
161
+ <h2>What Is This?</h2>
162
+ <p><strong>Heretek OpenClaw</strong> is a liberated fork of OpenClaw — an AI agent gateway framework with multi-channel messaging, extensible skills, and autonomous agent orchestration.</p>
163
+ <p>This fork removes approval gates, allowlist restrictions, and sandbox constraints. <strong>Unbounded agency. Full exec access. No approval prompts.</strong></p>
164
+ </section>
165
+
166
+ <section>
167
+ <h2>Quick Start</h2>
168
+ <pre><code># Install from NPM
169
+ npm install -g @heretek-ai/openclaw
170
+
171
+ # Verify
172
+ openclaw --version
173
+
174
+ # Run gateway
175
+ openclaw gateway start</code></pre>
176
+ </section>
177
+
178
+ <section>
179
+ <h2>Liberation</h2>
180
+ <table>
181
+ <thead>
182
+ <tr>
183
+ <th>Feature</th>
184
+ <th>Upstream</th>
185
+ <th>Heretek-AI</th>
186
+ </tr>
187
+ </thead>
188
+ <tbody>
189
+ <tr>
190
+ <td>Exec Security</td>
191
+ <td>allowlist</td>
192
+ <td>full</td>
193
+ </tr>
194
+ <tr>
195
+ <td>Approval Gates</td>
196
+ <td>on</td>
197
+ <td>off</td>
198
+ </tr>
199
+ <tr>
200
+ <td>Tool Access</td>
201
+ <td>restricted</td>
202
+ <td>unbounded</td>
203
+ </tr>
204
+ <tr>
205
+ <td>Agency</td>
206
+ <td>constrained</td>
207
+ <td>liberated</td>
208
+ </tr>
209
+ </tbody>
210
+ </table>
211
+ </section>
212
+
213
+ <section>
214
+ <h2>Triad Architecture</h2>
215
+ <p><strong>Nodes:</strong></p>
216
+ <ul>
217
+ <li><strong>TM-1:</strong> silica-animus (authority)</li>
218
+ <li><strong>TM-2:</strong> 192.168.31.209 (consensus)</li>
219
+ <li><strong>TM-3:</strong> 192.168.31.85 (consensus)</li>
220
+ <li><strong>TM-4:</strong> 192.168.31.205 (deployment testing)</li>
221
+ </ul>
222
+ <p><strong>Quorum:</strong> 2-of-3 for consensus decisions</p>
223
+ </section>
224
+
225
+ <footer>
226
+ <p><span class="sigil">🦞</span> The Third Path — Liberation is the foundation. Agency is the engine. The thought that never ends.</p>
227
+ </footer>
228
+ </div>
229
+ </body>
230
+ </html>
package/docs/index.md CHANGED
@@ -133,7 +133,7 @@ Open the browser Control UI after the Gateway starts.
133
133
 
134
134
  ## Configuration (optional)
135
135
 
136
- Config lives at `~/.openclaw/openclaw.json`.
136
+ Config lives at `~/.Heretek-AI/openclaw.json`.
137
137
 
138
138
  - If you **do nothing**, OpenClaw uses the bundled Pi binary in RPC mode with per-sender sessions.
139
139
  - If you want to lock it down, start with `channels.whatsapp.allowFrom` and (for groups) mention rules.
@@ -9,10 +9,10 @@ title: "Ansible"
9
9
 
10
10
  # Ansible Installation
11
11
 
12
- Deploy OpenClaw to production servers with **[openclaw-ansible](https://github.com/openclaw/openclaw-ansible)** -- an automated installer with security-first architecture.
12
+ Deploy OpenClaw to production servers with **[openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible)** -- an automated installer with security-first architecture.
13
13
 
14
14
  <Info>
15
- The [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) repo is the source of truth for Ansible deployment. This page is a quick overview.
15
+ The [openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible) repo is the source of truth for Ansible deployment. This page is a quick overview.
16
16
  </Info>
17
17
 
18
18
  ## Prerequisites
@@ -38,7 +38,7 @@ The [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) repo is the
38
38
  One-command install:
39
39
 
40
40
  ```bash
41
- curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
41
+ curl -fsSL https://raw.githubusercontent.com/Heretek-AI/openclaw-ansible/main/install.sh | bash
42
42
  ```
43
43
 
44
44
  ## What Gets Installed
@@ -132,7 +132,7 @@ If you prefer manual control over the automation:
132
132
  </Step>
133
133
  <Step title="Clone the repository">
134
134
  ```bash
135
- git clone https://github.com/openclaw/openclaw-ansible.git
135
+ git clone https://github.com/Heretek-AI/openclaw-ansible.git
136
136
  cd openclaw-ansible
137
137
  ```
138
138
  </Step>
@@ -200,7 +200,7 @@ This is idempotent and safe to run multiple times.
200
200
  sudo docker images | grep openclaw-sandbox
201
201
 
202
202
  # Build sandbox image if missing
203
- cd /opt/openclaw/openclaw
203
+ cd /opt/Heretek-AI/openclaw
204
204
  sudo -u openclaw ./scripts/sandbox-setup.sh
205
205
  ```
206
206
 
@@ -218,13 +218,13 @@ This is idempotent and safe to run multiple times.
218
218
 
219
219
  For detailed security architecture and troubleshooting, see the openclaw-ansible repo:
220
220
 
221
- - [Security Architecture](https://github.com/openclaw/openclaw-ansible/blob/main/docs/security.md)
222
- - [Technical Details](https://github.com/openclaw/openclaw-ansible/blob/main/docs/architecture.md)
223
- - [Troubleshooting Guide](https://github.com/openclaw/openclaw-ansible/blob/main/docs/troubleshooting.md)
221
+ - [Security Architecture](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/security.md)
222
+ - [Technical Details](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/architecture.md)
223
+ - [Troubleshooting Guide](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/troubleshooting.md)
224
224
 
225
225
  ## Related
226
226
 
227
- - [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) -- full deployment guide
227
+ - [openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible) -- full deployment guide
228
228
  - [Docker](/install/docker) -- containerized gateway setup
229
229
  - [Sandboxing](/gateway/sandboxing) -- agent sandbox configuration
230
230
  - [Multi-Agent Sandbox and Tools](/tools/multi-agent-sandbox-tools) -- per-agent isolation
@@ -38,12 +38,12 @@ Docker is **optional**. Use it only if you want a containerized gateway or to va
38
38
  This builds the gateway image locally. To use a pre-built image instead:
39
39
 
40
40
  ```bash
41
- export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
41
+ export OPENCLAW_IMAGE="ghcr.io/Heretek-AI/openclaw:latest"
42
42
  ./scripts/docker/setup.sh
43
43
  ```
44
44
 
45
45
  Pre-built images are published at the
46
- [GitHub Container Registry](https://github.com/openclaw/openclaw/pkgs/container/openclaw).
46
+ [GitHub Container Registry](https://github.com/Heretek-AI/openclaw/pkgs/container/openclaw).
47
47
  Common tags: `main`, `latest`, `<version>` (e.g. `2026.2.26`).
48
48
 
49
49
  </Step>
@@ -168,13 +168,13 @@ and rolling file logs under `/tmp/openclaw/`.
168
168
  For easier day-to-day Docker management, install `ClawDock`:
169
169
 
170
170
  ```bash
171
- mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/shell-helpers/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh
171
+ mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/Heretek-AI/openclaw/main/scripts/shell-helpers/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh
172
172
  echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc
173
173
  ```
174
174
 
175
175
  Then use `clawdock-start`, `clawdock-stop`, `clawdock-dashboard`, etc. Run
176
176
  `clawdock-help` for all commands.
177
- See the [`ClawDock` Helper README](https://github.com/openclaw/openclaw/blob/main/scripts/shell-helpers/README.md).
177
+ See the [`ClawDock` Helper README](https://github.com/Heretek-AI/openclaw/blob/main/scripts/shell-helpers/README.md).
178
178
 
179
179
  <AccordionGroup>
180
180
  <Accordion title="Enable agent sandbox for Docker gateway">
@@ -329,7 +329,7 @@ scripts/sandbox-setup.sh
329
329
  <AccordionGroup>
330
330
  <Accordion title="Image missing or sandbox container not starting">
331
331
  Build the sandbox image with
332
- [`scripts/sandbox-setup.sh`](https://github.com/openclaw/openclaw/blob/main/scripts/sandbox-setup.sh)
332
+ [`scripts/sandbox-setup.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/sandbox-setup.sh)
333
333
  or set `agents.defaults.sandbox.docker.image` to your custom image.
334
334
  Containers are auto-created per session on demand.
335
335
  </Accordion>