夜雨聆风
系统版本：主流发行版如Debian 12均可。
硬件配置：最低1核1GB内存即可运行，推荐2核2GB或更高配置以获得更好体验。OpenClaw本身轻量，主要消耗内存的是Node.js运行时。
权限要求：需要拥有SSH访问权限，并且是root用户或有sudo权限的普通用户。
网络要求：网络通畅，能够正常访问GitHub、npm等外部资源。
sudo apt update && sudo apt upgrade -ysudo apt install -y gcc g++ make cmake python3 git curl
No
curl -fsSL https://clawdbot.org.cn/install.sh | bash
检测并安装Node.js 22或更高版本（OpenClaw的核心依赖）。
全局安装OpenClaw命令行工具（CLI）。
配置步骤 | 推荐选择 | 说明与理由 |
|---|---|---|
1. 安全警告 Security warning: OpenClaw can execute commands... | Y (Yes) | 确认你了解该框架具有系统命令执行权限，同意继续安装。 |
2. 配置模式 Select onboarding mode | 1 (QuickStart) | 使用默认设置快速配置。对于首次部署，避免在命令行中纠结高级参数，先让服务跑起来。 |
3. 模型提供商 Select model provider | 5 (Skip for now) | 关键建议：在 Debian 服务器上，命令行输入长串 API Key 容易出错。先跳过，安装完成后通过 Web 控制台（ |
4. 聊天渠道 Select channels | 4 (Skip for now) | 先不配置 WhatsApp/Telegram 等。优先通过 Web 控制台验证核心功能是否正常。 |
5.搜索功能Search provider | N (No) | 搜索功能（Web Search）是 OpenClaw 的可选工具，不是启动 Gateway 或运行 Agent 的必需项。跳过它不会影响系统安装和基础功能。 |
6. 安装 Skills Select skills | N (No) | 技能插件（如文件操作、代码解释）后续可根据需求单独安装，初次部署保持最小化。 |
7.安装 Hooks Install hooks? | 全选 | 安装钩子系统，启用记忆功能，这对 Agent 的长期运行有益。 |
这个提示是 OpenClaw 的安全声明，告知你默认配置下 Agent 具有访问个人数据（如文件系统、环境变量）的权限。对于 服务器部署 场景， 选择 Yes继续安装。
选项中， 推荐选择 1. QuickStart。使用默认配置快速启动。
Model/auth provider，遇到 Model/auth provider 选项，建议根据你手头拥有的 API Key 或网络环境进行选择。如果暂时没有或不想在命令行输入长串密钥， 推荐选择 Skip for now。
是选择 Agent 的交互渠道。对于在 Debian 服务器上的首次部署， 强烈建议选择 4. Skip for now。先确保核心服务（Gateway）在服务器上稳定运行，后续再通过 Web 界面轻松配置其他渠道。
Search provider， 建议直接选择 Skip for now。
Configure skills now? (recommended) 建议直接选择 NO。
Enable hooks?该步骤会列出几个核心的钩子（Hooks），它们是实现 OpenClaw 自动化功能的关键组件。 建议全部选择。
How do you want to hatch your bot?推荐选择`Hatch in TUI (recommended)`
curl https://ollama.com/install.sh | shollama pull qwen2.5:7b # 或 qwen3.5:9b 等其他模型安装Ollama并拉取模型 配置OpenClaw连接Ollama 重启网关并验证
# 设置API Key（占位符）openclaw config set models.providers.ollama.apiKey "ollama-local"# 设置Ollama服务地址（将IP替换为你的服务器内网IP，如果Ollama就在本机则是127.0.0.1）openclaw config set models.providers.ollama.baseUrl "http://127.0.0.1:11434/v1"# 设置OpenClaw默认使用Ollama的某个模型openclaw config set agents.defaults.model.primary "ollama/qwen2.5:7b"openclaw gateway restartopenclaw models list # 应能看到配置的模型
常用命令
测试功能：可以运行进入文本用户界面，直接与OpenClaw对话测试。
openclaw tui访问Web界面：在浏览器中访问，即可进入OpenClaw的Web对话界面。
http://你的服务器IP:18789/?token=你的令牌端口占用：如果端口被占用，可以使用查找进程ID，并用终止。
18789lsof -i:18789kill -9 <进程ID>Node.js版本：确保Node.js版本不低于v22.0.0，否则可能导致安装或运行失败。