设置
最后更新：2026-01-01
TL;DR
- 个性化内容在仓库外：
~/clawd（工作空间）+~/.clawdbot/openclaw.json（配置）。 - 稳定工作流： 安装macOS应用；让它运行捆绑的网关。
- 前沿工作流： 通过
pnpm gateway:watch自己运行网关，然后让macOS应用以本地模式连接。
先决条件（从源代码）
- Node
>=22 pnpm- Docker（可选；仅用于容器化设置/e2e — 参见Docker）
个性化策略（这样更新不会破坏）
如果您想要"100%个性化"并且轻松更新，请将您的自定义内容保存在：
- 配置：
~/.clawdbot/openclaw.json（JSON/JSON5-ish） - 工作空间：
~/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在同一端口。 - 状态存储位置：
- 凭据：
~/.clawdbot/credentials/ - 会话：
~/.clawdbot/agents/<agentId>/sessions/ - 日志：
/tmp/openclaw/
- 凭据：
凭据存储映射
在调试认证或决定备份什么时使用此映射：
- WhatsApp：
~/.clawdbot/credentials/whatsapp/<accountId>/creds.json - Telegram机器人令牌： 配置/环境变量或
channels.telegram.tokenFile - Discord机器人令牌： 配置/环境变量（令牌文件尚不支持）
- Slack令牌： 配置/环境变量（
channels.slack.*） - 配对允许列表：
~/.clawdbot/credentials/<channel>-allowFrom.json - 模型认证配置文件：
~/.clawdbot/agents/<agentId>/agent/auth-profiles.json - 旧版OAuth导入：
~/.clawdbot/credentials/oauth.json更多详情：安全。
更新（不破坏您的设置）
- 将
~/clawd和~/.clawdbot/视为"您的东西"；不要将个人提示/配置放入openclaw仓库。 - 更新源代码：
git pull+pnpm install（当lockfile更改时）+ 继续使用pnpm gateway:watch。
Linux（systemd用户服务）
Linux安装使用systemd用户服务。默认情况下，systemd在注销/空闲时停止用户 服务，这会杀死网关。入门尝试为您启用 linger（可能需要sudo）。如果仍然关闭，请运行：
bash
sudo loginctl enable-linger $USER对于始终在线或多用户服务器，考虑使用系统服务而不是 用户服务（不需要linger）。参见网关运行手册中的systemd说明。