在 deepin 操作系统(特别是 v25 版本) 上安装 OpenClaw(“小龙虾”),需特别注意其对 Node.js 版本(≥22)、Git、系统权限及网络环境的要求。以下是面向 deepin v25 用户的完整、可靠、分步实操指南,整合了官方推荐方式与社区验证流程,并规避常见坑点(如 Node.js 版本过低、Homebrew 环境未生效、飞书配置遗漏等)。
✅ 说明:本文严格依据你提供的最新搜索数据(含 2026-05-18 发布的 deepin v25 专项教程),并结合 OpenClaw 官方兼容性要求(Linux/Debian 系统通用),不依赖 Windows/macOS 脚本或 GUI 安装包(因无 deepin 专用一键 exe),全程终端操作,安全可控。
✅ 前置准备(务必完成)
| 项目 |
要求 |
验证命令 |
不满足则处理 |
| 系统版本 |
deepin v25(基于 Debian 12+) |
`cat /etc/os-release | grep -E "(VERSION |
ID)"` |
| 网络连接 |
可访问 GitHub / npm / openclaw.ai |
ping -c 3 github.com |
如失败,需配置代理或科学上网 |
| 基础工具 |
curl, git, sudo 已预装 |
curl --version && git --version |
若缺失:sudo apt update && sudo apt install -y curl git |
| 磁盘空间 |
≥10 GB 可用空间(建议 /home 分区充足) |
df -h ~ |
清理或挂载新分区 |
⚠️ 重要提醒(安全与稳定性)
- OpenClaw 是测试阶段开源项目,具备读写文件、执行命令等高权限能力;
- 请勿在生产环境或含敏感数据的机器上首次尝试;
- 建议新建普通用户(如
clawuser)运行,避免使用 root;
- 安装全程关闭 360/火绒/腾讯管家等安全软件(会拦截 Node.js 进程或文件写入)。
? 步骤一:升级 Node.js 至 v22+(deepin v25 默认为 v18,不兼容!)
✅ 成功标志:node -v 返回 v22.x.x
? 步骤二:一键安装 OpenClaw(官方推荐脚本)
? 脚本会自动:
- 检测 Node.js v22 ✔
- 安装
openclaw 全局 CLI 命令
- 创建默认工作区
~/.openclaw/workspace
- 初始化配置骨架
? 步骤三:运行初始化向导(onboard)
按提示逐步操作(关键选项说明?):
| 步骤 |
推荐选择 |
说明 |
| Security Warning |
Yes, I understand |
必须确认风险(否则中断) |
| Onboarding Mode |
QuickStart |
新手首选,跳过高级定制 |
| Model Provider |
选 Qwen (通义千问) / Z.AI (GLM 4.7) 等 |
输入对应 API Key(需提前在 dashscope.aliyun.com 或 zhipu.ai 获取) |
| Channels |
Skip for now(暂不配置飞书/Telegram) |
后续单独配置更稳妥 |
| Skills |
Yes, install all recommended skills |
后续可通过 openclaw skills list 管理 |
| Hooks |
全选(boot-md, command-logger, session-memory) |
增强记忆与审计能力 |
| Gateway |
接受默认端口 18789 和地址 127.0.0.1 |
如端口被占:openclaw gateway --port 18790 |
✅ 成功标志:最后出现 ✅ Gateway is running + Dashboard URL: http://127.0.0.1:18789/#token=xxx
? 步骤四:启动服务 & 访问 Web 控制台
✅ 成功标志:浏览器打开后显示 OpenClaw 聊天界面,右上角显示 “Gateway ONLINE”
? 步骤五(可选):接入飞书(按需配置)
✅ 仅当需通过飞书聊天触发 OpenClaw 时才执行此步。
5.1 安装飞书插件
5.2 配置飞书应用凭证(需提前在 飞书开放平台 创建应用)
5.3 验证飞书通道状态
5.4 飞书后台关键配置(必须!否则收不到消息)
进入 飞书开发者后台 → 你的应用:
- ✅ 添加能力 → 启用 「机器人」
- ✅ 权限管理 → 开通:
contact:user.base:readonly, im:message, im:message.p2p_msg:readonly, im:message.group_at_msg:readonly, im:message:send_as_bot
- ✅ 事件与回调 →
- 订阅方式:长连接(WebSocket)
- 添加事件:
im.message.receive_v1
- 添加回调:
card.action.trigger, profile.view.get
- ✅ 发布应用 → 创建版本并「发布」(否则飞书客户端搜不到)
✅ 测试:在飞书中搜索并添加你的机器人 → 发送 你好 → 收到回复即成功。
? 常用运维命令(随时可用)
❌ 常见问题速查(deepin v25 特有)
| 现象 |
原因 |
解决方案 |
node -v 仍是 v18 |
nvm 未生效 |
关闭终端重开,或执行 source ~/.bashrc |
openclaw: command not found |
CLI 未加入 PATH |
重新运行安装脚本,或手动执行 export PATH="$HOME/.openclaw/bin:$PATH" 并写入 ~/.bashrc |
brew not installed 报错(Skills 安装失败) |
Homebrew 未配置到当前 shell |
执行 eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)" 并追加到 ~/.bashrc |
| Dashboard 打不开 / Token 失效 |
Gateway 未启动或崩溃 |
openclaw gateway stop && openclaw gateway start,再查 openclaw logs |
| 飞书收不到消息 |
权限/事件/发布任一环节遗漏 |
严格对照上文「5.4 飞书后台关键配置」逐项核对 |
? 总结:deepin v25 安装 OpenClaw 的核心要点
- 必升 Node.js → v22+(用 nvm)
- 必用官方脚本 →
curl ... install.sh \| bash
- 必走
onboard 向导 → 不跳过安全确认与模型配置
- 飞书接入 → 插件 + CLI 配置 + 飞书后台三者缺一不可
- 安全第一 → 普通用户运行、关闭杀软、非生产环境试用
? 补充资源(2026 最新):
声明:
1.本站主要是为了记录工作学习中遇到的问题,可能由于本人技术有限,内容难免有纰漏,一切内容仅供参考。
2.本站部分内容来源互联网,如果有图片或者内容侵犯您的权益请联系我们删除!
3.本站所有原创作品,包括文字、资料、图片、网页格式,转载时请标注作者与来源。
------------------------------------------------------------------------------------------------
出处:网际迅联
网址:https://www.wjxlkj.com
联系方式:
手机号码:13910758317
微信:13910758317
客服QQ:58053012
或下图二维码微信扫码或长按识别添加微信