@heretek-ai/openclaw 2026.3.24 → 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 +21 -2
- 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
package/docs/install/fly.md
CHANGED
package/docs/install/gcp.md
CHANGED
|
@@ -186,7 +186,7 @@ For the generic Docker flow, see [Docker](/install/docker).
|
|
|
186
186
|
|
|
187
187
|
<Step title="Clone the OpenClaw repository">
|
|
188
188
|
```bash
|
|
189
|
-
git clone https://github.com/
|
|
189
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
190
190
|
cd openclaw
|
|
191
191
|
```
|
|
192
192
|
|
package/docs/install/hetzner.md
CHANGED
|
@@ -105,7 +105,7 @@ For the generic Docker flow, see [Docker](/install/docker).
|
|
|
105
105
|
|
|
106
106
|
<Step title="Clone the OpenClaw repository">
|
|
107
107
|
```bash
|
|
108
|
-
git clone https://github.com/
|
|
108
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
109
109
|
cd openclaw
|
|
110
110
|
```
|
|
111
111
|
|
package/docs/install/index.md
CHANGED
|
@@ -90,7 +90,7 @@ SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
|
|
|
90
90
|
For contributors or anyone who wants to run from a local checkout:
|
|
91
91
|
|
|
92
92
|
```bash
|
|
93
|
-
git clone https://github.com/
|
|
93
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
94
94
|
cd openclaw
|
|
95
95
|
pnpm install && pnpm ui:build && pnpm build
|
|
96
96
|
pnpm link --global
|
|
@@ -102,7 +102,7 @@ Or skip the link and use `pnpm openclaw ...` from inside the repo. See [Setup](/
|
|
|
102
102
|
### Install from GitHub main
|
|
103
103
|
|
|
104
104
|
```bash
|
|
105
|
-
npm install -g github:
|
|
105
|
+
npm install -g github:Heretek-AI/openclaw#main
|
|
106
106
|
```
|
|
107
107
|
|
|
108
108
|
### Containers and package managers
|
|
@@ -138,7 +138,7 @@ OPENCLAW_NAMESPACE=my-namespace ./scripts/k8s/deploy.sh
|
|
|
138
138
|
Edit the `image` field in `scripts/k8s/manifests/deployment.yaml`:
|
|
139
139
|
|
|
140
140
|
```yaml
|
|
141
|
-
image: ghcr.io/
|
|
141
|
+
image: ghcr.io/Heretek-AI/openclaw:latest # or pin to a specific version from https://github.com/Heretek-AI/openclaw/releases
|
|
142
142
|
```
|
|
143
143
|
|
|
144
144
|
### Expose beyond port-forward
|
package/docs/install/macos-vm.md
CHANGED
package/docs/install/podman.md
CHANGED
|
@@ -7,7 +7,7 @@ title: "Podman"
|
|
|
7
7
|
|
|
8
8
|
# Podman
|
|
9
9
|
|
|
10
|
-
Run the OpenClaw Gateway in a **rootless** Podman container. Uses the same image as Docker (built from the repo [Dockerfile](https://github.com/
|
|
10
|
+
Run the OpenClaw Gateway in a **rootless** Podman container. Uses the same image as Docker (built from the repo [Dockerfile](https://github.com/Heretek-AI/openclaw/blob/main/Dockerfile)).
|
|
11
11
|
|
|
12
12
|
## Prerequisites
|
|
13
13
|
|
|
@@ -24,7 +24,7 @@ Run the OpenClaw Gateway in a **rootless** Podman container. Uses the same image
|
|
|
24
24
|
./scripts/podman/setup.sh
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
This also creates a minimal config at `~openclaw/.
|
|
27
|
+
This also creates a minimal config at `~openclaw/.Heretek-AI/openclaw.json` (sets `gateway.mode` to `"local"`) so the Gateway can start without running the wizard.
|
|
28
28
|
|
|
29
29
|
By default the container is **not** installed as a systemd service -- you start it manually in the next step. For a production-style setup with auto-start and restarts, pass `--quadlet` instead:
|
|
30
30
|
|
|
@@ -94,7 +94,7 @@ To add quadlet **after** an initial setup that did not use it, re-run: `./script
|
|
|
94
94
|
sudo -u openclaw /home/openclaw/run-openclaw-podman.sh setup
|
|
95
95
|
```
|
|
96
96
|
|
|
97
|
-
- **Config:** Only `openclaw` and root can access `/home/openclaw/.openclaw`. To edit config: use the Control UI once the gateway is running, or `sudo -u openclaw $EDITOR /home/openclaw/.
|
|
97
|
+
- **Config:** Only `openclaw` and root can access `/home/openclaw/.openclaw`. To edit config: use the Control UI once the gateway is running, or `sudo -u openclaw $EDITOR /home/openclaw/.Heretek-AI/openclaw.json`.
|
|
98
98
|
|
|
99
99
|
## Environment and config
|
|
100
100
|
|
|
@@ -122,7 +122,7 @@ To add quadlet **after** an initial setup that did not use it, re-run: `./script
|
|
|
122
122
|
## Troubleshooting
|
|
123
123
|
|
|
124
124
|
- **Permission denied (EACCES) on config or auth-profiles:** The container defaults to `--userns=keep-id` and runs as the same uid/gid as the host user running the script. Ensure your host `OPENCLAW_CONFIG_DIR` and `OPENCLAW_WORKSPACE_DIR` are owned by that user.
|
|
125
|
-
- **Gateway start blocked (missing `gateway.mode=local`):** Ensure `~openclaw/.
|
|
125
|
+
- **Gateway start blocked (missing `gateway.mode=local`):** Ensure `~openclaw/.Heretek-AI/openclaw.json` exists and sets `gateway.mode="local"`. `scripts/podman/setup.sh` creates this file if missing.
|
|
126
126
|
- **Rootless Podman fails for user openclaw:** Check `/etc/subuid` and `/etc/subgid` contain a line for `openclaw` (e.g. `openclaw:100000:65536`). Add it if missing and restart.
|
|
127
127
|
- **Container name in use:** The launch script uses `podman run --replace`, so the existing container is replaced when you start again. To clean up manually: `podman rm -f openclaw`.
|
|
128
128
|
- **Script not found when running as openclaw:** Ensure `scripts/podman/setup.sh` was run so that `run-openclaw-podman.sh` is copied to openclaw’s home (e.g. `/home/openclaw/run-openclaw-podman.sh`).
|
package/docs/install/updating.md
CHANGED
package/docs/ja-JP/index.md
CHANGED
|
@@ -123,7 +123,7 @@ Gatewayの起動後、ブラウザでControl UIを開きます。
|
|
|
123
123
|
|
|
124
124
|
## 設定(オプション)
|
|
125
125
|
|
|
126
|
-
設定は`~/.
|
|
126
|
+
設定は`~/.Heretek-AI/openclaw.json`にあります。
|
|
127
127
|
|
|
128
128
|
- **何もしなければ**、OpenClawはバンドルされたPiバイナリをRPCモードで使用し、送信者ごとのセッションを作成します。
|
|
129
129
|
- 制限を設けたい場合は、`channels.whatsapp.allowFrom`と(グループの場合)メンションルールから始めてください。
|
package/docs/logging.md
CHANGED
|
@@ -21,11 +21,11 @@ levels and formats.
|
|
|
21
21
|
|
|
22
22
|
By default, the Gateway writes a rolling log file under:
|
|
23
23
|
|
|
24
|
-
`/tmp/
|
|
24
|
+
`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`
|
|
25
25
|
|
|
26
26
|
The date uses the gateway host's local timezone.
|
|
27
27
|
|
|
28
|
-
You can override this in `~/.
|
|
28
|
+
You can override this in `~/.Heretek-AI/openclaw.json`:
|
|
29
29
|
|
|
30
30
|
```json
|
|
31
31
|
{
|
|
@@ -98,13 +98,13 @@ Console formatting is controlled by `logging.consoleStyle`.
|
|
|
98
98
|
|
|
99
99
|
## Configuring logging
|
|
100
100
|
|
|
101
|
-
All logging configuration lives under `logging` in `~/.
|
|
101
|
+
All logging configuration lives under `logging` in `~/.Heretek-AI/openclaw.json`.
|
|
102
102
|
|
|
103
103
|
```json
|
|
104
104
|
{
|
|
105
105
|
"logging": {
|
|
106
106
|
"level": "info",
|
|
107
|
-
"file": "/tmp/
|
|
107
|
+
"file": "/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log",
|
|
108
108
|
"consoleLevel": "info",
|
|
109
109
|
"consoleStyle": "pretty",
|
|
110
110
|
"redactSensitive": "tools",
|
package/docs/nodes/talk.md
CHANGED
package/docs/perplexity.md
CHANGED
|
@@ -86,7 +86,7 @@ Optional compatibility controls:
|
|
|
86
86
|
## Where to set the key
|
|
87
87
|
|
|
88
88
|
**Via config:** run `openclaw configure --section web`. It stores the key in
|
|
89
|
-
`~/.
|
|
89
|
+
`~/.Heretek-AI/openclaw.json` under `plugins.entries.perplexity.config.webSearch.apiKey`.
|
|
90
90
|
That field also accepts SecretRef objects.
|
|
91
91
|
|
|
92
92
|
**Via environment:** set `PERPLEXITY_API_KEY` or `OPENROUTER_API_KEY`
|
|
@@ -9,7 +9,7 @@ title: "Android App"
|
|
|
9
9
|
|
|
10
10
|
# Android App (Node)
|
|
11
11
|
|
|
12
|
-
> **Note:** The Android app has not been publicly released yet. The source code is available in the [OpenClaw repository](https://github.com/
|
|
12
|
+
> **Note:** The Android app has not been publicly released yet. The source code is available in the [OpenClaw repository](https://github.com/Heretek-AI/openclaw) under `apps/android`. You can build it yourself using Java 17 and the Android SDK (`./gradlew :app:assemblePlayDebug`). See [apps/android/README.md](https://github.com/Heretek-AI/openclaw/blob/main/apps/android/README.md) for build instructions.
|
|
13
13
|
|
|
14
14
|
## Support snapshot
|
|
15
15
|
|
|
@@ -50,7 +50,7 @@ Confirm in logs you see something like:
|
|
|
50
50
|
|
|
51
51
|
For tailnet-only setups (recommended for Vienna ⇄ London), bind the gateway to the tailnet IP:
|
|
52
52
|
|
|
53
|
-
- Set `gateway.bind: "tailnet"` in `~/.
|
|
53
|
+
- Set `gateway.bind: "tailnet"` in `~/.Heretek-AI/openclaw.json` on the gateway host.
|
|
54
54
|
- Restart the Gateway / macOS menubar app.
|
|
55
55
|
|
|
56
56
|
### 2) Verify discovery (optional)
|
|
@@ -35,7 +35,7 @@ To build the macOS app and package it into `dist/OpenClaw.app`, run:
|
|
|
35
35
|
If you don't have an Apple Developer ID certificate, the script will automatically use **ad-hoc signing** (`-`).
|
|
36
36
|
|
|
37
37
|
For dev run modes, signing flags, and Team ID troubleshooting, see the macOS app README:
|
|
38
|
-
[https://github.com/
|
|
38
|
+
[https://github.com/Heretek-AI/openclaw/blob/main/apps/macos/README.md](https://github.com/Heretek-AI/openclaw/blob/main/apps/macos/README.md)
|
|
39
39
|
|
|
40
40
|
> **Note**: Ad-hoc signed apps may trigger security prompts. If the app crashes immediately with "Abort trap 6", see the [Troubleshooting](#troubleshooting) section.
|
|
41
41
|
|
|
@@ -87,7 +87,7 @@ If the app crashes when you try to allow **Speech Recognition** or **Microphone*
|
|
|
87
87
|
tccutil reset All ai.openclaw.mac.debug
|
|
88
88
|
```
|
|
89
89
|
|
|
90
|
-
2. If that fails, change the `BUNDLE_ID` temporarily in [`scripts/package-mac-app.sh`](https://github.com/
|
|
90
|
+
2. If that fails, change the `BUNDLE_ID` temporarily in [`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh) to force a "clean slate" from macOS.
|
|
91
91
|
|
|
92
92
|
### Gateway "Starting..." indefinitely
|
|
93
93
|
|
|
@@ -31,4 +31,4 @@ How to see whether the linked channel is healthy from the menu bar app.
|
|
|
31
31
|
|
|
32
32
|
## When in doubt
|
|
33
33
|
|
|
34
|
-
- You can still use the CLI flow in [Gateway health](/gateway/health) (`openclaw status`, `openclaw status --deep`, `openclaw health --json`) and tail `/tmp/
|
|
34
|
+
- You can still use the CLI flow in [Gateway health](/gateway/health) (`openclaw status`, `openclaw status --deep`, `openclaw health --json`) and tail `/tmp/Heretek-AI/openclaw-*.log` for `web-heartbeat` / `web-reconnect`.
|
|
@@ -7,11 +7,11 @@ title: "macOS Signing"
|
|
|
7
7
|
|
|
8
8
|
# mac signing (debug builds)
|
|
9
9
|
|
|
10
|
-
This app is usually built from [`scripts/package-mac-app.sh`](https://github.com/
|
|
10
|
+
This app is usually built from [`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh), which now:
|
|
11
11
|
|
|
12
12
|
- sets a stable debug bundle identifier: `ai.openclaw.mac.debug`
|
|
13
13
|
- writes the Info.plist with that bundle id (override via `BUNDLE_ID=...`)
|
|
14
|
-
- calls [`scripts/codesign-mac-app.sh`](https://github.com/
|
|
14
|
+
- calls [`scripts/codesign-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/codesign-mac-app.sh) to sign the main binary and app bundle so macOS treats each rebuild as the same signed bundle and keeps TCC permissions (notifications, accessibility, screen recording, mic, speech). For stable permissions, use a real signing identity; ad-hoc is opt-in and fragile (see [macOS permissions](/platforms/mac/permissions)).
|
|
15
15
|
- uses `CODESIGN_TIMESTAMP=auto` by default; it enables trusted timestamps for Developer ID signatures. Set `CODESIGN_TIMESTAMP=off` to skip timestamping (offline debug builds).
|
|
16
16
|
- inject build metadata into Info.plist: `OpenClawBuildTimestamp` (UTC) and `OpenClawGitCommit` (short hash) so the About pane can show build, git, and debug/release channel.
|
|
17
17
|
- **Packaging defaults to Node 24**: the script runs TS builds and the Control UI build. Node 22 LTS, currently `22.16+`, remains supported for compatibility.
|
|
@@ -25,7 +25,7 @@ The macOS app surfaces OpenClaw skills via the gateway; it does not parse skills
|
|
|
25
25
|
|
|
26
26
|
## Env/API keys
|
|
27
27
|
|
|
28
|
-
- The app stores keys in `~/.
|
|
28
|
+
- The app stores keys in `~/.Heretek-AI/openclaw.json` under `skills.entries.<skillKey>`.
|
|
29
29
|
- `skills.update` patches `enabled`, `apiKey`, and `env`.
|
|
30
30
|
|
|
31
31
|
## Remote mode
|
|
@@ -118,7 +118,7 @@ curl -fsSL https://openclaw.ai/install.sh | bash
|
|
|
118
118
|
### Option B: Hackable Install (For tinkering)
|
|
119
119
|
|
|
120
120
|
```bash
|
|
121
|
-
git clone https://github.com/
|
|
121
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
122
122
|
cd openclaw
|
|
123
123
|
npm install
|
|
124
124
|
npm run build
|
|
@@ -225,7 +225,7 @@ systemctl --user status
|
|
|
225
225
|
Follow the Linux Getting Started flow inside WSL:
|
|
226
226
|
|
|
227
227
|
```bash
|
|
228
|
-
git clone https://github.com/
|
|
228
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
229
229
|
cd openclaw
|
|
230
230
|
pnpm install
|
|
231
231
|
pnpm ui:build # auto-installs UI deps on first run
|
|
@@ -38,7 +38,7 @@ You will be prompted to select an endpoint:
|
|
|
38
38
|
- **Global** - International users (`api.minimax.io`)
|
|
39
39
|
- **CN** - Users in China (`api.minimaxi.com`)
|
|
40
40
|
|
|
41
|
-
See [MiniMax plugin README](https://github.com/
|
|
41
|
+
See [MiniMax plugin README](https://github.com/Heretek-AI/openclaw/tree/main/extensions/minimax) for details.
|
|
42
42
|
|
|
43
43
|
### MiniMax M2.7 (API key)
|
|
44
44
|
|
|
@@ -34,8 +34,8 @@ OpenClaw has three public release lanes:
|
|
|
34
34
|
|
|
35
35
|
## Public references
|
|
36
36
|
|
|
37
|
-
- [`.github/workflows/openclaw-npm-release.yml`](https://github.com/
|
|
38
|
-
- [`scripts/openclaw-npm-release-check.ts`](https://github.com/
|
|
37
|
+
- [`.github/workflows/openclaw-npm-release.yml`](https://github.com/Heretek-AI/openclaw/blob/main/.github/workflows/openclaw-npm-release.yml)
|
|
38
|
+
- [`scripts/openclaw-npm-release-check.ts`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/openclaw-npm-release-check.ts)
|
|
39
39
|
|
|
40
40
|
Maintainers use the private release docs in
|
|
41
41
|
[`openclaw/maintainers/release/README.md`](https://github.com/openclaw/maintainers/blob/main/release/README.md)
|
package/docs/reference/test.md
CHANGED
|
@@ -43,7 +43,7 @@ If `pnpm test` flakes on a loaded host, rerun once before treating it as a regre
|
|
|
43
43
|
|
|
44
44
|
## Model latency bench (local keys)
|
|
45
45
|
|
|
46
|
-
Script: [`scripts/bench-model.ts`](https://github.com/
|
|
46
|
+
Script: [`scripts/bench-model.ts`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/bench-model.ts)
|
|
47
47
|
|
|
48
48
|
Usage:
|
|
49
49
|
|
|
@@ -58,7 +58,7 @@ Last run (2025-12-31, 20 runs):
|
|
|
58
58
|
|
|
59
59
|
## CLI startup bench
|
|
60
60
|
|
|
61
|
-
Script: [`scripts/bench-cli-startup.ts`](https://github.com/
|
|
61
|
+
Script: [`scripts/bench-cli-startup.ts`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/bench-cli-startup.ts)
|
|
62
62
|
|
|
63
63
|
Usage:
|
|
64
64
|
|
package/docs/reference/wizard.md
CHANGED
|
@@ -17,7 +17,7 @@ For a high-level overview, see [Onboarding (CLI)](/start/wizard).
|
|
|
17
17
|
|
|
18
18
|
<Steps>
|
|
19
19
|
<Step title="Existing config detection">
|
|
20
|
-
- If `~/.
|
|
20
|
+
- If `~/.Heretek-AI/openclaw.json` exists, choose **Keep / Modify / Reset**.
|
|
21
21
|
- Re-running onboarding does **not** wipe anything unless you explicitly choose **Reset**
|
|
22
22
|
(or pass `--reset`).
|
|
23
23
|
- CLI `--reset` defaults to `config+creds+sessions`; use `--reset-scope full`
|
|
@@ -202,7 +202,7 @@ Notes:
|
|
|
202
202
|
|
|
203
203
|
## What the wizard writes
|
|
204
204
|
|
|
205
|
-
Typical fields in `~/.
|
|
205
|
+
Typical fields in `~/.Heretek-AI/openclaw.json`:
|
|
206
206
|
|
|
207
207
|
- `agents.defaults.workspace`
|
|
208
208
|
- `agents.defaults.model` / `models.providers` (if Minimax chosen)
|
package/docs/start/lore.md
CHANGED
|
@@ -116,7 +116,7 @@ Moltbot never quite rolled off the tongue. And so, at 4am GMT, the team gathered
|
|
|
116
116
|
|
|
117
117
|
In just 3 hours:
|
|
118
118
|
|
|
119
|
-
- GitHub renamed: `github.com/
|
|
119
|
+
- GitHub renamed: `github.com/Heretek-AI/openclaw` ✅
|
|
120
120
|
- X handle `@openclaw` secured with GOLD CHECKMARK 💰
|
|
121
121
|
- npm packages released under new name
|
|
122
122
|
- Docs migrated to `docs.openclaw.ai`
|
package/docs/start/openclaw.md
CHANGED
package/docs/start/setup.md
CHANGED
|
@@ -15,7 +15,7 @@ For onboarding details, see [Onboarding (CLI)](/start/wizard).
|
|
|
15
15
|
|
|
16
16
|
## TL;DR
|
|
17
17
|
|
|
18
|
-
- **Tailoring lives outside the repo:** `~/.openclaw/workspace` (workspace) + `~/.
|
|
18
|
+
- **Tailoring lives outside the repo:** `~/.openclaw/workspace` (workspace) + `~/.Heretek-AI/openclaw.json` (config).
|
|
19
19
|
- **Stable workflow:** install the macOS app; let it run the bundled Gateway.
|
|
20
20
|
- **Bleeding edge workflow:** run the Gateway yourself via `pnpm gateway:watch`, then let the macOS app attach in Local mode.
|
|
21
21
|
|
|
@@ -29,7 +29,7 @@ For onboarding details, see [Onboarding (CLI)](/start/wizard).
|
|
|
29
29
|
|
|
30
30
|
If you want “100% tailored to me” _and_ easy updates, keep your customization in:
|
|
31
31
|
|
|
32
|
-
- **Config:** `~/.
|
|
32
|
+
- **Config:** `~/.Heretek-AI/openclaw.json` (JSON/JSON5-ish)
|
|
33
33
|
- **Workspace:** `~/.openclaw/workspace` (skills, prompts, memories; make it a private git repo)
|
|
34
34
|
|
|
35
35
|
Bootstrap once:
|
|
@@ -31,7 +31,7 @@ It does not install or modify anything on the remote host.
|
|
|
31
31
|
|
|
32
32
|
<Steps>
|
|
33
33
|
<Step title="Existing config detection">
|
|
34
|
-
- If `~/.
|
|
34
|
+
- If `~/.Heretek-AI/openclaw.json` exists, choose Keep, Modify, or Reset.
|
|
35
35
|
- Re-running the wizard does not wipe anything unless you explicitly choose Reset (or pass `--reset`).
|
|
36
36
|
- CLI `--reset` defaults to `config+creds+sessions`; use `--reset-scope full` to also remove workspace.
|
|
37
37
|
- If config is invalid or contains legacy keys, the wizard stops and asks you to run `openclaw doctor` before continuing.
|
|
@@ -248,7 +248,7 @@ to the gateway host.
|
|
|
248
248
|
|
|
249
249
|
## Outputs and internals
|
|
250
250
|
|
|
251
|
-
Typical fields in `~/.
|
|
251
|
+
Typical fields in `~/.Heretek-AI/openclaw.json`:
|
|
252
252
|
|
|
253
253
|
- `agents.defaults.workspace`
|
|
254
254
|
- `agents.defaults.model` / `models.providers` (if Minimax chosen)
|
|
@@ -164,7 +164,7 @@ openclaw gateway status
|
|
|
164
164
|
|
|
165
165
|
```bash
|
|
166
166
|
# Backup existing config
|
|
167
|
-
cp /home/openclaw/.
|
|
167
|
+
cp /home/openclaw/.Heretek-AI/openclaw.json /tmp/openclaw.json.bak
|
|
168
168
|
|
|
169
169
|
# Run heretek-openclaw installer
|
|
170
170
|
./first-run.sh --migrate
|
|
@@ -37,7 +37,7 @@ sudo dpkg -i google-chrome-stable_current_amd64.deb
|
|
|
37
37
|
sudo apt --fix-broken install -y # if there are dependency errors
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
Then update your OpenClaw config (`~/.
|
|
40
|
+
Then update your OpenClaw config (`~/.Heretek-AI/openclaw.json`):
|
|
41
41
|
|
|
42
42
|
```json
|
|
43
43
|
{
|
|
@@ -15,7 +15,7 @@ This guide covers the common split-host setup where:
|
|
|
15
15
|
- Chrome runs on Windows
|
|
16
16
|
- browser control must cross the WSL2/Windows boundary
|
|
17
17
|
|
|
18
|
-
It also covers the layered failure pattern from [issue #39369](https://github.com/
|
|
18
|
+
It also covers the layered failure pattern from [issue #39369](https://github.com/Heretek-AI/openclaw/issues/39369): several independent problems can show up at once, which makes the wrong layer look broken first.
|
|
19
19
|
|
|
20
20
|
## Choose the right browser mode first
|
|
21
21
|
|
package/docs/tools/browser.md
CHANGED
package/docs/tools/diffs.md
CHANGED
|
@@ -86,7 +86,7 @@ Optional compatibility controls:
|
|
|
86
86
|
## Where to set the key
|
|
87
87
|
|
|
88
88
|
**Via config:** run `openclaw configure --section web`. It stores the key in
|
|
89
|
-
`~/.
|
|
89
|
+
`~/.Heretek-AI/openclaw.json` under `plugins.entries.perplexity.config.webSearch.apiKey`.
|
|
90
90
|
That field also accepts SecretRef objects.
|
|
91
91
|
|
|
92
92
|
**Via environment:** set `PERPLEXITY_API_KEY` or `OPENROUTER_API_KEY`
|
package/docs/tools/skills.md
CHANGED
|
@@ -23,7 +23,7 @@ If a skill name conflicts, precedence is:
|
|
|
23
23
|
`<workspace>/skills` (highest) → `~/.openclaw/skills` → bundled skills (lowest)
|
|
24
24
|
|
|
25
25
|
Additionally, you can configure extra skill folders (lowest precedence) via
|
|
26
|
-
`skills.load.extraDirs` in `~/.
|
|
26
|
+
`skills.load.extraDirs` in `~/.Heretek-AI/openclaw.json`.
|
|
27
27
|
|
|
28
28
|
## Per-agent vs shared skills
|
|
29
29
|
|
|
@@ -189,7 +189,7 @@ Notes:
|
|
|
189
189
|
If no `metadata.openclaw` is present, the skill is always eligible (unless
|
|
190
190
|
disabled in config or blocked by `skills.allowBundled` for bundled skills).
|
|
191
191
|
|
|
192
|
-
## Config overrides (`~/.
|
|
192
|
+
## Config overrides (`~/.Heretek-AI/openclaw.json`)
|
|
193
193
|
|
|
194
194
|
Bundled/managed skills can be toggled and supplied with env values:
|
|
195
195
|
|
package/docs/web/control-ui.md
CHANGED
|
@@ -84,7 +84,7 @@ The Control UI can localize itself on first load based on your browser locale, a
|
|
|
84
84
|
- Skills: status, enable/disable, install, API key updates (`skills.*`)
|
|
85
85
|
- Nodes: list + caps (`node.list`)
|
|
86
86
|
- Exec approvals: edit gateway or node allowlists + ask policy for `exec host=gateway/node` (`exec.approvals.*`)
|
|
87
|
-
- Config: view/edit `~/.
|
|
87
|
+
- Config: view/edit `~/.Heretek-AI/openclaw.json` (`config.get`, `config.set`)
|
|
88
88
|
- Config: apply + restart with validation (`config.apply`) and wake the last active session
|
|
89
89
|
- Config writes include a base-hash guard to prevent clobbering concurrent edits
|
|
90
90
|
- Config schema + form rendering (`config.schema`, including plugin + channel schemas); Raw JSON editor remains available
|
package/docs/zh-CN/AGENTS.md
CHANGED
|
@@ -58,4 +58,4 @@ go run scripts/docs-i18n/main.go -mode segment docs/channels/matrix.md
|
|
|
58
58
|
- 反馈来源:GitHub issue #6995
|
|
59
59
|
- 反馈用户:@AaronWander、@taiyi747、@Explorer1092、@rendaoyuan
|
|
60
60
|
- 变更要点:更新 prompt 规则、扩充 glossary、清理 TM、批量再生成 + 定点修复
|
|
61
|
-
- 参考链接:https://github.com/
|
|
61
|
+
- 参考链接:https://github.com/Heretek-AI/openclaw/issues/6995
|
|
@@ -1046,6 +1046,6 @@ node -e "import('./path/to/handler.ts').then(console.log)"
|
|
|
1046
1046
|
## 另请参阅
|
|
1047
1047
|
|
|
1048
1048
|
- [CLI Reference: hooks](/cli/hooks)
|
|
1049
|
-
- [Bundled Hooks README](https://github.com/
|
|
1049
|
+
- [Bundled Hooks README](https://github.com/Heretek-AI/openclaw/tree/main/src/hooks/bundled)
|
|
1050
1050
|
- [Webhook Hooks](/automation/webhook)
|
|
1051
1051
|
- [Configuration](/gateway/configuration#hooks)
|
|
@@ -194,7 +194,7 @@ exec ssh -T bot@mac-mini.tailnet-1234.ts.net imsg "$@"
|
|
|
194
194
|
- 使用 SSH 密钥使 `ssh bot@mac-mini.tailnet-1234.ts.net` 无需提示即可工作。
|
|
195
195
|
- `remoteHost` 应与 SSH 目标匹配,以便 SCP 可以获取附件。
|
|
196
196
|
|
|
197
|
-
多账户支持:使用 `channels.imessage.accounts` 配置每个账户及可选的 `name`。参见 [`gateway/configuration`](/gateway/configuration#telegramaccounts--discordaccounts--slackaccounts--signalaccounts--imessageaccounts) 了解共享模式。不要提交 `~/.
|
|
197
|
+
多账户支持:使用 `channels.imessage.accounts` 配置每个账户及可选的 `name`。参见 [`gateway/configuration`](/gateway/configuration#telegramaccounts--discordaccounts--slackaccounts--signalaccounts--imessageaccounts) 了解共享模式。不要提交 `~/.Heretek-AI/openclaw.json`(它通常包含令牌)。
|
|
198
198
|
|
|
199
199
|
## 访问控制(私信 + 群组)
|
|
200
200
|
|
|
@@ -150,7 +150,7 @@ OpenClaw 将自动提供本地安装路径。
|
|
|
150
150
|
2. 创建一个 **Azure Bot**(App ID + 密钥 + 租户 ID)。
|
|
151
151
|
3. 构建一个引用机器人并包含以下 RSC 权限的 **Teams 应用包**。
|
|
152
152
|
4. 将 Teams 应用上传/安装到团队中(或用于私信的个人范围)。
|
|
153
|
-
5. 在 `~/.
|
|
153
|
+
5. 在 `~/.Heretek-AI/openclaw.json`(或环境变量)中配置 `msteams` 并启动 Gateway 网关。
|
|
154
154
|
6. Gateway 网关默认在 `/api/messages` 上监听 Bot Framework webhook 流量。
|
|
155
155
|
|
|
156
156
|
## Azure Bot 设置(前提条件)
|
|
@@ -19,7 +19,7 @@ x-i18n:
|
|
|
19
19
|
## 快速设置(新手)
|
|
20
20
|
|
|
21
21
|
1. 如果可能,使用**单独的手机号码**(推荐)。
|
|
22
|
-
2. 在 `~/.
|
|
22
|
+
2. 在 `~/.Heretek-AI/openclaw.json` 中配置 WhatsApp。
|
|
23
23
|
3. 运行 `openclaw channels login` 扫描二维码(关联设备)。
|
|
24
24
|
4. 启动 Gateway 网关。
|
|
25
25
|
|
|
@@ -390,7 +390,7 @@ WhatsApp 将音频作为**语音消息**(PTT 气泡)发送。
|
|
|
390
390
|
## 日志 + 故障排除
|
|
391
391
|
|
|
392
392
|
- 子系统:`whatsapp/inbound`、`whatsapp/outbound`、`web-heartbeat`、`web-reconnect`。
|
|
393
|
-
- 日志文件:`/tmp/
|
|
393
|
+
- 日志文件:`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`(可配置)。
|
|
394
394
|
- 故障排除指南:[Gateway 网关故障排除](/gateway/troubleshooting)。
|
|
395
395
|
|
|
396
396
|
## 故障排除(快速)
|
package/docs/zh-CN/cli/doctor.md
CHANGED
|
@@ -33,7 +33,7 @@ openclaw doctor --deep
|
|
|
33
33
|
注意事项:
|
|
34
34
|
|
|
35
35
|
- 交互式提示(如钥匙串/OAuth 修复)仅在 stdin 是 TTY 且**未**设置 `--non-interactive` 时运行。无头运行(cron、Telegram、无终端)将跳过提示。
|
|
36
|
-
- `--fix`(`--repair` 的别名)会将备份写入 `~/.
|
|
36
|
+
- `--fix`(`--repair` 的别名)会将备份写入 `~/.Heretek-AI/openclaw.json.bak`,并删除未知的配置键,同时列出每个删除项。
|
|
37
37
|
|
|
38
38
|
## macOS:`launchctl` 环境变量覆盖
|
|
39
39
|
|
|
@@ -42,7 +42,7 @@ openclaw gateway run
|
|
|
42
42
|
|
|
43
43
|
注意事项:
|
|
44
44
|
|
|
45
|
-
- 默认情况下,除非在 `~/.
|
|
45
|
+
- 默认情况下,除非在 `~/.Heretek-AI/openclaw.json` 中设置了 `gateway.mode=local`,否则 Gateway 网关将拒绝启动。使用 `--allow-unconfigured` 进行临时/开发运行。
|
|
46
46
|
- 在没有认证的情况下绑定到 loopback 之外的地址会被阻止(安全护栏)。
|
|
47
47
|
- `SIGUSR1` 在授权时触发进程内重启(启用 `commands.restart` 或使用 gateway 工具/config apply/update)。
|
|
48
48
|
- `SIGINT`/`SIGTERM` 处理程序会停止 Gateway 网关进程,但不会恢复任何自定义终端状态。如果你用 TUI 或 raw-mode 输入包装 CLI,请在退出前恢复终端。
|
|
@@ -127,7 +127,7 @@ openclaw sandbox recreate --agent alfred
|
|
|
127
127
|
|
|
128
128
|
## 配置
|
|
129
129
|
|
|
130
|
-
沙箱设置位于 `~/.
|
|
130
|
+
沙箱设置位于 `~/.Heretek-AI/openclaw.json` 的 `agents.defaults.sandbox` 下(每个智能体的覆盖设置在 `agents.list[].sandbox` 中):
|
|
131
131
|
|
|
132
132
|
```jsonc
|
|
133
133
|
{
|