OpenClaw 初始化配置在哪里做？

运行 openclaw onboard --install-daemon 命令启动向导，引导你完成 API Key 设置、模型选择和通讯平台连接。如果跳过了向导，可以在 dashboard 的「API Providers」和「Integrations」里手动配置。

OpenClaw 初始化需要哪些东西？

至少需要 Node.js 22.14+ 或 24，以及一个 AI 模型的 API Key。国内推荐 ofox.ai（支持支付宝/微信充值），一个 Key 可以调用 Claude、GPT、DeepSeek、Kimi 等 100+ 模型，不需要科学上网。如果要连接通讯平台（如 Telegram），还需要对应平台的 Bot Token。

OpenClaw onboard 配置后模型不响应怎么办？

依次排查：1）确认 API Key 填写正确，没有多余空格；2）检查 Base URL，国内直连海外 API 可能超时，改用 ofox.ai 的国内端点；3）在 /model 命令里切换到另一个模型测试；4）查看右下角状态栏是否显示 context 限制警告。

OpenClaw 支持哪些国内模型？

通过 ofox.ai 接入可以使用全部主流国产模型：Kimi K2.5、MiniMax M2.7、DeepSeek V4、通义千问 Qwen3.6、字节豆包、智谱 GLM-5 等。直接在 API Provider 里填 ofox.ai 的 Base URL 和 Key，再选模型 ID 即可。

OpenClaw 可以同时配置多个 API Provider 吗？

可以。OpenClaw 支持添加多个 API Provider，每个 Provider 对应不同的 Base URL 和 Key。你可以同时接入 ofox.ai（国内模型）和官方 Anthropic（Claude 官方直连）。配置完成后在 /model 命令里按模型切换。

Apr 10, 2026 (updated Apr 10, 2026 )

openclawonboardapi-setupchina-guidetutorial

OpenClaw 初始化配置完全指南：从安装到第一次对话（2026）

第一次打开 OpenClaw，很多人在 Onboard 向导卡住——不知道填什么 API、从哪找 Key、通讯平台要不要现在连。这篇把整个初始化流程拆开，按顺序走完就能跑起来。

安装 OpenClaw

一行命令装完，需要 Node.js 22.14+ 或 24（推荐）。

macOS / Linux：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

也支持 Docker、Nix、npm 全局安装，服务器部署细节见《OpenClaw Docker 部署指南》。

安装完运行 Onboard 命令，这就是配置入口：

openclaw onboard --install-daemon

OpenClaw Onboard 向导全流程

第一步：运行 Onboard 命令

openclaw onboard --install-daemon

向导大约 2 分钟走完，引导你选 Provider、填 API Key、配置 Gateway 并设置为守护进程开机自启。

第二步：添加 API Provider

OpenClaw 本身不包含 AI 模型，要靠你填一个 API。

向导里列了内置选项（OpenAI、Anthropic 等），国内直连这些延迟高、容易超时，还要境外信用卡。实际用下来，填 ofox.ai 是最省事的：

字段	填写内容
Provider Name	ofox.ai（随便写）
Base URL	`https://api.ofox.ai/v1`
API Key	你的 ofox.ai Key（`sk-` 开头）

ofox.ai 走 OpenAI 兼容协议，OpenClaw 直接识别为标准 OpenAI Provider。支付宝/微信充值，不要境外卡。去 ofox.ai 注册后在「API Keys」里生成。

填完点「Verify」，状态变绿说明通了。

第三步：选择默认模型

连通 Provider 后选默认模型，列表里会把这个 Provider 支持的模型全列出来。用 ofox.ai 会有 100+ 个，按场景选就行：

场景	推荐模型
日常对话/写作	`claude-sonnet-4-6` 或 `gpt-5.4`
复杂推理/代码	`claude-opus-4-6`
高频调用/省钱	`deepseek-v4` 或 `minimax-m2-7`
国产模型	`kimi-k2-5`

选好就是新对话的默认，随时 /model 切换。

第四步：连接通讯平台（可选）

Telegram、Discord、飞书等平台连接可以跳过，先把 AI 跑起来再说。

现在想配的话，Telegram 最简单：在 Telegram 找 @BotFather，发 /newbot 创建 Bot，把拿到的 Token 填到向导里。配好之后向 Bot 发消息，OpenClaw 就用你选的模型回复。飞书/钉钉需要在开发者后台建应用，稍复杂一些，详见《OpenClaw 国内 API 完全攻略》。

第五步：完成向导并验证 Gateway

Onboard 完成后检查 Gateway 状态：

openclaw gateway status

应该显示监听在 18789 端口。然后打开控制台：

openclaw dashboard

第一次对话：验证配置

Dashboard 在浏览器打开后，在聊天界面随便发一句话，比如「你好，自我介绍一下」。AI 正常回复说明配置没问题。

没响应或报错，看状态栏：

API Error → Key 填错了或余额不足
Connection Timeout → Base URL 不可达，换 ofox.ai 端点
Model Not Found → 模型名拼错了，用 /model 从列表选

接入国内大模型

国内主流模型通过 ofox.ai 都能用，配置方式和海外模型一样：Base URL 填 https://api.ofox.ai/v1，选对应模型 ID。

常用国产模型 ID：

模型	模型 ID
Kimi K2.5	`kimi-k2-5`
MiniMax M2.7	`minimax-m2-7`
DeepSeek V4	`deepseek-v4`
通义 Qwen3.6	`qwen3.6-plus`
豆包 Doubao Seed 2.0	`doubao-seed-2-0`
GLM-5	`glm-5`

某个国产模型的具体效果和配置建议，参考 Kimi K2.5 OpenClaw 配置教程。

5 个高频 Onboard 报错

no api key found for provider：Key 没填或填了没保存。进「Settings → API Providers」重新检查。

llm request timed out：请求超时，通常是直连海外 API 网络问题。换 ofox.ai 国内端点基本能解决。

unauthorized / 401：Key 无效，可能过期、填错、或账户余额归零。重新生成 Key 或充值。

there's an issue with the selected model：模型 ID 写错了，或这个 Provider 不支持这个模型。用 /model 从列表里选，不要手动输入。

100% context used：对话超出模型 context 限制。发 /new 开新对话，或换 context 更大的模型（claude-sonnet-4-6 是 128K）。

配好之后值得去做的几件事

联网搜索需要单独开，进「Settings → Search」填搜索 API（Brave Search 或 Serper）。细节见《OpenClaw Search Provider 配置指南》。

不同任务用不同模型省钱效果明显——代码任务走 Claude Opus，日常问答走 DeepSeek，token 消耗能差好几倍。「Settings → API Providers」里加多个 Provider 就行。

ClawHub 里有社区分享的 skill 包，自动化运维、写作助手这类常用场景都有现成的，OpenClaw Skills 完全指南有详细介绍。省钱方案见《OpenClaw 省钱完全指南》。

初始化核心就三步：装软件、配 API Provider、选模型。卡住了先查 API Key 和 Base URL，大多数问题出在这里。配好之后想深挖模型配置，OpenClaw 模型配置完全教程接着看。