最后更新：2026-01-01<\/p>\n
~\/.openclaw\/workspace<\/code>（工作区）+ ~\/.openclaw\/openclaw.json<\/code>（配置）。<\/li>\n- 稳定工作流：<\/strong> 安装 macOS 应用；让它运行内置的 Gateway 网关。<\/li>\n
- 前沿工作流：<\/strong> 通过
pnpm gateway:watch<\/code> 自己运行 Gateway 网关，然后让 macOS 应用以本地模式连接。<\/li>\n<\/ul>\n先决条件（从源码）<\/h2>\n\n- Node
>=22<\/code><\/li>\npnpm<\/code><\/li>\n- Docker（可选；仅用于容器化设置\/e2e — 参阅 Docker<\/a>）<\/li>\n<\/ul>\n
个性化策略（让更新不会造成问题）<\/h2>\n
如果你想要”100% 为我定制”并且<\/em>易于更新，将你的自定义内容保存在：<\/p>\n\n- 配置：<\/strong>
~\/.openclaw\/openclaw.json<\/code>（JSON\/JSON5 格式）<\/li>\n- 工作区：<\/strong>
~\/.openclaw\/workspace<\/code>（Skills、提示、记忆；将其设为私有 git 仓库）<\/li>\n<\/ul>\n引导一次：<\/p>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw setup<\/p>\n
\n在此仓库内部，使用本地 CLI 入口：\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw setup\n<\/code><\/pre>\n如果你还没有全局安装，通过 pnpm openclaw setup<\/code> 运行它。<\/p>\n稳定工作流（macOS 应用优先）<\/h2>\n\n- 安装并启动 OpenClaw.app<\/strong>（菜单栏）。<\/li>\n
- 完成新手引导\/权限检查清单（TCC 提示）。<\/li>\n
- 请确保 Gateway 网关是本地<\/strong>并正在运行（应用管理它）。<\/li>\n
- 链接表面（示例：WhatsApp）：<\/li>\n<\/ol>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw channels login<\/p>\n
\n5. 完整性检查：\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nopenclaw health\n<\/code><\/pre>\n如果你的构建版本中没有新手引导：<\/p>\n
\n- 运行
openclaw setup<\/code>，然后 openclaw channels login<\/code>，然后手动启动 Gateway 网关（openclaw gateway<\/code>）。<\/li>\n<\/ul>\n前沿工作流（在终端中运行 Gateway 网关）<\/h2>\n
目标：开发 TypeScript Gateway 网关，获得热重载，保持 macOS 应用 UI 连接。<\/p>\n
0)（可选）也从源码运行 macOS 应用<\/h3>\n
如果你也想让 macOS 应用保持前沿：<\/p>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\n.\/scripts\/restart-mac.sh<\/p>\n
\n### 1) 启动开发 Gateway 网关\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\npnpm install\npnpm gateway:watch\n<\/code><\/pre>\ngateway:watch<\/code> 以监视模式运行 Gateway 网关，并在 TypeScript 更改时重新加载。<\/p>\n2) 将 macOS 应用指向你正在运行的 Gateway 网关<\/h3>\n
在 OpenClaw.app<\/strong> 中：<\/p>\n\n- 连接模式：本地<\/strong>
\n 应用将连接到在配置端口上运行的 Gateway 网关。<\/li>\n<\/ul>\n3) 验证<\/h3>\n\n- 应用内 Gateway 网关状态应显示 “Using existing gateway …”<\/strong><\/li>\n
- 或通过 CLI：<\/li>\n<\/ul>\n
“`bash theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nopenclaw health<\/p>\n
\n### 常见陷阱\n\n* **端口错误：** Gateway 网关 WS 默认为 `ws:\/\/127.0.0.1:18789`；保持应用 + CLI 在同一端口上。\n* **状态存储位置：**\n * 凭证：`~\/.openclaw\/credentials\/`\n * 会话：`~\/.openclaw\/agents\/<agentId>\/sessions\/`\n * 日志：`\/tmp\/openclaw\/`\n\n## 凭证存储映射\n\n在调试认证或决定备份什么时使用此映射：\n\n* **WhatsApp**：`~\/.openclaw\/credentials\/whatsapp\/<accountId>\/creds.json`\n* **Telegram bot token**：配置\/环境变量或 `channels.telegram.tokenFile`\n* **Discord bot token**：配置\/环境变量（尚不支持令牌文件）\n* **Slack tokens**：配置\/环境变量（`channels.slack.*`）\n* **配对允许列表**：`~\/.openclaw\/credentials\/<channel>-allowFrom.json`\n* **模型认证配置文件**：`~\/.openclaw\/agents\/<agentId>\/agent\/auth-profiles.json`\n* **旧版 OAuth 导入**：`~\/.openclaw\/credentials\/oauth.json`\n 更多详情：[安全](\/gateway\/security#credential-storage-map)。\n\n## 更新（不破坏你的设置）\n\n* 将 `~\/.openclaw\/workspace` 和 `~\/.openclaw\/` 保持为\"你的东西\"；不要将个人提示\/配置放入 `openclaw` 仓库。\n* 更新源码：`git pull` + `pnpm install`（当锁文件更改时）+ 继续使用 `pnpm gateway:watch`。\n\n## Linux（systemd 用户服务）\n\nLinux 安装使用 systemd **用户**服务。默认情况下，systemd 在注销\/空闲时停止用户服务，这会终止 Gateway 网关。新手引导会尝试为你启用 lingering（可能提示 sudo）。如果仍然关闭，运行：\n\n```bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\nsudo loginctl enable-linger $USER\n<\/code><\/pre>\n对于常驻或多用户服务器，考虑使用系统<\/strong>服务而不是用户服务（不需要 lingering）。参阅 Gateway 网关运行手册<\/a> 了解 systemd 说明。<\/p>\n相关文档<\/h2>\n\n- Gateway 网关运行手册<\/a>（标志、监督、端口）<\/li>\n
- Gateway 网关配置<\/a>（配置模式 + 示例）<\/li>\n
- Discord<\/a> 和 Telegram<\/a>（回复标签 + replyToMode 设置）<\/li>\n
- OpenClaw 助手设置<\/a><\/li>\n
- macOS 应用<\/a>（Gateway 网关生命周期）<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
设置 最后更新ᦂ […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-269","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/269","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=269"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/269\/revisions"}],"predecessor-version":[{"id":782,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/269\/revisions\/782"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=269"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=269"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=269"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}