在 AI 工具快速发展的今天，拥有一个真正属于自己的“本地 AI 助手”正在成为越来越多技术爱好者和内容创作者的刚需。 OpenClaw 中文版 基于原版 OpenClaw 深度优化，在保持与官方版本同步自动更新的前提下，进行了更符合国内用户习惯的增强与适配：

✅ 完整中文界面

✅ 非阉割版功能保留

✅ 自动跟进原版更新

✅ 内置飞书支持

✅ 针对国内网络环境优化

✅ 支持 Windows / macOS / Linux 等多平台

对于 Windows 用户来说，本地部署不仅可以保证数据隐私安全，还能获得更稳定、可控的 AI 体验，不再依赖复杂的网络环境配置。 本教程将以 Windows 系统 为例，手把手带你完成 OpenClaw 中文版的完整部署流程。从环境准备、安装步骤，到启动运行与常见问题排查，全流程讲解，即使是新手也可以顺利搭建属于自己的专属 AI 助手。 如果你希望： 在本地拥有长期可用的 AI 助理 避免网络波动带来的影响 深度定制属于自己的 AI 工作流 打造稳定高效的生产力工具 那么这篇教程就是为你准备的。 接下来，我们正式开始部署。

📁Workspace 工作空间

Workspace 是 OpenClaw 智能体的工作目录，也是它读取上下文、保存记忆、执行工具操作的唯一位置。

Workspace 结构

~/.openclaw/

├── openclaw.json # 主配置文件

├── workspace/ # 默认工作空间

│ ├── AGENTS.md # 操作指令和记忆

│ ├── SOUL.md # 人格、边界、语气

│ ├── TOOLS.md # 工具使用笔记

│ ├── IDENTITY.md # 助手名称/头像/表情

│ ├── USER.md # 用户信息

│ ├── MEMORY.md # 长期记忆（仅主会话加载）

│ └── skills/ # 工作空间级技能

├── agents/ # 多智能体会话存储

├── skills/ # 全局技能

└── credentials/ # 凭证存储

核心文件说明

Workspace 核心文件及其用途说明

文件	用途	加载时机
AGENTS.md	操作指令、连续性规则、重要记忆	每会话首条消息
SOUL.md	人格定义、语气、边界	每会话首条消息
TOOLS.md	环境特定的工具说明	每会话首条消息
USER.md	用户信息、偏好、项目背景	每会话首条消息
IDENTITY.md	助手身份（名称、表情、头像）	每会话首条消息
MEMORY.md	长期记忆（安全敏感内容）	仅主会话

一、准备条件

openclaw官网

中文openclaw github

免费token（大模型）硅基流动-我的邀请码：MZ0ZbuJp

完成个人认证可以获得16元抵用券

**二、**部署OpenClaw在Windows电脑

0.1 安装环境：Node.js ≥ 22

0.2 Git (根据自己系统选择对应版本)

下载对应系统版本，这里打上勾安装依赖避免一些报错，其它默认。

0.2 用管理员身份打开 PowerShell，然后执行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后就是打开OpenClaw 中文社区使用一键安装脚本进行安装

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

等待安装——YES——YES——快速开始——用上下键选择硅基流动

输入在硅基流动后台获得的API口令

这时候默认是千问的siliconflow/Qwen/Qwen2.5-32B-Instruct模型

我选择手动输入 siliconflow/deepseek-ai/DeepSeek-V3.2模型

0.3 选择通讯配置时暂时跳过（事后再配置）——YES——NPM——暂时跳过（钩子）

0.4 此时自动打开浏览器

如果打开失败执行：

openclaw-cn gateway

openclaw dashboard
# 或直接在浏览器访问：
# http://127.0.0.1:18789

**三、**接入飞书或其它通讯工具

先 Crtl+C 停止运行 然后运行安装配置向导，执行以下命令

openclaw-cn onboard --install-daemon

进入 飞书开放平台

0.1 创建应用——创建企业自建应该——填写应用名称及描述——选择图标——发布

得到ID 在权限管理页面，点击批量导入，替换之前的

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

0.2 配置机器人名称

配置事件订阅

⚠️ 重要提醒：在配置事件订阅前，请务必确保已完成以下步骤：

运行 openclaw-cn channels add

添加了 Feishu 渠道 网关处于启动状态

可通过 openclaw-cn gateway status 检查状态

在 事件订阅 页面： 选择 使用长连接接收事件（WebSocket 模式）

添加事件：im.message.receive_v1（接收消息）

⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。

0.3 启动并测试

启动网关 openclaw-cn gateway

发送测试消息 在飞书中找到您创建的机器人，发送一条消息。 配对授权 默认情况下，机器人会回复一个 配对码。

您需要批准此代码： openclaw-cn pairing approve feishu <配对码> 批准后即可正常对话。

**四、**ClawHub CLI（相当于应用商店——SKILLS应用）

首先确保已安装 ClawHub 命令行工具：

npm install -g clawhub

搜索技能

在 ClawHub 上搜索你需要的技能：

# 搜索关键词
clawhub search "postgres backups"
clawhub search "image generation"
clawhub search "weather"

安装技能

找到想要的技能后，使用以下命令安装：

# 安装最新版本
clawhub install baoyu-image-gen

# 安装指定版本
clawhub install baoyu-image-gen --version 1.2.3

查看版本：

openclaw --version

升级 (Core Update)：

openclaw update

核心程序更新 (Core Update)

更新 OpenClaw 的引擎。直接在 PowerShell 运行：

npm install -g openclaw@latest

管理技能

ClawHub CLI 常用命令

命令	说明	示例
clawhub list	列出已安装的技能	查看当前工作空间的所有技能
clawhub update <skill>	更新指定技能到最新版本	clawhub update baoyu-image-gen
clawhub update --all	更新所有技能	批量更新所有已安装技能
clawhub update --force	强制更新（忽略版本检查）	解决版本冲突时使用

**五、**常用命令

暂停运行：Ctrl+C

openclaw中方版安装命令

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

openclaw官方版安装命令

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

重启网管

openclaw-cn gateway   

# 前台运行（适合调试）
openclaw gateway --port 18789 --verbose

# 使用守护进程（后台运行）
openclaw gateway start

openclaw-cn gateway status - 查看网关运行状态

openclaw-cn gateway restart - 重启网关以应用新配置

openclaw gateway restart - 官方版重启网关

openclaw-cn logs --follow - 查看实时日志

强制重启

openclaw gateway run

添加通讯渠道

openclaw-cn channels add
openclaw channels add

重新配置模型 （运行配置向导）

openclaw-cn onboard    镜像中文版
openclaw onboard    官方版

诊断工具

# 健康检查
openclaw doctor

# 自动修复
openclaw doctor --fix

# 查看日志
openclaw logs --follow

**五、**省TOKEN常用技巧

新建会话（清空历史） /new

对方中不知道龙虾有干嘛也没有干活（相当于重启龙虾） /restart

一直在思考任务没完没了就让它停下来 /stop

查看当前上下文大小 /status

清空上下文（但保留配置） /clear

当前圣诞历史压缩成一段摘要 /compress

/compact
注：上面命令都是在对话窗口输入

**六、**卸载 OpenClaw中文版

停止 gateway 服务：

openclaw-cn gateway stop

卸载 gateway 服务（launchd/systemd/schtasks）：

openclaw-cn gateway uninstall

删除状态 + 配置： Windows（PowerShell）：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

如果你将 OPENCLAW_CONFIG_PATH 设置为状态目录之外的自定义位置，也删除该文件。

删除工作区（可选，删除 agent 文件）：

Windows（PowerShell）：

Remove-Item -Recurse -Force "$env:USERPROFILE\clawd"

删除 CLI 安装（选择你使用的那个）：

npm rm -g openclaw-cn

pnpm remove -g openclaw-cn

bun remove -g openclaw-cn

🔧故障排除

常见错误及解决方案

错误	原因	解决
Config validation failed	配置格式错误	运行 openclaw doctor
Unauthorized	API Key 无效	检查 auth 配置
Session not found	会话已过期	发送 /new 重置

🔗资源链接

• 官网: openclaw.ai

• 文档: docs.openclaw.ai

• GitHub: github.com/openclaw/openclaw

• Discord: discord.gg/clawd

• 技能市场: clawhub.com

📝总结

OpenClaw 是一个功能强大、灵活的个人 AI 助手平台。关键要点：

1. Gateway 是核心 - 所有功能都围绕 Gateway 展开

2. Workspace 是工作空间 - 保持文件整洁，控制 token 使用

3. 配置即代码 - openclaw.json 定义一切行为

4. 安全第一 - 默认使用配对模式，谨慎开放 DM

5. 多智能体支持 - 可以为不同任务创建专门的助手

---

祝使用愉快！🦞