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

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

综述由AI生成介绍在鸿蒙系统上安装配置 OpenClaw 工具的步骤。涵盖环境准备(Node.js、JDK 等)、npm 安装、服务启动及 Dashboard 访问。提供鸿蒙系统兼容性问题的解决思路,包括修改源文件逻辑。演示了通过 Coding Plan 订阅配置多厂商大模型接口的方法,包含 API Key 获取及 RAW JSON 配置示例。旨在帮助用户完成本地 AI 开发环境的搭建与调试。

怪力乱神发布于 2026/3/30更新于 2026/5/2226 浏览
鸿蒙系统安装配置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:网关服务不支持鸿蒙系统

![截图]

解决方案:

  1. 使用以下命令启动 Dashboard 和 Gateway:
  2. 如遇兼容性问题,可手动修改源文件中的系统检测逻辑(将 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
  1. 访问 Coding Plan 官网订阅服务
  2. 获取专属 API Key
步骤 2:通过 Web UI 配置
  1. 在终端执行命令打开配置界面:
openclaw dashboard 
  1. 将以下配置粘贴到 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, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-2026-01-23",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-coder-next",
            "name": "qwen3-coder-next",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 65536
          },
          {
            "id": "qwen3-coder-plus",
            "name": "qwen3-coder-plus",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 1000000,
            "maxTokens": 65536
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 196608,
            "maxTokens": 32768
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 202752,
            "maxTokens": 16384
          },
          {
            "id": "glm-4.7",
            "name": "glm-4.7",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 202752,
            "maxTokens": 16384
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 262144,
            "maxTokens": 32768
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-max-2026-01-23": {},
        "bailian/qwen3-coder-next": {},
        "bailian/qwen3-coder-plus": {},
        "bailian/MiniMax-M2.5": {},
        "bailian/glm-5": {},
        "bailian/glm-4.7": {},
        "bailian/kimi-k2.5": {}
      }
    }
  },
  "gateway": {
    "mode": "local"
  }
}

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

总结

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

目录

  1. 前言
  2. 前置准备
  3. 必要应用安装
  4. Node.js 环境部署
  5. 步骤 1:创建并设置 Node.js 安装目录
  6. 步骤 2:配置环境变量
  7. 步骤 3:使配置生效
  8. OpenClaw 安装
  9. 安装 OpenClaw
  10. 初始化与启动
  11. 初始化配置
  12. 启动服务
  13. 启动 Dashboard(不自动打开浏览器)
  14. 启动 Gateway 服务(指定端口)
  15. 常见问题与解决方案
  16. 问题 1:网关服务不支持鸿蒙系统
  17. 问题 2:模块报错
  18. 模型配置优化
  19. Coding Plan 简介
  20. 配置步骤
  21. 步骤 1:获取 API Key
  22. 步骤 2:通过 Web UI 配置
  23. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • Java 中 ML-KEM 密钥封装机制的 5 大核心实现步骤
  • FPGA 快速傅里叶变换(FFT)IP 核配置与实现
  • Prompt 驱动的 SQL 生成与查询优化
  • C/C++ 输入输出实战:OJ 场景与性能优化
  • 2026 AI行业纵深:技术破壁、场景深耕与合规共生
  • Python 窗体编程技术详解
  • 零基础学习网络安全技术入门指南
  • AJAX 与 Fetch:异步 Web 请求实战对比
  • MySQL 索引与 B+ 树核心知识总结
  • Spring AOP 核心代理组件 MethodProxy 深度解析
  • 华为 OD 机试双机位 C 卷 - 数组连续和
  • JavaScript 基础语法与 jQuery 快速入门
  • 节点小宝 4.0 macOS 客户端正式发布
  • Dubbo 服务降级机制详解:Mock 配置与实战
  • Vue 实例劫持解除 Web 编辑器粘贴限制
  • 开源低代码平台 Microi 吾码:架构、部署与实战指南
  • Capacitor 跨平台打包工具实战指南
  • llama.cpp 本地部署性能调优:从启动瓶颈到推理效率优化
  • Python 爬虫自学指南:核心知识框架与实战思维导图
  • PPT 中嵌入 VR 全景图片的实操指南

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online