设置
最后更新：2026-01-01
概述
- 定制化存在于仓库之外：
~/clawd（工作区）+~/.openclaw/openclaw.json（配置）。 - 稳定工作流程： 安装 macOS 应用；让它运行捆绑的网关。
- 前沿工作流程： 通过
pnpm gateway:watch自己运行网关，然后让 macOS 应用以本地模式附加。
先决条件（从源码）
- Node
>=22 pnpm- Docker（可选；仅用于容器化设置/e2e — 参见 Docker）
定制策略（因此更新不会造成损害）
如果您想要 "100% 适合我" 并且 易于更新，请将您的自定义保存在：
- 配置：
~/.openclaw/openclaw.json（JSON/JSON5 类似） - 工作区：
~/clawd（技能、提示、记忆；将其设为私有 git 仓库）
引导一次：
bash
openclaw setup在此仓库内部，使用本地 CLI 入口：
bash
openclaw setup如果您还没有全局安装，请通过 pnpm openclaw setup 运行它。
稳定工作流程（先用 macOS 应用）
- 安装 + 启动 OpenClaw.app（菜单栏）。
- 完成入门/权限清单（TCC 提示）。
- 确保网关是本地且正在运行（应用管理它）。
- 链接界面（示例：WhatsApp）：
bash
openclaw channels login- 健康检查：
bash
openclaw health如果您的构建中不可用入门：
- 运行
openclaw setup，然后openclaw channels login，然后手动启动网关（openclaw gateway）。
前沿工作流程（网关在终端中）
目标：在 TypeScript 网关上工作，获得热重载，保持 macOS 应用 UI 附加。
0) （可选）也从源码运行 macOS 应用
如果您也希望 macOS 应用处于前沿：
bash
./scripts/restart-mac.sh1) 启动开发网关
bash
pnpm install
pnpm gateway:watchgateway:watch 在监视模式下运行网关并在 TypeScript 更改时重新加载。
2) 让 macOS 应用指向您正在运行的网关
在 OpenClaw.app 中：
- 连接模式：本地 应用将附加到配置端口上正在运行的网关。
3) 验证
- 应用内网关状态应显示 "使用现有网关 …"
- 或通过 CLI：
bash
openclaw health常见错误
- 错误端口： 网关 WS 默认为
ws://127.0.0.1:18789；保持应用 + CLI 在同一端口。 - 状态存储位置：
- 凭据：
~/.openclaw/credentials/ - 会话：
~/.openclaw/agents/<agentId>/sessions/ - 日志：
/tmp/openclaw/
- 凭据：
更新（不破坏您的设置）
- 将
~/clawd和~/.openclaw/保留为 "您的内容"；不要将个人提示/配置放入openclaw仓库。 - 更新源码：
git pull+pnpm install（当锁文件更改时）+ 继续使用pnpm gateway:watch。
Linux（systemd 用户服务）
Linux 安装使用 systemd 用户 服务。默认情况下，systemd 在注销/空闲时停止用户 服务，这会终止网关。入门尝试为您启用持久化（可能提示 sudo）。如果仍然关闭，请运行：
bash
sudo loginctl enable-linger $USER对于始终在线或多用户服务器，请考虑使用 系统 服务而不是 用户服务（不需要持久化）。参见 网关运行手册 获取 systemd 注释。