OpenClaw 配置向导

快速安装和配置 OpenClaw

10-15 分钟

入门

openclaw onboard

概述

配置向导是在 macOS、Linux 或 Windows (通过 WSL2，强烈推荐) 上设置 OpenClaw 的推荐方式。它在一个引导流程中配置本地 Gateway 或远程 Gateway 连接，以及频道、技能和工作区默认设置。

主要入口命令：

openclaw onboard

💡 最快的方式：打开 Control UI（无需频道设置）。运行 openclaw dashboard 并在浏览器中聊天。

QuickStart 与 Advanced 模式

QuickStart（快速开始）

使用默认配置，适合大多数用户

本地 Gateway（loopback）
工作区默认值
Gateway 端口 18789
自动生成的认证令牌
Tailscale 暴露关闭

Advanced（高级）

完全控制每个配置选项

模式选择（本地/远程）
自定义工作区路径
Gateway 高级设置
手动配置所有频道
守护进程和技能控制

向导配置流程

1. 现有配置检测

如果 ~/.openclaw/openclaw.json 存在，选择保留 / 修改 / 重置。重新运行向导不会删除任何内容，除非你明确选择重置（或传递 --reset）。

2. 模型/认证配置

Anthropic API Key (推荐): 使用 ANTHROPIC_API_KEY（如果存在）或提示输入密钥

Anthropic OAuth (Claude Code CLI): 在 macOS 上向导检查钥匙串项"Claude Code-credentials"；在 Linux/Windows 上重用 ~/.claude/.credentials.json（如果存在）

Anthropic Token (paste setup-token): 在任何机器上运行 claude setup-token，然后粘贴令牌

OpenAI API Key: 使用 OPENAI_API_KEY 或提示输入

MiniMax / Moonshot / Kimi / Synthetic / Vercel AI Gateway / OpenCode Zen: 配置自动写入或提示输入 API 密钥

3. 工作区设置

默认 ~/.openclaw/workspace（可配置）。为 agent bootstrap ritual 所需的工作区文件做种子。

4. Gateway 配置

端口、绑定、认证模式、Tailscale 暴露。建议：即使对于 loopback 也保留 Token 认证。

5. 频道配置

WhatsApp: 可选 QR 登录

Telegram: bot token

Discord: bot token

Google Chat: 服务账户 JSON + webhook audience

Signal: 可选 signal-cli 安装

iMessage: 本地 imsg CLI 路径 + DB 访问

DM 安全: 默认是配对模式。第一个 DM 发送代码；通过 openclaw pairing approve <channel> <code> 批准或使用允许列表。

6. 守护进程安装

macOS: LaunchAgent （需要登录的用户会话；无头模式使用自定义 LaunchDaemon）

Linux (和 Windows 通过 WSL2): systemd user unit

向导尝试通过 loginctl enable-linger <user> 启用 lingering，以便 Gateway 在注销后保持运行。

运行时选择：Node（推荐；WhatsApp/Telegram 必需）。不推荐 Bun。

7. 健康检查

启动 Gateway（如果需要）并运行 openclaw health。提示：openclaw status --deep 向状态输出添加 gateway 健康探测（需要可访问的 gateway）。

8. 技能安装

读取可用技能并检查要求。让你选择节点管理器：npm / pnpm（不推荐 bun）。安装可选依赖（某些在 macOS 上使用 Homebrew）。

后续重新配置

openclaw configure

推荐：设置 Brave Search API 密钥，以便 agent 可以使用 web_search（web_fetch 不需要密钥）。最简单的方法：openclaw configure --section web，它存储 tools.web.search.apiKey。

非交互模式

使用 --non-interactive 自动化或脚本化配置流程：

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --anthropic-api-key "$ANTHROPIC_API_KEY" \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills

添加 --json 以获得机器可读的摘要。

添加另一个 Agent

使用 openclaw agents add <name> 创建一个具有自己的工作区、会话和认证配置文件的独立 agent。不带 --workspace 运行会启动向导。

openclaw agents add work \
  --workspace ~/.openclaw/workspace-work \
  --model openai/gpt-5.2 \
  --bind whatsapp:biz \
  --non-interactive \
  --json

向导写入的配置

~/.openclaw/openclaw.json

• agents.defaults.workspace
• agents.defaults.model / models.providers
• gateway.* (mode, bind, auth, tailscale)
• channels.telegram.botToken, channels.discord.token
• skills.install.nodeManager
• wizard.lastRunAt, wizard.lastRunVersion, etc.