deepin v25 安装 OpenClaw

在 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），全程终端操作，安全可控。

✅ 前置准备（务必完成）

⚠️ 重要提醒（安全与稳定性）

• OpenClaw 是测试阶段开源项目，具备读写文件、执行命令等高权限能力；
• 请勿在生产环境或含敏感数据的机器上首次尝试；
• 建议新建普通用户（如 clawuser）运行，避免使用 root；
• 安装全程关闭 360/火绒/腾讯管家等安全软件（会拦截 Node.js 进程或文件写入）。

? 步骤一：升级 Node.js 至 v22+（deepin v25 默认为 v18，不兼容！）

# 1. 安装 nvm（Node Version Manager）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
# 2. 重启终端（或手动加载配置）
source ~/.bashrc
# 3. 安装 Node.js v22（OpenClaw 强制要求）
nvm install 22
# 4. 设为默认版本并验证
nvm use 22
node -v  # 应输出 v22.22.0（或类似 v22.x.x）
npm -v   # 应输出 ≥10.9.0

✅ 成功标志：node -v 返回 v22.x.x

? 步骤二：一键安装 OpenClaw（官方推荐脚本）

# 执行官方安装脚本（自动检测系统、下载、安装 CLI）
curl -fsSL https://openclaw.ai/install.sh | bash
# 验证 CLI 是否注册成功
openclaw --version  # 应显示类似 "2026.1.29"

? 脚本会自动：

• 检测 Node.js v22 ✔
• 安装 openclaw 全局 CLI 命令
• 创建默认工作区 ~/.openclaw/workspace
• 初始化配置骨架

? 步骤三：运行初始化向导（onboard）

# 启动交互式配置（推荐加 --install-daemon 实现开机自启）
openclaw onboard --install-daemon

按提示逐步操作（关键选项说明?）：

✅ 成功标志：最后出现 ✅ Gateway is running + Dashboard URL: http://127.0.0.1:18789/#token=xxx

? 步骤四：启动服务 & 访问 Web 控制台

# 1. 确保网关已运行（若未自动启动）
openclaw gateway start
# 2. 查看状态（应显示 ON / OK）
openclaw gateway status
# 3. 在浏览器中打开控制台（复制 URL 中的完整地址）
openclaw dashboard
# 或手动访问：http://127.0.0.1:18789/#token=你的Token

✅ 成功标志：浏览器打开后显示 OpenClaw 聊天界面，右上角显示 “Gateway ONLINE”

? 步骤五（可选）：接入飞书（按需配置）

✅ 仅当需通过飞书聊天触发 OpenClaw 时才执行此步。

5.1 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu
openclaw gateway restart  # 重启使插件生效

5.2 配置飞书应用凭证（需提前在 飞书开放平台 创建应用）

# 替换为你的飞书 App ID 和 Secret
openclaw config set channels.feishu.appId "cli_xxxxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret_here"
openclaw config set channels.feishu.enabled true
openclaw gateway restart

5.3 验证飞书通道状态

openclaw status | grep feishu
# 应输出类似：feishu    ON    OK

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
• ✅ 发布应用 → 创建版本并「发布」（否则飞书客户端搜不到）

✅ 测试：在飞书中搜索并添加你的机器人 → 发送 你好 → 收到回复即成功。

? 常用运维命令（随时可用）

openclaw gateway restart     # 重启服务
openclaw logs --follow       # 实时查看日志（排查问题必备）
openclaw doctor              # 检查所有依赖/技能/权限状态
openclaw skills list         # 查看已安装技能
openclaw update              # 升级 OpenClaw 到最新版
openclaw health              # 极简健康检查（ok/error）

❌ 常见问题速查（deepin v25 特有）

? 总结：deepin v25 安装 OpenClaw 的核心要点

1. 必升 Node.js → v22+（用 nvm）
2. 必用官方脚本 → curl ... install.sh \| bash
3. 必走 onboard 向导 → 不跳过安全确认与模型配置
4. 飞书接入 → 插件 + CLI 配置 + 飞书后台三者缺一不可
5. 安全第一 → 普通用户运行、关闭杀软、非生产环境试用

? 补充资源（2026 最新）：

• 官方文档：https://docs.openclaw.ai
• 中文社区：https://xialiao.ai（虾聊社区）
• GitHub 仓库：https://github.com/openclaw/openclaw