第一次打开 OpenClaw,很多人在 Onboard 向导卡住——不知道填什么 API、从哪找 Key、通讯平台要不要现在连。这篇把整个初始化流程拆开,按顺序走完就能跑起来。
两种运行方式:桌面客户端和自托管服务端。
桌面客户端从 openclaw.ai 下载安装包。Mac 用 .dmg,Windows 用 .exe,安装完第一次打开就进 Onboard 向导。
自托管适合服务器部署或团队共用,Docker 一行启动,或 npm/pnpm 全局安装后命令行运行。Web UI 和桌面端一样,Onboard 流程没差别。服务器部署细节见《OpenClaw Docker 部署指南》。
Onboard 向导弹出来不要关,这就是配置入口。
向导先问你用 OpenClaw 做什么:Personal(个人日常)、Developer(开发者场景)、Team(团队共用)。这影响默认推荐的模型和功能开关,后面设置里随时可改,不用太纠结。
OpenClaw 本身不包含 AI 模型,要靠你填一个 API。
向导里列了内置选项(OpenAI、Anthropic 等),国内直连这些延迟高、容易超时,还要境外信用卡。实际用下来,填 ofox.ai 是最省事的:
https://api.ofox.ai/v1API 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、飞书、iMessage 等平台连接这步可以跳过,先把 AI 跑起来再说。
现在想配的话,Telegram 最简单:在 Telegram 找 @BotFather,发 /newbot 创建 Bot,把拿到的 Token 粘到向导里。配好之后向 Bot 发消息,OpenClaw 就用你选的模型回复。飞书/钉钉需要在开发者后台建应用,稍复杂一些,详见《OpenClaw 国内 API 完全攻略》。
最后确认设置摘要,点「Start Using OpenClaw」进主界面。初始化到这里就完了。
主界面随便发一句话,比如「你好,自我介绍一下」。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:
kimi-k2-5MiniMax M2.7
minimax-m2-7DeepSeek V4
deepseek-v4通义 Qwen3.6
qwen3.6-plus豆包 Doubao Seed 2.0
doubao-seed-2-0GLM-5
glm-5
某个国产模型的具体效果和配置建议,参考 Kimi K2.5 OpenClaw 配置教程。
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 模型配置完全教程接着看。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/256902.html