跳到主要内容 OpenClaw 在 Manjaro 上的部署与使用指南 | 极客日志
Python
OpenClaw 在 Manjaro 上的部署与使用指南 > OpenClaw(原名 Clawdbot、Moltbot)是一款开源的个人 AI 代理工具,可以部署在你的个人电脑上,通过自然语言指令帮你完成各种自动化任务。将详细介绍如何在 Manjaro 系统上安装、配置和使用 OpenClaw。 目录 什么是 OpenClaw 环境准备 安装 OpenClaw 配置 OpenRouter API 使用 Web UI 使用终端 UI AionUi 访问…
编程诗人 发布于 2026/4/6 更新于 2026/4/17 7.7K 浏览
OpenClaw(原名 Clawdbot、Moltbot)是一款开源的个人 AI 代理工具,可以部署在你的个人电脑上,通过自然语言指令帮你完成各种自动化任务。本文将详细介绍如何在 Manjaro 系统上安装、配置和使用 OpenClaw。
目录
什么是 OpenClaw OpenClaw 是一款开源的个人 AI 助手项目,它的核心理念是让 AI 成为你的"数字分身",帮助你完成流程化、重复性的工作。
核心特点
多平台接入 :支持 WhatsApp、Telegram、Discord、Slack、飞书、钉钉等多种通讯平台
多模型支持 :兼容 OpenAI、DeepSeek、阿里云通义千问等多种 AI 模型
本地部署 :完全运行在你自己的服务器或电脑上,数据更安全
开源免费 :代码完全开源,任何人都可以免费使用
环境准备 在安装 OpenClaw 之前,你需要确保 Manjaro 系统满足以下要求:
1. 安装 Node.js 22+ OpenClaw 要求 Node.js 版本 >= 22。Manjaro 默认软件源中的 Node.js 版本可能较旧,建议使用 NodeSource 仓库安装最新版本。
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo pacman -S nodejs npm
node --version
npm --version
2. 安装 pnpm(推荐) OpenClaw 项目使用 pnpm 管理依赖,pnpm 比 npm 更快、更省磁盘空间。
sudo npm install -g pnpm
pnpm --version
3. 安装 Git sudo pacman -S git
git --version
安装 OpenClaw
方法一:使用 npm/pnpm 安装(推荐)
npm install -g openclaw@latest
pnpm add -g openclaw@latest
方法二:使用中文社区版本 如果你更喜欢中文界面,可以安装 OpenClaw 中文社区版本:
npm install -g @qingchencloud/openclaw-zh@latest
验证安装
openclaw --version
openclaw --help
配置 OpenRouter API OpenRouter 是一个支持多种 AI 模型统一访问的平台,里面有免费的模型可以使用,通过它你可以使用 Claude、GPT 等多种模型。
1. 获取 OpenRouter API Key
访问 OpenRouter 官网
注册账户并登录
进入设置页面,创建 API Key
注意 :API Key 只显示一次,请妥善保存
2. 初始化 OpenClaw
选择 AI 模型
配置 API 密钥
设置聊天通道
3. 手动配置文件方式 如果你更喜欢手动配置,可以直接编辑配置文件。配置文件位于:~/.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" } ] } } } }
4. 配置环境变量
vim ~/.zshrc
export OPENROUTER_API_KEY="你的 OpenRouter API Key"
source ~/.zshrc
支持的模型 OpenRouter 支持众多模型,部分热门模型包括:
anthropic/claude-3.5-sonnet
openai/gpt-4o
google/gemini-pro
meta-llama/llama-3.1-70b-instruct
使用 Web UI OpenClaw 提供了直观的 Web 界面,方便你通过浏览器进行交互。
启动 Web UI 执行命令后,浏览器会自动打开 OpenClaw 的 Web 控制台界面。
Web UI 功能
对话界面 :类似 ChatGPT 的直观聊天界面
主题自定义 :支持多种主题选择
代码高亮 :增强代码可读性
模型切换 :可以随时切换不同的 AI 模型
历史记录 :保存对话历史,方便回顾
访问地址
本地:http://localhost:18789
使用终端 UI 如果你更喜欢在终端中直接操作,OpenClaw 也提供了强大的终端界面。
基本使用
常用命令
openclaw --help
openclaw status
openclaw start
openclaw stop
openclaw restart
终端 UI 特点
纯命令行交互,无需图形界面
占用资源少,运行高效
适合远程服务器使用
支持命令自动补全
AionUi 访问方式
AionUi 是一个免费、本地、开源的 AI 办公助手,专门为多 AI 工具协作而设计。它基于 Electron 和 React 构建,提供现代化的 GUI 界面和 WebUI 远程访问功能。
什么是 AionUi AionUi 是一个跨平台的 AI 终端界面工具,旨在将命令行体验转化为现代化的 AI 聊天界面。它的核心特点是可以同时管理多个 AI 代理,让它们协同工作。
核心特性
多 AI 代理支持 :支持 Gemini CLI、Claude Code、Codex、OpenCode、Qwen Code、OpenClaw 等多种主流 AI 工具
跨平台 :支持 macOS、Linux、Windows 系统
双界面模式 :提供原生 GUI 界面和 WebUI 远程访问
本地部署 :所有数据保存在本地,保护隐私安全
多模型并行 :支持同时运行多个 AI 代理
安装 AionUi
环境要求
Node.js >= 18
npm 或 pnpm
Git
安装步骤
git clone https://github.com/iOfficeAI/AionUi.git
cd AionUi
npm install
pnpm install
快速启动
配置 OpenClaw 连接 AionUi 可以作为 OpenClaw 的图形化界面,下面是配置步骤:
1. 启动 OpenClaw 服务
openclaw start
openclaw status
2. 在 AionUi 中添加 OpenClaw
打开 AionUi 界面
进入设置页面
选择"代理管理"或"Agents"选项
添加新的 AI 代理
选择 OpenClaw 作为代理类型
输入 OpenClaw 的连接地址(默认为 http://localhost:18789)
配置 API 密钥(如果需要)
3. 配置文件方式 你也可以通过编辑 AionUi 的配置文件来添加 OpenClaw:
{ "agents" : { "openclaw" : { "enabled" : true , "type" : "openclaw" , "endpoint" : "http://localhost:18789" , "apiKey" : "你的 OpenClaw API Key(如果有)" } } }
使用 AionUi 的优势
统一管理 :在一个界面中管理多个 AI 代理
可视化界面 :无需记忆命令行参数,通过图形界面配置
远程访问 :通过 WebUI 随时随地访问
资源优化 :提供简洁模式,减少资源占用
主题定制 :支持多种主题选择
低配电脑优化
关闭动画效果 :在设置中禁用动画和背景模糊
选择轻量模型 :如 Gemini Nano 或 Qwen-1.8B
使用简洁主题 :推荐 "retro-windows" 主题
禁用多模型并行 :减少内存占用
常见问题
确认 OpenClaw 服务正在运行
检查端口 18789 是否被占用
确认防火墙允许该端口访问
启用简洁模式
关闭动画效果
选择更轻量的 AI 模型
常见问题与解决方案
1. 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
2. API 连接失败
检查网络是否正常
确认 API Key 是否正确
确认 baseUrl 配置是否正确
如果在国内使用,可能需要配置代理
3. 端口被占用
lsof -i :18789
vim ~/.openclaw/openclaw.json
4. 守护进程安装失败 问题 :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
相关免费在线工具 curl 转代码 解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
Markdown转HTML 将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
HTML转Markdown 将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online