部署 OpenClaw：开源 AI 个人助手从安装到 QQ 机器人接入

什么是 OpenClaw？#

OpenClaw 是一个本地优先的开源 AI 个人助手框架，核心特性包括：

• 多平台聊天接入：支持 QQ、Telegram、Discord、微信等主流聊天平台
• 模型无关：可接入 Anthropic、OpenAI、DeepSeek、Moonshot 等多种 AI 模型
• 插件/技能系统：通过插件扩展功能，支持自定义技能
• 本地优先：数据存储在本地，保护隐私
• 可视化面板：内置 Dashboard 管理界面

支持的聊天渠道：

• QQ（通过 QQ 开放平台）
• Telegram
• Discord
• 微信（企业微信）
• Slack
• 命令行（CLI）

支持的 AI 模型提供商：

环境准备#

OpenClaw 基于 Node.js 运行，需要 Node.js 22+ 环境。

推荐使用 nvm 管理 Node.js 版本：

1
# 安装 nvm
2
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
3

4
# 安装 Node.js 22
5
nvm install 22
6
nvm use 22
7

8
# 验证版本
9
node --version  # 应该显示 v22.x.x

第一步：安装 OpenClaw#

通过 npm 全局安装 OpenClaw：

1
npm install -g openclaw

安装完成后验证：

1
openclaw --version

第二步：运行初始化向导#

首次安装完成后，运行初始化向导进行配置：

1
openclaw onboard

向导会引导你完成以下步骤。

安全提示#

初次运行时会显示安全提示，告知 OpenClaw 将在本地启动 Gateway 服务。确认后选择 Yes 继续。

选择 Onboarding 模式#

向导提供两种模式：

• QuickStart（推荐）：快速配置，适合大部分用户
• Advanced：高级配置，可自定义更多选项

建议选择 QuickStart 模式快速上手。

配置 AI 模型#

选择你要接入的 AI 模型提供商，填写对应的 API Key。

提供商	API Key 获取地址	备注
Anthropic	https://console.anthropic.com	Claude 系列模型
OpenAI	https://platform.openai.com	GPT 系列模型
OpenRouter	https://openrouter.ai	聚合多种模型
DeepSeek	https://platform.deepseek.com	国产高性价比
Moonshot	https://platform.moonshot.cn	Kimi 系列模型
本地模型	Ollama / LM Studio	无需 API Key

这里以 Kimi 2.5 为例，在 Moonshot 平台获取 API Key 后填入即可，其他提供商的配置流程类似。

选择聊天频道#

选择你要接入的聊天平台。可以选择多个频道，后续也可以在 Dashboard 中添加。

配置技能#

根据自己所需，如果你是Linux/mac，最好安装一下brew。

确认UI#

这是最后一步

选项	说明
**Hatch in TUI (recommended) **	直接在终端进入交互式 TUI 界面，与 Bot 对话并设定人设。推荐选择此方式。
Open the Web UI	打开浏览器中的 Web 控制面板完成初始化配置。
Do this later	跳过初始化流程，以后再进行设置。

选择 Hatch in TUI 后，会自动进入终端聊天界面：

1
openclaw tui - ws://127.0.0.1:18789 - agent main - session main

Bot 会发送 “Wake up, my friend!” 作为第一条消息。你可以开始和它对话，告诉它你的需求和偏好——描述越详细，后续体验越好。

退出 TUI：按 Ctrl+C 即可退出。Bot 的 Gateway 服务仍在后台运行。

1
openclaw status

1
openclaw dashboard

第三步：QQ 机器人接入#

将 OpenClaw 接入 QQ 机器人，需要完成以下步骤。

注册 QQ 开放平台#

1. 访问 QQ 开放平台
2. 使用手机 QQ 扫码登录或注册开发者账号
3. 完成开发者认证

创建 QQ Bot 机器人#

1. 登录后进入 QQ 机器人管理页面
2. 点击 创建机器人
3. 填写机器人基本信息（名称、头像、简介等）
4. 创建成功后，在机器人详情页获取 AppID 和 AppSecret

1
openclaw plugins install @sliverp/qqbot@latest
2

3
openclaw channels add --channel qqbot --token ""
4

5
openclaw gateway restart

使用#

安全注意事项#

• 不要将 Gateway 端口直接暴露到公网，避免未授权访问
• 如需远程访问，使用 反向代理（如 Nginx、Caddy）+ HTTPS 加密
• 定期更新 OpenClaw 到最新版本，获取安全修复
• API Key 等敏感信息不要提交到版本控制系统

常用命令#

总结#

通过本文，我们完成了以下步骤：

1. 安装 OpenClaw：通过 npm 全局安装
2. 初始化配置：运行向导完成 AI 模型和聊天频道配置
3. QQ 机器人接入：注册 QQ 开放平台、创建机器人、安装插件并配置

OpenClaw 的插件和技能系统非常灵活，建议进一步探索：

• 安装更多插件扩展功能
• 尝试接入不同的 AI 模型对比效果
• 自定义技能满足个性化需求

相关链接：

• OpenClaw 官网：https://openclaw.ai
• OpenClaw 文档：https://docs.openclaw.ai
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• QQ 开放平台：https://q.qq.com