@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
|
@@ -26,7 +26,7 @@ x-i18n:
|
|
|
26
26
|
- 默认值:`~/.openclaw/workspace`
|
|
27
27
|
- 如果设置了 `OPENCLAW_PROFILE` 且其值不是 `"default"`,默认值将变为
|
|
28
28
|
`~/.openclaw/workspace-<profile>`。
|
|
29
|
-
- 在 `~/.
|
|
29
|
+
- 在 `~/.Heretek-AI/openclaw.json` 中覆盖:
|
|
30
30
|
|
|
31
31
|
```json5
|
|
32
32
|
{
|
|
@@ -117,7 +117,7 @@ x-i18n:
|
|
|
117
117
|
|
|
118
118
|
这些内容位于 `~/.openclaw/` 下,**不应**提交到工作区仓库:
|
|
119
119
|
|
|
120
|
-
- `~/.
|
|
120
|
+
- `~/.Heretek-AI/openclaw.json`(配置)
|
|
121
121
|
- `~/.openclaw/credentials/`(OAuth 令牌、API 密钥)
|
|
122
122
|
- `~/.openclaw/agents/<agentId>/sessions/`(会话记录和元数据)
|
|
123
123
|
- `~/.openclaw/skills/`(托管 Skills)
|
|
@@ -208,7 +208,7 @@ git push
|
|
|
208
208
|
## 将工作区迁移到新机器
|
|
209
209
|
|
|
210
210
|
1. 将仓库克隆到所需路径(默认是 `~/.openclaw/workspace`)。
|
|
211
|
-
2. 在 `~/.
|
|
211
|
+
2. 在 `~/.Heretek-AI/openclaw.json` 中将 `agents.defaults.workspace` 设置为该路径。
|
|
212
212
|
3. 运行 `openclaw setup --workspace <path>` 以植入任何缺失的文件。
|
|
213
213
|
4. 如果你需要会话,请将旧机器上的 `~/.openclaw/agents/<agentId>/sessions/` 单独复制过来。
|
|
214
214
|
|
|
@@ -20,7 +20,7 @@ OpenClaw 运行一个源自 **pi-mono** 的嵌入式智能体运行时。
|
|
|
20
20
|
|
|
21
21
|
OpenClaw 使用单一智能体工作区目录(`agents.defaults.workspace`)作为智能体**唯一**的工作目录(`cwd`),用于工具和上下文。
|
|
22
22
|
|
|
23
|
-
建议:使用 `openclaw setup` 在缺失时创建 `~/.
|
|
23
|
+
建议:使用 `openclaw setup` 在缺失时创建 `~/.Heretek-AI/openclaw.json` 并初始化工作区文件。
|
|
24
24
|
|
|
25
25
|
完整工作区布局 + 备份指南:[智能体工作区](/concepts/agent-workspace)
|
|
26
26
|
|
|
@@ -40,7 +40,7 @@ Gateway 网关可以托管**一个智能体**(默认)或**多个智能体**
|
|
|
40
40
|
|
|
41
41
|
## 路径(快速映射)
|
|
42
42
|
|
|
43
|
-
- 配置:`~/.
|
|
43
|
+
- 配置:`~/.Heretek-AI/openclaw.json`(或 `OPENCLAW_CONFIG_PATH`)
|
|
44
44
|
- 状态目录:`~/.openclaw`(或 `OPENCLAW_STATE_DIR`)
|
|
45
45
|
- 工作区:`~/.openclaw/workspace`(或 `~/.openclaw/workspace-<agentId>`)
|
|
46
46
|
- 智能体目录:`~/.openclaw/agents/<agentId>/agent`(或 `agents.list[].agentDir`)
|
|
@@ -139,7 +139,7 @@ openclaw agents list --bindings
|
|
|
139
139
|
|
|
140
140
|
## 示例:两个 WhatsApp → 两个智能体
|
|
141
141
|
|
|
142
|
-
`~/.
|
|
142
|
+
`~/.Heretek-AI/openclaw.json`(JSON5):
|
|
143
143
|
|
|
144
144
|
```js
|
|
145
145
|
{
|
|
@@ -275,7 +275,7 @@ Swift 生成器输出:
|
|
|
275
275
|
|
|
276
276
|
生成的 JSON Schema 在仓库的 `dist/protocol.schema.json` 中。发布的原始文件通常可在以下位置获取:
|
|
277
277
|
|
|
278
|
-
- https://raw.githubusercontent.com/
|
|
278
|
+
- https://raw.githubusercontent.com/Heretek-AI/openclaw/main/dist/protocol.schema.json
|
|
279
279
|
|
|
280
280
|
## 当你更改模式时
|
|
281
281
|
|
|
@@ -64,7 +64,7 @@ OPENCLAW_DIAGNOSTICS=0
|
|
|
64
64
|
标志将日志输出到标准诊断日志文件。默认位置:
|
|
65
65
|
|
|
66
66
|
```
|
|
67
|
-
/tmp/
|
|
67
|
+
/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log
|
|
68
68
|
```
|
|
69
69
|
|
|
70
70
|
如果你设置了 `logging.file`,则使用该路径。日志为 JSONL 格式(每行一个 JSON 对象)。脱敏仍然根据 `logging.redactSensitive` 应用。
|
|
@@ -74,19 +74,19 @@ OPENCLAW_DIAGNOSTICS=0
|
|
|
74
74
|
选择最新的日志文件:
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
|
-
ls -t /tmp/
|
|
77
|
+
ls -t /tmp/Heretek-AI/openclaw-*.log | head -n 1
|
|
78
78
|
```
|
|
79
79
|
|
|
80
80
|
过滤 Telegram HTTP 诊断:
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
rg "telegram http error" /tmp/
|
|
83
|
+
rg "telegram http error" /tmp/Heretek-AI/openclaw-*.log
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
或在复现时使用 tail:
|
|
87
87
|
|
|
88
88
|
```bash
|
|
89
|
-
tail -f /tmp/
|
|
89
|
+
tail -f /tmp/Heretek-AI/openclaw-$(date +%F).log | rg "telegram http error"
|
|
90
90
|
```
|
|
91
91
|
|
|
92
92
|
对于远程 Gateway 网关,你也可以使用 `openclaw logs --follow`(参见 [/cli/logs](/cli/logs))。
|
|
@@ -80,7 +80,7 @@ Gateway 网关 WS 端口(默认 `18789`)默认绑定到 loopback。对于局
|
|
|
80
80
|
|
|
81
81
|
对于仅 Tailnet 的设置:
|
|
82
82
|
|
|
83
|
-
- 在 `~/.
|
|
83
|
+
- 在 `~/.Heretek-AI/openclaw.json` 中设置 `gateway.bind: "tailnet"`。
|
|
84
84
|
- 重启 Gateway 网关(或重启 macOS 菜单栏应用)。
|
|
85
85
|
|
|
86
86
|
## 什么在广播
|
|
@@ -163,7 +163,7 @@ Bonjour/DNS‑SD 经常将服务实例名称中的字节转义为十进制 `\DDD
|
|
|
163
163
|
## 禁用 / 配置
|
|
164
164
|
|
|
165
165
|
- `OPENCLAW_DISABLE_BONJOUR=1` 禁用广播(旧版:`OPENCLAW_DISABLE_BONJOUR`)。
|
|
166
|
-
- `~/.
|
|
166
|
+
- `~/.Heretek-AI/openclaw.json` 中的 `gateway.bind` 控制 Gateway 网关绑定模式。
|
|
167
167
|
- `OPENCLAW_SSH_PORT` 覆盖 TXT 中广播的 SSH 端口(旧版:`OPENCLAW_SSH_PORT`)。
|
|
168
168
|
- `OPENCLAW_TAILNET_DNS` 在 TXT 中发布 MagicDNS 提示(旧版:`OPENCLAW_TAILNET_DNS`)。
|
|
169
169
|
- `OPENCLAW_CLI_PATH` 覆盖广播的 CLI 路径(旧版:`OPENCLAW_CLI_PATH`)。
|
|
@@ -77,7 +77,7 @@ Payload 字段(除非注明,否则都是可选的):
|
|
|
77
77
|
|
|
78
78
|
## Tailnet 使用
|
|
79
79
|
|
|
80
|
-
- 将 bridge 绑定到 tailnet IP:在 `~/.
|
|
80
|
+
- 将 bridge 绑定到 tailnet IP:在 `~/.Heretek-AI/openclaw.json` 中设置 `bridge.bind: "tailnet"`。
|
|
81
81
|
- 客户端通过 MagicDNS 名称或 tailnet IP 连接。
|
|
82
82
|
- Bonjour **不**跨网络;需要时使用手动主机/端口或广域 DNS‑SD。
|
|
83
83
|
|
|
@@ -29,7 +29,7 @@ x-i18n:
|
|
|
29
29
|
}
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
-
保存到 `~/.
|
|
32
|
+
保存到 `~/.Heretek-AI/openclaw.json`,你就可以从该号码私信机器人了。
|
|
33
33
|
|
|
34
34
|
### 推荐的入门配置
|
|
35
35
|
|
|
@@ -96,7 +96,7 @@ x-i18n:
|
|
|
96
96
|
// 日志
|
|
97
97
|
logging: {
|
|
98
98
|
level: "info",
|
|
99
|
-
file: "/tmp/
|
|
99
|
+
file: "/tmp/Heretek-AI/openclaw.log",
|
|
100
100
|
consoleLevel: "info",
|
|
101
101
|
consoleStyle: "pretty",
|
|
102
102
|
redactSensitive: "tools",
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: Complete field-by-field reference for ~/.
|
|
2
|
+
description: Complete field-by-field reference for ~/.Heretek-AI/openclaw.json
|
|
3
3
|
read_when:
|
|
4
4
|
- 你需要精确到字段级别的配置语义或默认值
|
|
5
5
|
- 你正在验证渠道、模型、Gateway 网关或工具配置块
|
|
@@ -16,7 +16,7 @@ x-i18n:
|
|
|
16
16
|
|
|
17
17
|
# 配置参考
|
|
18
18
|
|
|
19
|
-
`~/.
|
|
19
|
+
`~/.Heretek-AI/openclaw.json` 中所有可用字段。若需面向任务的概览,请参见 [Configuration](/gateway/configuration)。
|
|
20
20
|
|
|
21
21
|
配置格式为 **JSON5**(允许注释和尾随逗号)。所有字段都是可选的——省略时,OpenClaw 会使用安全默认值。
|
|
22
22
|
|
|
@@ -2912,7 +2912,7 @@ Secret refs 是增量能力:明文值仍然可用。
|
|
|
2912
2912
|
{
|
|
2913
2913
|
logging: {
|
|
2914
2914
|
level: "info",
|
|
2915
|
-
file: "/tmp/
|
|
2915
|
+
file: "/tmp/Heretek-AI/openclaw.log",
|
|
2916
2916
|
consoleLevel: "info",
|
|
2917
2917
|
consoleStyle: "pretty", // pretty | compact | json
|
|
2918
2918
|
redactSensitive: "tools", // off | tools
|
|
@@ -2921,7 +2921,7 @@ Secret refs 是增量能力:明文值仍然可用。
|
|
|
2921
2921
|
}
|
|
2922
2922
|
```
|
|
2923
2923
|
|
|
2924
|
-
- 默认日志文件:`/tmp/
|
|
2924
|
+
- 默认日志文件:`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`。
|
|
2925
2925
|
- 设置 `logging.file` 以获得稳定路径。
|
|
2926
2926
|
- 使用 `--verbose` 时,`consoleLevel` 会提升为 `debug`。
|
|
2927
2927
|
|
|
@@ -3079,7 +3079,7 @@ Secret refs 是增量能力:明文值仍然可用。
|
|
|
3079
3079
|
将配置拆分为多个文件:
|
|
3080
3080
|
|
|
3081
3081
|
```json5
|
|
3082
|
-
// ~/.
|
|
3082
|
+
// ~/.Heretek-AI/openclaw.json
|
|
3083
3083
|
{
|
|
3084
3084
|
gateway: { port: 18789 },
|
|
3085
3085
|
agents: { $include: "./agents.json5" },
|
|
@@ -16,7 +16,7 @@ x-i18n:
|
|
|
16
16
|
|
|
17
17
|
# 配置
|
|
18
18
|
|
|
19
|
-
OpenClaw 会从 `~/.
|
|
19
|
+
OpenClaw 会从 `~/.Heretek-AI/openclaw.json` 读取可选的 <Tooltip tip="JSON5 supports comments and trailing commas">**JSON5**</Tooltip> 配置。
|
|
20
20
|
|
|
21
21
|
如果该文件缺失,OpenClaw 会使用安全的默认值。添加配置的常见原因包括:
|
|
22
22
|
|
|
@@ -33,7 +33,7 @@ OpenClaw 会从 `~/.openclaw/openclaw.json` 读取可选的 <Tooltip tip="JSON5
|
|
|
33
33
|
## 最小配置
|
|
34
34
|
|
|
35
35
|
```json5
|
|
36
|
-
// ~/.
|
|
36
|
+
// ~/.Heretek-AI/openclaw.json
|
|
37
37
|
{
|
|
38
38
|
agents: { defaults: { workspace: "~/.openclaw/workspace" } },
|
|
39
39
|
channels: { whatsapp: { allowFrom: ["+15555550123"] } },
|
|
@@ -61,7 +61,7 @@ OpenClaw 会从 `~/.openclaw/openclaw.json` 读取可选的 <Tooltip tip="JSON5
|
|
|
61
61
|
Control UI 会根据配置 schema 渲染表单,并提供 **Raw JSON** 编辑器作为后备方式。
|
|
62
62
|
</Tab>
|
|
63
63
|
<Tab title="Direct edit">
|
|
64
|
-
直接编辑 `~/.
|
|
64
|
+
直接编辑 `~/.Heretek-AI/openclaw.json`。Gateway 网关会监视该文件并自动应用更改(参见[热重载](#config-hot-reload))。
|
|
65
65
|
</Tab>
|
|
66
66
|
</Tabs>
|
|
67
67
|
|
|
@@ -420,7 +420,7 @@ OpenClaw 只接受完全符合 schema 的配置。未知键、类型格式错误
|
|
|
420
420
|
使用 `$include` 组织大型配置:
|
|
421
421
|
|
|
422
422
|
```json5
|
|
423
|
-
// ~/.
|
|
423
|
+
// ~/.Heretek-AI/openclaw.json
|
|
424
424
|
{
|
|
425
425
|
gateway: { port: 18789 },
|
|
426
426
|
agents: { $include: "./agents.json5" },
|
|
@@ -442,7 +442,7 @@ OpenClaw 只接受完全符合 schema 的配置。未知键、类型格式错误
|
|
|
442
442
|
|
|
443
443
|
## 配置热重载
|
|
444
444
|
|
|
445
|
-
Gateway 网关会监视 `~/.
|
|
445
|
+
Gateway 网关会监视 `~/.Heretek-AI/openclaw.json` 并自动应用更改 —— 对于大多数设置,无需手动重启。
|
|
446
446
|
|
|
447
447
|
### 重载模式
|
|
448
448
|
|
|
@@ -78,7 +78,7 @@ Bonjour 是尽力而为的,不会跨网络。它仅用于"同一 LAN"的便利
|
|
|
78
78
|
禁用/覆盖:
|
|
79
79
|
|
|
80
80
|
- `OPENCLAW_DISABLE_BONJOUR=1` 禁用广播。
|
|
81
|
-
- `~/.
|
|
81
|
+
- `~/.Heretek-AI/openclaw.json` 中的 `gateway.bind` 控制 Gateway 网关绑定模式。
|
|
82
82
|
- `OPENCLAW_SSH_PORT` 覆盖 TXT 中广播的 SSH 端口(默认为 22)。
|
|
83
83
|
- `OPENCLAW_TAILNET_DNS` 发布 `tailnetDns` 提示(MagicDNS)。
|
|
84
84
|
- `OPENCLAW_CLI_PATH` 覆盖广播的 CLI 路径。
|
|
@@ -59,7 +59,7 @@ openclaw doctor --deep
|
|
|
59
59
|
如果你想在写入前查看更改,请先打开配置文件:
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
cat ~/.
|
|
62
|
+
cat ~/.Heretek-AI/openclaw.json
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
## 功能概述
|
|
@@ -106,7 +106,7 @@ Doctor 将:
|
|
|
106
106
|
|
|
107
107
|
- 解释找到了哪些遗留键。
|
|
108
108
|
- 显示它应用的迁移。
|
|
109
|
-
- 使用更新后的 schema 重写 `~/.
|
|
109
|
+
- 使用更新后的 schema 重写 `~/.Heretek-AI/openclaw.json`。
|
|
110
110
|
|
|
111
111
|
Gateway 网关在检测到遗留配置格式时也会在启动时自动运行 doctor 迁移,因此过时的配置无需手动干预即可修复。
|
|
112
112
|
|
|
@@ -158,7 +158,7 @@ Doctor 检查:
|
|
|
158
158
|
- **主会话"1 行 JSONL"**:当主记录只有一行时标记(历史未累积)。
|
|
159
159
|
- **多个状态目录**:当多个 `~/.openclaw` 文件夹存在于不同 home 目录或当 `OPENCLAW_STATE_DIR` 指向别处时发出警告(历史可能在安装之间分裂)。
|
|
160
160
|
- **远程模式提醒**:如果 `gateway.mode=remote`,doctor 会提醒你在远程主机上运行它(状态在那里)。
|
|
161
|
-
- **配置文件权限**:当 `~/.
|
|
161
|
+
- **配置文件权限**:当 `~/.Heretek-AI/openclaw.json` 对组/其他用户可读时发出警告,并提供收紧到 `600` 的选项。
|
|
162
162
|
|
|
163
163
|
### 5)模型认证健康(OAuth 过期)
|
|
164
164
|
|
|
@@ -23,7 +23,7 @@ x-i18n:
|
|
|
23
23
|
- `openclaw status --deep` — 还会探测运行中的 Gateway 网关(支持时进行每渠道探测)。
|
|
24
24
|
- `openclaw health --json` — 向运行中的 Gateway 网关请求完整健康快照(仅 WS;不直接访问 Baileys 套接字)。
|
|
25
25
|
- 在 WhatsApp/WebChat 中单独发送 `/status` 消息可获取状态回复,而不调用智能体。
|
|
26
|
-
- 日志:跟踪 `/tmp/
|
|
26
|
+
- 日志:跟踪 `/tmp/Heretek-AI/openclaw-*.log` 并过滤 `web-heartbeat`、`web-reconnect`、`web-auto-reply`、`web-inbound`。
|
|
27
27
|
|
|
28
28
|
## 深度诊断
|
|
29
29
|
|
|
@@ -34,7 +34,7 @@ openclaw gateway --force
|
|
|
34
34
|
pnpm gateway:watch
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
- 配置热重载监视 `~/.
|
|
37
|
+
- 配置热重载监视 `~/.Heretek-AI/openclaw.json`(或 `OPENCLAW_CONFIG_PATH`)。
|
|
38
38
|
- 默认模式:`gateway.reload.mode="hybrid"`(热应用安全更改,关键更改时重启)。
|
|
39
39
|
- 热重载在需要时通过 **SIGUSR1** 使用进程内重启。
|
|
40
40
|
- 使用 `gateway.reload.mode="off"` 禁用。
|
|
@@ -26,7 +26,7 @@ OpenClaw 有两个日志"界面":
|
|
|
26
26
|
|
|
27
27
|
- 默认滚动日志文件位于 `/tmp/openclaw/` 下(每天一个文件):`openclaw-YYYY-MM-DD.log`
|
|
28
28
|
- 日期使用 Gateway 网关主机的本地时区。
|
|
29
|
-
- 日志文件路径和级别可以通过 `~/.
|
|
29
|
+
- 日志文件路径和级别可以通过 `~/.Heretek-AI/openclaw.json` 配置:
|
|
30
30
|
- `logging.file`
|
|
31
31
|
- `logging.level`
|
|
32
32
|
|
|
@@ -309,7 +309,7 @@ OpenClaw 有两个独立的"谁可以触发我?"层:
|
|
|
309
309
|
|
|
310
310
|
在 Gateway 网关主机上保持配置 + 状态私有:
|
|
311
311
|
|
|
312
|
-
- `~/.
|
|
312
|
+
- `~/.Heretek-AI/openclaw.json`:`600`(仅用户读/写)
|
|
313
313
|
- `~/.openclaw`:`700`(仅用户)
|
|
314
314
|
|
|
315
315
|
`openclaw doctor` 可以警告并提供收紧这些权限的选项。
|
|
@@ -710,7 +710,7 @@ Doctor 可以为你生成一个:`openclaw doctor --generate-gateway-token`。
|
|
|
710
710
|
|
|
711
711
|
### 审计
|
|
712
712
|
|
|
713
|
-
1. 检查 Gateway 网关日志:`/tmp/
|
|
713
|
+
1. 检查 Gateway 网关日志:`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`(或 `logging.file`)。
|
|
714
714
|
2. 审查相关记录:`~/.openclaw/agents/<agentId>/sessions/*.jsonl`。
|
|
715
715
|
3. 审查最近的配置更改(任何可能扩大访问权限的内容:`gateway.bind`、`gateway.auth`、私信/群组策略、`tools.elevated`、插件更改)。
|
|
716
716
|
|
|
@@ -119,7 +119,7 @@ Doctor/service 将显示运行时状态(PID/最后退出)和日志提示。
|
|
|
119
119
|
**日志:**
|
|
120
120
|
|
|
121
121
|
- 优先:`openclaw logs --follow`
|
|
122
|
-
- 文件日志(始终):`/tmp/
|
|
122
|
+
- 文件日志(始终):`/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`(或你配置的 `logging.file`)
|
|
123
123
|
- macOS LaunchAgent(如果已安装):`$OPENCLAW_STATE_DIR/logs/gateway.log` 和 `gateway.err.log`
|
|
124
124
|
- Linux systemd(如果已安装):`journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager`
|
|
125
125
|
- Windows:`schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST`
|
|
@@ -322,7 +322,7 @@ openclaw status
|
|
|
322
322
|
# 消息必须匹配 mentionPatterns 或显式提及;默认值在渠道 groups/guilds 中。
|
|
323
323
|
# 多智能体:`agents.list[].groupChat.mentionPatterns` 覆盖全局模式。
|
|
324
324
|
grep -n "agents\\|groupChat\\|mentionPatterns\\|channels\\.whatsapp\\.groups\\|channels\\.telegram\\.groups\\|channels\\.imessage\\.groups\\|channels\\.discord\\.guilds" \
|
|
325
|
-
"${OPENCLAW_CONFIG_PATH:-$HOME/.
|
|
325
|
+
"${OPENCLAW_CONFIG_PATH:-$HOME/.Heretek-AI/openclaw.json}"
|
|
326
326
|
```
|
|
327
327
|
|
|
328
328
|
**检查 3:** 检查日志
|
|
@@ -330,7 +330,7 @@ grep -n "agents\\|groupChat\\|mentionPatterns\\|channels\\.whatsapp\\.groups\\|c
|
|
|
330
330
|
```bash
|
|
331
331
|
openclaw logs --follow
|
|
332
332
|
# 或者如果你想快速过滤:
|
|
333
|
-
tail -f "$(ls -t /tmp/
|
|
333
|
+
tail -f "$(ls -t /tmp/Heretek-AI/openclaw-*.log | head -1)" | grep "blocked\\|skip\\|unauthorized"
|
|
334
334
|
```
|
|
335
335
|
|
|
336
336
|
### 配对码未到达
|
|
@@ -443,7 +443,7 @@ ls -la /path/to/your/image.jpg
|
|
|
443
443
|
**检查 3:** 检查媒体日志
|
|
444
444
|
|
|
445
445
|
```bash
|
|
446
|
-
grep "media\\|fetch\\|download" "$(ls -t /tmp/
|
|
446
|
+
grep "media\\|fetch\\|download" "$(ls -t /tmp/Heretek-AI/openclaw-*.log | head -1)" | tail -20
|
|
447
447
|
```
|
|
448
448
|
|
|
449
449
|
### 高内存使用
|
|
@@ -631,7 +631,7 @@ tccutil reset All bot.molt.mac.debug
|
|
|
631
631
|
```
|
|
632
632
|
|
|
633
633
|
**修复 2:强制使用新的 Bundle ID**
|
|
634
|
-
如果重置不起作用,在 [`scripts/package-mac-app.sh`](https://github.com/
|
|
634
|
+
如果重置不起作用,在 [`scripts/package-mac-app.sh`](https://github.com/Heretek-AI/openclaw/blob/main/scripts/package-mac-app.sh) 中更改 `BUNDLE_ID`(例如,添加 `.test` 后缀)并重新构建。这会强制 macOS 将其视为新应用。
|
|
635
635
|
|
|
636
636
|
### Gateway 网关卡在"Starting..."
|
|
637
637
|
|
|
@@ -674,7 +674,7 @@ npm install -g openclaw@<version>
|
|
|
674
674
|
|
|
675
675
|
```bash
|
|
676
676
|
# 在配置中打开跟踪日志:
|
|
677
|
-
# ${OPENCLAW_CONFIG_PATH:-$HOME/.
|
|
677
|
+
# ${OPENCLAW_CONFIG_PATH:-$HOME/.Heretek-AI/openclaw.json} -> { logging: { level: "trace" } }
|
|
678
678
|
#
|
|
679
679
|
# 然后运行详细命令将调试输出镜像到标准输出:
|
|
680
680
|
openclaw gateway --verbose
|
|
@@ -685,7 +685,7 @@ openclaw channels login --verbose
|
|
|
685
685
|
|
|
686
686
|
| 日志 | 位置 |
|
|
687
687
|
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
688
|
-
| Gateway 网关文件日志(结构化) | `/tmp/
|
|
688
|
+
| Gateway 网关文件日志(结构化) | `/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log`(或 `logging.file`) |
|
|
689
689
|
| Gateway 网关服务日志(监管程序) | macOS:`$OPENCLAW_STATE_DIR/logs/gateway.log` + `gateway.err.log`(默认:`~/.openclaw/logs/...`;配置文件使用 `~/.openclaw-<profile>/logs/...`)<br />Linux:`journalctl --user -u openclaw-gateway[-<profile>].service -n 200 --no-pager`<br />Windows:`schtasks /Query /TN "OpenClaw Gateway (<profile>)" /V /FO LIST` |
|
|
690
690
|
| 会话文件 | `$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/` |
|
|
691
691
|
| 媒体缓存 | `$OPENCLAW_STATE_DIR/media/` |
|
|
@@ -710,7 +710,7 @@ lsof -nP -iTCP:18789 -sTCP:LISTEN
|
|
|
710
710
|
# 最近活动(RPC 日志尾部)
|
|
711
711
|
openclaw logs --follow
|
|
712
712
|
# 如果 RPC 宕机的备用方案
|
|
713
|
-
tail -20 /tmp/
|
|
713
|
+
tail -20 /tmp/Heretek-AI/openclaw-*.log
|
|
714
714
|
```
|
|
715
715
|
|
|
716
716
|
## 重置所有内容
|
|
@@ -23,7 +23,7 @@ OpenClaw 从多个来源拉取环境变量。规则是**永不覆盖现有值**
|
|
|
23
23
|
1. **进程环境**(Gateway 网关进程从父 shell/守护进程已有的内容)。
|
|
24
24
|
2. **当前工作目录中的 `.env`**(dotenv 默认;不覆盖)。
|
|
25
25
|
3. **全局 `.env`** 位于 `~/.openclaw/.env`(即 `$OPENCLAW_STATE_DIR/.env`;不覆盖)。
|
|
26
|
-
4. **配置 `env` 块** 位于 `~/.
|
|
26
|
+
4. **配置 `env` 块** 位于 `~/.Heretek-AI/openclaw.json`(仅在缺失时应用)。
|
|
27
27
|
5. **可选的登录 shell 导入**(`env.shellEnv.enabled` 或 `OPENCLAW_LOAD_SHELL_ENV=1`),仅对缺失的预期键名应用。
|
|
28
28
|
|
|
29
29
|
如果配置文件完全缺失,步骤 4 将被跳过;如果启用了 shell 导入,它仍会运行。
|
package/docs/zh-CN/help/faq.md
CHANGED
|
@@ -245,7 +245,7 @@ x-i18n:
|
|
|
245
245
|
如果 RPC 不可用,回退到:
|
|
246
246
|
|
|
247
247
|
```bash
|
|
248
|
-
tail -f "$(ls -t /tmp/
|
|
248
|
+
tail -f "$(ls -t /tmp/Heretek-AI/openclaw-*.log | head -1)"
|
|
249
249
|
```
|
|
250
250
|
|
|
251
251
|
文件日志与服务日志是分开的;参阅[日志](/logging)和[故障排除](/gateway/troubleshooting)。
|
|
@@ -285,8 +285,8 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
|
285
285
|
提示:要求智能体**计划并监督**修复(逐步进行),然后只执行必要的命令。这样改动较小,更容易审查。
|
|
286
286
|
|
|
287
287
|
如果你发现了真正的 bug 或修复方案,请提交 GitHub issue 或发送 PR:
|
|
288
|
-
https://github.com/
|
|
289
|
-
https://github.com/
|
|
288
|
+
https://github.com/Heretek-AI/openclaw/issues
|
|
289
|
+
https://github.com/Heretek-AI/openclaw/pulls
|
|
290
290
|
|
|
291
291
|
从以下命令开始(在寻求帮助时分享输出):
|
|
292
292
|
|
|
@@ -322,7 +322,7 @@ openclaw onboard --install-daemon
|
|
|
322
322
|
从源码安装(贡献者/开发者):
|
|
323
323
|
|
|
324
324
|
```bash
|
|
325
|
-
git clone https://github.com/
|
|
325
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
326
326
|
cd openclaw
|
|
327
327
|
pnpm install
|
|
328
328
|
pnpm build
|
|
@@ -421,7 +421,7 @@ openclaw doctor
|
|
|
421
421
|
### 在哪里查看最新版本的更新内容
|
|
422
422
|
|
|
423
423
|
查看 GitHub 变更日志:
|
|
424
|
-
https://github.com/
|
|
424
|
+
https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md
|
|
425
425
|
|
|
426
426
|
最新条目在顶部。如果顶部部分标记为 **Unreleased**,则下一个带日期的部分是最新发布版本。条目按**亮点**、**变更**和**修复**分组(需要时还有文档/其他部分)。
|
|
427
427
|
|
|
@@ -431,7 +431,7 @@ https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md
|
|
|
431
431
|
请帮助我们在此处报告以解除封锁:https://spa.xfinity.com/check_url_status。
|
|
432
432
|
|
|
433
433
|
如果仍然无法访问该网站,文档在 GitHub 上有镜像:
|
|
434
|
-
https://github.com/
|
|
434
|
+
https://github.com/Heretek-AI/openclaw/tree/main/docs
|
|
435
435
|
|
|
436
436
|
### stable 和 beta 有什么区别
|
|
437
437
|
|
|
@@ -443,7 +443,7 @@ https://github.com/openclaw/openclaw/tree/main/docs
|
|
|
443
443
|
我们将构建发布到 **beta**,测试后,一旦构建稳定,就会**将同一版本提升为 `latest`**。这就是为什么 beta 和 stable 可以指向**相同版本**。
|
|
444
444
|
|
|
445
445
|
查看变更:
|
|
446
|
-
https://github.com/
|
|
446
|
+
https://github.com/Heretek-AI/openclaw/blob/main/CHANGELOG.md
|
|
447
447
|
|
|
448
448
|
### 如何安装 beta 版本,beta 和 dev 有什么区别
|
|
449
449
|
|
|
@@ -497,7 +497,7 @@ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
|
|
|
497
497
|
如果你更喜欢手动克隆,使用:
|
|
498
498
|
|
|
499
499
|
```bash
|
|
500
|
-
git clone https://github.com/
|
|
500
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
501
501
|
cd openclaw
|
|
502
502
|
pnpm install
|
|
503
503
|
pnpm build
|
|
@@ -795,7 +795,7 @@ brew install <formula>
|
|
|
795
795
|
从 npm → git:
|
|
796
796
|
|
|
797
797
|
```bash
|
|
798
|
-
git clone https://github.com/
|
|
798
|
+
git clone https://github.com/Heretek-AI/openclaw.git
|
|
799
799
|
cd openclaw
|
|
800
800
|
pnpm install
|
|
801
801
|
pnpm build
|
|
@@ -934,11 +934,11 @@ OpenClaw 是一个**个人助手**和协调层,不是 IDE 替代品。使用 C
|
|
|
934
934
|
|
|
935
935
|
### 如何自定义 Skills 而不弄脏仓库
|
|
936
936
|
|
|
937
|
-
使用托管覆盖而不是编辑仓库副本。将你的更改放在 `~/.openclaw/skills/<name>/SKILL.md`(或通过 `~/.
|
|
937
|
+
使用托管覆盖而不是编辑仓库副本。将你的更改放在 `~/.openclaw/skills/<name>/SKILL.md`(或通过 `~/.Heretek-AI/openclaw.json` 中的 `skills.load.extraDirs` 添加文件夹)。优先级是 `<workspace>/skills` > `~/.openclaw/skills` > 内置,所以托管覆盖优先生效而不会修改 git。只有值得上游合并的编辑才应该放在仓库中并作为 PR 提交。
|
|
938
938
|
|
|
939
939
|
### 可以从自定义文件夹加载 Skills 吗
|
|
940
940
|
|
|
941
|
-
可以。通过 `~/.
|
|
941
|
+
可以。通过 `~/.Heretek-AI/openclaw.json` 中的 `skills.load.extraDirs` 添加额外目录(最低优先级)。默认优先级保持不变:`<workspace>/skills` → `~/.openclaw/skills` → 内置 → `skills.load.extraDirs`。`clawhub` 默认安装到 `./skills`,OpenClaw 将其视为 `<workspace>/skills`。
|
|
942
942
|
|
|
943
943
|
### 如何为不同任务使用不同模型
|
|
944
944
|
|
|
@@ -1222,7 +1222,7 @@ OpenClaw 还会运行**静默的预压缩记忆刷新**,以提醒模型在自
|
|
|
1222
1222
|
|
|
1223
1223
|
### 配置文件是什么格式?在哪里
|
|
1224
1224
|
|
|
1225
|
-
OpenClaw 从 `$OPENCLAW_CONFIG_PATH`(默认:`~/.
|
|
1225
|
+
OpenClaw 从 `$OPENCLAW_CONFIG_PATH`(默认:`~/.Heretek-AI/openclaw.json`)读取可选的 **JSON5** 配置:
|
|
1226
1226
|
|
|
1227
1227
|
```
|
|
1228
1228
|
$OPENCLAW_CONFIG_PATH
|
|
@@ -1311,7 +1311,7 @@ Gateway 网关监视配置文件并支持热重载:
|
|
|
1311
1311
|
|
|
1312
1312
|
恢复:
|
|
1313
1313
|
|
|
1314
|
-
- 从备份恢复(git 或复制的 `~/.
|
|
1314
|
+
- 从备份恢复(git 或复制的 `~/.Heretek-AI/openclaw.json`)。
|
|
1315
1315
|
- 如果没有备份,重新运行 `openclaw doctor` 并重新配置渠道/模型。
|
|
1316
1316
|
- 如果这是意外情况,提交 bug 并附上你最后已知的配置或任何备份。
|
|
1317
1317
|
- 本地编码智能体通常可以从日志或历史中重建工作配置。
|
|
@@ -1826,7 +1826,7 @@ MiniMax M2.1 有自己的文档:[MiniMax](/providers/minimax) 和
|
|
|
1826
1826
|
- 聊天中的 `/model`(快速,按会话)
|
|
1827
1827
|
- `openclaw models set ...`(只更新模型配置)
|
|
1828
1828
|
- `openclaw configure --section models`(交互式)
|
|
1829
|
-
- 编辑 `~/.
|
|
1829
|
+
- 编辑 `~/.Heretek-AI/openclaw.json` 中的 `agents.defaults.model`
|
|
1830
1830
|
|
|
1831
1831
|
避免使用部分对象执行 `config.apply`,除非你打算替换整个配置。如果你确实覆盖了配置,从备份恢复或重新运行 `openclaw doctor` 来修复。
|
|
1832
1832
|
|
|
@@ -2291,7 +2291,7 @@ openclaw tui --url ws://<host>:18789 --token <token>
|
|
|
2291
2291
|
文件日志(结构化):
|
|
2292
2292
|
|
|
2293
2293
|
```
|
|
2294
|
-
/tmp/
|
|
2294
|
+
/tmp/Heretek-AI/openclaw-YYYY-MM-DD.log
|
|
2295
2295
|
```
|
|
2296
2296
|
|
|
2297
2297
|
你可以通过 `logging.file` 设置稳定路径。文件日志级别由 `logging.level` 控制。控制台详细度由 `--verbose` 和 `logging.consoleLevel` 控制。
|
|
@@ -2637,4 +2637,4 @@ OpenClaw 默认阻止**跨提供商**消息。如果工具调用绑定到 Telegr
|
|
|
2637
2637
|
|
|
2638
2638
|
---
|
|
2639
2639
|
|
|
2640
|
-
仍然卡住?在 [Discord](https://discord.com/invite/clawd) 中提问或发起 [GitHub 讨论](https://github.com/
|
|
2640
|
+
仍然卡住?在 [Discord](https://discord.com/invite/clawd) 中提问或发起 [GitHub 讨论](https://github.com/Heretek-AI/openclaw/discussions)。
|
|
@@ -307,7 +307,7 @@ OPENCLAW_LIVE_CLI_BACKEND=1 \
|
|
|
307
307
|
- 如果实时测试说"无凭证",用调试 `openclaw models list`/模型选择相同的方式调试。
|
|
308
308
|
|
|
309
309
|
- 配置文件存储:`~/.openclaw/credentials/`(首选;测试中"配置文件密钥"的含义)
|
|
310
|
-
- 配置:`~/.
|
|
310
|
+
- 配置:`~/.Heretek-AI/openclaw.json`(或 `OPENCLAW_CONFIG_PATH`)
|
|
311
311
|
|
|
312
312
|
如果你想依赖环境变量密钥(例如在 `~/.profile` 中导出的),在 `source ~/.profile` 后运行本地测试,或使用下面的 Docker 运行器(它们可以将 `~/.profile` 挂载到容器中)。
|
|
313
313
|
|
package/docs/zh-CN/index.md
CHANGED
|
@@ -123,7 +123,7 @@ Gateway 网关启动后,打开浏览器控制界面。
|
|
|
123
123
|
|
|
124
124
|
## 配置(可选)
|
|
125
125
|
|
|
126
|
-
配置文件位于 `~/.
|
|
126
|
+
配置文件位于 `~/.Heretek-AI/openclaw.json`。
|
|
127
127
|
|
|
128
128
|
- 如果你**不做任何修改**,OpenClaw 将使用内置的 Pi 二进制文件以 RPC 模式运行,并按发送者创建独立会话。
|
|
129
129
|
- 如果你想要限制访问,可以从 `channels.whatsapp.allowFrom` 和(针对群组的)提及规则开始配置。
|
|
@@ -16,17 +16,17 @@ x-i18n:
|
|
|
16
16
|
|
|
17
17
|
# Ansible 安装
|
|
18
18
|
|
|
19
|
-
将 OpenClaw 部署到生产服务器的推荐方式是通过 **[openclaw-ansible](https://github.com/
|
|
19
|
+
将 OpenClaw 部署到生产服务器的推荐方式是通过 **[openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible)** — 一个安全优先架构的自动化安装程序。
|
|
20
20
|
|
|
21
21
|
## 快速开始
|
|
22
22
|
|
|
23
23
|
一条命令安装:
|
|
24
24
|
|
|
25
25
|
```bash
|
|
26
|
-
curl -fsSL https://raw.githubusercontent.com/
|
|
26
|
+
curl -fsSL https://raw.githubusercontent.com/Heretek-AI/openclaw-ansible/main/install.sh | bash
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
> **📦 完整指南:[github.com/
|
|
29
|
+
> **📦 完整指南:[github.com/Heretek-AI/openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible)**
|
|
30
30
|
>
|
|
31
31
|
> openclaw-ansible 仓库是 Ansible 部署的权威来源。本页是快速概述。
|
|
32
32
|
|
|
@@ -125,7 +125,7 @@ Docker 用于**智能体沙箱**(隔离的工具执行),而不是用于运
|
|
|
125
125
|
sudo apt update && sudo apt install -y ansible git
|
|
126
126
|
|
|
127
127
|
# 2. 克隆仓库
|
|
128
|
-
git clone https://github.com/
|
|
128
|
+
git clone https://github.com/Heretek-AI/openclaw-ansible.git
|
|
129
129
|
cd openclaw-ansible
|
|
130
130
|
|
|
131
131
|
# 3. 安装 Ansible collections
|
|
@@ -186,7 +186,7 @@ sudo systemctl status docker
|
|
|
186
186
|
sudo docker images | grep openclaw-sandbox
|
|
187
187
|
|
|
188
188
|
# 如果缺失则构建沙箱镜像
|
|
189
|
-
cd /opt/
|
|
189
|
+
cd /opt/Heretek-AI/openclaw
|
|
190
190
|
sudo -u openclaw ./scripts/sandbox-setup.sh
|
|
191
191
|
```
|
|
192
192
|
|
|
@@ -203,13 +203,13 @@ openclaw channels login
|
|
|
203
203
|
|
|
204
204
|
详细的安全架构和故障排除:
|
|
205
205
|
|
|
206
|
-
- [安全架构](https://github.com/
|
|
207
|
-
- [技术详情](https://github.com/
|
|
208
|
-
- [故障排除指南](https://github.com/
|
|
206
|
+
- [安全架构](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/security.md)
|
|
207
|
+
- [技术详情](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/architecture.md)
|
|
208
|
+
- [故障排除指南](https://github.com/Heretek-AI/openclaw-ansible/blob/main/docs/troubleshooting.md)
|
|
209
209
|
|
|
210
210
|
## 相关内容
|
|
211
211
|
|
|
212
|
-
- [openclaw-ansible](https://github.com/
|
|
212
|
+
- [openclaw-ansible](https://github.com/Heretek-AI/openclaw-ansible) — 完整部署指南
|
|
213
213
|
- [Docker](/install/docker) — 容器化 Gateway 网关设置
|
|
214
214
|
- [沙箱隔离](/gateway/sandboxing) — 智能体沙箱配置
|
|
215
215
|
- [多智能体沙箱与工具](/tools/multi-agent-sandbox-tools) — 每个智能体的隔离
|