OpenClaw 新手引导配置完全指南

📋 什么是新手引导

CLI 新手引导是在 macOS、Linux 或 Windows 上设置 OpenClaw 的推荐方式。它通过交互式流程配置本地 Gateway 网关、渠道、Skills 和工作区默认值。

🚀 启动新手引导

openclaw onboard

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

⚙️ 两种模式选择

快速开始（默认）

• 本地网关（loopback）
• Gateway 网关端口：18789
• 自动生成认证 Token
• 默认工具策略：coding
• Tailscale 暴露：关闭
• Telegram + WhatsApp 私信默认使用白名单

高级模式

• 暴露每一个配置步骤
• 完全控制模式、工作区、网关、渠道等

📝 新手引导配置项

1. 模型/认证

选择 AI 模型提供商，支持：

• OpenAI（GPT-4o 等）
• Anthropic（Claude 系列）
• Gemini
• 自定义 OpenAI Compatible API

2. 工作区

智能体文件存储位置，默认：~/.openclaw/workspace

3. Gateway 网关

• 端口配置
• 绑定地址
• 认证模式
• Tailscale 暴露设置

4. 渠道连接

可选择的聊天渠道：

• WhatsApp
• Telegram
• Discord
• Google Chat
• Signal
• iMessage

5. 守护进程安装

自动安装后台服务：

• macOS：LaunchAgent
• Linux：systemd 用户单元

6. Skills 安装

安装推荐的 Skills 和可选依赖项

🔑 API Key 配置提示

新手引导包含 web search 步骤，可选择以下提供商并粘贴 API Key：

• Perplexity
• Brave
• Gemini
• Grok
• Kimi

💡 常用命令

# 重新运行新手引导（不清除内容）openclaw configure

# 添加新的智能体openclaw agents add 

# 查看帮助openclaw onboard --help

⚠️ 注意事项

• 重新运行新手引导不会清除任何内容，除非你选择 Reset
• 使用 --reset 会重置配置、凭证和会话
• 如需完全重置，使用 --reset-scope full

🔗 相关资源

• 入门指南
• 控制 UI 使用
• 聊天渠道配置