avatar
文章
649
标签
2112
分类
180
开发
  • 大前端
  • 人工智能
  • 小程序
  • 桌面应用
  • 游戏开发
服务器&网络
  • 服务器
  • 网络
归档
标签
友链
联系我们
仰观苍穹思环宇
开发
  • 大前端
  • 人工智能
  • 小程序
  • 桌面应用
  • 游戏开发
服务器&网络
  • 服务器
  • 网络
归档
标签
友链
联系我们

OpenClaw在Debian虚拟机上的完整安装与避坑指南

发表于2026-04-08|更新于2026-09-12|AI
linuxopenclawdeepseekdebian
cover of previous post
上一篇
Shopify Vision主题自定义锚点导航实现指南
cover of next post
下一篇
Hostinger多站点WordPress媒体404日志分析与自动修复脚本实现批量扫描去重统计精准IP过滤与安全修复
相关推荐
cover
2024-06-06
Fail2ban的功能和特性
cover
2024-05-27
Linux 服务器日常巡检脚本及常见问题解决方案
cover
2024-07-02
Linux压缩命令tar之排除不需要的文件或者目录(--exclude)
cover
2023-03-24
Linux基本磁盘
cover
2026-03-04
Linux服务器文件替换脚本实战指南脚本支持多模式覆盖预览确认自动备份日志记录权限恢复与生产级运维最佳实践
cover
2026-03-12
WordPress开发者问题排查完整指南从浏览器调试Enfold主题JavaScript错误定位到日志体系debug log error log access log的系统化排查思维与工具清单
avatar
鸢尾花序
文章
649
标签
2112
分类
180
联系我们
目录
  1. 1. 一、背景说明
  2. 2. 二、标准安装流程（推荐路径）
    1. 2.1. 1️⃣ 安装 Node.js（建议使用 nvm）
    2. 2.2. 2️⃣ 安装 nvm（Node 版本管理）
    3. 2.3. 3️⃣ 安装 Node 24
    4. 2.4. 4️⃣ 加速 npm（关键优化）
    5. 2.5. 5️⃣ 安装 OpenClaw
    6. 2.6. 6️⃣ 初始化并启动
    7. 2.7. 7️⃣ 验证运行状态
  3. 3. 三、关键问题与解决方案
  4. 4. 1️⃣ Windows 安装失败
    1. 4.1. 现象：
    2. 4.2. 结论：
  5. 5. 2️⃣ nvm command not found
    1. 5.1. 原因：
    2. 5.2. 解决：
  6. 6. 3️⃣ systemd + nvm 冲突
    1. 6.1. 现象：
    2. 6.2. 原因：
    3. 6.3. 解决方案（推荐）：
  7. 7. 4️⃣ 无法外部访问（127.0.0.1 限制）
    1. 7.1. 现象：
    2. 7.2. 原因：
    3. 7.3. 解决方案：
  8. 8. 5️⃣ 浏览器报错（安全上下文）
    1. 8.1. 原因：
    2. 8.2. 解决：
  9. 9. 6️⃣ token 未授权问题
    1. 9.1. 解决：
  10. 10. 7️⃣ 跨域限制（origin not allowed）
    1. 10.1. 解决：
  11. 11. 四、推荐的开发环境最佳实践
    1. 11.1. ✅ 推荐架构
    2. 11.2. ✅ 推荐启动方式
    3. 11.3. ✅ 可选增强（自动重连）
  12. 12. 五、完整流程总结（精简版）
  13. 13. 六、经验总结
  14. 14. 七、一句话总结
  15. 15. OpenClaw在Debian虚拟机上的完整安装与避坑指南补充版
  16. 16. 八、防火墙配置（很多人会忽略的关键点）
    1. 16.1. 1️⃣ 查看防火墙状态
    2. 16.2. 2️⃣ 如果防火墙开启（active）
    3. 16.3. 3️⃣ 或者直接关闭防火墙（开发环境推荐）
  17. 17. 九、跨域问题 origin not allowed 解决
    1. 17.1. 1️⃣ 报错说明
    2. 17.2. 2️⃣ 修改配置文件位置
    3. 17.3. 3️⃣ 添加配置（关键）
    4. 17.4. 4️⃣ 修改前后对比（方便小白理解）
    5. 17.5. 5️⃣ 修改后必须重启
    6. 17.6. 6️⃣ 小白注意事项
    7. 17.7. 7️⃣ 开发环境偷懒方案
  18. 18. 十、nvm 永久生效（避免每次失效）
    1. 18.1. 1️⃣ 原因
    2. 18.2. 2️⃣ 正确做法（必须执行）
    3. 18.3. 3️⃣ 立即生效
    4. 18.4. 4️⃣ 验证
    5. 18.5. 5️⃣ 设置默认 Node 版本（关键）
  19. 19. 十一、小白最容易踩的几个坑总结
    1. 19.1. ❌ 1. node 装了但版本不对
    2. 19.2. ❌ 2. nvm 装了但命令不可用
    3. 19.3. ❌ 3. openclaw 启动失败（systemd）
    4. 19.4. ❌ 4. 只能 localhost 访问
    5. 19.5. ❌ 5. 浏览器打不开 UI
    6. 19.6. ❌ 6. origin not allowed
    7. 19.7. ❌ 7. 能访问但打不开
  20. 20. 十二、最终推荐的“最稳方案”（小白无脑版）
  21. 21. 十三、一句话终极总结
  22. 22. 十四、关于 localhost 访问的一些补充说明（容易忽略但很关键）
  23. 23. 一、重要结论（必须理解）
  24. 24. 二、为什么有时候 localhost 也访问不了
  25. 25. 1️⃣ 浏览器问题（非常常见）
    1. 25.1. 现象：
    2. 25.2. 原因：
    3. 25.3. 解决方法：
  26. 26. 2️⃣ 本地开启了代理 / VPN（高概率问题）
    1. 26.1. 现象：
    2. 26.2. 原因：
    3. 26.3. 解决方法：
  27. 27. 3️⃣ SSH 隧道未建立或断开
    1. 27.1. 检查方式：
    2. 27.2. 常见问题：
    3. 27.3. 解决：
  28. 28. 4️⃣ 端口被占用
    1. 28.1. 检查：
    2. 28.2. 如果被占用：
  29. 29. 三、小白快速排查流程（强烈推荐）
    1. 29.1. Step 1️⃣ 确认 SSH 是否连接成功
    2. 29.2. Step 2️⃣ 确认隧道是否在运行
    3. 29.3. Step 3️⃣ 换浏览器（Edge 测试）
    4. 29.4. Step 4️⃣ 关闭代理 / VPN
    5. 29.5. Step 5️⃣ 换端口测试
  30. 30. 四、一个非常重要的认知
  31. 31. 五、最终经验总结
    1. 31.1. 稳定访问的最佳实践：
  32. 32. 六、一句话总结
  33. 33. 十五、如何在 OpenClaw 中接入大模型（以 DeepSeek 为例）
  34. 34. 一、整体流程概览
  35. 35. 二、初始化配置（建议执行一次）
    1. 35.1. 参数说明：
  36. 36. 三、检查服务状态
  37. 37. 四、获取 DeepSeek API Key
  38. 38. 五、配置 DeepSeek Provider（核心步骤）
  39. 39. 六、设置默认模型
  40. 40. 七、创建模型别名（可选但推荐）
  41. 41. 八、重启服务
  42. 42. 九、验证是否配置成功
  43. 43. 十、常见问题与解决方案
  44. 44. ❌ 1. 配置后模型不可用
    1. 44.1. 原因：
    2. 44.2. 解决：
  45. 45. ❌ 2. 请求报错 401 / unauthorized
    1. 45.1. 原因：
  46. 46. ❌ 3. 请求超时 / 无响应
    1. 46.1. 原因：
    2. 46.2. 解决：
  47. 47. ❌ 4. models.providers 配置写错
    1. 47.1. 常见错误：
  48. 48. ❌ 5. JSON 写错（非常常见）
    1. 48.1. 现象：
    2. 48.2. 解决：
  49. 49. 十一、进阶建议（推荐）
    1. 49.1. ✅ 使用环境变量管理 API Key
    2. 49.2. ✅ 多模型切换
  50. 50. 十二、完整流程总结（精简版）
  51. 51. 十三、一句话总结
  52. 52. 十四、延伸方向
  53. 53. 十六、如何在 OpenClaw 中接入 OpenAI
  54. 54. 一、获取 OpenAI API Key
  55. 55. 二、配置 OpenAI Provider
  56. 56. 三、设置默认模型（可选）
  57. 57. 四、重启服务
  58. 58. 五、验证模型
  59. 59. 十七、多模型共存（推荐架构）
  60. 60. 十八、如何在不同任务中切换模型（核心能力）
  • ✅ 方式一：全局默认模型
  • ✅ 方式二：在 Agent 中指定模型（推荐）
    1. 1. 示例：不同任务用不同模型
    2. 2. 使用效果：
  • ✅ 方式三：命令行指定模型（临时切换）
  • ✅ 方式四：使用模型别名（强烈推荐）
    1. 1. 十九、推荐模型分工策略（实战经验）
    2. 2. 二十、进阶：模型分层策略（推荐）
    3. 3. 二十一、常见坑总结
      1. 3.1. ❌ 1. 模型名字写错
      2. 3.2. ❌ 2. provider 没配置
      3. 3.3. ❌ 3. 忘记重启
      4. 3.4. ❌ 4. API 不匹配
    4. 4. 二十二、一句话总结
    5. 5. 二十三、进阶方向（下一步可以做）
    6. 6. OpenClaw 两种启动模式详解与标准操作流程
    7. 7. 一、两种启动模式总览
    8. 8. 二、模式一：后台服务模式（systemd）
      1. 8.1. 1️⃣ 启动方式
      2. 8.2. 2️⃣ 查看状态
      3. 8.3. 3️⃣ 停止服务
      4. 8.4. 4️⃣ 特点
      5. 8.5. 5️⃣ 适用场景
    9. 9. 三、模式二：前台运行模式（CLI）
      1. 9.1. 1️⃣ 启动方式
      2. 9.2. 2️⃣ 停止方式
      3. 9.3. 3️⃣ 特点
      4. 9.4. 4️⃣ 适用场景
    10. 10. 四、为什么会冲突（核心原理）
    11. 11. 五、常见冲突报错
    12. 12. 六、标准操作流程（避免冲突）
  • ✅ 场景一：开发环境（推荐）
    1. 1. 标准流程：
    2. 2. 配合 SSH 隧道：
  • ✅ 场景二：生产环境
    1. 1. 标准流程：
    2. 2. ❗ 注意：
    3. 3. 七、冲突时的解决流程（通用）
      1. 3.1. Step 1️⃣ 查占用
      2. 3.2. Step 2️⃣ 判断来源
      3. 3.3. Step 3️⃣ 停止服务
      4. 3.4. Step 4️⃣ 重新启动
    4. 4. 八、进阶技巧（避免再次踩坑）
      1. 4.1. ✅ 1. 启动前先检查
      2. 4.2. ✅ 2. 固定使用一种模式
      3. 4.3. ✅ 3. 不要混用
      4. 4.4. ✅ 4. 修改端口（多实例）
    5. 5. 九、推荐最佳实践
    6. 6. 十、一句话总结
    7. 7. 十七、cpolar 内网穿透访问出现 pairing required 的原因与解决方案
    8. 8. 一、问题本质（关键点）
    9. 9. ⚠️ OpenClaw 的“设备绑定机制”触发了
    10. 10. 二、为什么 SSH 可以，但 cpolar 不行？
      1. 10.1. 你之前成功的方式：
      2. 10.2. 现在的方式：
    11. 11. 三、解决方案（推荐三种）
  • ✅ 方案一：允许公网来源 + 关闭严格设备校验（推荐）
    1. 1. 🔧 添加这一段（核心）
    2. 2. 然后重启：
  • ✅ 方案二：改为“开发模式”（最简单）
  • ✅ 方案三：使用反向代理“伪装 localhost”（高级方案）
    1. 1. 四、为什么会有 pairing 机制（设计原因）
    2. 2. 五、你当前最佳方案建议
    3. 3. ✅ 用这个配置：
    4. 4. 六、如果还是出现 pairing（进阶排查）
      1. 4.1. 1️⃣ 清理浏览器缓存
      2. 4.2. 2️⃣ 换浏览器（Edge）
      3. 4.3. 3️⃣ 关闭 VPN / 代理
      4. 4.4. 4️⃣ 确认访问地址一致
    5. 5. 七、终极理解（非常重要）
    6. 6. 八、一句话总结
    7. 7. 十八、开发模式下如何正确停止 OpenClaw
    8. 8. 一、最标准停止方式（推荐）
    9. 9. 二、如果窗口关闭了怎么办（常见情况）
      1. 9.1. ✅ 解决方法：手动查进程
      2. 9.2. 然后杀掉：
    10. 10. 三、另一种更精准方式（推荐）
    11. 11. 四、快速一键清理（懒人用法）
    12. 12. 五、如何确认已经停止
    13. 13. 六、开发模式 vs 后台模式停止对比
    14. 14. 七、最容易犯的错误（一定要避免）
      1. 14.1. ❌ 错误操作：
    15. 15. 八、推荐开发习惯（很重要）
    16. 16. 九、一句话总结
    • 最新文章
    Hexo静态博客添加联系表单:用Google Apps Script实现邮件直达
    Hexo静态博客添加联系表单:用Google Apps Script实现邮件直达2026-09-17
    白手起家没有资源的人如何通过资源整合一步步突破认知并打通合作路径的完整分析
    白手起家没有资源的人如何通过资源整合一步步突破认知并打通合作路径的完整分析2026-09-15
    独立站定位四步法服务谁、解决什么、凭什么是你、怎么赚钱——WordPress独立站从模糊定位到清晰战略的完整框架
    独立站定位四步法服务谁、解决什么、凭什么是你、怎么赚钱——WordPress独立站从模糊定位到清晰战略的完整框架2026-09-15
    Duplicator全量迁移WordPress后HTTPS挂了正确做法是只换wp-content并在duplicator部署网站的时候1Panel里把数据库host填成mysql而不是localhost
    Duplicator全量迁移WordPress后HTTPS挂了正确做法是只换wp-content并在duplicator部署网站的时候1Panel里把数据库host填成mysql而不是localhost2026-09-15
    多设备Hexo安装Butterfly主题里面博客search.xml过大导致GitHub推送失败的完整解决方案(含交互式清理脚本)
    多设备Hexo安装Butterfly主题里面博客search.xml过大导致GitHub推送失败的完整解决方案(含交互式清理脚本)2026-09-14
    告别逐个转换用md2pdf一键批量把Markdown变成PDF
    告别逐个转换用md2pdf一键批量把Markdown变成PDF2026-09-14
    Hexo+Butterfly主题search.xml过大导致GitHub推送失败之完整排查与解决SOP
    Hexo+Butterfly主题search.xml过大导致GitHub推送失败之完整排查与解决SOP2026-09-14
    用Python批量给Hexo文章自动补齐TDK：DeepSeek驱动、严格YAML、动态备份的完整实践
    用Python批量给Hexo文章自动补齐TDK：DeepSeek驱动、严格YAML、动态备份的完整实践2026-09-12
    ©2022 - 2026 By 鸢尾花序