设置

最后更新：2026-01-01

简要说明

  • 定制化内容存放在仓库外： ~/clawd（工作区）+ ~/.clawdbot/openclaw.json（配置）。
  • 稳定工作流： 安装 macOS 应用；让它运行内置的 Gateway。
  • 前沿工作流： 自己通过 pnpm gateway:watch 运行 Gateway，然后让 macOS 应用以本地模式连接。

前置要求（从源码安装）

  • Node >=22
  • pnpm
  • Docker（可选；仅用于容器化设置/端到端测试 — 参见 Docker）

定制化策略（让更新不会破坏设置）

如果你想要”100% 为我定制”并且轻松更新，请将你的自定义内容保存在：

  • 配置： ~/.clawdbot/openclaw.json（JSON/JSON5 格式）
  • 工作区： ~/clawd（技能、提示词、记忆；可以将其设为私有 git 仓库）

首次初始化：

openclaw setup

在此仓库内，使用本地 CLI 入口：

openclaw setup

如果你还没有全局安装，通过 pnpm openclaw setup 运行。

稳定工作流（macOS 应用优先）

  1. 安装并启动 OpenClaw.app（菜单栏）。
  2. 完成入门引导/权限检查清单（TCC 提示）。
  3. 确保 Gateway 为 Local 并正在运行（应用会管理它）。
  4. 连接平台（例如：WhatsApp）：
openclaw channels login
  1. 健康检查：
openclaw health

如果你的构建版本中没有入门引导：

  • 运行 openclaw setup，然后 openclaw channels login，然后手动启动 Gateway（openclaw gateway）。

前沿工作流（在终端中运行 Gateway）

目标：开发 TypeScript Gateway，获得热重载，保持 macOS 应用 UI 连接。

0) （可选）也从源码运行 macOS 应用

如果你也想让 macOS 应用使用最新版本：

./scripts/restart-mac.sh

1) 启动开发 Gateway

pnpm install
pnpm gateway:watch

gateway:watch 以监视模式运行 gateway，并在 TypeScript 更改时重新加载。

2) 将 macOS 应用指向你运行的 Gateway

在 OpenClaw.app 中：

  • 连接模式：Local 应用将连接到配置端口上运行的 gateway。

3) 验证

  • 应用内 Gateway 状态应显示 “Using existing gateway …”
  • 或通过 CLI：
openclaw health

常见问题

  • 端口错误： Gateway WS 默认为 ws://127.0.0.1:18789；保持应用 + CLI 使用相同端口。
  • 状态存储位置：
    • 凭证：~/.clawdbot/credentials/
    • 会话：~/.clawdbot/agents/<agentId>/sessions/
    • 日志：/tmp/openclaw/

凭证存储映射

在调试认证或决定备份内容时使用：

  • WhatsApp：~/.clawdbot/credentials/whatsapp/<accountId>/creds.json
  • Telegram bot token：config/env 或 channels.telegram.tokenFile
  • Discord bot token：config/env（尚不支持 token 文件）
  • Slack tokens：config/env（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 在注销/空闲时停止用户 服务，这会终止 Gateway。入门引导会尝试为你启用 lingering（可能需要 sudo 权限）。如果仍然关闭，运行：

sudo loginctl enable-linger $USER

对于始终在线或多用户服务器，考虑使用 系统服务而不是用户服务（不需要 lingering）。参见 Gateway 运行手册 了解 systemd 说明。

相关文档