ClawCN - OpenClaw 中文版

主题

设置 ​

最后更新:2026-01-01

简要说明 ​

  • 定制内容位于仓库外: ~/.openclaw/workspace(工作区)+ ~/.openclaw/openclaw.json(配置)。
  • **稳定工作流:**安装 macOS 应用;让它运行捆绑的 Gateway。
  • **前沿工作流:**通过 pnpm gateway:watch 自行运行 Gateway,然后让 macOS 应用以本地模式连接。

前置要求(从源码) ​

  • Node >=22
  • pnpm
  • Docker(可选;仅用于容器化设置/e2e — 参见 Docker)

定制策略(以便更新不会造成影响) ​

如果您想要"100% 定制"_同时_轻松更新,请将您的自定义内容保存在:

  • 配置: ~/.openclaw/openclaw.json(JSON/JSON5 风格)
  • 工作区: ~/.openclaw/workspace(技能、提示词、记忆;建议设为私有 git 仓库)

一次性初始化:

bash
openclaw setup

在此仓库内,使用本地 CLI 入口:

bash
openclaw setup

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

稳定工作流(macOS 应用优先) ​

  1. 安装并启动 OpenClaw.app(菜单栏)。
  2. 完成引导/权限检查清单(TCC 提示)。
  3. 确保 Gateway 为 本地模式并正在运行(应用会管理它)。
  4. 链接界面(例如:WhatsApp):
bash
openclaw channels login
  1. 完整性检查:
bash
openclaw health

如果您的构建版本中没有引导功能:

  • 运行 openclaw setup,然后 openclaw channels login,接着手动启动 Gateway(openclaw gateway)。

前沿工作流(在终端中运行 Gateway) ​

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

0)(可选)也从源码运行 macOS 应用 ​

如果您也希望 macOS 应用保持前沿版本:

bash
./scripts/restart-mac.sh

1)启动开发 Gateway ​

bash
pnpm install
pnpm gateway:watch

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

2)将 macOS 应用指向正在运行的 Gateway ​

在 OpenClaw.app 中:

  • 连接模式:本地 应用将连接到配置端口上运行的 gateway。

3)验证 ​

  • 应用内 Gateway 状态应显示 "使用现有 gateway ..."
  • 或通过 CLI:
bash
openclaw health

常见问题 ​

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

凭证存储映射 ​

调试身份验证或决定备份内容时使用:

  • WhatsApp: ~/.openclaw/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.*)
  • 配对白名单: ~/.openclaw/credentials/<channel>-allowFrom.json
  • 模型认证配置: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • 旧版 OAuth 导入: ~/.openclaw/credentials/oauth.json 更多详情:安全。

更新(不破坏您的设置) ​

  • 将 ~/.openclaw/workspace 和 ~/.openclaw/ 保留为"您的内容";不要将个人提示词/配置放入 openclaw 仓库。
  • 更新源码:git pull + pnpm install(当 lockfile 变更时)+ 继续使用 pnpm gateway:watch。

Linux(systemd 用户服务) ​

Linux 安装使用 systemd 用户服务。默认情况下,systemd 在注销/空闲时停止用户服务,这会终止 Gateway。引导程序会尝试为您启用持久化(可能需要 sudo 提示)。如果仍未开启,运行:

bash
sudo loginctl enable-linger $USER

对于始终在线或多用户服务器,考虑使用 系统服务而非用户服务(无需持久化)。参见 Gateway 运维手册中的 systemd 说明。

相关文档 ​