首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 开始使用
开始使用 3 个部分 3 条关键信息

Setup Strategy

设置

这页回答的是“怎么保持 OpenClaw 一直能更新,但我自己的配置、工作区和凭证又不被仓库改动拖乱”。核心原则是:把个性化内容放在仓库外,仓库只负责代码,~/.openclaw 负责你的状态。

两种典型工作流

macOS App 稳定

稳定工作流

安装并启动 OpenClaw.app,让它管理本地 Gateway。完成 TCC 权限与向导后,再通过 openclaw channels login 接入渠道。

前沿

开发工作流

自己在终端中运行 pnpm gateway:watch,再让 macOS 应用以本地模式连接现有 Gateway,适合开发 TypeScript Gateway 与热重载调试。

常用命令

初始化个人状态

openclaw setup

源码开发 Gateway

pnpm install
pnpm gateway:watch

基础健康检查

openclaw health
openclaw channels login

长期可维护的规则

把配置和工作区放在 ~/.openclaw,不要把个人提示词、记忆和密钥回写进仓库。

更新源码时优先保持 git pull + pnpm install 的干净路径,而不是在 repo 内直接堆个人定制。

如果你在 Linux 上使用 systemd 用户服务,必要时开启 loginctl enable-linger,避免退出登录后 Gateway 被回收。