本手册详细记录了如何在 Linux (Ubuntu) 环境下从零开始配置 OpenClaw解决常见的权限、路径及服务启动问题。 环境要求系统: Windows 11 WSL2 (Ubuntu 24.04)核心: 建议 8 核以上 (本案为 16 核)环境: Node.js v22.22.1 (通过 NVM 管理)模型: 通义千问 (Qwen-Coder-Port)️ 第一阶段基础环境准备1. 安装 NVM 与 Node.js为了确保版本兼容性推荐使用 NVM 安装最新的 LTS 版本curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bashsource~/.bashrc nvminstall222. 安装 OpenClaw CLI使用 npm 全局安装核心程序npminstall-gopenclaw⚙️ 第二阶段交互式初始化 (Onboarding)执行以下命令开始配置向导openclaw onboard核心配置要点Model Selection: 选择Qwen(通义千问)。API Key: 填入来自 DashScope 的sk-xxxx密钥。Skill Install: 建议勾选clawhub,summarize,nano-pdf。Node Manager: 务必选择npm。Hooks: 强烈建议开启session-memory(赋予 AI 长期记忆)。Optional API: 若无特殊需求所有Set XXX_API_KEY均选No以快速完成。 第三阶段解决 WSL2 启动难题在 WSL2 中由于systemd的限制自动安装服务可能会失败。请按以下步骤手动激活1. 修复全局路径 (关键)由于 NVM 路径较深且sudo环境下常找不到命令建议建立软链接# 替换为你实际的二进制路径 (可用 find /root/.nvm -name openclaw 查找)ln-sf/root/.nvm/versions/node/v22.22.1/bin/openclaw /usr/local/bin/openclaw2. 启动网关 (Gateway)OpenClaw 依靠网关运行。请开启一个独立的终端窗口执行openclaw gateway注意看到[gateway] listening on ws://127.0.0.1:18789表示启动成功。请保持此窗口开启。️ 第四阶段交互与管理1. 终端对话模式 (TUI)新开一个 WSL 窗口输入openclaw tui在这里你可以直接通过自然语言命令 AI 操控你的 16 核系统。2. 网页控制面板 (Dashboard)如果你喜欢图形化界面输入openclaw dashboard复制输出的http://127.0.0.1:18789/#tokenxxx链接在Windows 浏览器中打开。 常用维护命令功能命令重置会话/reset(在 TUI 中输入)查看可用工具/tools查看运行日志tail -f /tmp/openclaw/openclaw-$(date %F).log修改配置openclaw configure检查健康状态openclaw doctor 部署心得与排错Command Not Found: 切换到 root 后务必source ~/.bashrc或使用全路径/usr/local/bin/openclaw。Warn: apply_patch: 若日志提示unknown entries是因为配置了该工具但未安装对应插件不影响使用。权限问题: 在 WSL 中建议以root或具备sudo权限的用户运行否则 AI 无法执行系统级任务如读取/etc。文档结束。如果你在后续使用中需要增加网络搜索或图片生成功能只需要重新运行openclaw configure补全 API Key 即可