OpenClawCN

OpenClaw CN Logo

OpenClaw 中国社区 (CN)

🦞 你的私人 AI 助手 (Personal AI Assistant)

Based on OpenClaw v2026.2.23

更安全 · 更懂中文 · 适配 DeepSeek 的 Local Agent 基础设施

🌐 官方文档 • English README

OpenClaw CN (中国社区版) 是 OpenClaw 的本地化维护版本，针对国内网络环境进行了深度优化，源码级原生支持 DeepSeek/Qwen 等国产大模型，致力于让中国开发者拥有最顺滑的 Agent 开发体验。

🇨🇳 社区版特性 (Features)

本项目是 OpenClaw (原Clawdbot) 的中国本土化维护版本，针对国内网络与使用习惯进行了深度优化：

  • 🧠 国产大脑：源码内置 DeepSeek-V3 / Qwen 支持，开箱即用，告别昂贵的 Claude。
  • 🛡️ 安全审计：代码经社区人工审计，剔除潜在风险与不必要的遥测。
  • ⚡ 极速下载：预配置 pnpm 国内镜像源，安装依赖“飞”一般的感觉。
  • 🔌 生态落地：已集成飞书并开发企业微信、钉钉等连接器。

🚀 快速开始 (Quick Start)

请访问我们的文档站查看保姆级教程：
这里探索了极速的一键安装方式，网站内提供了针对 Windows 原生环境、Linux、WSL 与 macOS 的保姆级图文部署指南。

👉 https://open-claw.org.cn/guide/getting-started

⚡️ 源码安装（贡献者/开发）

为了确保在国内网络环境下依赖能快速下载，我们强制推荐使用 pnpm 并配置国内镜像源。

1. 准备环境

确保你的 Node.js 版本 ≥22。如果未安装 pnpm，请运行：

1
npm install -g pnpm

2. 配置国内高速镜像 (关键步骤)

在开始安装前，请务必设置 pnpm 的镜像源，否则下载速度会很慢：

1
2
# 设置淘宝/阿里云镜像
pnpm config set registry https://registry.npmmirror.com/

3. 安装与启动

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 1. 克隆仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn

# 2. 安装依赖
pnpm install

# 3. 首次构建 UI 依赖
pnpm ui:build

# 4. 构建项目
pnpm build

# 5. 启动初始化向导
pnpm openclaw onboard --install-daemon

# 6. 使用初始化向导安装完毕后，再次启动网关（关闭后再次启动）
pnpm openclaw gateway

# 6.1 再次启动网关后，如何再次打开管理页面（管理页面已关闭的前提下）
pnpm openclaw dashboard

💡 开发模式: 如果你想修改源码并实时预览，请使用 pnpm gateway:watch 启动。

🗑️ 卸载说明 (Uninstall)

如果你需要移除 OpenClaw 服务，请根据操作系统执行以下命令。
(注：如果 CLI 命令 openclaw uninstall 无法使用，请手动执行以下步骤)

🍎 macOS (launchd)

默认标签是 bot.molt.gateway（或 bot.molt.<profile>；旧版 com.openclaw.* 可能仍然存在）：

1
2
3
4
5
6
7
8
# 1. 停止并移除服务
launchctl bootout gui/$UID/bot.molt.gateway
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

# 2. (可选) 清理遗留的旧版配置
# 如果使用了配置文件，请将标签和 plist 名称替换为 bot.molt.<profile>
# 如果存在任何旧版 com.openclaw.* plist，请将其移除。
rm -f ~/Library/LaunchAgents/com.openclaw.*

🐧 Linux (systemd)

默认单元名称是 openclaw-gateway.service（或 openclaw-gateway-<profile>.service）：

1
2
3
4
5
6
# 1. 停止用户级服务
systemctl --user disable --now openclaw-gateway.service

# 2. 移除服务文件并重新加载
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

🪟 Windows (计划任务)

默认任务名称是 OpenClaw Gateway（或 OpenClaw Gateway (<profile>)）。

CMD (命令提示符):

1
2
schtasks /Delete /F /TN "OpenClaw Gateway"
rmdir /s /q "%USERPROFILE%\.openclaw"

PowerShell:

1
2
Unregister-ScheduledTask -TaskName "OpenClaw Gateway" -Confirm:$false
Remove-Item -Path "$env:USERPROFILE\.openclaw" -Recurse -Force

🧠 模型配置 (DeepSeek 原生支持)

得益于 OpenClaw CN 的源码改造，DeepSeek 已成为系统的一级公民，配置极其简单。

方法一：通过向导配置 (最推荐)

在运行 pnpm openclaw onboard 时：

  1. Select Provider: 在列表中直接选择 👉 DeepSeek (Recommended for CN)
  2. API Key: 输入您的 DeepSeek Key (sk-xxxxxxxx)。
  3. Model: 系统会自动为您配置 deepseek-chat (V3) 为默认模型。

方法二：手动修改配置文件

如果您需要手动干预配置，请修改 ~/.openclaw/openclaw.json。得益于原生集成，您只需关注 auth 和 agents 部分：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "auth": {
    "profiles": {
      "deepseek:default": {
        "provider": "deepseek",
        "mode": "api_key",
        "apiKey": "sk-你的Key"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

注意：无需再手动配置 baseUrl，系统源码已内置 DeepSeek 官方节点 (https://api.deepseek.com)。

OpenClaw-CN Community © 2026
[up主专用，视频内嵌代码贴在这]