第一次配置 OpenClaw 向导，每个选项是什么意思？全部用大白话解释

你在终端里跑了安装命令，OpenClaw 开始要你回答一堆问题——选模型、填端口、选渠道、装技能……每个选项背后跟着几个英文单词，你不确定选哪个，最后只能凭感觉乱点，然后担心自己选错了。

这篇文章把引导向导的每一个选项翻译成人话，告诉你每个问题在问什么、选哪个最合适、以及不想现在决定时能不能跳过。更多资源请访问 OpenClaw 中文版官网。

先了解整个流程的结构

运行 openclaw onboard 之后，向导会按顺序问你几个大类的问题：

1. 选配置模式：QuickStart 还是自定义
2. 选 AI 模型：用哪个大模型作为 AI 的”大脑”
3. 填认证信息：API Key 或 OAuth 登录
4. 设置 Gateway 端口：控制面板在哪个端口
5. 选消息渠道：通过哪个 App 和 AI 对话
6. 选技能包：要不要安装额外功能
7. 其他配置：各种可选功能的开关

每一大步遇到不懂的选项，找到下面对应的章节就能看到解释。

第一步：QuickStart 还是自定义？

问题原文

How would you like to set up OpenClaw?
> QuickStart（recommended）
  Custom

大白话解释

QuickStart：向导帮你做大多数决定，只问你最关键的几个。适合绝大多数新手——选这个，10 分钟内能跑起来。

Custom：每个细节都自己控制，选项非常多。适合你知道自己要做什么、有特殊配置需求的情况。

建议：第一次配置选 QuickStart。以后熟悉了之后，任何设置都可以在配置文件里手动修改，不需要重新跑向导。

第二步：选 AI 模型

问题原文

Select your AI model provider:
> Anthropic (Claude)
  OpenAI (GPT)
  Google (Gemini)
  Moonshot AI (Kimi K2.5)
  Qwen (Alibaba Cloud Model Studio)
  DeepSeek
  ...（其他选项）

大白话解释

这里选的是让哪家公司的 AI 来给你的 OpenClaw “提供大脑”。OpenClaw 本身不是 AI 模型，它需要连接一个外部的 AI 服务来理解和回答你的问题。

主要选项的区别：

国内用户推荐：没有代理的情况下，选 Kimi、Qwen 或 DeepSeek 任意一个，都能直连，API 注册也方便。有代理的情况下，Claude 或 Gemini 是更多人的首选。

第三步：选认证方式

问题原文（以 Gemini 为例）

Select authentication method:
> Gemini API Key
  Gemini CLI (OAuth)
  Skip for now

大白话解释

API Key：你去这家公司的开发者平台申请一个密钥（一串字母数字），填进去，OpenClaw 用它来调用 AI 服务，按你实际使用量计费。适合大多数人。

OAuth（如 Gemini CLI / OpenAI Codex）：用你的账号直接登录授权，不需要单独申请 Key，消耗的是你的订阅额度（比如 ChatGPT Plus）。适合已经有订阅的用户。

Skip for now：先跳过，以后再填。选这个的话 AI 暂时无法工作，但向导会继续让你完成其他设置。如果你还没申请 Key，选 Skip，配置完成后单独填 Key 就行。

API Key 填哪里找

• Gemini：aistudio.google.com/apikey，免费注册即可创建
• Kimi（Moonshot）：platform.moonshot.ai → API Keys
• Qwen（通义千问）：bailian.aliyun.com → API Key 管理
• DeepSeek：platform.deepseek.com → API Keys
• Claude：console.anthropic.com → API Keys

第四步：选默认模型

问题原文（以 Moonshot 为例）

Select default model:
> moonshot/kimi-k2.5  (recommended)
  moonshot/kimi-k2-thinking
  moonshot/kimi-k2-turbo-preview
  Keep current

大白话解释

同一家提供商通常有几个不同的模型可以选，区别是能力和速度的权衡：

• 标准版（如 kimi-k2.5、deepseek-chat、gemini-3-flash-preview）：速度和质量平衡，日常任务够用，价格合理。大多数人选这个。
• Thinking / 推理版（如 kimi-k2-thinking、deepseek-reasoner）：回答前先进行深度推理，适合复杂分析。速度慢、花费多，不适合作默认。
• Turbo / Fast 版：速度优先，质量略低，适合对响应速度有要求的场景。
• Keep current：如果你之前配置过，保持现有的不变。

建议：选标准版（向导通常会标注 recommended）。以后可以随时用 /model 命令临时切换到更强的模型处理特定任务。

第五步：Gateway 端口设置

问题原文

Gateway port (default: 18789):
> [输入框，默认 18789]

大白话解释

Gateway 是 OpenClaw 的核心服务进程，它需要在你的电脑上”占用”一个端口来接收连接。这个端口决定了你以后在浏览器里访问控制面板时用的地址：

• 默认端口 18789 → 控制面板地址：http://127.0.0.1:18789
• 如果改成 8080 → 控制面板地址：http://127.0.0.1:8080

直接回车，用默认的 18789 就好。只有当这个端口已经被你电脑上的其他程序占用时，才需要换一个数字（随便换一个 10000～65535 之间的数字都行）。

怎么知道端口被占了？如果后续 Gateway 启动失败，错误信息里会有 “EADDRINUSE” 字样，那时候再换就行。

第六步：选消息渠道

问题原文

Select a messaging channel to connect:
> Telegram
  WhatsApp
  Discord
  Slack
  Signal
  WeChat (via plugin)
  Skip for now

大白话解释

渠道是你和 AI 对话的”窗口”。OpenClaw 的设计理念是让 AI 住在你已经在用的消息软件里，而不是要你专门去开另一个 App。

几个主要选项的特点：

• Telegram：配置最简单，功能最完整，Bot 注册用 @BotFather，几分钟搞定。国内访问需要代理，但在海外部署的服务器上没问题。技术用户首选。
• WhatsApp：国际用户多，配置稍复杂（需要扫二维码登录），适合已经在用 WhatsApp 的人。
• Discord：适合已经在用 Discord 的开发者社区用户，支持线程和频道管理。
• Slack：适合企业/团队场景，连接已有工作 Slack 工作区。
• 微信（WeChat）：需要安装官方腾讯插件，功能有一定限制，但对国内用户最方便。
• Skip for now：暂时不连接渠道，只用控制面板里的 WebChat（网页版聊天）。如果不确定选哪个，先选 Skip，以后随时加。

渠道不是必须的，也不限制只选一个——可以同时连接 Telegram 和微信，两个里面都能和同一个 AI 对话。

第七步：技能（Skills）安装

问题原文

Install basic skills?
> Yes, install recommended skills
  Let me choose
  Skip for now

大白话解释

技能包是给 AI 装上”专用工具”的扩展模块。不装技能，AI 只能回答问题；装了天气技能，AI 就能真的去查天气；装了 GitHub 技能，AI 就能操作你的代码仓库。

Yes, install recommended skills：自动安装一批常用技能（天气、日历等）。如果你对这些用途感兴趣，选这个，省事。

Let me choose：自己选择要安装哪些技能。

Skip for now：先不装，以后用到什么再装。这是完全合理的选择，技能随时可以用 openclaw plugins install 命令添加。

建议：第一次配置选 Skip for now，先跑通基础功能，以后按需要再加技能。

第八步：npm 还是 pnpm？

问题原文

Preferred package manager for skills:
> npm
  pnpm
  bun

大白话解释

这里问的是你电脑上用哪个 Node.js 包管理工具。不知道自己用的是什么？运行一下检查：

which npm    # 看 npm 在不在
which pnpm   # 看 pnpm 在不在

有输出的那个就是你装了的。如果两个都有，用 npm 没问题。如果你不确定，直接选 npm——这是最通用的选择，99% 的电脑上都有。

第九步：是否安装守护进程

问题原文

Install OpenClaw as a background service (daemon)?
> Yes (recommended)
  No

大白话解释

选 Yes：OpenClaw 的 Gateway 会被注册为系统服务（macOS 的 launchd，Linux 的 systemd），开机自动启动，不需要手动运行，你关掉终端窗口它也继续在后台跑。几乎所有人都应该选 Yes。

选 No：每次使用 OpenClaw 之前，你需要手动在终端里运行 openclaw gateway start，关掉终端或重启电脑后 Gateway 就停了。除非你有特殊原因不想让它后台运行，否则选 No 会很麻烦。

第十步：是否启用 Session Hook

问题原文

Enable session logging hooks?
> Yes
  No

大白话解释

Hook（钩子）是一类事件触发机制——比如”每次会话结束后，自动把对话内容写入日志文件”。Session Hook 会让 OpenClaw 在特定事件发生时自动运行一段脚本或命令。

如果你不知道这是什么，选 No。Hook 是高级功能，普通用户用不到，以后有需要再手动配置。

第十一步：其他各种”Yes/No”问题

向导的最后阶段会有一些功能的开关确认，遇到不认识的按这个原则判断：

向导跑完之后，做这三件事

向导完成后，OpenClaw 会显示配置摘要并启动 Gateway。这时候建议马上做三件事，确认一切正常：

# 1. 确认 Gateway 在运行
openclaw gateway status

# 2. 打开控制面板（浏览器访问）
open http://127.0.0.1:18789   # macOS
# Linux 用户手动在浏览器里打开这个地址

# 3. 查看当前状态和模型
# 在控制面板的聊天框里发这条指令：
/status

如果 /status 返回了你选择的模型名称，说明配置成功，可以开始用了。

配错了怎么办？

向导选错了不用重新安装。所有配置都存在 ~/.openclaw/openclaw.json 里，可以直接编辑：

# 打开配置文件（用系统默认编辑器）
open ~/.openclaw/openclaw.json    # macOS
nano ~/.openclaw/openclaw.json    # Linux

# 或者直接通过命令行修改某个值
openclaw config set agents.defaults.model.primary "google/gemini-3-flash-preview"

# 也可以重新跑向导（覆盖部分设置）
openclaw configure --section models

最常见的”配错了”场景是选了 API Key 但跳过没填——去 openclaw.json 里找 env.OPENAI_API_KEY（或对应服务商的变量名），把你的 Key 填进去，重启 Gateway 就行：

openclaw daemon restart

总结：新手的最优选法

如果你看了上面所有解释还是不确定，按这个简单规则选：

• 配置模式 → QuickStart
• AI 模型 → 国内用 Kimi / DeepSeek / Qwen，有代理用 Gemini（免费）
• 认证 → 填 API Key，没准备好选 Skip for now
• 默认模型 → 选标准版（recommended 标注的那个）
• Gateway 端口 → 直接回车（用 18789）
• 消息渠道 → 不确定先 Skip for now
• 技能安装 → Skip for now
• 包管理器 → npm
• 守护进程 → Yes
• 其他不认识的 → No 或 Skip

按这个表格选完，10 分钟内能跑起来一个可以用的 OpenClaw。后续的高级配置，等熟悉基础功能之后再慢慢探索。

想了解更多 OpenClaw 使用技巧，欢迎访问 OpenClaw 中文版官网。