OpenClaw从入门到应用：基础知识——CLI 入门

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

OpenClaw 的 CLI 入门向导是在macOS、Linux 或 Windows（强烈推荐通过 WSL2）上设置 OpenClaw 的推荐方式。它通过一个引导式交互流程，帮助您配置本地或远程网关连接，以及频道（channels）、技能（skills）和工作区（workspace）的默认设置。

openclaw onboard

💡最快开启首次聊天：直接打开控制界面（无需配置频道）。运行openclaw dashboard即可在浏览器中开始聊天。文档详见：控制面板。

如需后续重新配置，可以使用以下命令：

openclaw configure openclaw agentsadd

⚠️ 注意：--json参数并不表示非交互模式。若用于脚本，请使用--non-interactive。

向导中包含一个网络搜索配置步骤，您可以选择一个提供商（Perplexity、Brave、Gemini、Grok 或 Kimi）并粘贴 API 密钥，以便智能体（agent）能够使用web_search功能。您也可以稍后通过openclaw configure --section web进行配置。文档详见：Web 工具。

快速启动 vs 高级模式

向导开始时提供两种选择：快速启动（QuickStart）（使用默认设置）或高级模式（Advanced）（完全控制每一步）。

快速启动（QuickStart）默认配置包括：

• 本地网关（loopback 地址）
• 工作区：使用默认路径（或已有工作区）
• 网关端口：18789
• 网关认证方式：Token（即使在 loopback 模式下也会自动生成）
• 新本地设置的工具策略默认值：tools.profile: "coding"（如果已存在明确配置的 profile，则保留原值）
• 私信（DM）隔离默认行为：若未设置，本地入门流程将写入session.dmScope: "per-channel-peer"。详情见 CLI 入门向导参考文档
• Tailscale 暴露：关闭
• Telegram 和 WhatsApp 私信默认为允许列表（allowlist）模式（系统会提示您输入手机号码）

高级模式（Advanced）则暴露所有配置步骤：

• 模式（mode）
• 工作区（workspace）
• 网关（gateway）
• 频道（channels）
• 守护进程（daemon）
• 技能（skills）

向导配置的内容

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

1. 模型/认证（Model/Auth）

选择任意受支持的提供商/认证流程（API 密钥、OAuth 或 setup-token），包括自定义提供商（Custom Provider）（兼容 OpenAI、Anthropic，或自动检测未知类型）。选择默认模型。

🔒安全提示：如果此智能体将运行工具或处理 webhook/hooks 内容，建议使用当前最强的最新模型，并保持工具策略严格。较弱或较旧的模型更容易受到提示注入攻击。

• 非交互式运行：--secret-input-mode ref会将基于环境变量的引用存储在认证配置文件中，而不是明文 API 密钥。必须预先设置对应的 provider 环境变量；若未设置而直接传入内联密钥标志，程序将立即失败。
• 交互式运行：选择 secret reference 模式可让您指向环境变量或已配置的 provider 引用（file或exec类型），并在保存前进行快速预检验证。

2. 工作区（Workspace）

智能体文件的存储位置（默认为~/.openclaw/workspace），并生成引导文件（bootstrap files）。

3. 网关（Gateway）

配置端口、绑定地址、认证模式、Tailscale 暴露选项。

• 在交互式 token 模式下，可选择默认的明文 token 存储方式，或启用 SecretRef。
• 非交互式 token SecretRef 路径参数：--gateway-token-ref-env。

4. 频道（Channels）

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

5. 守护进程（Daemon）

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

• 若 token 认证需要 token，且gateway.auth.token由 SecretRef 管理，守护进程安装时会验证该引用，但不会将解析后的 token 持久化到 supervisor 服务的环境元数据中。
• 若 token 认证需要 token，但配置的 token SecretRef 未解析，则守护进程安装会被阻止，并提供可操作的指引。
• 若同时配置了gateway.auth.token和gateway.auth.password，但gateway.auth.mode未设置，则守护进程安装会被阻止，直到显式指定认证模式。

6. 健康检查（Health check）

启动 Gateway 并验证其是否正常运行。

7. 技能（Skills）

安装推荐的技能及可选依赖项。

📝重新运行向导不会删除任何现有内容，除非您明确选择重置（Reset）（或传入--reset参数）。CLI 的--reset默认重置配置、凭据和会话；若要包含工作区，请使用--reset-scope full。如果当前配置无效或包含过时字段，向导会提示您先运行openclaw doctor。

远程模式（Remote mode）仅配置本地客户端以连接到其他位置的 Gateway，不会在远程主机上安装或更改任何内容。

添加另一个智能体

使用openclaw agents add可创建一个独立的智能体，拥有自己的工作区、会话和认证配置文件。若不带--workspace参数运行，将启动向导。

它会设置以下字段：

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

注意事项：

• 默认工作区路径遵循~/.openclaw/workspace-命名规则。
• 可添加bindings以路由入站消息（向导可协助完成此操作）。
• 非交互式标志包括：--model、--agent-dir、--bind、--non-interactive。