OpenClaw 在 Manjaro 系统上的部署与使用指南
在 Manjaro 系统上部署 OpenClaw 个人 AI 助手的完整流程。包括安装 Node.js 22+、pnpm 及 Git 环境,通过 npm 或 pnpm 全局安装 OpenClaw,配置 OpenRouter API Key 以接入多种 AI 模型。支持 Web UI 和终端 UI 两种交互方式,可灵活选择 Claude、GPT 等模型,实现本地化 AI 自动化任务处理。

在 Manjaro 系统上部署 OpenClaw 个人 AI 助手的完整流程。包括安装 Node.js 22+、pnpm 及 Git 环境,通过 npm 或 pnpm 全局安装 OpenClaw,配置 OpenRouter API Key 以接入多种 AI 模型。支持 Web UI 和终端 UI 两种交互方式,可灵活选择 Claude、GPT 等模型,实现本地化 AI 自动化任务处理。

OpenClaw(原名 Clawdbot、Moltbot)是一款开源的个人 AI 代理工具,可以部署在你的个人电脑上,通过自然语言指令帮你完成各种自动化任务。本文将详细介绍如何在 Manjaro 系统上安装、配置和使用 OpenClaw。
OpenClaw 是一款开源的个人 AI 助手项目,它的核心理念是让 AI 成为你的'数字分身',帮助你完成流程化、重复性的工作。
在安装 OpenClaw 之前,你需要确保 Manjaro 系统满足以下要求:
OpenClaw 要求 Node.js 版本 >= 22。Manjaro 默认软件源中的 Node.js 版本可能较旧,建议使用 NodeSource 仓库安装最新版本。
# 添加 NodeSource 仓库(以 Node.js 22 为例)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
# 安装 Node.js
sudo pacman -S nodejs npm
# 验证安装
node --version
npm --version
OpenClaw 项目使用 pnpm 管理依赖,pnpm 比 npm 更快、更省磁盘空间。
# 使用 npm 全局安装 pnpm
sudo npm install -g pnpm
# 验证安装
pnpm --version
sudo pacman -S git
# 验证安装
git --version
# 使用 npm 安装
npm install -g openclaw@latest
# 或者使用 pnpm 安装
pnpm add -g openclaw@latest
如果你更喜欢中文界面,可以安装 OpenClaw 中文社区版本:
# 安装中文版本
npm install -g @qingchencloud/openclaw-zh@latest
# 查看 OpenClaw 版本
openclaw --version
# 查看帮助信息
openclaw --help
OpenRouter 是一个支持多种 AI 模型统一访问的平台,里面有免费的模型可以使用,通过它你可以使用 Claude、GPT 等多种模型。
# 启动初始化向导
openclaw onboard
初始化向导会引导你完成以下配置:
如果你更喜欢手动配置,可以直接编辑配置文件。配置文件位于:~/.openclaw/openclaw.json
{"auth":{"profiles":{"openrouter:default":{"provider":"openrouter","mode":"api_key"}}},"models":{"mode":"merge","providers":{"openrouter":{"baseUrl":"https://openrouter.ai/api/v1","apiKey":"你的 OpenRouter API Key","api":"openai-completions","models":[{"id":"anthropic/claude-3.5-sonnet","region":"auto"}]}
你也可以通过环境变量配置 API:
# 编辑 .zshrc 文件(如果你使用 zsh)
vim ~/.zshrc
# 添加以下内容
export OPENROUTER_API_KEY="你的 OpenRouter API Key"
# 生效配置
source ~/.zshrc
OpenRouter 支持众多模型,部分热门模型包括:
anthropic/claude-3.5-sonnetopenai/gpt-4ogoogle/gemini-prometa-llama/llama-3.1-70b-instructOpenClaw 提供了直观的 Web 界面,方便你通过浏览器进行交互。
# 启动控制台(Web UI)
openclaw dashboard
执行命令后,浏览器会自动打开 OpenClaw 的 Web 控制台界面。
默认情况下,Web UI 会在以下地址运行:
http://localhost:18789如果端口被占用,可以在配置文件中修改端口。
如果你更喜欢在终端中直接操作,OpenClaw 也提供了强大的终端界面。
# 启动终端交互模式
openclaw chat
# 查看帮助
openclaw --help
# 查看状态
openclaw status
# 启动服务
openclaw start
# 停止服务
openclaw stop
# 重启服务
openclaw restart
问题:安装时报错提示 Node.js 版本过低
解决:
# 使用 nvm 管理 Node.js 版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc
nvm install 22
nvm use 22
问题:无法连接到 AI 模型 API
解决:
问题:启动 Web UI 时提示端口被占用
解决:
# 查看端口占用情况
lsof -i :18789
# 修改配置文件中的端口
vim ~/.openclaw/openclaw.json
# 在配置中添加 "port": "新端口号"
问题:openclaw onboard --install-daemon 失败
解决:
# 手动安装守护进程
sudo systemctl daemon-reload
openclaw daemon install
本文详细介绍了在 Manjaro 系统上安装和配置 OpenClaw 的完整流程。通过 OpenRouter API,你可以灵活选择各种 AI 模型,无论是 Claude、GPT 还是其他模型,都可以轻松接入。
OpenClaw 的 Web UI 和终端 UI 提供了灵活的交互方式,满足不同场景的需求。作为一个完全开源的项目,OpenClaw 为个人 AI 助手的部署提供了极大的自由度,让每个人都能拥有属于自己的'数字分身'。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online