OpenClaw 中文版部署全指南10分钟搞定！
一、前言
OpenClaw 是一款强大的个人 AI 智能体框架，能让你在本地运行专属 AI 助手，并接入飞书等通讯工具。本文基于 2026 年最新版 OpenClaw 中文版 (@qingchencloud/openclaw-zh)，手把手带你完成从环境准备、API Key 获取、网关启动到 Web 管理界面配置的全过程。
如果你身在国内，想用最熟悉的工具和最划算的模型（国产大模型）来搭建 AI 助手，中文版是唯一可行的选择【更适合中国宝宝的体质！】。原版更像是一个给全球极客玩的“原型”，而中文版才是真正能落地的“产品”。
openclaw官方中文版文档：docs.openclaw.ai/zh-CN
二、环境准备
在开始之前，请确保你的电脑满足以下条件：
操作系统：Windows 10/11 Node.js：版本需 ≥ 22.x (推荐使用 LTS 版本) npm强烈推荐版本: v10.x 或更高
检查版本：在终端输入
node -v
npm -v
下载地址：Node.js 官网 https://nodejs.org/
请点击左侧绿色的 LTS (Long Term Support) 版本（目前通常是 v22.x）。
💡 提示：Windows 用户推荐使用 Cmder 或 PowerShell 以获得更好的命令行体验。(如果要配置fs插件要用到二维码显示，建议提前下载 cmder.app/ )
三、安装 OpenClaw 中文版
1、打开cmder，执行以下命令安装最新版的中文核心包：
// 使用淘宝镜像地址
npm install @qingchencloud/openclaw-zh --registry=https://registry.npmmirror.com
// 将默认源永久修改为淘宝镜像，以后所有 npm 操作都会加速：
npm config set registry https://registry.npmmirror.com
// 验证是否成功：
npm config get registry
// 安装openclaw中文版
npm install -g @qingchencloud/openclaw-zh@latest
2、安装成功标志： 终端显示 added XXX packages 且无 error 字样。 ⚠️ 注意：如果出现 deprecated 警告（如 node-domexception），可忽略，不影响使用。
3、安装完成后，验证版本：
openclaw -v
应显示类似 OpenClaw 2026.3.23 ... 的版本信息。
4、关键步骤：获取并配置 API Key
OpenClaw 本身是一个框架，它需要连接大模型（LLM）才能思考。你需要获取一个 API Key。
4.1 选择模型提供商 国内用户推荐常见的几个平台（注册通常送免费额度）。
4.2 获取 API Key (以硅基流动/阿里云为例) 登录对应平台的控制台。 找到 "API Key" 或 "访问令牌" 管理页面。
点击 "创建新密钥" (Create New Key)。
重要：复制生成的 Key（通常以 sk- 开头），只显示一次，请立即保存到安全的地方（如密码管理器）。
4.3 在 OpenClaw 中配置 Key 方式 A：交互式向导（推荐新手） 首次运行时，直接启动程序，它会引导你输入： openclaw onboard
按提示选择模型提供商，粘贴刚才复制的 API Key。
方式 B：命令行直接配置（快捷） 如果你已经知道要用的模型，可以直接运行：
设置默认模型提供商 (例如 siliconflow) openclaw config set-key llm.default.provider-value siliconflow
设置 API Key (替换为你真实的 Key) openclaw config set-key llm.default.apiKey-value sk-xxxxxxxxxxxxxxxxxxxxxxxx
(可选) 设置模型名称 openclaw config set-key llm.default.model-value xxxx
🔒 安全提示：API Key 等同于密码，不要上传到 GitHub 或分享给他人。
五、启动网关服务
配置好 API Key 后，需要启动 Gateway（网关） 服务，它是连接 Web 界面、聊天工具和 AI 核心的桥梁。
启动步骤 在终端输入：
openclaw onboard
或者如果已配置过：
openclaw
观察日志： 看到类似以下日志表示启动成功： ✅ Gateway service started on ws://127.0.0.1:18789 🌐 Web UI available at http://localhost:3000
💡 后台运行： 如果需要关机重启后自动运行，可运行 openclaw onboard --daemon (具体命令视版本而定，或使用系统任务计划程序)。
六、访问 Web 管理界面
网关启动成功后，你就可以通过浏览器管理你的 AI 助手了。
打开浏览器（Chrome/Edge/Firefox）。 输入地址， 通常是：
http://127.0.0.1:18789/communications
界面功能： 仪表盘：查看 AI 运行状态、Token 消耗。 技能/插件市场：启用/禁用各种功能（如搜索、文件处理、定时任务）。 通道配置：绑定飞书、微信、Telegram 等。 对话测试：直接在网页上和 AI 聊天测试效果。
