手把手教你部署OpenClaw(保姆级教程)

OpenClaw 是一个强大的本地 AI 助手框架，支持多种通道（QQ、WeChat、Telegram、Discord 等）和丰富的技能系统。

本教程部分内容参考了Bilibili的UP主“技术爬爬虾”点击我跳转视频

环境要求

  • 操作系统：Windows 10/11, macOS, Linux
  • Node.js：v22+
  • npm

一、安装OpenClaw

这里以Windows为例子，推荐下载LTC长期支持版本

Node.js — 下载 Node.js®

1.安装NodeJS

claw01

2.安装OpenClaw

npm install -g openclaw@latest

3.初始化配置

openclaw onboard --install-daemon

I understand this is powerful and inherently risky. Continue?
│  ● Yes / ○ No	#这里选择yes

Onboarding mode
│  ● QuickStart (Configure details later via openclaw configure.)	#快速开始
│  ○ Manual

Model/auth provider
│  ○ OpenAI
│  ○ Anthropic
│  ● MiniMax	#推荐使用国内模型，开通29元套餐即可
│  ○ Qwen (OAuth)
│  ○ Synthetic
│  ○ Venice AI
│  ○ Google
│  ○ Copilot
│  ○ OpenRouter
│  ○ Vercel AI Gateway
│  ○ Moonshot AI
│  ○ Z.AI (GLM 4.7)
│  ○ Xiaomi
│  ○ OpenCode Zen
│  ○ Skip for now

Default model
│  ● Keep current (minimax-cn/MiniMax-M2.5)	#这里保持默认
│  ○ Enter model manually
│  ○ qwen-portal/coder-model
│  ○ qwen-portal/vision-model

Select channel (QuickStart)
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Tlon (Urbit)
│  ● Skip for now (You can add channels later via `openclaw
channels add`)	#我这里选择跳过，后续手动配置QQ-Bot

Configure skills now? (recommended)
│  No	#跳过安装技能，后续通过WebUI配置
│
◇  Homebrew recommended ──────────────────────────────╮
│                                                     │
│  Many skill dependencies are shipped via Homebrew.  │
│  Without brew, you'll need to build from source or  │
│  download releases manually.                        │
│                                                     │
├─────────────────────────────────────────────────────╯

Enable hooks?
│  ◼ Skip for now	#这里选择跳过
│  ◻ 🚀 boot-md (Run BOOT.md on gateway startup)
│  ◻ 📝 command-logger (Log all command events to a centralized
audit file)
│  ◻ 💾 session-memory (Save session context to memory when /new
command is issued)

Gateway service already installed
│  ● Restart	#因为我这里之前安装过，我就不重复安装了，你需要选择install
│  ○ Reinstall
│  ○ Skip

How do you want to hatch your bot?
│  ○ Hatch in TUI (recommended)
│  ● Open the Web UI	#为了方便管理，使用webui
│  ○ Do this later

4.访问WebUI

强烈建议不要把网关暴露到公网！！！

#打开浏览器输入以下内容
http://127.0.0.1:18789/?token=你的终端输出的token

如果忘记了token，可以在这个文件内查看C:\Users\你的用户名\.openclaw\openclaw.json

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "123456789000000000"    #这里就是你唯一的token
    },

claw02

5.打开权限(重要)

由于新版的OpenClaw削弱了默认的权限，如果这一步不修改的话，你的OpenClaw很难独立完成复杂任务，只是一个普通的聊天工具

claw04

"tools": {
    "profile": "full",	#这里更改
    "web": {
      "search": {
        "enabled": false	#这里是禁用默认搜索插件，后面会用到
      }
    }
  },

二、配置QQ-Bot

1.安装QQ-Bot插件

openclaw plugins install @sliverp/qqbot@latest

2.注册QQ-Bot

快速注册创建QQ机器人

claw03

3.配置QQ-Bot

openclaw channels add --channel qqbot --token "你的AppID:你的AppSeret"

以上步骤配置完成，就可以通过QQ-Bot和OpenClaw对话了

OpenClaw基本安装完成，以下是推荐安装的技能(Skills)和其他配置，推荐继续往下看。

三、配置Skills

所有的skills推荐使用这个网站进行搜索下载ClawHub

安装Skills的方法

方式一：直接把链接丢给OpenClaw

claw05

claw06

方式二：使用命令工具安装

npm install -g clawhub@latest

clawhub search "你在ClawHub上看到skills的名字" #搜索skills,不保留双引号

clawhub install "skills名字"	#安装skills,不保留双引号

clawhub update --all	#更新所有skills

方式三：手动下载离线安装

适用于网络条件不好的人群

claw07

claw08

然后把文件放到C:\Users\你的用户名\.openclaw\workspace\skills下

最后交给OpenClaw手动帮你编译安装

claw09

推荐安装的几个skills

技能名称功能
skill-vetter(推荐必须安装)skill安全审查
tavily-searchAI 优化搜索
multi-search-engine多引擎搜索
self-improvingOpenClaw自我提升
weather天气查询
find-skills(有风险，可能会安装带有隐患的skills，所以推荐先安装skill安全审查后安装)自动查找安装需要的skills

搜索引擎提示词优化

因为OpenClaw默认的搜索插件需要配置APIKEY，所以调用默认的搜索插件会报错

推荐安装了tavily-search和multi-search-engine后更改

**修改文件C:\Users\你的用户名\.openclaw\workspace\TOOLS.md**增加以下内容

## Web Search

Use the openclaw-tavily-search skill as the top-priority search tool when do web search.

If the question requires searching for more relevant knowledge, use multi-search-engine skill as an alternative solution.

禁用默认搜索插件

推荐安装了tavily-search和multi-search-engine后更改

修改文件"C:\Users\你的用户名\.openclaw\openclaw.json"增加以下内容

  "tools": {
    "profile": "full",
    "web": {
      "search": {
        "enabled": false	#这里是禁用默认搜索插件
      }
    }
  },

四、拓展

OpenClaw常用命令格式

命令功能
openclaw status查看状态
openclaw gateway start启动服务
openclaw gateway stop停止服务
openclaw gateway restart重启服务
openclaw config edit编辑配置
openclaw config get <key>查看配置项
openclaw config set <key> <value>设置配置项
openclaw logs --follow查看日志