在这里插入图片描述

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。

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

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐