OpenClaw AI助手入门教程-本地ubuntu安装openclaw
说明：
OpenClaw（昵称“小龙虾”）是一款开源的个人AI助理。与传统的聊天机器人不同，它不仅能和你对话，更能直接操作你的电脑——帮你整理文件、处理邮件、编写代码，真正做到“指哪打哪”。最关键的是，OpenClaw支持完全本地部署。这意味着你的所有数据（聊天记录、文件等）都保留在自己的电脑上，无需上传云端，隐私和安全由你自己掌控。
本教程将指导你在本地环境中（如虚拟机或物理机）完成OpenClaw的安装、配置，并接入DeepSeek大模型，最终通过Web UI与你的AI助理进行交互。
系统要求
在开始之前，请确保你的环境满足以下要求：
内存：建议 2GB 或以上。
硬盘空间：建议预留至少 10GB 的可用空间，用于存放程序文件和AI模型相关的依赖。
网络：需要稳定的互联网连接以下载安装包和依赖（后续使用中模型调用可能需要联网，但你的数据始终保留在本地）。
操作系统：支持Linux、macOS和Windows（通过WSL或Cygwin等）。本教程以Linux（如Ubuntu）为例。
Node.js：版本必须 ≥ v22。OpenClub的核心运行环境基于Node.js，请先安装Node.js。
安装步骤
- 安装Node.js（如未安装）
如果系统中没有Node.js v22或更高版本，请先安装。以Ubuntu为例：
# 使用NodeSource安装Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证版本
node --version # 应输出 v22.x.x 或更高
- 一键安装OpenClaw
OpenClaw提供了一键安装脚本，可以自动下载并配置所有组件。打开终端，执行以下命令：
curl -fsSL https://openclaw.ai/install.sh | bash
- 该脚本会执行以下操作：
下载OpenClaw核心包及其依赖
将openclaw命令添加到系统PATH
创建默认配置目录 ~/.openclaw
- 安装完成后，验证是否成功：
openclaw --version
- 预期输出类似：2026.2.3（版本号≥2026.2.x）
- 首次配置并启用守护进程
第一次使用OpenClaw需要运行交互式配置向导，同时可以选择安装系统守护进程以便后台运行：
openclaw onboard --install-daemon
- 该命令会引导你完成以下设置：
选择数据存储目录（默认~/.openclaw/data）
设置管理员账号（用于Web UI登录）
配置AI模型接入（暂时跳过，后续单独配置DeepSeek）
自动安装并启动openclaw-daemon服务（如果你使用systemd，会创建服务单元）
注意：如果你没有使用--install-daemon，后续需要手动启动服务，可使用openclaw start。
配置DeepSeek大模型
OpenClaw本身不包含AI模型，需要接入第三方模型服务。本教程以DeepSeek为例，说明如何配置模型接入。DeepSeek提供了API接口，你需要先注册获取API密钥。
- 获取DeepSeek API密钥
访问 DeepSeek官网 注册账号。
登录后进入API密钥管理页面，创建一个新的API密钥，复制保存。
- 配置OpenClaw使用DeepSeek
OpenClaw的配置文件位于 ~/.openclaw/openclaw.json。你可以直接编辑该文件，或通过命令设置。
- 编辑配置文件：
nano ~/.openclaw/openclaw.json
- 找到 "models" 相关配置段（如果没有则手动添加），示例配置如下：
"models": {
"mode": "merge",
"providers": {
"custom-api-deepseek-com": {
"baseUrl": "https://api.deepseek.com",
"apiKey": "sk-b5687763",
"api": "openai-completions",
"models": [
{
"id": "deepseek-chat",
"name": "deepseek-chat (Custom Provider)",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 64000,
"maxTokens": 8192
}
]
}
}
},
保存文件并退出。
注意：如果你使用的是DeepSeek的本地部署版本（如通过Ollama），则需相应调整配置，本教程以云端API为例。
- 验证模型连接
重启OpenClaw服务使配置生效：
openclaw restart
然后检查模型状态：
openclaw doctor
在输出中应能看到模型连接成功的提示。
使用OpenClaw
- 打开Web UI
OpenClaw提供了一个友好的Web界面用于对话和管理。运行以下命令启动dashboard（如果守护进程已在运行，它会直接打开浏览器）：
openclaw dashboard
该命令会启动一个本地Web服务器（通常监听在http://localhost:3000），并自动在默认浏览器中打开。如果未自动打开，请手动访问该地址。
首次访问需要登录，使用你在onboard步骤中设置的管理员账号。
- 开始对话
登录后，你将看到聊天界面。在输入框中输入你的问题或指令，例如：
“帮我整理桌面上的文件，按类型分类到文件夹”
“给张三写一封邮件，提醒他明天开会”
“写一个Python脚本，计算斐波那契数列”
OpenClaw会根据你的指令分析并执行相应操作。由于AI模型调用的是DeepSeek，响应速度取决于你的网络和API服务状态。
- 查看服务状态
你可以随时查看OpenClaw各个服务的运行状态：
openclaw gateway status
该命令会显示网关服务、模型服务等组件的健康状态。
- 运行健康检查
如果遇到问题，可以使用诊断工具检查环境配置和依赖：
openclaw doctor
它会检测Node.js版本、配置文件权限、模型连接等，并给出建议。
配置文件的进阶说明
- OpenClaw的主配置文件位于 ~/.openclaw/openclaw.json，你可以根据需要修改以下常用项：
数据存储路径：dataDir（默认为~/.openclaw/data）
Web UI端口：web.port（默认为3000）
日志级别：log.level（可选debug、info、warn、error）
AI模型配置：如上所述
- 修改配置后需要重启服务：
openclaw restart
- 升级OpenClaw
OpenClaw会定期发布新版本。升级非常简单：
openclaw update
该命令会自动下载最新版本并替换旧文件，同时保留你的配置和数据。
- 卸载OpenClaw
如果你需要完全移除OpenClaw，可以执行：
openclaw uninstall
该命令会停止服务、删除可执行文件，但默认会保留你的数据目录（~/.openclaw/data）。如需彻底删除所有数据，请手动删除~/.openclaw目录。
常见问题与故障排除
- Q: 一键安装脚本执行失败怎么办？
A: 检查网络连接，确保能访问openclaw.ai。也可以手动下载安装包：从GitHub Releases页面下载对应系统的压缩包，解压后将openclaw命令放入PATH。
- Q: 启动dashboard后页面无法打开？
A: 确认服务是否运行：openclaw gateway status。如果服务正常，检查防火墙是否放行了对应端口（默认3000）。也可以尝试更换端口：修改配置文件中的web.port。
- Q: 模型调用时报错“API key invalid”
A: 检查~/.openclaw/openclaw.json中的API密钥是否正确，注意不要有多余空格。如果密钥正确，确认DeepSeek账户余额充足。
- Q: OpenClaw能否完全离线工作？
A: 可以，但需要配置本地模型（如通过Ollama运行DeepSeek的量化版本）。本教程未涉及本地模型部署，如有需要请参考DeepSeek本地部署文档。
- Q: 如何备份我的数据？
A: 直接备份~/.openclaw/data目录即可。恢复时重新安装OpenClaw后将备份的数据放回原位置。
结语
- 至此，你已经成功安装并配置了OpenClaw个人AI助理。现在，你可以开始体验AI操控电脑的便捷了。记住，所有操作都在本地执行，你的隐私完全由自己掌控。如果在使用过程中遇到任何问题，欢迎查阅官方文档或社区寻求帮助。
获取最新文章: 扫一扫右上角的二维码加入“创客智造”公众号