一、安装龙虾

OpenClaw 需要 Node.js 22+的运行环境，如果想加快安装速度的，可以先自行下载并安装好以下基础环境

• node.js
• git
• python

基本上有手就行，保持默认安装就可以了

本地部署：标准模式

如果你想操作自己电脑上的文件，那么推荐用终端安装方式,一个命令可以完成基础环境、龙虾本体的安装

什么是终端？

备注：终端是一个文字界面，你输入命令，电脑执行。 打开方式：

• Windows：按Win + X，选择"终端"或"PowerShell"
• macOS：按Cmd + 空格，搜索"Terminal"
• Linux：按Ctrl + Alt + T

1.开始安装

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）

打开 PowerShell（必须是管理员模式），运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
iwr -useb https://openclaw.ai/install.ps1 | iex

命名运行后出现下面的安全提示，选是：

到这里时先选No，一会再配置

2.验证安装是否成功

openclaw -v

如果出现上图的日期则代安装成功

3.激活龙虾

安装OpenClaw 后，需要通过 Onboarding（配置向导） 给龙虾装大脑。

在终端执行下面的命令

openclaw onboard

小提示：设置为开机启动模式

如果想让 OpenClaw 能在后台持续运行（即使关闭终端 / 退出应用），并随系统开机自动启动

openclaw onboard --install-daemon

运行后看到这个提示时选yes

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?

向导启动后会问你第一个问题：QuickStart（快速开始） 还是 Manual（高级模式、专家模式）？ 对于大多数刚开始接触OpenClaw的用户，建议都选QuickStart.

步骤一：模型与认证

先到阿里云百炼平台注册一个账号，新用户可以免费领取7000万token额度

领取详细步骤

第1步：注册阿里云账号,并完成实名认证（支付宝扫认证二维码就可以了）

第2步：完成认证后到阿里云百炼领免费额度

点左侧工作台下的模型用量，在右侧找到qwen-plus-2025-07-28,点击打开开关

接下来到密钥管理，创建ApiKey

选择用户名就可以了

在ApiKey这里点复制

完成上面的步骤后，开始选择模型提供商和认证方式，选择Custom Provider模式（最通用、最灵活), 这里以阿里云平台提供的服务为例，依次填写：

步骤	内容	填写
1. 选择兼容类型	OpenAI-compatible / Anthropic-compatible / Unknown（自动检测）	OpenAI-compatible
2. 输入 Base URL	提供商的 API 地址	https://dashscope.aliyuncs.com/compatible-mode/v1
3. 输入 API Key	不知道的看上面的领取步骤	供应商给你的ApiKey sk-custom-...
4. 填写 Model ID	模型标识符	qwen-plus-2025-07-28
5. 设置别名（可选）	方便记忆的短名称	bailian
6. 设置 Endpoint ID	区分多个自定义端点	mycompany

如下图所示：

第1步就完成了，下方的资料可以不用看，接下来进入步骤2.

高级设置：多个自定义端点共存

每个 Custom Provider 通过 Endpoint ID 区分，所以你可以同时配置多个自定义端点：

// openclaw.json 示例
{
  "models": {
    "providers": {
      "custom-company-a": {
        "type": "openai",
        "baseUrl": "https://api.company-a.com/v1",
        "apiKey": "sk-a-..."
      },
      "custom-company-b": {
        "type": "anthropic",
        "baseUrl": "https://api.company-b.com/v1",
        "apiKey": "sk-b-..."
      }
    }
  }
}

安全提示：模型选择与工具安全

如果你的龙虾会运行工具（执行命令、调用 API）或处理来自 Webhook/Hooks 的外部内容，请注意：

• 优先选择最新一代的强模型——较弱/较旧的模型更容易被提示词注入攻击
• 保持严格的工具策略——避免使用tools.profile: "full"（不限制模式），除非你完全信任所有输入来源
• 详细查看

密钥存储：明文 vs SecretRef

向导默认将 API Key 以明文存储在配置文件中。如果你需要更安全的存储方式：

交互模式：选择 Secret Reference 模式，可以指向环境变量或 Provider Ref（文件/可执行程序），向导会立即验证引用是否有效。

非交互模式：使用 --secret-input-mode ref，此时提供商的环境变量必须已设置：

export OPENAI_API_KEY="sk-..."
openclaw onboard --secret-input-mode ref --non-interactive

步骤二：工作区

程序自动配置龙虾的工作目录，存放 IDENTITY.md、MEMORY.md 等工作区文件。

• 默认路径：~/.openclaw/workspace/
• 如果路径下已有工作区文件，向导会复用而非覆盖

步骤三：Gateway 配置

程序自动设置的Gateway运行参数：

• 端口：默认 18789
• 绑定地址：默认 127.0.0.1（仅本机）
• 认证模式：Token 或密码
• Tailscale 暴露：是否通过 Tailnet 访问，默认为false

Gateway Token 与 SecretRef

在交互式 Token 模式下，你可以选择：

• 明文 Token（默认）：存储在配置文件中
• SecretRef：通过环境变量或外部程序管理 Token

非交互模式下使用 SecretRef：

openclaw onboard --gateway-token-ref-env GATEWAY_TOKEN --non-interactive

注意：如果同时配置了 gateway.auth.token 和 gateway.auth.password 但未设置 gateway.auth.mode，后台服务安装会被阻止，直到你明确选择一种模式。

步骤四：渠道接入

手动跳过(选skip)，都是国外的软件

后续用 openclaw channels add 随时添加。

步骤五：Web 搜索配置

这个配置是让龙虾能使用 web_search 工具，先跳过

后续用openclaw configure --section web随时添加

步骤六：安装技能

Skill 就是让 OpenClaw 从「只会聊天的 AI」，变成「能帮你干具体活的工具人」的关键插件。

先跳过，后续在网页界面配置

步骤七、启动钩子

选日志记录、对话记忆

步骤八：激活机器人的方式

选网页方式，敲回车后会打开网页，安装完成

4. 重新配置与维护

4.1 重新运行向导

openclaw configure

与 openclaw onboard 的区别：configure 用于修改现有配置，onboard 用于首次设置。两者流程类似，但 configure 不会重新安装后台服务。

4.2 重置配置

# 默认重置：配置、凭证、会话
openclaw onboard --reset

# 完整重置：包括工作区
openclaw onboard --reset --reset-scope full

⚠️ --reset 会清除现有配置，请谨慎使用。如果只是想修改某项配置，用 openclaw configure 更安全。

4.3 配置异常处理

如果配置文件损坏或包含过时的字段，向导会提示你先运行诊断：

openclaw doctor

doctor 命令会自动检测并修复常见问题，包括服务注册、配置格式和凭证有效性。

非交互模式（脚本化部署）

在 CI/CD 或批量部署场景中，可以使用非交互模式跳过所有交互式提问：

openclaw onboard \
  --non-interactive \
  --auth-choice openai-api-key \
  --install-daemon

注意事项：

• --json 标志不代表非交互模式，它只是改变输出格式
• 非交互模式下必须通过命令行参数或环境变量提供所有必要配置
• 使用--secret-input-mode ref 时，对应的环境变量必须已设置

---

5. 常见问题

Q：向导配置的文件存在哪里？

主配置文件在 ~/.openclaw/openclaw.json，工作区文件在 ~/.openclaw/workspace/。

Q：跑完向导后最快的方式开始聊天是什么？

打开浏览器 Dashboard（无需任何渠道配置），在浏览器中输入http://127.0.0.1:18789/

或者使用下面的命令：

openclaw dashboard

Q: Windows 上运行 openclaw 提示"命令未找到"？

A: PowerShell 默认禁止执行脚本。以管理员身份运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后重新打开终端。

Q: 提示"API key not found"怎么办？

A: 编辑 ~/.openclaw/openclaw.json（Windows 上是 C:\Users\你的用户名\.openclaw\openclaw.json），确保 API 密钥配置正确。参考模型与认证的配置示例。

Q: 机器人回复很慢或超时？

A: 可能是模型响应慢，尝试换一个模型。

Q: 安装脚本下载很慢或超时？

A: 可能是网络问题。可以尝试使用代理，或者多试几次。如果始终无法下载，可以手动访问 https://openclaw.ai/install.sh（或 .ps1）保存到本地后执行。

本地部署：预制菜模式

国内提供 OpenClaw 桌面端的厂家及产品如下，均为本地安装/桌面客户端形态，覆盖主流场景：

厂家	产品名称	核心定位	平台	官网/入口
腾讯	QClaw	本地一键部署，企业微信/QQ原生接入	Windows、macOS（内测）	腾讯电脑管家渠道
智谱	AutoClaw（澳龙）	浏览器自动化，一键安装	Windows、macOS	https://autoglm.zhipuai.cn/autoclaw/
猎豹移动	EasyClaw	轻量化本地工具，个人免费，每天200免费积分	Windows	https://easyclaw.com/zh-cn

个人不推荐使用这种一键安装包模式，因为厂商可能会改了OpenClaw默认的文件夹，会塞一堆东西进来、会禁止你换模型，会预装一堆不需要的技能（导致token烧钱速度更快）。

云端部署

使用云端部署方式，就无法用龙虾操作本地电脑的文件了，并且需要额外支付服务器成本,目前国内三大厂商均提供云端Openclaw一键开通服务

维度	腾讯云	阿里云	火山引擎
部署难度	★☆☆☆	★★☆☆	★★☆☆
最快跑通	5 分钟	10 分钟	10 分钟
核心优势	IM 接入教程最全	标准化镜像，出问题好恢复	订阅制，费用可预测
模型计费	按量（活动期送 tokens）	按量（绑定百炼平台）	订阅制（Coding Plan）
适合谁	国内 IM 用户（企微/QQ/钉钉/飞书）	追求稳定可靠、标准化 SOP 的用户	开发者、想要可预测费用的用户