【OpenClaw 从入门到精通】第 3 篇Onboarding 向导 — 五分钟完成初始配置本系列定位零基础入门从安装配置到高级架构全覆盖。无论你是开发者、运维工程师、还是技术爱好者本系列带你彻底掌握 OpenClaw。本篇你将学到openclaw onboard交互式向导完整流程Gateway 配置与 Daemon 安装Workspace 初始化配置第一个 AI 模型 ProviderOAuth 订阅登录Claude Pro/Max / ChatGPT / Copilot学完本篇你的 OpenClaw 将完成全部初始配置随时可以开始使用。一、Onboarding 概述1.1 什么是 OnboardingOpenClaw 的 Onboarding 是一个交互式引导向导帮助你一步步完成从零到可用的全部配置openclaw onboard --install-daemon--install-daemon参数同时安装 Gateway 守护进程后台持续运行。1.2 Onboarding 完成的事项步骤 1Gateway 配置端口、安全策略 步骤 2Workspace 初始化工作目录、上下文文件 步骤 3模型 Provider 配置选择 AI 模型 步骤 4消息通道配置可选跳过后也可后续添加 步骤 5技能安装推荐技能 步骤 6Daemon 安装launchd / systemd / Scheduled Task下面是 Onboarding 的完整流程概览启动 OnboardingGateway 配置Workspace 初始化选择认证方式API Key 模式OAuth 订阅登录通道配置可选技能安装Daemon 安装配置完成 二、逐步配置2.1 启动 Onboardingopenclaw onboard --install-daemon OpenClaw Onboarding ════════════════════════════════════════ Welcome! This wizard will guide you through setting up your personal AI assistant. Step 1/5: Gateway Configuration ───────────────────────────────── Gateway port [18789]: ← 按 Enter 用默认端口 Enable DM pairing? [Y/n]: Y ← 推荐安全授权机制 Step 2/5: Workspace Setup ───────────────────────── Workspace path [~/.openclaw/workspace]: ← 按 Enter 用默认路径2.2 配置模型 ProviderStep 3/5: Model Provider ──────────────────────── Choose your AI provider: ❯ Anthropic (Claude) ← Claude 系列 OpenAI (GPT-4o, o3) ← OpenAI 系列 Google (Gemini) ← Gemini 系列 xAI (Grok) ← Grok 系列 OpenRouter (recommended) ← 一个 Key 访问所有模型 GitHub Copilot ← Copilot 订阅 MiniMax ← MiniMax Custom endpoint ← 自定义 / 本地模型2.3 API Key 模式 vs OAuth 订阅OpenClaw 支持两种认证方式方式一API Key传统Enter your ANTHROPIC_API_KEY: sk-ant-xxxxxxxx ✅ API Key saved to ~/.openclaw/secrets/方式二OAuth 订阅登录推荐如果你有 Claude Pro/Max、ChatGPT Plus 或 GitHub Copilot 订阅Choose auth method: ❯ OAuth (use your Claude Pro/Max subscription) ← 推荐 API Key Launching browser for OAuth... Enter the code: XXXX-XXXX ✅ Authenticated as your-emailexample.comOAuth 的优势不需要单独购买 API Key直接用你已有的订阅。2.4 通道配置可选Step 4/5: Channels (optional) ────────────────────────────── Configure messaging channels now? [y/N]: N You can add channels later with: openclaw config set channels.telegram.token YOUR_TOKEN初次使用可以跳过通道配置先在 CLI / WebChat 中体验。2.5 技能安装Step 5/5: Recommended Skills ──────────────────────────── Install recommended skills? [Y/n]: Y ✅ Installed: - web-search Web search capability - code-tools Code execution and file tools - session-tools Session management2.6 Daemon 安装Installing Gateway daemon... ✅ Daemon installed: systemd user service Service name: openclaw-gateway Auto-start: enabled Port: 18789 Onboarding complete! Quick start: openclaw gateway status Check if running openclaw dashboard Open control panel openclaw agent -m Hello Send a message三、手动配置不用向导如果你想完全控制配置过程3.1 创建配置文件# 创建配置目录mkdir-p~/.openclaw/workspace# 创建最小配置cat~/.openclaw/openclaw.jsonEOF { agents: { defaults: { model: anthropic/claude-sonnet-4, workspace: ~/.openclaw/workspace } } } EOF3.2 配置 API Key# 创建密钥目录mkdir-p~/.openclaw/secrets# 写入 API KeyechoANTHROPIC_API_KEYsk-ant-xxxxxxxx~/.openclaw/secrets/.env3.3 手动启动 Gateway# 前台运行调试用openclaw gateway--port18789--verbose# 安装为后台服务openclaw gatewayinstallopenclaw gateway start四、验证配置4.1 健康检查openclaw doctor OpenClaw Health Check ════════════════════════════════════════ ✅ Node.js: v24.15.0 ✅ OpenClaw: v2026.7.1 ✅ Gateway: Running on port 18789 ✅ Model: anthropic/claude-sonnet-4 ✅ API Key: Configured ✅ Workspace: ~/.openclaw/workspace ✅ DM Policy: pairing (secure) All checks passed! 4.2 发送测试消息openclaw agent--messageHello! What can you do?如果 Agent 回复了说明配置完全成功。五、Daemon 管理5.1 什么是 DaemonDaemon守护进程让 Gateway 在后台持续运行——即使你关闭终端OpenClaw 依然在线。5.2 平台对应的 Daemon平台Daemon 机制安装命令macOSlaunchdopenclaw gateway installLinuxsystemd user serviceopenclaw gateway installWindowsScheduled Taskopenclaw gateway install5.3 管理命令openclaw gateway start# 启动openclaw gateway stop# 停止openclaw gateway restart# 重启openclaw gateway status# 查看状态下面是 Daemon 与 Gateway 的架构关系Daemon守护进程端口 18789后台服务DM 配对技能引擎模型 Provider用户终端CLI 命令DashboardWebChatGateway 服务–本篇小结知识点核心内容openclaw onboard交互式配置向导--install-daemon同时安装守护进程OAuth 订阅用 Claude Pro/Max / ChatGPT / Copilot 订阅API Key传统密钥认证openclaw.json主配置文件Workspace~/.openclaw/workspace/Daemonlaunchd / systemd / Scheduled Taskopenclaw doctor健康检查下篇预告第 4 篇与 OpenClaw 的第一次对话配置完毕开始和 OpenClaw 对话下一篇体验 CLI 对话、Dashboard 控制面板和 WebChat 聊天界面。如果本篇内容对你有帮助欢迎点赞收藏有任何疑问欢迎在评论区交流。