麒麟桌面系统【安装小龙虾openclaw】
·
一、OpenClaw介绍
OpenClaw 是一个运行在本地设备上的个人 AI 助手。安装很简单，复制粘贴就行了。
在电脑上可以用浏览器打开这个网址： https://gxxc.wiki/other/7503.html ，将需要用到的命令复制粘贴执行就行。
这里演示：麒麟v11 + 腾讯QQ + minimax 的组合。
minimax的api需要提前申请好，还没有的，可以先跳过，后面再配置也可以。
二、安装步骤 (V10SP1和V11步骤一样)
-
关闭kysec安全 (略)
V10-SP1和V11不同，关闭步骤可以查看一下我其他文章。
-
安装依赖程序（可以切换root，也可以不切）
sudo apt update && sudo apt install git -y
-
使用nvm安装node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
上面命令执行没问题后，再执行以下命令：
source ~/.bashrc
nvm install 22
nvm use 22
node --version
-
安装pnpm
npm install -g pnpm
pnpm setup
source ~/.bashrc
# 配置淘宝镜像源
pnpm config set registry https://registry.npmmirror.com
pnpm config set @npm:registry https://registry.npmmirror.com
# 验证配置
pnpm config get registry # 输出 https://registry.npmmirror.com
-
使用 pnpm 全局安装openclaw
pnpm add -g openclaw@latest
openclaw --version
如上图所示，openclaw已经安装完成。
三、初始化及配置openclaw
-
执行以下命令配置工作目录（可以省略）
openclaw setup
-
执行以下命令进行导航式配置：
openclaw onboard
-
配置QQ机器人
浏览器打开 https://q.qq.com
用qq扫码登录
点击创建机器人
把这三条命令，复制到终端去执行
打开QQ就能看到小龙虾机器人了
-
安装chromium浏览器
四、卸载
全局卸载OpenClaw
-
使用以下命令卸载通过pnpm全局安装的OpenClaw：
pnpm remove -g openclaw
或简写为：
pnpm rm -g openclaw
-
检查是否已卸载 执行以下命令检查是否已成功卸载：
pnpm list -g | grep openclaw
若无输出，则表示已卸载。
-
手动删除残留文件（可选） 如果标准方法无效，可以手动删除全局包： 找到pnpm全局安装目录：
pnpm root -g
进入该目录并删除OpenClaw相关文件夹：
rm -rf <pnpm_global_path>/openclaw
-
清除缓存（可选）：
pnpm store prune
五、常用命令
| 命令 | 作用 | 备注 / 参数 |
|---|---|---|
| npm install -g openclaw@latest --registry https://registry.npmmirror.com | 安装 | openclaw |
| openclaw onboard | 安装引导 | |
| openclaw status | 查看 Gateway 状态 | 检查网关是否可达及运行状况 |
| openclaw health | 健康检查 | 主要检测 core 运行和依赖情况 |
| openclaw doctor | 综合诊断与修复建议 | 可配合 --yes / --non-interactive 自动执行 |
| openclaw configure | 交互式配置向导 | 用于设置模型、通道、凭据等 |
| openclaw config get |
获取配置值 | 指定路径提取配置 |
| openclaw config set |
设置配置项 | 支持 JSON5/raw 文本 |
| openclaw config unset |
清除配置项 | 移除单个键值 |
| openclaw channels list | 列出已登录通道 | 可观察 WhatsApp/Telegram 等登录状态 |
| openclaw channels login | 登录新的通道账号 | 用于扫描 / 授权链接 |
| openclaw skills list | 列出技能 | 查看可用 / 已安装的技能 |
| openclaw skills info | 技能详情 | 观察某项技能参数或版本 |
| openclaw plugins list | 列出插件 | 查看已安装插件 |
| openclaw plugins install | 安装插件 | 例如 @openclaw/voice-call |
| openclaw plugins enable | 启用插件 | 之后通常需要重启网关 |
| openclaw logs --follow | 显示日志 | --json / --plain / --limit 等组合使用 |
| openclaw gateway | 启动 Gateway 网关 | |
| openclaw gateway install | 安装系统服务 | 根据平台注册 Gateway 守护进程 |
| openclaw gateway start | 启动 Gateway 网关 | 系统服务模式下启动 |
| openclaw gateway stop | 停止 Gateway 网关 | 同上 |
| openclaw gateway restart | 重启 Gateway 网关 | 适合配置变更后应用 |
| openclaw gateway status | 网关系统服务状态 | 不同于 openclaw status，会探测服务单元 |
| openclaw uninstall | 卸载 Gateway 服务及数据 | 官方推荐使用 |
| openclaw uninstall --all --yes --non-interactive | 全自动卸载 | 包含状态、workspace、插件等 |
| openclaw uninstall --state | 删除状态文件 | 不删除 workspace/CLI |
| openclaw uninstall --workspace | 删除工作区 | 移除 agent/workspace 文件 |
| openclaw uninstall --service | 仅卸载服务 | 不删除数据 |
| openclaw uninstall --dry-run | 模拟卸载 | 显示结果但不实际执行 |
其他
-
官网中文文档地址：https://docs.openclaw.ai/zh-CN
安装过程中的常见错误
-
pnpm 找不到全局 bin 目录，如下图所示： 
这个错误是因为 pnpm 找不到全局 bin 目录，导致无法将 openclaw 命令链接到全局。你可以按以下步骤解决：
-
自动创建全局 bin 目录（推荐） 直接运行 pnpm 提供的 setup 命令，它会自动创建并配置好目录：
pnpm setup
source ~/.bashrc -
执行完成后，重启终端或重新加载 shell 配置，再尝试安装： bash pnpm add -g openclaw@latest
-
缺少git命令
处理：
apt update && apt install -y git
-
打开的web界面显示4008，如下图所示：
处理方法1：
从软件商店上下载chromium浏览器，用chromium浏览器打开就好了。
处理方法2：
# 生成新的 gateway token
openclaw doctor --generate-gateway-token
# 重启服务
systemctl --user restart openclaw-gateway
# 打开带 token 的 dashboard
openclaw dashboard
本文由 mdnice 多平台发布
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。
更多推荐
12
0- 0
已为社区贡献1条内容
所有评论(0)