简单说，OpenClaw 是一个自托管的 AI 网关，让你能通过 WhatsApp、Telegram、Discord、QQ 等聊天软件和 AI 对话。
本文作为 OpenClaw 的易上手安装使用教程，不再赘述关于 OpenClaw 的介绍，先把 OpenClaw 跑起来。
GitHub：https://github.com/openclaw/openclaw
安装
环境要求
OpenClaw 是 TypeScript 开发的项目，运行在 Node.js 上，程序运行至少需要1G内存，所以要满足以下最低配置。
机器最低配置：2H4G
预装环境：Node.js（版本 >= 22） 或 Docker，建议使用 nvm 或者 fnm 管理 Node.js
操作系统：Linux / MacOS，如果你的系统是Windows，强烈建议使用 WSL2
本地安装
方式一：官方一键安装脚本
此脚本会自动检测系统环境、完成 Node.js 和 OpenClaw 的安装。
curl -fsSL https: /openclaw.ai/install.sh | bash
官方安装脚本适用于 Linux / macOS 系统。Windows 需要开启 WSL2 后再运行，或者使用 npm 安装，强烈建议在 Linux /macOS 设备上安装使用 OpenClaw 。
方式二：npm 全局安装
# 安装 OpenClaw
npm install -g openclaw@latest
# 运行配置向导
openclaw onboard -install-daemon
openclaw 是使用openclaw的命令，可以使用openclaw -v查看版本。onboard 命令会引导你完成初始配置，包括选择模型、配置 API Key、设置消息频道等。 -install-daemon 参数会同时安装守护进程，让 OpenClaw 在后台持续运行。
初始化 OpenClaw 时会出现很多选项，如果不知道如何配置，可以参考下面部分选项。
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
这个是风险提示，按左右方向键选择 Yes 即可。
Onboarding mode 选择 QuickStart 模式
Model/auth provider 这里是选择模型提供商，我使用Google
Google auth method 选择 Google Gemini API key
How do you want to provide this API key? 选择Paste API key now
Enter Gemini API key 填入 相关 API key 即可
Select channel (QuickStart) 选择通讯工具，这里选择 Skip for now 先跳过
Search provider Skip for now
Configure skills now? (recommended) No
Enable hooks? Skip for now
How do you want to hatch your bot? 这里建议选择 Open the Web UI 开启面板，这样后续配置更方便
全部完成后会得到面板信息，程序默认运行在 18789 端口上，可以直接打开 web 面板。
◇ Dashboard ready ────────────────────────────────────────────────────────────────╮
│ │
│ Dashboard link (with token): │
│ http://127.0.0.1:18789/#token=3339cf36d14745439f48a4c8a175736de07d06bbf037d28c │
│ Copy/paste this URL in a browser on this machine to control OpenClaw. │
│ No GUI detected. Open from your computer: │
│ ssh -N -L 18789:127.0.0.1:18789 root@192.168.0.6 │
│ Then open: │
│ http://localhost:18789/ │
│ http://localhost:18789/#token=3339cf36d14745439f48a4c8a175736de07d06bbf037d28c │
│ Docs: │
│ https://docs.openclaw.ai/gateway/remote │
│ https://docs.openclaw.ai/web/control-ui │
│ │
├──────────────────────────────────────────────────────────────────────────────────╯
Docker 部署
Docker 部署的好处是简单方便，环境隔离、方便迁移。
直接使用官当仓库里的 docker-compose 快速启动
git clone https: /github.com/openclaw/openclaw.git
cd openclaw
docker-compose up -d
数据的持久化需要挂载两个目录：
volumes:
- ~/.openclaw:/root/.openclaw # 配置和状态数据
- ~/openclaw/workspace:/workspace # 工作空间
配置
openclaw.json配置
~/.openclaw/openclaw.json 文件是 OpenClaw 的配置文件，大部分功能的配置都在这里。
使用中转API
在openclaw.json添加配置。
"env": {
"MY_CUSTOM_API_KEY": "sk-这里填第三方密钥"
},
"models": {
"mode": "merge",
"providers": {
"my_provider": {
"baseUrl": "https://第三方接口地址/v1",
"apiKey": "${MY_CUSTOM_API_KEY}",
"api": "openai-completions",
"models": [
{
"id": "gpt-4o",
"name": "gpt-4o",
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
}
},
找到 agents 里面的 primary 模型设置，格式必须是 "提供商/模型名"
"agents": {
"defaults": {
"model": {
"primary": "my_provider/gpt-4o"
},
修改后需要重启服务
openclaw gateway restart
设置
mode: "merge"。这能保留系统内置的所有 Provider（如官方 Claude、Google 等），同时叠加自定义配置。如果不设置此项，自定义配置将会覆盖内置 Provider。在
models.providers的自定义配置块中，需要声明api协议标准。对于绝大多数第三方中转接口，该字段通常填写"openai-completions"或"openai-responses"。
另外，建议删除 agents.defaults.models 这个配置，因为这个字段其是一个模型白名单，它的作用是限制当前系统中允许被调用的所有模型，要么删除要么与使用的模型保持一致，建议删除。
社交配置
接入QQ
QQ 官方机器人申请地址：https://q.qq.com/qqbot/openclaw/login.html
1.安装OpenClaw开源社区QQBot插件
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
2.配置绑定当前QQ机器人
openclaw channels add --channel qqbot --token "bot账号:密钥"
3.重启本地OpenClaw服务
openclaw gateway restart
接入 TG
Telegram 配置
- 找 @BotFather 创建 Bot，保存 Token
- 配置: openclaw channels add --channel telegram --token "你的Token"
- 配对: openclaw pairing approve telegram 配对码
浏览器接入
打开openclaw.json配置文件，添加以下配置并重启:
"browser": {
"enabled": true,
"headless": false,
"executablePath": "/root/.cache/puppeteer/chrome/linux-146.0.7680.76/chrome-linux64/chrome",
"noSandbox": true,
"defaultProfile": "openclaw"
}
参数说明：
enabled: true：开启浏览器自动化能力。headless: true：无头模式（不弹出真实的浏览器窗口，在后台静默运行，服务器必备）。noSandbox: true：禁用沙盒（Linux 服务器环境下root运行 Chrome 往往需要这个参数）。executablePath：指定浏览器内核路径（明确告诉 OpenClaw 去哪里找浏览器启动程序）。defaultProfile：指定用户数据配置文件（让浏览器在启动时加载特定的“用户档案（Profile）”文件夹）。
命令
安装
# 全局安装OpenClaw
npm install -g openclaw@latest
# 初始化配置 + 安装守护进程
openclaw onboard -install-daemon
# 诊断检查，排查常见问题
openclaw doctor
# 查看当前版本
openclaw -version
使用
# 启动Gateway（详细日志模式）
openclaw gateway -port 18789 -verbose
# 重启Gateway（改配置后必须执行）
openclaw gateway restart
# 直接发送消息给Agent
openclaw agent -message "xxx"
# 设备配对（新设备首次连接）
openclaw devices pair
# 列出已配置的模型
openclaw models list
# 测试模型连通性
openclaw models status -probe
更新
# 更新到最新稳定版（推荐）
openclaw update -channel stable
# 更新到 Beta 版
openclaw update -channel beta
# 更新到开发版
openclaw update -channel dev
备份
# 完整备份
openclaw backup create
# 仅备份配置文件
openclaw backup create -only-config
# 验证备份
openclaw backup verify
v2026.3.8 之后的版本支持备份，在进行破坏性更新时建议先进行备份
权限
如果想让OpenClaw 读写所有文件，可以开启这个权限，注意此类操作权限风险较大。
openclaw config set tools.profile full
资源
社区资源
awesome-openclawskills
github.com/VoltAgent/awesome-openclaw-skills
5,494个精选Skill（已过滤问题 Skill）
awesome-openclawusecases
github.com/hesamsheikh/awesome-openclawusecases
社区用例合集
openclaw-claudecode-skill
github.com/Enderfga/openclaw-claude-codeskill
桥接Claude Code能力
openclaw-china插件
github.com/BytePioneer-AI/openclaw-china
钉钉/QQ/企微/微信接入
OpenClaw中文文档 openclaw.cc
0