中国

AI 智能体

OpenClaw-CN中文版安装部署教程

中文版OpenClaw安装部署

链接直达手机查看

OpenClaw-CN 中文版

OpenClaw（曾用名：Clawdbot、Moltbot）是由开发者 Peter Steinberger 推出的开源自部署个人 AI 智能体网关，主打本地运行、隐私可控，并非传统云托管聊天机器人，它可在 macOS、Linux、Windows WSL2 等个人设备部署，能无缝接入 WhatsApp、Telegram、Discord、iMessage 等主流通讯渠道，用户无需切换新应用，在日常聊天工具中即可发起交互，同时支持连接 Claude、OpenAI 等主流大模型，还具备本地工具调用、记忆系统与任务执行能力，可实现从对话到决策再到实际操作的闭环，兼具跨平台适配性与高度自定义空间，是面向极客与技术爱好者的轻量化、私有化 AI 助手解决方案。

安装更多技能

帮我远程安装

Windows 系统安装部署OpenClaw中文版

Windows 系统 安装 OpenClaw-CN 中文版教程，纯国内网络环境安装，看步骤操作操作，全程零门槛，简单快捷。

准备工作

1、OpenClaw-Cn中文版网站

OpenClaw-Cn 中文社区网站：https://clawd.org.cn
OpenClaw-Cn 在GitHub开源项目网址：https://github.com/jiulingyun/openclaw-cn

2、Ai大模型提供商

可接入的国内厂家（选择一家即可）：

阿里云百炼 Qwen-Plus：https://www.aliyun.com
MiniMax：https://www.minimaxi.com
Xiaomi-MiMo：https://platform.xiaomimimo.com
DeepSeek：https://www.deepseek.com
火山引擎：https://www.volcengine.com

以上Ai模型网站注册申请ApiKey，有免费试用、有赠送代金券、或付费购买。

3、环境要求

系统：Windows11（本文以Win系统为主）
Node.js ：版本>=22，下载地址：https://nodejs.org

安装步骤一：环境配置

1、下载安装Node.js

OpenClaw 基于 Node.js 运行，可以下载安装包程序，安装后自动配置系统环境。

也可以使用免安装版本.zip，所有配置都在一个文件夹里，但是系统环境需要手动配置一下，

本人使用软件喜欢免安装版本，以下为免安装版本的配置方式。

打开 Node.js 官方下载页：https://nodejs.org/en/download

下滑找到 Standalone Binary (.zip) 版本，选择 win-x64 下载（如 node-v24.13.0-win-x64.zip）

下载完成后，解压到无中文、无空格、无特殊字符的路径，示例：

C:\Programs\node

✅ 检查：解压后文件夹内必须有 node.exe、npm.cmd 两个核心文件

2. 配置系统环境变量

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」

在下方系统变量区域，找到并双击 Path

点击「新建」，粘贴 Node.js 解压路径：

C:\Programs\node

依次点击「确定」，关闭所有配置窗口（必须保存生效）

3. 验证 Node.js 安装

按下 Win + R，输入 cmd，打开新的命令提示符窗口，分别执行以下两条命令，查看版本号：

node -v

npm -v

出现类似以下输出，说明配置成功：

v24.13.0

11.11.0

安装步骤二：安装OpenClaw-CN

1、使用代码安装 OpenClaw

在 OpenClaw 中文社区网站内可以看到 Windows 国内镜像安装命令

系统左下角--Win图标右键--点击打开：终端管理员或者 PowerShell，运行以下代码

iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com

提示风险，选择 Yes 继续

2、设置 OpenClaw-CN

到这里，OpenClaw-CN 已经安装完成，如果在上面的设置过程，操作不对，也没关系，都可以继续下一步，直到完成，随后还可以重新设置。

重新打开终端（PowerShell），测试一下OpenClaw-CN 是否安装成功，输入命令：

openclaw-cn -v

3、修改配置 OpenClaw-CN

先查询一下OpenClaw有哪些命令，输入

如果之前的操作中，没有配置好OpenClaw-CN，可以输入命令：

openclaw-cn --help

《OpenClaw 所有参数/命令/示例》

用法：

openclaw-cn [options] [command]

选项 options

参数	中文说明
-V, --version	输出版本号
--dev	开发模式：将状态隔离到 ~/.openclaw-cn-dev，默认网关端口 19001，并调整派生端口（浏览器/画布）
--profile <name>	使用命名配置文件（将 OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH 隔离到 ~/.openclaw-cn-<name>）
--no-color	禁用 ANSI 彩色输出
-h, --help	显示命令帮助信息

命令 command

命令	中文说明
setup	初始化 ~/.openclaw/openclaw.json 和智能体工作区
onboard	交互式引导配置：完成网关、工作空间和技能的初始化设置
configure	交互式弹窗配置：设置密钥凭证、设备配对和代理默认参数
config	配置文件辅助工具（支持获取 / 设置 / 清空配置项）；直接运行将启动交互式配置向导
doctor	健康检查工具：检测网关和通信渠道问题，并尝试快速修复
dashboard	使用当前令牌打开控制界面（UI）
reset	重置本地配置 / 运行状态（保留 CLI 命令行工具，不卸载）
uninstall	卸载网关服务及本地数据（CLI 命令行工具仍保留，可继续使用）
message	发送消息和执行渠道相关操作
memory	记忆数据检索工具（检索历史会话 / 存储的记忆信息）
agent	通过网关运行代理单次交互（添加 --local 参数可启用本地嵌入式代理）
agents	管理隔离式代理（包括工作空间、身份验证和路由规则配置）
acp	代理控制协议（Agent Control Protocol）工具集
gateway	网关服务控制（启动 / 停止 / 重启等）
daemon	网关守护进程（旧版别名，功能同 gateway）
logs	查看网关运行日志
system	系统事件管理：查看心跳、设备在线状态等系统信息
models	模型配置工具（配置调用的 AI 模型、接口参数等）
approvals	执行权限审批工具（管理操作执行的审批规则）
nodes	节点管理命令集
devices	设备配对及令牌管理（绑定 / 解绑设备、管理设备访问令牌）
node	单个节点的控制操作
sandbox	沙箱工具（隔离运行环境，测试技能 / 操作）
tui	终端交互界面（纯命令行可视化操作界面）
cron	定时任务调度工具（配置自动化定时执行的操作）
dns	DNS 解析辅助工具
docs	文档辅助工具（查看本地 / 在线文档）
hooks	钩子工具（配置事件触发的自定义钩子操作）
webhooks	网络钩子工具（配置外部系统的 Webhook 联动）
pairing	设备配对辅助工具
plugins	插件管理（安装 / 卸载 / 启用 / 禁用插件）
channels	通信渠道管理（配置 / 登录 / 解绑 WhatsApp、Telegram 等消息渠道）
directory	目录管理命令集
security	安全辅助工具（管理权限、加密、安全规则等）
skills	技能管理（添加 / 删除 / 配置代理的技能）
update	命令行工具（CLI）更新辅助工具
feishu	飞书调试工具
status	查看通信渠道健康状态和最近会话的接收方信息
health	从运行中的网关获取实时健康状态数据
sessions	列出已存储的所有对话会话记录
browser	管理 OpenClaw 专属浏览器（Chrome/Chromium）
help	显示命令帮助信息

示例：

openclaw-cn channels login --verbose
（连接个人 WhatsApp Web 并显示二维码和连接日志。）
openclaw-cn message send --target +15555550123 --message "Hi" --json
（通过你的 Web 会话发送消息并输出 JSON 结果。）
openclaw-cn gateway --port 18789
（在本地运行 WebSocket 网关。）
openclaw-cn --dev gateway
（在 ws://127.0.0.1:19001 运行开发网关（隔离状态/配置）。）
openclaw-cn gateway --force
（终止占用默认网关端口的进程，然后启动网关。）
openclaw-cn gateway ...
（通过 WebSocket 控制网关。）
openclaw-cn agent --to +15555550123 --message "Run summary" --deliver
（通过网关与智能体直接对话；可选择发送 WhatsApp 回复。）
openclaw-cn message send --channel telegram --target @mychat --message "Hi"
（通过你的 Telegram 机器人发送消息。）

接下来我们输入一个OpenClaw配置页面的命令：

openclaw-cn configure

这样就又回到OpenClaw的配置页面了，可以对之前设置进行修改，如果有任何错误信息或者不懂的操作，可以复制powerShell 内容给任何一个Ai应用（千问、豆包等），帮你回答提供解决办法。

4、运行 OpenClaw-CN

重新打开一个终端（PowerShell），启动网关，命令：

openclaw-cn gateway

显示上面的PowerShell信息，就说明 OpenClaw 启动成功了

其中可以看到：

[heartbeat] started 已启动
Agent模型：dashscope/qwen-plus
正在监听：127.0.0.1:18789
监听端口:18789

注意：这个窗口不能关闭，如果关闭，就是结束OpenClaw

现在可以在终端 PowerShell 内直接与Ai模型对话，开启一个新的PowerShell，输入命令：

openclaw-cn tui

可以正常对话，说明Ai模型Api接入成功

当然，这种对话并不方便和直观，可以在浏览器输入：127.0.0.1:18789，打开浏览器 UI 界面，就舒服多了。

安装步骤三：配置通讯工具（飞书）

飞书开放平台网址：https://open.feishu.cn

1、飞书后台配置

（1）创建应用：登录飞书开放平台，点击 “创建企业自建应用”，名字随你起（比如：我的AI助理）。

（2）获取凭证：在左侧菜单 “凭证与基础信息” 里，复制保存以下两个东西：

应用 ID（App ID）：*************************

应用秘密（App Secret）：****************************************

（3）开启机器人：在左侧菜单 “应用功能” -> “添加应用能力” -> “机器人”，点击 “添加”。

（4）设置权限：在左侧 “权限管理”，搜索并勾选以下权限（非常重要，否则机器人不说话）

im:message.p2p_msg (接收单聊消息)

im:message.group_msg (接收群聊消息)

im:message:send_as_bot (以机器人身份发送消息)

im:chat:readonly (读取群组信息)

（5）发布应用：点击左侧 “版本管理与发布”，创建一个版本，点击 “保存” 然后 “申请发布”（自建应用通常会自动通过）。

2、在 OpenClaw 中配置飞书渠道

（1）关闭所有开着的 OpenClaw（停掉当前的 gateway），重新打开PowerShell，输入代码：openclaw-cn configure，进入OpenClaw的配置页面。选择 ○ 渠道 (Channels)，回车

（2）选择飞书 (Lark)

按提示依次输入你之前在飞书后台拿到的信息：

Lark 应用编号 ： 填入你的 cli_xxx

Lark 应用秘密 ： 填入你的 secret_xxx

3、配置事件订阅（把消息传给电脑）

（1）PowerShell 窗口启动OpenClaw网关：

https://www.cpolar.comopenclaw-cn gateway

（2）安装 Cpolar 并启动

去 cpolar 官网下载 Windows 版本并安装。（https://www.cpolar.com）

登录Cpolar控制台：安装后，它通常会自动弹出一个网页，如果没有，浏览器内访问：

http://localhost:9200

输入你在 Cpolar网站注册的邮箱和密码，登录 cpolar 的本地管理后台。

先注册一个账号，

点击左侧菜单的 “隧道管理” -> “创建隧道”

隧道名称：随便填（例如 opOpenClaw）。

协议：选择 http。

本地地址：填 18789（这是 OpenClaw 网关的默认端口）。

域名类型：免费版选“随机域名”。

地区：选“China”或“China VIP”。