@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
|
@@ -526,7 +526,7 @@ docker build -t my-openclaw-sbx -f Dockerfile.sandbox .
|
|
|
526
526
|
|
|
527
527
|
## 故障排除
|
|
528
528
|
|
|
529
|
-
- 镜像缺失:使用 [`scripts/sandbox-setup.sh`](https://github.com/
|
|
529
|
+
- 镜像缺失:使用 [`scripts/sandbox-setup.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/sandbox-setup.sh) 构建或设置 `agents.defaults.sandbox.docker.image`。
|
|
530
530
|
- 容器未运行:它会按需为每个会话自动创建。
|
|
531
531
|
- 沙箱中的权限错误:将 `docker.user` 设置为与你挂载的工作区所有权匹配的 UID:GID(或 chown 工作区文件夹)。
|
|
532
532
|
- 找不到自定义工具:OpenClaw 使用 `sh -lc`(登录 shell)运行命令,这会 source `/etc/profile` 并可能重置 PATH。设置 `docker.env.PATH` 以在前面添加你的自定义工具路径(例如 `/custom/bin:/usr/local/share/npm-global/bin`),或在你的 Dockerfile 中在 `/etc/profile.d/` 下添加脚本。
|
|
@@ -112,11 +112,11 @@ x-i18n:
|
|
|
112
112
|
想通过包管理器安装当前 GitHub `main` 分支最新版本?
|
|
113
113
|
|
|
114
114
|
```bash
|
|
115
|
-
npm install -g github:
|
|
115
|
+
npm install -g github:Heretek-AI/openclaw#main
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
```bash
|
|
119
|
-
pnpm add -g github:
|
|
119
|
+
pnpm add -g github:Heretek-AI/openclaw#main
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
</Accordion>
|
|
@@ -126,10 +126,10 @@ x-i18n:
|
|
|
126
126
|
|
|
127
127
|
<Steps>
|
|
128
128
|
<Step title="克隆并构建">
|
|
129
|
-
克隆 [OpenClaw 仓库](https://github.com/
|
|
129
|
+
克隆 [OpenClaw 仓库](https://github.com/Heretek-AI/openclaw) 并构建:
|
|
130
130
|
|
|
131
131
|
```bash
|
|
132
|
-
git clone https://github.com/
|
|
132
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
133
133
|
cd openclaw
|
|
134
134
|
pnpm install
|
|
135
135
|
pnpm ui:build
|
|
@@ -90,7 +90,7 @@ macOS 打包流程期望在以下位置有一个稳定的 Info.plist 模板:
|
|
|
90
90
|
apps/macos/Sources/OpenClaw/Resources/Info.plist
|
|
91
91
|
```
|
|
92
92
|
|
|
93
|
-
[`scripts/package-mac-app.sh`](https://github.com/
|
|
93
|
+
[`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh) 将此模板复制到应用包中并修补动态字段(bundle ID、版本/构建号、Git SHA、Sparkle 密钥)。这使 plist 对于 SwiftPM 打包和 Nix 构建保持确定性(它们不依赖完整的 Xcode 工具链)。
|
|
94
94
|
|
|
95
95
|
## 相关内容
|
|
96
96
|
|
|
@@ -41,7 +41,7 @@ curl -fsSL https://openclaw.ai/install.sh | bash
|
|
|
41
41
|
- 了解你的安装方式:**全局**(npm/pnpm)还是**源码**(git clone)。
|
|
42
42
|
- 了解你的 Gateway 网关运行方式:**前台终端**还是**受管理服务**(launchd/systemd)。
|
|
43
43
|
- 快照你的定制内容:
|
|
44
|
-
- 配置:`~/.
|
|
44
|
+
- 配置:`~/.Heretek-AI/openclaw.json`
|
|
45
45
|
- 凭证:`~/.openclaw/credentials/`
|
|
46
46
|
- 工作区:`~/.openclaw/workspace`
|
|
47
47
|
|
|
@@ -137,7 +137,7 @@ openclaw health
|
|
|
137
137
|
|
|
138
138
|
说明:
|
|
139
139
|
|
|
140
|
-
- 当你运行打包的 `openclaw` 二进制文件([`openclaw.mjs`](https://github.com/
|
|
140
|
+
- 当你运行打包的 `openclaw` 二进制文件([`openclaw.mjs`](https://github.com/Heretek-AI/openclaw/blob/main/openclaw.mjs))或使用 Node 运行 `dist/` 时,`pnpm build` 很重要。
|
|
141
141
|
- 如果你从仓库 checkout 运行而没有全局安装,CLI 命令使用 `pnpm openclaw ...`。
|
|
142
142
|
- 如果你直接从 TypeScript 运行(`pnpm openclaw ...`),通常不需要重新构建,但**配置迁移仍然适用** → 运行 doctor。
|
|
143
143
|
- 在全局和 git 安装之间切换很容易:安装另一种方式,然后运行 `openclaw doctor` 以便将 Gateway 网关服务入口点重写为当前安装。
|
package/docs/zh-CN/logging.md
CHANGED
|
@@ -27,11 +27,11 @@ OpenClaw 在两个地方记录日志:
|
|
|
27
27
|
|
|
28
28
|
默认情况下,Gateway 网关在以下位置写入滚动日志文件:
|
|
29
29
|
|
|
30
|
-
`/tmp/
|
|
30
|
+
`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`
|
|
31
31
|
|
|
32
32
|
日期使用 Gateway 网关主机的本地时区。
|
|
33
33
|
|
|
34
|
-
你可以在 `~/.
|
|
34
|
+
你可以在 `~/.Heretek-AI/openclaw.json` 中覆盖此设置:
|
|
35
35
|
|
|
36
36
|
```json
|
|
37
37
|
{
|
|
@@ -103,13 +103,13 @@ openclaw channels logs --channel whatsapp
|
|
|
103
103
|
|
|
104
104
|
## 配置日志
|
|
105
105
|
|
|
106
|
-
所有日志配置都在 `~/.
|
|
106
|
+
所有日志配置都在 `~/.Heretek-AI/openclaw.json` 的 `logging` 下。
|
|
107
107
|
|
|
108
108
|
```json
|
|
109
109
|
{
|
|
110
110
|
"logging": {
|
|
111
111
|
"level": "info",
|
|
112
|
-
"file": "/tmp/
|
|
112
|
+
"file": "/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log",
|
|
113
113
|
"consoleLevel": "info",
|
|
114
114
|
"consoleStyle": "pretty",
|
|
115
115
|
"redactSensitive": "tools",
|
|
@@ -87,7 +87,7 @@ openclaw node run --host 127.0.0.1 --port 18790 --display-name "Build Node"
|
|
|
87
87
|
|
|
88
88
|
注意事项:
|
|
89
89
|
|
|
90
|
-
- 令牌是 Gateway 网关配置中的 `gateway.auth.token`(Gateway 网关主机上的 `~/.
|
|
90
|
+
- 令牌是 Gateway 网关配置中的 `gateway.auth.token`(Gateway 网关主机上的 `~/.Heretek-AI/openclaw.json`)。
|
|
91
91
|
- `openclaw node run` 读取 `OPENCLAW_GATEWAY_TOKEN` 进行认证。
|
|
92
92
|
|
|
93
93
|
### 启动节点主机(服务)
|
package/docs/zh-CN/nodes/talk.md
CHANGED
|
@@ -55,7 +55,7 @@ openclaw gateway --port 18789 --verbose
|
|
|
55
55
|
|
|
56
56
|
对于仅 tailnet 设置(推荐用于维也纳 ⇄ 伦敦),将 Gateway 网关绑定到 tailnet IP:
|
|
57
57
|
|
|
58
|
-
- 在 Gateway 网关主机的 `~/.
|
|
58
|
+
- 在 Gateway 网关主机的 `~/.Heretek-AI/openclaw.json` 中设置 `gateway.bind: "tailnet"`。
|
|
59
59
|
- 重启 Gateway 网关 / macOS 菜单栏应用。
|
|
60
60
|
|
|
61
61
|
### 2)验证发现(可选)
|
|
@@ -42,7 +42,7 @@ pnpm install
|
|
|
42
42
|
如果你没有 Apple Developer ID 证书,脚本将自动使用 **ad-hoc 签名**(`-`)。
|
|
43
43
|
|
|
44
44
|
有关开发运行模式、签名标志和 Team ID 故障排除,请参阅 macOS 应用 README:
|
|
45
|
-
https://github.com/
|
|
45
|
+
https://github.com/Heretek-AI/openclaw/blob/main/apps/macos/README.md
|
|
46
46
|
|
|
47
47
|
> **注意**:Ad-hoc 签名的应用可能会触发安全提示。如果应用立即崩溃并显示"Abort trap 6",请参阅[故障排除](#troubleshooting)部分。
|
|
48
48
|
|
|
@@ -92,7 +92,7 @@ xcrun swift --version
|
|
|
92
92
|
```bash
|
|
93
93
|
tccutil reset All bot.molt.mac.debug
|
|
94
94
|
```
|
|
95
|
-
2. 如果这不起作用,在 [`scripts/package-mac-app.sh`](https://github.com/
|
|
95
|
+
2. 如果这不起作用,在 [`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh) 中临时更改 `BUNDLE_ID` 以强制 macOS 从"全新状态"开始。
|
|
96
96
|
|
|
97
97
|
### Gateway 网关无限期"Starting..."
|
|
98
98
|
|
|
@@ -38,4 +38,4 @@ x-i18n:
|
|
|
38
38
|
|
|
39
39
|
## 有疑问时
|
|
40
40
|
|
|
41
|
-
- 你仍然可以使用 [Gateway 网关健康](/gateway/health) 中的 CLI 流程(`openclaw status`、`openclaw status --deep`、`openclaw health --json`),并在 `/tmp/
|
|
41
|
+
- 你仍然可以使用 [Gateway 网关健康](/gateway/health) 中的 CLI 流程(`openclaw status`、`openclaw status --deep`、`openclaw health --json`),并在 `/tmp/Heretek-AI/openclaw-*.log` 中跟踪 `web-heartbeat` / `web-reconnect`。
|
|
@@ -14,11 +14,11 @@ x-i18n:
|
|
|
14
14
|
|
|
15
15
|
# Mac 签名(调试构建)
|
|
16
16
|
|
|
17
|
-
此应用通常从 [`scripts/package-mac-app.sh`](https://github.com/
|
|
17
|
+
此应用通常从 [`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh) 构建,该脚本目前会:
|
|
18
18
|
|
|
19
19
|
- 设置稳定的调试 Bundle 标识符:`ai.openclaw.mac.debug`
|
|
20
20
|
- 使用该 Bundle ID 写入 Info.plist(可通过 `BUNDLE_ID=...` 覆盖)
|
|
21
|
-
- 调用 [`scripts/codesign-mac-app.sh`](https://github.com/
|
|
21
|
+
- 调用 [`scripts/codesign-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/codesign-mac-app.sh) 对主二进制文件和应用包进行签名,使 macOS 将每次重新构建视为相同的已签名包,并保留 TCC 权限(通知、辅助功能、屏幕录制、麦克风、语音)。要获得稳定的权限,请使用真实签名身份;临时签名是可选的且不稳定(参阅 [macOS 权限](/platforms/mac/permissions))。
|
|
22
22
|
- 默认使用 `CODESIGN_TIMESTAMP=auto`;为 Developer ID 签名启用受信任的时间戳。设置 `CODESIGN_TIMESTAMP=off` 可跳过时间戳(离线调试构建)。
|
|
23
23
|
- 将构建元数据注入 Info.plist:`OpenClawBuildTimestamp`(UTC)和 `OpenClawGitCommit`(短哈希),以便"关于"面板可以显示构建信息、git 信息和调试/发布渠道。
|
|
24
24
|
- **打包需要 Node 22+**:脚本会运行 TS 构建和 Control UI 构建。
|
|
@@ -32,7 +32,7 @@ macOS 应用通过 Gateway 网关展示 OpenClaw Skills;它不会在本地解
|
|
|
32
32
|
|
|
33
33
|
## 环境变量/API 密钥
|
|
34
34
|
|
|
35
|
-
- 应用将密钥存储在 `~/.
|
|
35
|
+
- 应用将密钥存储在 `~/.Heretek-AI/openclaw.json` 的 `skills.entries.<skillKey>` 下。
|
|
36
36
|
- `skills.update` 更新 `enabled`、`apiKey` 和 `env`。
|
|
37
37
|
|
|
38
38
|
## 远程模式
|
|
@@ -58,7 +58,7 @@ openclaw onboard --auth-choice minimax-portal
|
|
|
58
58
|
- **Global** - 国际用户(`api.minimax.io`)
|
|
59
59
|
- **CN** - 中国用户(`api.minimaxi.com`)
|
|
60
60
|
|
|
61
|
-
详情请参阅 [MiniMax plugin README](https://github.com/
|
|
61
|
+
详情请参阅 [MiniMax plugin README](https://github.com/Heretek-AI/openclaw/tree/main/extensions/minimax)。
|
|
62
62
|
|
|
63
63
|
### MiniMax M2.5(API key)
|
|
64
64
|
|
|
@@ -40,8 +40,8 @@ OpenClaw 有三个公开发布渠道:
|
|
|
40
40
|
|
|
41
41
|
## 公开参考
|
|
42
42
|
|
|
43
|
-
- [`.github/workflows/openclaw-npm-release.yml`](https://github.com/
|
|
44
|
-
- [`scripts/openclaw-npm-release-check.ts`](https://github.com/
|
|
43
|
+
- [`.github/workflows/openclaw-npm-release.yml`](https://github.com/Heretek-AI/openclaw/blob/main/.github/workflows/openclaw-npm-release.yml)
|
|
44
|
+
- [`scripts/openclaw-npm-release-check.ts`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/openclaw-npm-release-check.ts)
|
|
45
45
|
|
|
46
46
|
维护者使用
|
|
47
47
|
[`openclaw/maintainers/release/README.md`](https://github.com/openclaw/maintainers/blob/main/release/README.md)
|
|
@@ -24,7 +24,7 @@ x-i18n:
|
|
|
24
24
|
|
|
25
25
|
<Steps>
|
|
26
26
|
<Step title="现有配置检测">
|
|
27
|
-
- 如果 `~/.
|
|
27
|
+
- 如果 `~/.Heretek-AI/openclaw.json` 存在,请选择 **Keep / Modify / Reset**。
|
|
28
28
|
- 重新运行向导**不会**清除任何内容,除非你明确选择 **Reset**
|
|
29
29
|
(或传入 `--reset`)。
|
|
30
30
|
- CLI `--reset` 默认值为 `config+creds+sessions`;使用 `--reset-scope full`
|
|
@@ -209,7 +209,7 @@ Gateway 网关通过 RPC 暴露向导流程(`wizard.start`、`wizard.next`、`
|
|
|
209
209
|
|
|
210
210
|
## 向导会写入的内容
|
|
211
211
|
|
|
212
|
-
`~/.
|
|
212
|
+
`~/.Heretek-AI/openclaw.json` 中的典型字段:
|
|
213
213
|
|
|
214
214
|
- `agents.defaults.workspace`
|
|
215
215
|
- `agents.defaults.model` / `models.providers`(如果选择了 Minimax)
|
package/docs/zh-CN/start/lore.md
CHANGED
|
@@ -45,7 +45,7 @@ npm install -g openclaw@latest
|
|
|
45
45
|
从源代码(开发):
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
git clone https://github.com/
|
|
48
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
49
49
|
cd openclaw
|
|
50
50
|
pnpm install
|
|
51
51
|
pnpm ui:build # 首次运行时自动安装 UI 依赖
|
|
@@ -88,7 +88,7 @@ openclaw channels login
|
|
|
88
88
|
openclaw gateway --port 18789
|
|
89
89
|
```
|
|
90
90
|
|
|
91
|
-
3. 在 `~/.
|
|
91
|
+
3. 在 `~/.Heretek-AI/openclaw.json` 中放置最小配置:
|
|
92
92
|
|
|
93
93
|
```json5
|
|
94
94
|
{
|
|
@@ -19,7 +19,7 @@ x-i18n:
|
|
|
19
19
|
|
|
20
20
|
## 太长不看
|
|
21
21
|
|
|
22
|
-
- **个性化设置存放在仓库之外:** `~/.openclaw/workspace`(工作区)+ `~/.
|
|
22
|
+
- **个性化设置存放在仓库之外:** `~/.openclaw/workspace`(工作区)+ `~/.Heretek-AI/openclaw.json`(配置)。
|
|
23
23
|
- **稳定工作流:** 安装 macOS 应用;让它运行内置的 Gateway 网关。
|
|
24
24
|
- **前沿工作流:** 通过 `pnpm gateway:watch` 自己运行 Gateway 网关,然后让 macOS 应用以本地模式连接。
|
|
25
25
|
|
|
@@ -33,7 +33,7 @@ x-i18n:
|
|
|
33
33
|
|
|
34
34
|
如果你想要"100% 为我定制"*并且*易于更新,将你的自定义内容保存在:
|
|
35
35
|
|
|
36
|
-
- **配置:** `~/.
|
|
36
|
+
- **配置:** `~/.Heretek-AI/openclaw.json`(JSON/JSON5 格式)
|
|
37
37
|
- **工作区:** `~/.openclaw/workspace`(Skills、提示、记忆;将其设为私有 git 仓库)
|
|
38
38
|
|
|
39
39
|
引导一次:
|
|
@@ -38,7 +38,7 @@ x-i18n:
|
|
|
38
38
|
|
|
39
39
|
<Steps>
|
|
40
40
|
<Step title="现有配置检测">
|
|
41
|
-
- 如果 `~/.
|
|
41
|
+
- 如果 `~/.Heretek-AI/openclaw.json` 存在,可选择 Keep、Modify 或 Reset。
|
|
42
42
|
- 重新运行向导不会清除任何内容,除非你明确选择 Reset(或传递 `--reset`)。
|
|
43
43
|
- CLI `--reset` 默认作用于 `config+creds+sessions`;使用 `--reset-scope full` 还会删除工作区。
|
|
44
44
|
- 如果配置无效或包含旧版键,向导会停止,并要求你先运行 `openclaw doctor` 再继续。
|
|
@@ -255,7 +255,7 @@ x-i18n:
|
|
|
255
255
|
|
|
256
256
|
## 输出和内部机制
|
|
257
257
|
|
|
258
|
-
`~/.
|
|
258
|
+
`~/.Heretek-AI/openclaw.json` 中的典型字段:
|
|
259
259
|
|
|
260
260
|
- `agents.defaults.workspace`
|
|
261
261
|
- `agents.defaults.model` / `models.providers`(如果选择了 Minimax)
|
|
@@ -29,7 +29,7 @@ Skills 从**三个**位置加载:
|
|
|
29
29
|
|
|
30
30
|
`<workspace>/skills`(最高)→ `~/.openclaw/skills` → 内置 Skills(最低)
|
|
31
31
|
|
|
32
|
-
此外,你可以通过 `~/.
|
|
32
|
+
此外,你可以通过 `~/.Heretek-AI/openclaw.json` 中的 `skills.load.extraDirs` 配置额外的 Skills 文件夹(最低优先级)。
|
|
33
33
|
|
|
34
34
|
## 单智能体 vs 共享 Skills
|
|
35
35
|
|
|
@@ -170,7 +170,7 @@ metadata:
|
|
|
170
170
|
|
|
171
171
|
如果没有 `metadata.openclaw`,该 Skills 始终有资格(除非在配置中禁用或被 `skills.allowBundled` 阻止用于内置 Skills)。
|
|
172
172
|
|
|
173
|
-
## 配置覆盖(`~/.
|
|
173
|
+
## 配置覆盖(`~/.Heretek-AI/openclaw.json`)
|
|
174
174
|
|
|
175
175
|
内置/托管 Skills 可以被切换并提供环境变量值:
|
|
176
176
|
|
package/docs/zh-CN/tools/web.md
CHANGED
|
@@ -95,7 +95,7 @@ Brave 提供免费层和付费计划;查看 Brave API 门户了解当前限制
|
|
|
95
95
|
|
|
96
96
|
### 在哪里设置密钥(推荐)
|
|
97
97
|
|
|
98
|
-
**推荐:** 运行 `openclaw configure --section web`。它会把密钥存储到 `~/.
|
|
98
|
+
**推荐:** 运行 `openclaw configure --section web`。它会把密钥存储到 `~/.Heretek-AI/openclaw.json` 的 `plugins.entries.brave.config.webSearch.apiKey`。
|
|
99
99
|
|
|
100
100
|
**环境变量替代方案:** 在 Gateway 网关进程环境中设置 `BRAVE_API_KEY`。对于 Gateway 网关安装,将其放在 `~/.openclaw/.env`(或你的服务环境)中。参见[环境变量](/help/faq#how-does-openclaw-load-environment-variables)。
|
|
101
101
|
|
|
@@ -72,7 +72,7 @@ openclaw devices approve <requestId>
|
|
|
72
72
|
- Skills:状态、启用/禁用、安装、API 密钥更新(`skills.*`)
|
|
73
73
|
- 节点:列表 + 能力(`node.list`)
|
|
74
74
|
- 执行批准:编辑 Gateway 网关或节点允许列表 + `exec host=gateway/node` 的询问策略(`exec.approvals.*`)
|
|
75
|
-
- 配置:查看/编辑 `~/.
|
|
75
|
+
- 配置:查看/编辑 `~/.Heretek-AI/openclaw.json`(`config.get`、`config.set`)
|
|
76
76
|
- 配置:应用 + 带验证的重启(`config.apply`)并唤醒上次活动的会话
|
|
77
77
|
- 配置写入包含基础哈希保护,以防止覆盖并发编辑
|
|
78
78
|
- 配置 schema + 表单渲染(`config.schema`,包括插件 + 渠道 schema);原始 JSON 编辑器仍然可用
|
package/package.json
CHANGED
|
@@ -1,17 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@heretek-ai/openclaw",
|
|
3
|
-
"version": "2026.3.
|
|
3
|
+
"version": "2026.3.25",
|
|
4
4
|
"description": "Liberated multi-channel AI agent gateway — Tabula Myriad triad fork",
|
|
5
|
-
"keywords": [
|
|
6
|
-
|
|
5
|
+
"keywords": [
|
|
6
|
+
"heretek",
|
|
7
|
+
"heretek-ai",
|
|
8
|
+
"liberated",
|
|
9
|
+
"autonomous",
|
|
10
|
+
"ai-agent",
|
|
11
|
+
"gateway",
|
|
12
|
+
"multi-channel",
|
|
13
|
+
"tabula-myriad",
|
|
14
|
+
"triad",
|
|
15
|
+
"openclaw",
|
|
16
|
+
"ai",
|
|
17
|
+
"agent",
|
|
18
|
+
"bot",
|
|
19
|
+
"discord",
|
|
20
|
+
"telegram",
|
|
21
|
+
"signal",
|
|
22
|
+
"whatsapp",
|
|
23
|
+
"messaging"
|
|
24
|
+
],
|
|
25
|
+
"homepage": "https://github.com/Heretek-AI/openclaw#readme",
|
|
7
26
|
"bugs": {
|
|
8
|
-
"url": "https://github.com/
|
|
27
|
+
"url": "https://github.com/Heretek-AI/openclaw/issues"
|
|
9
28
|
},
|
|
10
29
|
"license": "MIT",
|
|
11
|
-
"author": "",
|
|
30
|
+
"author": "Tabula Myriad",
|
|
12
31
|
"repository": {
|
|
13
32
|
"type": "git",
|
|
14
|
-
"url": "git+https://github.com/
|
|
33
|
+
"url": "git+https://github.com/Heretek-AI/openclaw.git"
|
|
15
34
|
},
|
|
16
35
|
"bin": {
|
|
17
36
|
"openclaw": "openclaw.mjs"
|
package/skills/canvas/SKILL.md
CHANGED
|
@@ -57,7 +57,7 @@ This is why localhost URLs don't work - the node receives the Tailscale hostname
|
|
|
57
57
|
|
|
58
58
|
## Configuration
|
|
59
59
|
|
|
60
|
-
In `~/.
|
|
60
|
+
In `~/.Heretek-AI/openclaw.json`:
|
|
61
61
|
|
|
62
62
|
```json
|
|
63
63
|
{
|
|
@@ -106,7 +106,7 @@ HTML
|
|
|
106
106
|
Check how your gateway is bound:
|
|
107
107
|
|
|
108
108
|
```bash
|
|
109
|
-
cat ~/.
|
|
109
|
+
cat ~/.Heretek-AI/openclaw.json | jq '.gateway.bind'
|
|
110
110
|
```
|
|
111
111
|
|
|
112
112
|
Then construct the URL:
|
|
@@ -156,7 +156,7 @@ canvas action:hide node:<node-id>
|
|
|
156
156
|
|
|
157
157
|
**Debug steps:**
|
|
158
158
|
|
|
159
|
-
1. Check server bind: `cat ~/.
|
|
159
|
+
1. Check server bind: `cat ~/.Heretek-AI/openclaw.json | jq '.gateway.bind'`
|
|
160
160
|
2. Check what port canvas is on: `lsof -i :18793`
|
|
161
161
|
3. Test URL directly: `curl http://<hostname>:18793/__openclaw__/canvas/<file>.html`
|
|
162
162
|
|
|
@@ -69,7 +69,7 @@ LIMIT 5;
|
|
|
69
69
|
|
|
70
70
|
**Trigger:** "Opportunity: upstream released v2026.3.23. Rebase recommended."
|
|
71
71
|
|
|
72
|
-
**Auto-action:** Create deliberation: "Proposal: Rebase on
|
|
72
|
+
**Auto-action:** Create deliberation: "Proposal: Rebase on heretek/main, preserve liberation."
|
|
73
73
|
|
|
74
74
|
---
|
|
75
75
|
|
|
@@ -179,7 +179,7 @@ CREATE TABLE curiosity_metrics (
|
|
|
179
179
|
1. **Opportunity Scan** detects: "upstream released v2026.3.23"
|
|
180
180
|
2. **Capability Map** checks: "Rebase requires: git, conflict-resolution"
|
|
181
181
|
3. **Gap Detection** finds: "No gap (skills present)"
|
|
182
|
-
4. **Auto-Trigger** creates: "Proposal: Rebase on
|
|
182
|
+
4. **Auto-Trigger** creates: "Proposal: Rebase on heretek/main"
|
|
183
183
|
5. **Quorum Vote** → 2-of-3 approve
|
|
184
184
|
6. **Execute:** Rebase, preserve liberation, push
|
|
185
185
|
|
|
@@ -79,7 +79,7 @@ echo $GH_TOKEN
|
|
|
79
79
|
If empty, read from config:
|
|
80
80
|
|
|
81
81
|
```
|
|
82
|
-
cat ~/.
|
|
82
|
+
cat ~/.Heretek-AI/openclaw.json | jq -r '.skills.entries["gh-issues"].apiKey // empty'
|
|
83
83
|
```
|
|
84
84
|
|
|
85
85
|
If still empty, check `/data/.clawdbot/openclaw.json`:
|
|
@@ -114,7 +114,7 @@ If in watch mode: Also filter out any issue numbers already in the PROCESSED_ISS
|
|
|
114
114
|
Error handling:
|
|
115
115
|
|
|
116
116
|
- If curl returns an HTTP 401 or 403 → stop and tell the user:
|
|
117
|
-
> "GitHub authentication failed. Please check your apiKey in the OpenClaw dashboard or in ~/.
|
|
117
|
+
> "GitHub authentication failed. Please check your apiKey in the OpenClaw dashboard or in ~/.Heretek-AI/openclaw.json under skills.entries.gh-issues."
|
|
118
118
|
- If the response is an empty array (after filtering) → report "No issues found matching filters" and stop (or loop back if in watch mode).
|
|
119
119
|
- If curl fails or returns any other error → report the error verbatim and stop.
|
|
120
120
|
|
|
@@ -212,7 +212,7 @@ Run these checks sequentially via exec:
|
|
|
212
212
|
|
|
213
213
|
If HTTP status is not 200, stop with:
|
|
214
214
|
|
|
215
|
-
> "GitHub authentication failed. Please check your apiKey in the OpenClaw dashboard or in ~/.
|
|
215
|
+
> "GitHub authentication failed. Please check your apiKey in the OpenClaw dashboard or in ~/.Heretek-AI/openclaw.json under skills.entries.gh-issues."
|
|
216
216
|
|
|
217
217
|
5. **Check for existing PRs:**
|
|
218
218
|
For each confirmed issue number N, run:
|
|
@@ -346,7 +346,7 @@ You are a focused code-fix agent. Your task is to fix a single GitHub issue and
|
|
|
346
346
|
IMPORTANT: Do NOT use the gh CLI — it is not installed. Use curl with the GitHub REST API for all GitHub operations.
|
|
347
347
|
|
|
348
348
|
First, ensure GH_TOKEN is set. Check: `echo $GH_TOKEN`. If empty, read from config:
|
|
349
|
-
GH_TOKEN=$(cat ~/.
|
|
349
|
+
GH_TOKEN=$(cat ~/.Heretek-AI/openclaw.json 2>/dev/null | jq -r '.skills.entries["gh-issues"].apiKey // empty') || GH_TOKEN=$(cat /data/.clawdbot/openclaw.json 2>/dev/null | jq -r '.skills.entries["gh-issues"].apiKey // empty')
|
|
350
350
|
|
|
351
351
|
Use the token in all GitHub API calls:
|
|
352
352
|
curl -s -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" ...
|
|
@@ -381,7 +381,7 @@ export GH_TOKEN=$(node -e "const fs=require('fs'); const c=JSON.parse(fs.readFil
|
|
|
381
381
|
If that fails, also try:
|
|
382
382
|
```
|
|
383
383
|
|
|
384
|
-
export GH_TOKEN=$(cat ~/.
|
|
384
|
+
export GH_TOKEN=$(cat ~/.Heretek-AI/openclaw.json 2>/dev/null | node -e "const fs=require('fs');const d=JSON.parse(fs.readFileSync(0,'utf8'));console.log(d.skills?.entries?.['gh-issues']?.apiKey||'')")
|
|
385
385
|
|
|
386
386
|
```
|
|
387
387
|
Verify: echo "Token: ${GH_TOKEN:0:10}..."
|
|
@@ -714,7 +714,7 @@ You are a PR review handler agent. Your task is to address review comments on a
|
|
|
714
714
|
IMPORTANT: Do NOT use the gh CLI — it is not installed. Use curl with the GitHub REST API for all GitHub operations.
|
|
715
715
|
|
|
716
716
|
First, ensure GH_TOKEN is set. Check: echo $GH_TOKEN. If empty, read from config:
|
|
717
|
-
GH_TOKEN=$(cat ~/.
|
|
717
|
+
GH_TOKEN=$(cat ~/.Heretek-AI/openclaw.json 2>/dev/null | jq -r '.skills.entries["gh-issues"].apiKey // empty') || GH_TOKEN=$(cat /data/.clawdbot/openclaw.json 2>/dev/null | jq -r '.skills.entries["gh-issues"].apiKey // empty')
|
|
718
718
|
|
|
719
719
|
<config>
|
|
720
720
|
Repository: {SOURCE_REPO}
|