（OrangePi Kunpeng Pro openEuler aarch64）华为香橙派OpenClaw 完整安装部署教程
·
硬件：香橙派鲲鹏Pro（Kunpeng Pro 16G，openEuler桌面系统，aarch64架构） 说明：OpenClaw是本地Agent调度前端，不在板子本地跑大模型，模型调用DeepSeek云端API；Agent具备执行shell、读写本地文件的能力，适合嵌入式/开发调试，类似桌面版智能助手。 ⚠️ 安全警告：Agent拥有执行系统命令权限，全程使用普通openEuler用户操作，禁止root运行，谨慎使用rm删除类指令。
前置准备
- 板子联网，openEuler桌面环境
- DeepSeek平台账号，完成实名认证、账户充值，提前获取
sk-xxxxAPI Key 地址：DeepSeek → API Keys 创建密钥，复制保存密钥，关闭弹窗后无法再次查看 - 终端操作：全部在普通用户终端执行
第1步：安装系统基础依赖
sudo dnf update -y
sudo dnf install git gcc gcc-c++ make -y
输入用户密码，等待全部安装完成。
第2步：安装NVM（Node版本管理器，适配aarch64鲲鹏）
curl -o- [https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh](https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh) | bash
脚本执行完毕，写入环境变量：
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.bashrc
echo '[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.bashrc
source ~/.bashrc
第3步：安装 Node 24（OpenClaw 2026.9.3硬性要求Node≥24.16.0）
设置国内镜像加速，解决 arm64 包下载缓慢
export NVM_NODEJS_ORG_MIRROR=[https://npmmirror.com/mirrors/node](https://npmmirror.com/mirrors/node)
nvm install 24
nvm use 24
# 设置Node24为默认版本，新开终端自动生效
nvm alias default 24
校验Node版本
node -v
npm -v
正常输出：v24.x.x
设置npm国内镜像，避免OpenClaw安装超时
npm config set registry [https://registry.npmmirror.com](https://registry.npmmirror.com)
第4步：全局安装 OpenClaw
npm install -g openclaw@latest
出现
warn警告属于新版npm安全提示，不是报错，不影响程序正常安装。
验证OpenClaw安装
openclaw --version
输出版本号 OpenClaw 2026.9.3 (xxxx) 即成功。
第5步：交互式初始化向导 onboard（接入DeepSeek模型）
openclaw onboard --auth-choice deepseek-api-key
下面是向导每一步选择，严格按顺序操作
I understand the risks... Continue?→Yes（确认Agent文件/命令操作风险）帮助OpenClaw收集使用数据？→不用，谢谢Setup mode 设置模式→QuickStart（推荐）What should we call your first agent?智能体名称，默认main，直接回车安装 DeepSeek 插件？→ 从npm下载（@openclaw/deepseek-provider）Accept these capabilities for "deepseek"?→Yes，授予插件调用模型权限- 粘贴你的DeepSeek
sk-xxxxAPI Key - Default model 默认模型填写：
deepseek/deepseek-coder（代码专用模型，适合嵌入式开发） - 技能选择：
exec（执行shell命令） → Yesfile文件读写 → Yes- web搜索：按需Yes
- 选择频道（对接IM聊天软件）：暂时跳过
- 搜索提供方：暂时跳过
- 安装缺失的技能依赖：暂时跳过（附加插件，非必需）
- 最后询问是否安装daemon后台服务 → Yes（开机后台自动启动网关）
等待向导执行完成，配置写入。
第6步：日常启动与使用（三种使用方式）
网关daemon后台服务，网关只需要启动一次
网关基础管理命令
# 查看网关运行状态
openclaw gateway status
启动后台网关
openclaw gateway start
停止网关
openclaw gateway stop
修改配置后，重启网关
openclaw gateway restart你的QuickStart自动分配端口：18789，不是5000，属于正常现象。
方式1：WebUI网页面板（推荐，桌面浏览器）
openclaw dashboard
自动唤起板子浏览器，访问 [http://127.0.0.1:18789](http://127.0.0.1:18789)，网页对话界面。
方式2：TUI终端对话（无需浏览器，纯终端交互）
openclaw tui
- 输入文字回车发送提问
Esc：中断AI正在执行的任务Ctrl + C：清空输入框；连续两次Ctrl+C退出TUICtrl + D：直接退出TUICtrl + L：快速切换模型提供商Ctrl + O：展开/折叠工具执行日志（shell输出、文件读写信息）
方式3：前台网关（调试用，不推荐长期使用）
openclaw gateway
终端不能关闭，关闭网关停止；已经安装daemon后台，一般不用这个。
第7步：测试验证（复制这条指令发送给Agent）
查看npu-smi的输出，写C语言UART串口代码，保存为uart.c到/home/openEuler，然后gcc编译它
预期效果：自动调用shell查看昇腾NPU信息、生成C代码、写入本地文件、执行gcc编译。
常用运维命令汇总
# 查看当前全部配置
openclaw config show
诊断异常（API调用失败、工具失效优先执行）
openclaw doctor
查看运行日志，排查报错
openclaw logs
安全审计
openclaw security audit
切换模型提供商（DeepSeek ↔ Kimi）
openclaw configure --provider moonshot
openclaw configure --provider deepseek故障排查清单
openclaw命令找不到：检查nvm环境，执行source ~/.bashrc，确认node版本为24- 网关提示已在运行：
A Gateway is running，直接使用tui/dashboard，不要重复启动gateway - API返回401密钥错误：检查DeepSeek密钥有无多余空格、账号实名+余额充足
- Web面板打不开：
openclaw gateway status确认网关running；检查防火墙端口18789 - npm安装OpenClaw卡住：确认
npm config get registry为淘宝镜像源
补充：防火墙放行（可选，局域网其他电脑访问WebUI）
sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload
附录：模型选型建议(仅代表个人观点)
- DeepSeek deepseek/deepseek-coder（当前默认）：嵌入式、STM32、C代码开发首选，token便宜，Agent多轮调用性价比高
- Kimi(Moonshot)：适合一次性读取整套工程、PDF芯片手册，超长上下文更强，价格更高。OpenClaw可随时切换提供商，无需重装。
openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构
更多推荐
1
0- 0
已为社区贡献1条内容
所有评论(0)