2026 OpenClaw (小龙虾) 全能安装与配置指南

📅 2026/7/2 11:56:29 👁️ 阅读次数 📝 编程学习
2026 OpenClaw (小龙虾) 全能安装与配置指南

文章目录

    • 2026 OpenClaw (小龙虾) 全能安装与配置指南
      • 一、 三大主流安装方式对比
        • 1. 极简 CLI 模式 (推荐普通用户)
        • 2. 源码克隆模式 (推荐开发者)
        • 3. Docker 镜像模式 (推荐服务器/NAS 用户)
      • 二、 核心步骤:`openclaw onboard --install-daemon`
        • 1. Select the Database (选择数据库)
        • 2. Choose your LLM Provider (选择模型供应商)
        • 3. Enable Auto-Run on Boot? (是否开机自启)
        • 4. Configure Communication Channels (配置通信渠道)
        • 5. Persistence Mode (持久化模式)
      • 三、 安装后的“加固”与注意事项
        • 1. 解决“权限丧失” (Windows 重点)
        • 2. 网络“出口”一致性
        • 3. 环境变量丢失
      • 四、 总结:你的最优路径

2026 OpenClaw (小龙虾) 全能安装与配置指南

一、 三大主流安装方式对比

根据你的需求场景(是想简单用用,还是想深度开发),选择对应的“姿势”:

1. 极简 CLI 模式 (推荐普通用户)

这种方式最快,直接把openclaw变成系统命令。

  • 命令npm install -g openclaw@latest
  • 优点:不占空间,升级简单(npm update -g),适合直接拿来办公。
2. 源码克隆模式 (推荐开发者)

如果你想修改它的插件代码,或者给它写新的功能。

  • 命令

    git clone https://github.com/openclaw/openclaw.git cd openclaw && pnpm install
  • 优点:可以深度自定义,方便调试错误。

3. Docker 镜像模式 (推荐服务器/NAS 用户)

如果你想让小龙虾 24 小时挂在云服务器或者群晖上。

  • 命令docker pull openclaw/openclaw:latest
  • 优点:环境完全隔离,不会污染你电脑的 Node.js 环境。

二、 核心步骤:openclaw onboard --install-daemon

当你运行这个命令时,系统会尝试将 OpenClaw 安装为后台守护进程(Daemon)。这意味着即使你关掉终端窗口,小龙虾依然在后台帮你监控消息、执行任务。

运行后,你会面临一系列“夺命连环问”,以下是最佳选择建议

1. Select the Database (选择数据库)
  • 选项SQLite/PostgreSQL/Redis
  • 推荐SQLite
    • 原因:对于个人用户,SQLite 只是一个本地文件,不需要额外安装数据库软件,性能绰绰有余。
2. Choose your LLM Provider (选择模型供应商)
  • 选项OpenAI/Anthropic/DeepSeek/Custom (OpenAI Compatible)
  • 推荐
    • 追求性价比/国内直连:选DeepSeek
    • 追求最强智力:选Anthropic (Claude 3.5/4)
    • 注意:选完后会要求输入API Key
3. Enable Auto-Run on Boot? (是否开机自启)
  • 推荐Yes
    • 效果:电脑开机,小龙虾就自动在后台待命。
4. Configure Communication Channels (配置通信渠道)

这里决定了你通过哪里控制它:

  • WeChat/QQ:需要扫码登录。建议先选Terminal(终端测试),等调通了再回来改配置文件接入社交软件。
  • Telegram:如果你有科学上网环境且追求隐私,这是体验最好的渠道。
5. Persistence Mode (持久化模式)
  • 推荐Enabled
    • 效果:它会记住你之前的聊天上下文。如果关了,它每次重启都会“失忆”。

三、 安装后的“加固”与注意事项

1. 解决“权限丧失” (Windows 重点)

当你执行--install-daemon后,OpenClaw 会以系统服务运行。如果你发现它无法操作你的桌面窗口(比如不能帮你点开 Excel),通常是因为权限不够。

  • 对策:在“任务管理器”或“服务”中,找到 OpenClaw 进程,右键属性,确保它以“当前登录用户”身份运行,而不是“System”账户。
2. 网络“出口”一致性
  • 如果你在.env里配置了海外模型(如 Claude),但你的守护进程是在后台运行的,请确保你的系统全局代理是开启的,或者在 OpenClaw 的config.yaml里显式写死代理地址:

    proxy: http://127.0.0.1:7890
3. 环境变量丢失

有时候全局安装后,openclaw命令在重启后失效。

  • 检查:确保C:\Users\你的用户名\AppData\Roaming\npm已经在你的系统变量Path中。

四、 总结:你的最优路径

  1. 执行npm install -g openclaw@latest
  2. 执行openclaw onboard --install-daemon
  3. 数据库SQLite模型DeepSeek(国内最香),渠道先选Terminal
  4. 测试没问题了,再去~/.openclaw/config.yaml里修改channels接入你的微信或 QQ。

这样配置出来的“小龙虾”既稳定又懂事,不用翻墙也能跑得飞起!安装过程中如果卡在哪个具体的报错代码上,直接贴给我。