设置

最后更新：2026-01-01

太长不看

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

先决条件（从源码）

Node >=22
pnpm
Docker（可选；仅用于容器化设置/e2e — 参阅 Docker）

个性化策略（让更新不会造成问题）

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

配置： ~/.coderclaw/coderclaw.json（JSON/JSON5 格式）
工作区： ~/.coderclaw/workspace（Skills、提示、记忆；将其设为私有 git 仓库）

引导一次：

coderclaw setup

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

coderclaw setup

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

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

安装并启动 CoderClaw.app（菜单栏）。
完成新手引导/权限检查清单（TCC 提示）。
确保 Gateway 网关是本地并正在运行（应用管理它）。
链接表面（示例：WhatsApp）：

coderclaw channels login

完整性检查：

coderclaw health

如果你的构建版本中没有新手引导：

运行 coderclaw setup，然后 coderclaw channels login，然后手动启动 Gateway 网关（coderclaw 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 网关

在 CoderClaw.app 中：

连接模式：本地应用将连接到在配置端口上运行的 Gateway 网关。

3) 验证

应用内 Gateway 网关状态应显示 “Using existing gateway …”
或通过 CLI：

coderclaw health

常见陷阱

端口错误： Gateway 网关 WS 默认为 ws://127.0.0.1:18789；保持应用 + CLI 在同一端口上。
状态存储位置：
- 凭证：~/.coderclaw/credentials/
- 会话：~/.coderclaw/agents/<agentId>/sessions/
- 日志：/tmp/coderclaw/

凭证存储映射

在调试认证或决定备份什么时使用此映射：

WhatsApp：~/.coderclaw/credentials/whatsapp/<accountId>/creds.json
Telegram bot token：配置/环境变量或 channels.telegram.tokenFile
Discord bot token：配置/环境变量（尚不支持令牌文件）
Slack tokens：配置/环境变量（channels.slack.*）
配对允许列表：~/.coderclaw/credentials/<channel>-allowFrom.json
模型认证配置文件：~/.coderclaw/agents/<agentId>/agent/auth-profiles.json
旧版 OAuth 导入：~/.coderclaw/credentials/oauth.json 更多详情：安全。

更新（不破坏你的设置）

将 ~/.coderclaw/workspace 和 ~/.coderclaw/ 保持为”你的东西”；不要将个人提示/配置放入 coderclaw 仓库。
更新源码：git pull + pnpm install（当锁文件更改时）+ 继续使用 pnpm gateway:watch。

Linux（systemd 用户服务）

Linux 安装使用 systemd 用户服务。默认情况下，systemd 在注销/空闲时停止用户服务，这会终止 Gateway 网关。新手引导会尝试为你启用 lingering（可能提示 sudo）。如果仍然关闭，运行：

sudo loginctl enable-linger $USER

对于常驻或多用户服务器，考虑使用系统服务而不是用户服务（不需要 lingering）。参阅 Gateway 网关运行手册了解 systemd 说明。

设置

设置