ubuntu/统信UOS/银河麒麟kylin系统下OpenClaw/openclaw-cn AI助手指南:安装与配置

一、背景介绍:为什么选择OpenClaw-CN?

1.1 OpenClaw-CN vs 官方OpenClaw

在AI个人助手领域,OpenClaw 无疑是一款备受关注的开源工具。但对于国内用户,特别是使用国产操作系统的政企用户来说,官方的OpenClaw存在一个痛点:没有内置DeepSeek接口,需要单独去解决模型接入问题。

OpenClaw-CN 完美解决了这个问题——它原生支持国内权威的DeepSeek接口,开箱即用,无需额外配置。这意味着你可以直接使用DeepSeek的强大模型能力,而不需要折腾复杂的模型接入流程。

1.2 国产系统的天然优势

OpenClaw原生于Unix类操作系统,在国产系统(统信UOS、银河麒麟kylin)上的表现比Windows更加完美。国产Linux内核与OpenClaw的兼容性更好,安装过程更顺畅,运行更稳定。而且linux root 密码将比windows更安全。

1.3 政企用户的福音

对于政企用户来说,最大的痛点不是技术本身,而是操作系统的使用门槛。很多用户熟悉Windows,但对Linux命令行望而却步。

当国产系统安装OpenClaw-cn之后,我们可以通过合理的权限配置,让这些不懂Linux的用户也能:

  • 通过自然语言操作本地电脑

  • 自动化执行日常指令

  • 无需记忆复杂的Linux命令

这对于政企数字化转型来说,可以说是一大福音!👏

二、系统环境预处理

无论你选择哪种安装方式,首先需要执行以下命令更新系统、安装基础依赖,这一步能解决90%的“依赖缺失”报错:

bash

# 更新系统软件包列表(必做)
sudo apt update 
# 安装基础依赖(编译工具、网络工具等,避免卡在 node-gyp rebuild)
sudo apt install -y curl wget git python3 build-essential libssl-dev ufw

💡 小贴士:这一步在统信UOS和银河麒麟上通用,如果你的系统默认没有配置apt源(一些定制版本os),请先配置好系统软件源。

三、安装 Node.js,npm(核心依赖,必做)

OpenClaw 要求 Node.js 版本 ≥ 22.0.0。这里推荐使用 NodeSource 官方源安装,稳定且可快速升级,避免使用系统官方源的低版本 Node.js:

bash

# 导入 NodeSource 22.x 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js 和 npm(npm 用于包管理)
sudo apt install -y nodejs

# 验证安装是否成功(显示版本号即正常)
node --version  # 需显示 v22.x.x
npm --version   # 需显示 10.x.x 及以上

四、国内环境优化(可选,但强烈推荐)

国内用户直接下载 OpenClaw 依赖可能卡顿,建议配置 npm 国内镜像(阿里云源),大幅加速下载速度:

bash

# 配置 npm 国内镜像
npm config set registry https://registry.npmmirror.com

# 验证镜像配置是否生效
npm config get registry  # 显示 https://registry.npmmirror.com 即成功

五、安装 OpenClaw-CN(四种方式详解)

OpenClaw-CN 提供多种安装方式,你可以根据自己的需求选择:

方式一:一键自动安装(推荐新手,最省心,笔者使用)

bash

curl -fsSL https://clawd.org.cn/install.sh | bash

这种方式会自动安装 Node.js 和所有依赖,全程自动化,适合不想折腾的用户。

方式二:npm 全局安装

bash

# 全局安装
npm install -g openclaw-cn@latest

# 运行向导
openclaw-cn onboard

方式三:pnpm 全局安装(适合喜欢 pnpm 的用户)

bash

# 全局安装
pnpm add -g openclaw-cn@latest

# 运行向导
openclaw-cn onboard

方式四:Docker 一键部署(适合服务器和 NAS 用户)

使用 Docker Compose 快速部署 OpenClaw,无需手动安装 Node.js 环境:

bash

# 拉取镜像并运行
docker run -d --name openclaw-cn -p 18789:18789 openclaw-cn/openclaw-cn:latest

六、配置 DeepSeek 模型接口

OpenClaw-CN 最大的优势就是原生支持 DeepSeek 接口。配置步骤如下:

6.1 注册 DeepSeek 开放平台

  1. 访问 DeepSeek 开放平台 注册账号

  2. 登录后进入控制台

6.2 充值(低成本体验)

笔者使用了一天轻度聊天,大概用了5块钱人民币。建议先充值10元,足够体验和测试:

  • 10元 ≈ 2天轻度使用

  • DeepSeek 模型性价比很高

6.3 获取 API Key 并配置

  1. 在 DeepSeek 控制台创建 API Key

  2. 复制 API Key

  3. 运行 OpenClaw-CN 配置向导:

bash

openclaw-cn onboard

在模型配置界面,选择 DeepSeek API,粘贴你复制的 API Key 即可。openClaw-cn的主配置界面已经完美支持 DeepSeek,无需额外折腾!

◇  安装引导模式
│  快速开始

◇  快速开始 ────────────────────╮
│  网关端口:18789              │
│  网关绑定:环回(127.0.0.1)  │
│  网关认证:令牌(默认)       │
│  Tailscale 暴露:关闭         │
│  直接到聊天频道。             │
├───────────────────────────────╯

◆  模型/认证提供商
│  ○ OpenAI
◇  模型/认证提供商
│  DeepSeek

◆  DeepSeek 认证方法
│  ● DeepSeek API key
│  ○ 返回

七、启动 Web 对话页面

安装和配置完成后,就可以启动 Web 对话界面了:

bash

# 启动 Web 界面(默认会打开浏览器)
openclaw-cn dashboard

# 或者启动但不自动打开浏览器(适合服务器环境)
openclaw-cn dashboard --no-open

⚠️ 避坑指南:浏览器选择

重要提醒:笔者测试发现,使用奇安信浏览器访问 Web 界面可能会遇到兼容性问题。强烈推荐使用 Chromium 浏览器

bash

# 安装 Chromium(如果没有)
可以在应用商店找到自带,uos和kylin官方商店都会有。点击下载即可。

openclaw-cn dashboard --no-open执行这个命令后再,如果设置了默认浏览器,会自动弹开管理对话页面。如果没有自动弹,请用

 openclaw-cn dashboard --no-open

🦞 OpenClaw-CN 0.1.8-fix.3 (10afea4) — 我不评判,但你缺失的API密钥绝对在评判你。

Dashboard URL: http://127.0.0.1:18789/?token=a767dbc12002607473d8e942500030f979bd0705623f1b49
(node:11947) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
(Use `node --trace-deprecation ...` to show where the warning was created)
Copy to clipboard unavailable.
Opened in your browser. Keep that tab to control Clawdbot.
用http://127.0.0.1:18789/?token=a767dbc12002607473d8e942500030f979bd0705623f1b49这个带密钥得网址就能自动登录弹出网页。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐