鸿蒙系统安装配置OpenClaw工具指南

前言

OpenClaw 是一款强大的 AI 开发工具，在鸿蒙系统上的使用正变得日益重要。本文将详细介绍在鸿蒙电脑上安装和配置 OpenClaw 最新版的完整流程，包括环境准备、安装步骤、常见问题解决方案以及模型配置优化。

前置准备

必要应用安装

在开始安装 OpenClaw 之前，请确保在鸿蒙应用市场安装以下应用：

BiShengJDK17-OH - Java 开发环境
DevBox - 开发工具箱
Python 安装器 - Python 环境支持
GitNext - 版本控制工具
DevNode-OH - Node.js 开发环境

Node.js 环境部署

步骤 1：创建并设置 Node.js 安装目录

执行以下命令（注意路径大小写）：

mkdir -p /storage/Users/currentUser/npm npm config set prefix -g /storage/Users/currentUser/npm

步骤 2：配置环境变量

将以下内容添加到 /storage/Users/currentUser/.zshrc 文件中（如文件不存在则手动创建）：

export PATH=$PATH:/storage/Users/currentUser/npm/bin

步骤 3：使配置生效

source /storage/Users/currentUser/.zshrc

OpenClaw 安装

安装 OpenClaw

打开终端，执行以下命令安装最新版本的 OpenClaw：

npm install -g --legacy-peer-deps openclaw@latest

⚠️ 注意： 如遇网络问题，请检查网络连接或考虑使用国内镜像源。

初始化与启动

初始化配置

如果报错，参考下面常见问题和解决方案：

openclaw onboard

启动服务

由于鸿蒙系统的特殊性，需要使用以下方式启动服务：

# 启动 Dashboard（不自动打开浏览器）
openclaw dashboard --no-open 
# 启动 Gateway 服务（指定端口）
openclaw gateway --port 18789 --verbose

在浏览器中直接打开 Dashboard 生成的带 token 的地址，例如：http://127.0.0.1:18789/#token=你自己的 token

![截图]

常见问题与解决方案

问题 1：网关服务不支持鸿蒙系统

![截图]

解决方案：

使用以下命令启动 Dashboard 和 Gateway：
如遇兼容性问题，可手动修改源文件中的系统检测逻辑（将 linux 改为 openharmony）：

openclaw dashboard --no-open 
openclaw gateway --port 18789 --verbose

问题 2：模块报错

![截图]

解决方案：

直接修改报错源文件，地址：/storage/Users/currentUser/npm/lib/node_modules/openclaw/dist/subsystem-kzdGVyce.js，注释掉抛出异常的部分（286 行和 297 行）。

![截图]

如果下面文件 /storage/Users/currentUser/npm/lib/node_modules/openclaw/node_modules/@snazzah/davey/index.js 报错也直接注释掉：

![截图]

模型配置优化

Coding Plan 简介

OpenClaw 支持多种大模型服务，Coding Plan 是推荐的订阅服务之一。它提供以下优势：

多厂商支持：包括 Kimi、火山引擎、MiniMax 等
成本效益：订阅制付费，使用成本可控
协议兼容：支持 Claude Code 接口协议
模型丰富：百炼平台提供多种高质量模型选择

配置步骤

步骤 1：获取 API Key

访问 Coding Plan 官网订阅服务
获取专属 API Key

步骤 2：通过 Web UI 配置

在终端执行命令打开配置界面：

openclaw dashboard

将以下配置粘贴到 RAW JSON 输入框中（注意：替换 YOUR_API_KEY 为你的实际 API Key）：

在左侧菜单栏中选择：配置 > All Settings > RAW

![截图]

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "YOUR_API_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0

💡 提示： 如需保留已有配置，请勿直接全量替换，建议选择性修改需要的部分。

总结

通过以上步骤，你已经成功在鸿蒙电脑上安装并配置了 OpenClaw。现在你可以开始使用这个强大的 AI 开发工具进行项目开发了。

鸿蒙系统安装配置OpenClaw工具指南

前言

前置准备

必要应用安装

Node.js 环境部署

步骤 1：创建并设置 Node.js 安装目录

步骤 2：配置环境变量

步骤 3：使配置生效

OpenClaw 安装

安装 OpenClaw

初始化与启动

初始化配置

启动服务

常见问题与解决方案

问题 1：网关服务不支持鸿蒙系统

问题 2：模块报错

模型配置优化

Coding Plan 简介

配置步骤

步骤 1：获取 API Key

步骤 2：通过 Web UI 配置

总结

更多推荐文章

相关免费在线工具

鸿蒙系统安装配置OpenClaw工具指南

前言

前置准备

必要应用安装

Node.js 环境部署

步骤 1：创建并设置 Node.js 安装目录

步骤 2：配置环境变量

步骤 3：使配置生效

OpenClaw 安装

安装 OpenClaw

初始化与启动

初始化配置

启动服务

常见问题与解决方案

问题 1：网关服务不支持鸿蒙系统

问题 2：模块报错

模型配置优化

Coding Plan 简介

配置步骤

步骤 1：获取 API Key

步骤 2：通过 Web UI 配置

总结

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

更多推荐文章

相关免费在线工具