跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

OpenClaw 开源汉化发行版:安装与配置指南

OpenClaw 开源汉化发行版基于 Node.js 构建,提供全中文界面的个人 AI 助手平台。支持通过 WhatsApp、Telegram、Discord 等聊天应用交互,实现邮件、日历、文件处理。数据本地存储,隐私可控。核心功能包括命令行初始化、Dashboard 控制台管理、插件扩展及自动同步官方更新。安装依赖 Node.js >= 22,可通过 npm 或 Docker 部署。常见问题涵盖镜像源配置、Token 匹配及设备配对。适合需要私有化 AI 助理的开发者使用。

不羁发布于 2026/3/27更新于 2026/6/1123 浏览

OpenClaw 开源汉化发行版:安装与配置指南

简介

OpenClaw 是 GitHub 上拥有超过 10 万 Stars 的开源个人 AI 助手平台。它运行在你的本地电脑上,通过 WhatsApp、Telegram、Discord 等聊天应用与你的 AI 助手交互,帮你处理邮件、日历、文件等日常事务。

本项目为 OpenClaw 的中文发行版,CLI 命令行和 Dashboard 网页控制台均已深度汉化。项目每小时自动同步官方更新,延迟小于 1 小时,让你既享受中文体验,又不掉队最新功能。数据完全本地掌控,告别隐私焦虑。

前置条件

需要 Node.js >= 22。检查版本命令如下:

node -v

快速安装

使用 npm 全局安装汉化版包:

npm install -g @qingchencloud/openclaw-zh@latest

初始化与启动

安装完成后,运行初始化向导引导你完成模型选择、API 密钥配置及聊天通道设置:

openclaw onboard

初始化完成后,打开全中文的 Dashboard 控制台:

openclaw dashboard

浏览器会自动打开控制台页面,至此即可完成基础部署。

界面预览

概览仪表板展示网关状态、实例监控及快捷操作。

概览仪表板

对话界面支持实时交互。

对话界面

渠道管理支持 WhatsApp、Telegram、Discord 等全平台。

渠道管理

配置中心已完整汉化。

配置中心

节点配置用于执行审批及安全策略管理。

节点配置

技能插件支持 1Password、Apple Notes 等丰富扩展。

技能插件

常用命令

openclaw              # 启动 OpenClaw
openclaw onboard      # 初始化向导
openclaw dashboard    # 打开网页控制台
openclaw config       # 查看/修改配置
openclaw skills       # 管理技能
openclaw --help       # 查看帮助

更新与维护

升级至最新版本:

npm update -g @qingchencloud/openclaw-zh

查看当前版本:

openclaw --version
版本安装命令说明
稳定版npm install -g @qingchencloud/openclaw-zh@latest经过测试,推荐使用
最新版npm install -g @qingchencloud/openclaw-zh@nightly每小时同步上游,体验新功能

其他部署方式

一键安装脚本

Linux / macOS:

curl -fsSL -o install.sh https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.sh && bash install.sh

Windows PowerShell:

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
Invoke-WebRequest -Uri "https://cdn.jsdelivr.net/gh/1186258278/OpenClawChineseTranslation@main/install.ps1" -OutFile "install.ps1" -Encoding UTF8
powershell -ExecutionPolicy Bypass -File ".\install.ps1"

如遇中文乱码,建议直接使用 npm 安装:npm install -g @qingchencloud/openclaw-zh@latest

Docker 部署

快速启动:

# 初始化配置
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:latest openclaw setup
docker run --rm -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:latest openclaw config set gateway.mode local

# 启动容器
docker run -d --name openclaw -p 18789:18789 -v openclaw-data:/root/.openclaw ghcr.io/1186258278/openclaw-zh:latest openclaw gateway run

访问地址:http://localhost:18789

pnpm / yarn 安装

# pnpm
pnpm add -g @qingchencloud/openclaw-zh@latest

# yarn
yarn global add @qingchencloud/openclaw-zh@latest

常见问题

问题快速解决详细说明
安装卡住 / 下载慢加镜像源:npm install -g @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com参考 FAQ 文档
安装后还是英文先卸载原版:npm uninstall -g openclaw && npm install -g @qingchencloud/openclaw-zh@latest参考 FAQ 文档
token mismatch运行 openclaw dashboard 自动打开带 Token 的 URL参考 FAQ 文档
pairing requiredopenclaw devices list 然后 openclaw devices approve <ID>参考 FAQ 文档
远程 / 内网访问不了openclaw config set gateway.bind lan + 设置 Token + 重启参考 FAQ 文档
Missing config运行 openclaw onboard 初始化参考 FAQ 文档
Missing workspace template2026.2.4-zh.1 及更早版本的已知 Bug,升级即可修复参考 FAQ 文档
Ollama 无响应检查 baseURL 配置是否为 http://localhost:11434/v1参考 FAQ 文档

插件扩展

安装更新检测插件:

npm install -g @qingchencloud/openclaw-updater

结语

OpenClaw 汉化版让「个人 AI 助理」真正触手可及。数据本地存储、多平台即时交互、自动化任务处理,这些曾经复杂的功能,现在开源免费且中文友好。更多详细安装指南、Docker 部署及故障排查,请参考项目仓库中的文档。

目录

  1. OpenClaw 开源汉化发行版:安装与配置指南
  2. 简介
  3. 前置条件
  4. 快速安装
  5. 初始化与启动
  6. 界面预览
  7. 常用命令
  8. 更新与维护
  9. 其他部署方式
  10. 一键安装脚本
  11. Docker 部署
  12. 初始化配置
  13. 启动容器
  14. pnpm / yarn 安装
  15. pnpm
  16. yarn
  17. 常见问题
  18. 插件扩展
  19. 结语
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • C++ 设计模式实践:工厂模式与单例模式详解
  • ComfyUI 可视化搭建教程:构建 AI 绘画工作流
  • Neo4j 安装与使用教程
  • SpringMVC 核心原理与实战应用详解
  • Windows 本地部署 OpenClaw 对接飞书与 MaaS 模型指南
  • 知网 AIGC 检测原理与降重策略指南
  • 算法题解:dd 爱框框 滑动窗口解法
  • 滑动窗口算法实战:四个经典例题详解
  • Java 使用 org.w3c.dom 解析 XML 文档的创建、读写与遍历
  • 万方AIGC检测降重工具实测与选择指南
  • 基于 Qwen3-VL 与 LLaMA-Factory 的 Grounding 任务 LoRA 微调
  • 基于腾讯混元与腾讯云智能体的文思通写作助手构建指南
  • 大模型微调核心:数据准备与 3 个实例详解
  • OpenClaw 本地 AI 智能体 Windows10 一键部署指南
  • 吴恩达:提升大模型性能的四个关键步骤
  • Java 面试核心知识点梳理:基础、并发与容器
  • 大模型厂商入驻钉钉生态,争夺企业级应用入口
  • B 站直播弹幕场控机器人使用指南
  • C++ 图论实战:深入理解三种经典最短路径算法
  • C++ CAS 原子操作深度解析与实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online