跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
JavaScriptNode.jsAI

OpenClaw 在 Manjaro 上的个人 AI 助手部署指南

综述由AI生成OpenClaw 是一款开源的个人 AI 代理工具,支持多平台接入与多模型兼容。详述了在 Manjaro 系统上通过 Node.js 和 pnpm 安装配置 OpenClaw 的步骤,包括获取 OpenRouter API Key、初始化向导及手动配置文件方法。同时介绍了 Web UI 与终端 UI 的使用方式,并提供了 Node.js 版本冲突、API 连接失败及端口占用等常见问题的解决方案。

292440837发布于 2026/3/30更新于 2026/4/253 浏览
OpenClaw 在 Manjaro 上的个人 AI 助手部署指南

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 仓库安装最新版本。

# 添加 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
2. 安装 pnpm(推荐)

OpenClaw 项目使用 pnpm 管理依赖,pnpm 比 npm 更快、更省磁盘空间。

# 使用 npm 全局安装 pnpm
sudo npm install -g pnpm

# 验证安装
pnpm --version
3. 安装 Git
sudo pacman -S git

# 验证安装
git --version

安装 OpenClaw

方法一:使用 npm/pnpm 安装(推荐)
# 使用 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 API

OpenRouter 是一个支持多种 AI 模型统一访问的平台,里面有免费的模型可以使用,通过它你可以使用 Claude、GPT 等多种模型。

1. 获取 OpenRouter API Key
  1. 访问 OpenRouter 官网
  2. 注册账户并登录
  3. 进入设置页面,创建 API Key
  4. 注意:API Key 只显示一次,请妥善保存
2. 初始化 OpenClaw
# 启动初始化向导
openclaw onboard

初始化向导会引导你完成以下配置:

  • 选择 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. 配置环境变量

你也可以通过环境变量配置 API:

# 编辑 .zshrc 文件(如果你使用 zsh)
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
# 启动控制台(Web UI)
openclaw dashboard

执行命令后,浏览器会自动打开 OpenClaw 的 Web 控制台界面。

Web UI 功能
  • 对话界面:类似 ChatGPT 的直观聊天界面
  • 主题自定义:支持多种主题选择
  • 代码高亮:增强代码可读性
  • 模型切换:可以随时切换不同的 AI 模型
  • 历史记录:保存对话历史,方便回顾
访问地址

默认情况下,Web UI 会在以下地址运行:

  • 本地:http://localhost:18789

如果端口被占用,可以在配置文件中修改端口。

使用终端 UI

如果你更喜欢在终端中直接操作,OpenClaw 也提供了强大的终端界面。

基本使用
# 启动终端交互模式
openclaw chat
常用命令
# 查看帮助
openclaw --help

# 查看状态
openclaw status

# 启动服务
openclaw start

# 停止服务
openclaw stop

# 重启服务
openclaw restart
终端 UI 特点
  • 纯命令行交互,无需图形界面
  • 占用资源少,运行高效
  • 适合远程服务器使用
  • 支持命令自动补全

常见问题与解决方案

1. Node.js 版本问题

问题:安装时报错提示 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
2. API 连接失败

问题:无法连接到 AI 模型 API

解决:

  • 检查网络是否正常
  • 确认 API Key 是否正确
  • 确认 baseUrl 配置是否正确
  • 如果在国内使用,可能需要配置代理
3. 端口被占用

问题:启动 Web UI 时提示端口被占用

解决:

# 查看端口占用情况
lsof -i :18789

# 修改配置文件中的端口
vim ~/.openclaw/openclaw.json

# 在配置中添加 "port": "新端口号"
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 助手的部署提供了极大的自由度,让每个人都能拥有属于自己的"数字分身"。

目录

  1. 什么是 OpenClaw
  2. 核心特点
  3. 环境准备
  4. 1. 安装 Node.js 22+
  5. 添加 NodeSource 仓库(以 Node.js 22 为例)
  6. 安装 Node.js
  7. 验证安装
  8. 2. 安装 pnpm(推荐)
  9. 使用 npm 全局安装 pnpm
  10. 验证安装
  11. 3. 安装 Git
  12. 验证安装
  13. 安装 OpenClaw
  14. 方法一:使用 npm/pnpm 安装(推荐)
  15. 使用 npm 安装
  16. 或者使用 pnpm 安装
  17. 方法二:使用中文社区版本
  18. 安装中文版本
  19. 验证安装
  20. 查看 OpenClaw 版本
  21. 查看帮助信息
  22. 配置 OpenRouter API
  23. 1. 获取 OpenRouter API Key
  24. 2. 初始化 OpenClaw
  25. 启动初始化向导
  26. 3. 手动配置文件方式
  27. 4. 配置环境变量
  28. 编辑 .zshrc 文件(如果你使用 zsh)
  29. 添加以下内容
  30. 生效配置
  31. 支持的模型
  32. 使用 Web UI
  33. 启动 Web UI
  34. 启动控制台(Web UI)
  35. Web UI 功能
  36. 访问地址
  37. 使用终端 UI
  38. 基本使用
  39. 启动终端交互模式
  40. 常用命令
  41. 查看帮助
  42. 查看状态
  43. 启动服务
  44. 停止服务
  45. 重启服务
  46. 终端 UI 特点
  47. 常见问题与解决方案
  48. 1. Node.js 版本问题
  49. 使用 nvm 管理 Node.js 版本
  50. 2. API 连接失败
  51. 3. 端口被占用
  52. 查看端口占用情况
  53. 修改配置文件中的端口
  54. 在配置中添加 "port": "新端口号"
  55. 4. 守护进程安装失败
  56. 手动安装守护进程
  57. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Spring Boot 使用 web3j 交互智能合约详解
  • 从零构建大模型:核心原理与实战指南
  • AI 绘画工作台:Z-Image-Turbo 云端协作部署指南
  • OpenClaw Skills 安装与实战:构建 AI 技能工具箱
  • 基于FPGA的CARRY4 抽头延迟链TDC延时仿真
  • Java 中间件:Dubbo 服务降级(Mock 机制)
  • 深入剖析 Spring 框架:架构、缺陷与演进之路
  • OpenClaw Skills 安装与实战:打造你的 AI 技能工具箱
  • 基于 FPGA 的 CARRY4 抽头延迟链 TDC 延时仿真
  • Java 集合框架进阶:Map 接口核心原理与实战
  • OpenClaw 是一个开源的、面向具身智能(Embodied AI)与机器人操作研究的多模态大模型框架
  • Faster-Whisper-GUI 日语语音识别长音频异常修复指南
  • FLUX.1-dev FP8 量化模型部署与优化指南
  • C++ 智能指针详解:从裸指针到 unique_ptr、shared_ptr、weak_ptr
  • 基于FPGA的CARRY4抽头延迟链TDC延时仿真
  • OpenClaw 浏览器控制方案:使用 Chrome Debug 模式保留登录状态
  • 大模型、超大模型与 Foundation Model 技术精要
  • OpenClaw 开源 AI Agent 框架解析
  • OpenAkita:自我进化的开源 AI 助手框架
  • 国内人工智能领域头部企业概览与求职方向分析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online