OpenClaw 国内 Windows 用户专属 - 初始导向页面（Onboarding 向导）超级详细说明 + 操作流程（2026 年 3 月最新官方版）

1. 如何启动初始导向页面（Onboarding 向导）

• 安装后自动启动（推荐）：运行安装脚本 iwr -useb https://openclaw.ai/install.ps1 | iex 时会直接进入。
• 手动启动（任何时候重跑）：
  PowerShell

  openclaw onboard

• 想跳过部分直接快速配置（高级）：
  PowerShell

  openclaw onboard --flow quickstart

• 完全重置重来（出问题时用）：
  PowerShell

  openclaw onboard --reset

提示：全程在同一个管理员 PowerShell 窗口操作。出现中文乱码？先运行 chcp 65001 切换 UTF-8。

2. 完整操作流程（9 大步骤 + 精确提示 & 操作说明）

向导会逐个弹出问题（用 ↑↓ 箭头选择，Enter 确认，Ctrl+C 可随时退出）：

步骤 1：安全提示 + 现有配置检测（欢迎页）

终端显示：

⚠️  OpenClaw 将获得本地文件、网络、聊天工具访问权限。请确认已了解风险。
Continue? (Yes/No)

操作：输入 Yes（必须！否则退出） 然后检测 ~/.openclaw/openclaw.json：

• 首次安装：直接跳过
• 已有配置：选择 保留（Keep） / 修改（Modify） / 重置（Reset）推荐：首次选保留或直接继续。

步骤 2：Onboarding 模式选择（最重要一步！）

终端显示：

Onboarding mode
→ QuickStart（快速开始，默认推荐）
  Advanced（高级模式，手动控制每一步）

国内用户强烈推荐选 QuickStart（最小配置，最快上线）

• QuickStart 会自动：
  • 本地 Gateway（loopback）
  • 端口 18789
  • Token 认证（自动生成）
  • 默认工作区 C:\Users\你的用户名\.openclaw\workspace

步骤 3：AI 模型 / 认证配置（国内模型首选）

终端显示模型列表（支持国内直连）：

Model / Auth Provider
→ Moonshot（Kimi K2 / Kimi Coding）← 中国用户首选
  MiniMax M2.5
  OpenAI / Anthropic（需FQ）
  xAI (Grok)
  OpenCode Zen / Vercel AI Gateway
  Skip for now（先跳过，后续改）

操作：

1. 选 Moonshot 或 MiniMax（国内最稳免费/低价）
2. 去对应官网（kimi.moonshot.cn 或 minimax.cn）复制 API Key
3. 粘贴（确保单行无空格）
4. 选择默认模型（推荐最新版，如 moonshot-v1 或 MiniMax-Text-01）
5. 测试连接（向导会自动 ping，国内秒通过）

国内用户Tips：DeepSeek / 通义千问 / GLM 可选 “Custom Provider” 或后期在 Dashboard 配置（OpenAI 兼容格式）。

步骤 4：工作区配置

Workspace location (默认 C:\Users\你的用户名\.openclaw\workspace)

推荐直接回车（默认路径）。向导会自动创建必要文件（AGENTS.md、IDENTITY.md 等）。

步骤 5：Gateway 网关设置

Gateway port: 18789（默认）
Bind: loopback（本地）
Auth mode: Token（推荐）
Tailscale: Off

全部默认回车即可（中国用户无需改）。

步骤 6：聊天渠道配置（飞书/钉钉后期再加）

Select channels to configure:
→ Telegram（推荐，最简单）
  Discord
  WhatsApp（需扫码）
  Skip all for now

国内用户推荐：

• 先选 Skip（最快）
• 或接 Telegram（BotFather 几秒搞定）
• 飞书/钉钉/企业微信：官方暂无原生（文档未列），但安装后可在 Dashboard → Channels 或 Skills 插件里添加（社区有飞书插件，命令 openclaw skills install feishu）。

步骤 7：守护进程（Daemon）安装

Install as daemon? (开机自启)
→ Yes（强烈推荐）
Runtime: Node.js（推荐）

选 Yes → 自动用 systemd（Windows 通过 WSL2 或直接服务）开机自启。

步骤 8：Skills 插件安装 + Web Search

Install recommended Skills? Yes
Web Search Provider:
→ Kimi（国内推荐）
  Brave / Perplexity
  Skip

选 Yes + 输入对应 API Key（Kimi 最丝滑）。

步骤 9：健康检查 + 完成总结

向导自动：

• 启动 Gateway
• 运行 openclaw health

显示总结：

Onboarding completed! 🎉 Dashboard: http://127.0.0.1:18789



无论您对文章有任何想法，或是合作、闲聊，我都乐于倾听。邮箱： sunsetbobo@qq.com

社交媒体：

抖音号：dykpxln9g87a

 

© 2026 您的博客名 · 由您用 ❤️ 维护
如有需要，可直接通过上方邮箱联系我。