Skip to main content

​
入门向导（CLI）

入门向导是在 macOS、Linux 或 Windows（通过 WSL2）上设置 OpenClaw 的推荐方式。它在一个引导流程中配置本地网关或远程网关连接，以及频道、技能和工作区默认设置。 
openclaw onboard
最快的首次聊天：打开控制界面（无需频道设置）。运行 openclaw dashboard，在浏览器中聊天。文档：Dashboard。
稍后重新配置： 
openclaw configure
openclaw agents add <name>
--json 并不意味着非交互模式。对于脚本，请使用 --non-interactive。
推荐：设置 Brave Search API 密钥，以便代理使用 web_search。 最简单路径：openclaw configure --section web。

​
快速开始与高级

向导以 快速开始（默认）或 高级（完全控制）启动。
  • 本地网关（回环）
  • 工作区默认（或现有工作区）
  • 网关端口 18789
  • 网关认证 Token（自动生成）
  • Tailscale 暴露 关闭
  • Telegram + WhatsApp 私聊默认为 允许列表

​
向导配置内容

本地模式（默认） 将引导完成以下步骤：
1

模型/认证

选择任何支持的提供商/认证流程（API 密钥、OAuth 或 setup-token），包括自定义提供商。选择默认模型。
如果此代理将运行工具或处理 webhook/钩子内容，建议使用最强最新一代模型。较弱/较旧的模型更易被提示注入。
2

工作区

代理文件存放位置（默认 ~/.openclaw/workspace）。初始化引导文件。
3

网关

端口、绑定地址、认证模式、Tailscale 暴露设置。
4

频道

WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal、BlueBubbles 或 iMessage。
5

守护进程

安装 LaunchAgent（macOS）或 systemd 用户单元（Linux/WSL2）。
6

健康检查

启动网关并确认其运行状态。
7

技能

安装推荐技能及可选依赖。
重新运行向导不会清除任何内容，除非你显式选择 重置（或传入 --reset）。 CLI 的 --reset 默认重置配置、凭据和会话；使用 --reset-scope full 可包括工作区。 如果配置无效或包含旧版键，向导会提示先运行 openclaw doctor。
远程模式 仅配置本地客户端连接远端网关。它不会在远程主机上安装或更改任何内容。

​
添加其他代理

使用 openclaw agents add <name> 创建带有自己工作区、会话和认证配置的独立代理。 它设置：
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
  • agents.list[].auth

​
命令行选项

​
--advanced
boolean
显示所有配置步骤（完全控制）
​
--install-daemon
boolean
自动安装守护进程服务
​
--reset
boolean
在配置前重置现有设置
​
--reset-scope
string
重置范围：config、credentials、sessions 或 full
​
--non-interactive
boolean
非交互模式（用于脚本）
​
--json
boolean
JSON 输出格式

​
后续步骤

入门指南

完整设置流程

配置

深入配置选项

CLI 命令

所有可用命令