@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.
- package/CHANGELOG.md +1 -1
- package/README.md +102 -507
- package/dist/.buildstamp +1 -1
- package/dist/dns-cli-A_DUY2mI.js +2 -2
- package/dist/env-overrides-DbK0fm-W.js +1 -1
- package/dist/paths-ViKUYWUK.js +1 -1
- package/dist/pi-embedded-doAakoP8.js +6 -6
- package/dist/plugin-sdk/src/agents/subagent-orphan-recovery.d.ts +1 -1
- package/dist/plugin-sdk/src/config/paths.d.ts +1 -1
- package/dist/plugin-sdk/src/config/types.gateway.d.ts +1 -1
- package/dist/plugin-sdk/src/cron/service/state.d.ts +3 -3
- package/dist/plugin-sdk/src/infra/exec-obfuscation-detect.d.ts +1 -1
- package/dist/plugin-sdk/src/infra/outbound/agent-delivery.d.ts +1 -1
- package/dist/plugin-sdk/src/infra/outbound/sanitize-text.d.ts +2 -2
- package/dist/plugin-sdk/src/infra/outbound/targets.d.ts +1 -1
- package/dist/prompt-select-styled-CR725EJM.js +2 -2
- package/dist/register.setup-CVyj44Ne.js +1 -1
- package/dist/server-startup-matrix-migration-W3FCsqhA.js +1 -1
- package/dist/setup.finalize-2dj2-0Le.js +1 -1
- package/dist/subagent-orphan-recovery-BsV6yVqW.js +1 -1
- package/dist/update-cli-CUVntZUl.js +1 -1
- package/docs/automation/hooks.md +1 -1
- package/docs/channels/feishu.md +1 -1
- package/docs/channels/group-messages.md +1 -1
- package/docs/channels/irc.md +1 -1
- package/docs/channels/msteams.md +1 -1
- package/docs/channels/signal.md +1 -1
- package/docs/cli/config.md +2 -2
- package/docs/cli/doctor.md +1 -1
- package/docs/cli/gateway.md +1 -1
- package/docs/cli/sandbox.md +1 -1
- package/docs/cli/setup.md +1 -1
- package/docs/cli/update.md +1 -1
- package/docs/concepts/agent-workspace.md +3 -3
- package/docs/concepts/agent.md +1 -1
- package/docs/concepts/context-engine.md +1 -1
- package/docs/concepts/multi-agent.md +2 -2
- package/docs/concepts/retry.md +1 -1
- package/docs/concepts/session.md +2 -2
- package/docs/concepts/typebox.md +1 -1
- package/docs/diagnostics/flags.md +4 -4
- package/docs/docs.json +2 -2
- package/docs/gateway/bonjour.md +2 -2
- package/docs/gateway/bridge-protocol.md +1 -1
- package/docs/gateway/configuration-examples.md +2 -2
- package/docs/gateway/configuration-reference.md +4 -4
- package/docs/gateway/configuration.md +5 -5
- package/docs/gateway/discovery.md +1 -1
- package/docs/gateway/doctor.md +3 -3
- package/docs/gateway/health.md +1 -1
- package/docs/gateway/logging.md +1 -1
- package/docs/gateway/security/index.md +4 -4
- package/docs/gateway/troubleshooting.md +1 -1
- package/docs/help/environment.md +2 -2
- package/docs/help/faq.md +17 -17
- package/docs/help/testing.md +1 -1
- package/docs/index.html +230 -0
- package/docs/index.md +1 -1
- package/docs/install/ansible.md +9 -9
- package/docs/install/docker.md +5 -5
- package/docs/install/fly.md +1 -1
- package/docs/install/gcp.md +1 -1
- package/docs/install/hetzner.md +1 -1
- package/docs/install/index.md +2 -2
- package/docs/install/kubernetes.md +1 -1
- package/docs/install/macos-vm.md +1 -1
- package/docs/install/podman.md +4 -4
- package/docs/install/updating.md +1 -1
- package/docs/ja-JP/index.md +1 -1
- package/docs/logging.md +4 -4
- package/docs/nodes/talk.md +1 -1
- package/docs/perplexity.md +1 -1
- package/docs/platforms/android.md +2 -2
- package/docs/platforms/mac/bundled-gateway.md +1 -1
- package/docs/platforms/mac/dev-setup.md +2 -2
- package/docs/platforms/mac/health.md +1 -1
- package/docs/platforms/mac/signing.md +2 -2
- package/docs/platforms/mac/skills.md +1 -1
- package/docs/platforms/raspberry-pi.md +1 -1
- package/docs/platforms/windows.md +1 -1
- package/docs/providers/minimax.md +1 -1
- package/docs/reference/RELEASING.md +2 -2
- package/docs/reference/test.md +2 -2
- package/docs/reference/wizard.md +2 -2
- package/docs/start/lore.md +1 -1
- package/docs/start/openclaw.md +1 -1
- package/docs/start/setup.md +2 -2
- package/docs/start/wizard-cli-reference.md +2 -2
- package/docs/tm4-deployment-testing.md +1 -1
- package/docs/tools/browser-linux-troubleshooting.md +1 -1
- package/docs/tools/browser-wsl2-windows-remote-cdp-troubleshooting.md +1 -1
- package/docs/tools/browser.md +1 -1
- package/docs/tools/diffs.md +1 -1
- package/docs/tools/perplexity-search.md +1 -1
- package/docs/tools/skills-config.md +1 -1
- package/docs/tools/skills.md +2 -2
- package/docs/web/control-ui.md +1 -1
- package/docs/zh-CN/AGENTS.md +1 -1
- package/docs/zh-CN/automation/hooks.md +1 -1
- package/docs/zh-CN/channels/feishu.md +1 -1
- package/docs/zh-CN/channels/group-messages.md +1 -1
- package/docs/zh-CN/channels/imessage.md +1 -1
- package/docs/zh-CN/channels/msteams.md +1 -1
- package/docs/zh-CN/channels/whatsapp.md +2 -2
- package/docs/zh-CN/cli/doctor.md +1 -1
- package/docs/zh-CN/cli/gateway.md +1 -1
- package/docs/zh-CN/cli/sandbox.md +1 -1
- package/docs/zh-CN/cli/setup.md +1 -1
- package/docs/zh-CN/concepts/agent-workspace.md +3 -3
- package/docs/zh-CN/concepts/agent.md +1 -1
- package/docs/zh-CN/concepts/multi-agent.md +2 -2
- package/docs/zh-CN/concepts/retry.md +1 -1
- package/docs/zh-CN/concepts/session.md +1 -1
- package/docs/zh-CN/concepts/typebox.md +1 -1
- package/docs/zh-CN/diagnostics/flags.md +4 -4
- package/docs/zh-CN/gateway/bonjour.md +2 -2
- package/docs/zh-CN/gateway/bridge-protocol.md +1 -1
- package/docs/zh-CN/gateway/configuration-examples.md +2 -2
- package/docs/zh-CN/gateway/configuration-reference.md +5 -5
- package/docs/zh-CN/gateway/configuration.md +5 -5
- package/docs/zh-CN/gateway/discovery.md +1 -1
- package/docs/zh-CN/gateway/doctor.md +3 -3
- package/docs/zh-CN/gateway/health.md +1 -1
- package/docs/zh-CN/gateway/index.md +1 -1
- package/docs/zh-CN/gateway/logging.md +1 -1
- package/docs/zh-CN/gateway/security/index.md +2 -2
- package/docs/zh-CN/gateway/troubleshooting.md +8 -8
- package/docs/zh-CN/help/environment.md +1 -1
- package/docs/zh-CN/help/faq.md +16 -16
- package/docs/zh-CN/help/testing.md +1 -1
- package/docs/zh-CN/index.md +1 -1
- package/docs/zh-CN/install/ansible.md +9 -9
- package/docs/zh-CN/install/docker.md +1 -1
- package/docs/zh-CN/install/fly.md +1 -1
- package/docs/zh-CN/install/gcp.md +1 -1
- package/docs/zh-CN/install/hetzner.md +1 -1
- package/docs/zh-CN/install/index.md +4 -4
- package/docs/zh-CN/install/macos-vm.md +1 -1
- package/docs/zh-CN/install/nix.md +1 -1
- package/docs/zh-CN/install/updating.md +2 -2
- package/docs/zh-CN/logging.md +4 -4
- package/docs/zh-CN/nodes/index.md +1 -1
- package/docs/zh-CN/nodes/talk.md +1 -1
- package/docs/zh-CN/platforms/android.md +1 -1
- package/docs/zh-CN/platforms/mac/bundled-gateway.md +1 -1
- package/docs/zh-CN/platforms/mac/dev-setup.md +2 -2
- package/docs/zh-CN/platforms/mac/health.md +1 -1
- package/docs/zh-CN/platforms/mac/signing.md +2 -2
- package/docs/zh-CN/platforms/mac/skills.md +1 -1
- package/docs/zh-CN/platforms/raspberry-pi.md +1 -1
- package/docs/zh-CN/platforms/windows.md +1 -1
- package/docs/zh-CN/providers/minimax.md +1 -1
- package/docs/zh-CN/reference/RELEASING.md +2 -2
- package/docs/zh-CN/reference/test.md +1 -1
- package/docs/zh-CN/reference/wizard.md +2 -2
- package/docs/zh-CN/start/lore.md +1 -1
- package/docs/zh-CN/start/openclaw.md +2 -2
- package/docs/zh-CN/start/quickstart.md +1 -1
- package/docs/zh-CN/start/setup.md +2 -2
- package/docs/zh-CN/start/wizard-cli-reference.md +2 -2
- package/docs/zh-CN/tools/browser-linux-troubleshooting.md +1 -1
- package/docs/zh-CN/tools/browser.md +1 -1
- package/docs/zh-CN/tools/skills-config.md +1 -1
- package/docs/zh-CN/tools/skills.md +2 -2
- package/docs/zh-CN/tools/web.md +1 -1
- package/docs/zh-CN/web/control-ui.md +1 -1
- package/package.json +25 -6
- package/skills/canvas/SKILL.md +3 -3
- package/skills/curiosity-engine/SKILL.md +2 -2
- package/skills/gh-issues/SKILL.md +6 -6
- package/skills/heretek-theme/SKILL.md +169 -0
- package/skills/openai-whisper-api/SKILL.md +1 -1
- package/skills/sherpa-onnx-tts/SKILL.md +1 -1
- 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 `~/.
|
|
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
|
-
// ~/.
|
|
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 `~/.
|
|
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
|
-
// ~/.
|
|
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 `~/.
|
|
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 `~/.
|
|
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.
|
package/docs/gateway/doctor.md
CHANGED
|
@@ -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 ~/.
|
|
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 `~/.
|
|
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 `~/.
|
|
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)
|
package/docs/gateway/health.md
CHANGED
|
@@ -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/
|
|
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
|
|
package/docs/gateway/logging.md
CHANGED
|
@@ -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 `~/.
|
|
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/
|
|
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 `~/.
|
|
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
|
-
- `~/.
|
|
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/
|
|
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/.
|
|
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
|
|
package/docs/help/environment.md
CHANGED
|
@@ -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 `~/.
|
|
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 `~/.
|
|
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/
|
|
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/
|
|
106
|
-
[https://github.com/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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 `~/.
|
|
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 `~/.
|
|
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: `~/.
|
|
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 `~/.
|
|
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 `~/.
|
|
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/
|
|
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/
|
|
2996
|
+
Still stuck? Ask in [Discord](https://discord.com/invite/clawd) or open a [GitHub discussion](https://github.com/Heretek-AI/openclaw/discussions).
|
package/docs/help/testing.md
CHANGED
|
@@ -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: `~/.
|
|
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
|
|
package/docs/index.html
ADDED
|
@@ -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 `~/.
|
|
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.
|
package/docs/install/ansible.md
CHANGED
|
@@ -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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
222
|
-
- [Technical Details](https://github.com/
|
|
223
|
-
- [Troubleshooting Guide](https://github.com/
|
|
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/
|
|
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
|
package/docs/install/docker.md
CHANGED
|
@@ -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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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>
|