一、引言在 AI 技术飞速发展的今天搭建家庭 AI 助手已成为越来越多开发者的选择。相比使用公开 API 服务私有部署的优势在于数据隐私对话数据完全保存在本地高度定制化自定义提示词、知识库和行为模式7x24 小时运行随时响应你的需求成本可控一次性硬件投入长期运营成本低本文将介绍如何在 NUC 迷你主机上部署 Openclaw AI 助手。二、硬件与环境准备硬件准备废旧电脑一台NUC迷你电脑系统准备使用Ubuntu Server 22.04 LTS安装时勾选OpenSSH Server。安装完成后通过 SSH 连接并准备环境sshyour-usernameyour-nuc-ip# 更新系统sudoaptupdatesudoaptupgrade -y# 安装基础工具sudoaptinstall-ycurl三、Openclaw 安装Openclaw 基于 Node.js 开发安装非常简单。方式一官方一键脚本推荐最快捷的安装方式脚本会自动检测系统、安装 Node.js、配置环境curl-fsSL https://openclaw.bot/install.sh|bash方式二手动安装高级用户如果你想自己控制 Node.js 版本可以手动安装# 安装 nvmNode 版本管理器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 openclawlatest四、配置与启动初始化配置运行初始化向导按提示完成配置# 初始化并安装守护进程开机自启openclaw onboard --install-daemon初始化过程中AI 模型选择免费的 QWen OAuthProvider: QWen OAuth 模型: qwen-portal/coder-model默认 其他配置: 均可跳过后续需要时再配置访问 Web UI初始化完成后命令行会输出一个带 token 的访问链接http://localhost:18789/?tokenxxxxxx在浏览器中打开该链接即可与 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