onboard

交互式向导，设置网关、工作区和技能。

用法

openclaw onboard [选项]

选项

基本选项

• --workspace <dir>: 工作区路径
• --reset: 向导前重置配置 + 凭据 + 会话 + 工作区
• --non-interactive: 非交互模式
• --mode <local|remote>: 向导模式
• --flow <quickstart|advanced|manual>: 流程类型

认证选项

• --auth-choice <选项>: 认证方式选择
  • setup-token - Anthropic setup-token
  • openai-codex - OpenAI Codex OAuth
  • openai-api-key - OpenAI API 密钥
  • anthropic-api-key - Anthropic API 密钥
  • skip - 跳过
• --anthropic-api-key <key>: Anthropic API 密钥
• --openai-api-key <key>: OpenAI API 密钥
• --openrouter-api-key <key>: OpenRouter API 密钥

网关选项

• --gateway-port <port>: 网关端口
• --gateway-bind <loopback|lan|tailnet|auto|custom>: 绑定模式
• --gateway-auth <token|password>: 认证方式
• --gateway-token <token>: 网关 token
• --gateway-password <password>: 网关密码

远程选项

• --remote-url <url>: 远程网关 URL
• --remote-token <token>: 远程网关 token

Tailscale 选项

• --tailscale <off|serve|funnel>: Tailscale 模式
• --tailscale-reset-on-exit: 退出时重置

服务选项

• --install-daemon: 安装守护进程
• --no-install-daemon / --skip-daemon: 跳过守护进程安装
• --daemon-runtime <node|bun>: 守护进程运行时

跳过选项

• --skip-channels: 跳过通道配置
• --skip-skills: 跳过技能配置
• --skip-health: 跳过健康检查
• --skip-ui: 跳过 UI

其他

• --node-manager <npm|pnpm|bun>: 包管理器（推荐 pnpm）
• --json: JSON 输出

示例

# 交互式入门
openclaw onboard

# 安装守护进程
openclaw onboard --install-daemon

# 非交互式快速设置
openclaw onboard --non-interactive --flow quickstart --auth-choice skip

# 使用 Anthropic API 密钥
openclaw onboard --anthropic-api-key sk-xxx

# 远程模式
openclaw onboard --mode remote --remote-url ws://server:18789 --remote-token xxx

向导流程

向导会引导你完成：

1. 模型/认证设置 - 推荐 Anthropic setup-token 用于 Claude 订阅
2. 工作区位置 + 引导文件
3. 网关设置 - 绑定/端口/认证/Tailscale
4. Provider - WhatsApp、Telegram、Discord 等
5. 守护进程安装 - macOS 使用 LaunchAgent，Linux 使用 systemd
6. 健康检查和技能选择

相关命令

• setup - 基本设置
• configure - 配置向导
• doctor - 健康检查