一、引言
在 AI 技术飞速发展的今天,搭建家庭 AI 助手已成为越来越多开发者的选择。相比使用公开 API 服务,私有部署的优势在于:
- 数据隐私:对话数据完全保存在本地
- 高度定制化:自定义提示词、知识库和行为模式
- 7x24 小时运行:随时响应你的需求
- 成本可控:一次性硬件投入,长期运营成本低
本文将介绍如何在 NUC 迷你主机上部署 Openclaw AI 助手。
二、硬件与环境准备
硬件准备
废旧电脑一台:NUC迷你电脑
系统准备
使用Ubuntu Server 22.04 LTS,安装时勾选OpenSSH Server。
安装完成后,通过 SSH 连接并准备环境:
sshyour-username@your-nuc-ip# 更新系统sudoaptupdate&&sudoaptupgrade -y# 安装基础工具sudoaptinstall-ycurl三、Openclaw 安装
Openclaw 基于 Node.js 开发,安装非常简单。
方式一:官方一键脚本(推荐)
最快捷的安装方式,脚本会自动检测系统、安装 Node.js、配置环境:
curl-fsSL https://openclaw.bot/install.sh|bash方式二:手动安装(高级用户)
如果你想自己控制 Node.js 版本,可以手动安装:
# 安装 nvm(Node 版本管理器)curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bash# 加载 nvm 环境\."$HOME/.nvm/nvm.sh"# 安装 Node.js(推荐 20 或 24 版本)nvminstall24# 验证安装node-v# 安装 Openclawnpminstall-g openclaw@latest四、配置与启动
初始化配置
运行初始化向导,按提示完成配置:
# 初始化并安装守护进程(开机自启)openclaw onboard --install-daemon初始化过程中,AI 模型选择免费的 QWen OAuth:
Provider: QWen OAuth 模型: qwen-portal/coder-model(默认) 其他配置: 均可跳过,后续需要时再配置访问 Web UI
初始化完成后,命令行会输出一个带 token 的访问链接:
http://localhost:18789/?token=xxxxxx在浏览器中打开该链接,即可与 Openclaw 对话。
服务管理命令
# 查看服务状态openclaw status# 重启服务openclaw restart# 停止服务openclaw stop# 查看日志openclaw logs五、命令行使用
TUI 终端界面
类似 Claude Code 的终端聊天界面:
openclaw tuiAgent 任务执行
直接让 Agent 执行特定任务:
openclaw agent --message"帮我整理今天的待办事项"--thinking high --session-id agent:main:main六、连接聊天平台
Openclaw 支持十余个聊天平台(WhatsApp、Telegram、Slack、Discord 等)。配置好 AI Agent 后,直接在聊天中让它帮你配置:
帮我配置 Telegram 连接Openclaw 会一步步引导你完成配置。
七、常见问题
服务无法启动:
openclaw logs# 查看错误日志端口 18789 被占用:
# 编辑配置文件openclaw config editNode.js 版本问题:
# 使用 nvm 切换版本nvm use24八、总结
本文完成了 Openclaw 的部署。下一篇文章将介绍如何接入飞书机器人。
参考资源:
- Openclaw 官网
- Openclaw GitHub