OpenClaw 安装配置与多渠道接入指南
OpenClaw 是一款支持系统级权限的 AI 自动化平台。其环境准备、三种安装方式(脚本、手动、Docker)、初始化配置流程以及网关启动方法。重点讲解了如何接入 WhatsApp、Telegram、飞书、钉钉和 Discord 等即时通讯渠道,并提供了核心功能使用与故障排除建议。适合希望部署自托管 AI Agent 的用户参考。

OpenClaw 是一款支持系统级权限的 AI 自动化平台。其环境准备、三种安装方式(脚本、手动、Docker)、初始化配置流程以及网关启动方法。重点讲解了如何接入 WhatsApp、Telegram、飞书、钉钉和 Discord 等即时通讯渠道,并提供了核心功能使用与故障排除建议。适合希望部署自托管 AI Agent 的用户参考。


OpenClaw 具备系统级权限(Agent Mode),意味着它可以执行 Shell 命令、访问文件系统等。因此,强烈建议在以下环境中运行:
最低硬件要求:
OpenClaw 提供了四种安装方式,你可以根据自己的需求选择。
这是一键式安装,自动检测系统环境并完成安装。
Windows PowerShell:
# 设置执行权限
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 运行一键脚本
iwr https://openclaw.ai/install.ps1 | iex
macOS / Linux Terminal:
# 直接运行脚本
curl -fsSL https://openclaw.ai/install.sh | bash
此脚本会自动安装 Node.js(≥22)并完成 CLI 配置。
如果你想自定义安装路径或贡献代码,可以手动安装。
# 1. 安装 Node.js (建议使用 nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
# 2. 安装 OpenClaw CLI
npm i -g openclaw@latest # 或者 pnpm add -g openclaw@latest
Docker 是最安全的运行方式,因为它将 OpenClaw 完全隔离在容器中。
docker run -d \
-p 18789:18789 \
-e OPENCLAW_ENDPOINT="http://127.0.0.1:18789" \
--restart unless-stopped \
ghcr.io/openclaw/openclaw:latest
Docker 镜像中已预装了 Node.js,省去了系统环境配置的麻烦。
安装完成后,你需要进行一次初始化向导来完成服务注册、模型配置和权限设置。
# 进入交互式配置向导
openclaw onboard
向导主要包括以下步骤:
⚠️ 权限警告:如果你选择了'无风险模式(No Risk)',OpenClaw 将仅作为一个聊天机器人,失去自动化执行任务的能力。
配置完成后,你需要启动网关服务并打开 Web Dashboard。
# 启动网关(默认端口 18789)
openclaw start
# 或者使用守护进程方式(推荐用于服务器)
openclaw onboard --install-daemon
网关默认监听 http://127.0.0.1:18789 ,可以通过浏览器访问 Web 控制面板。
打开浏览器,输入 http://127.0.0.1:18789 ,你将看到类似以下的控制面板:
OpenClaw 最强大的特性是可以通过聊天软件与 AI 交互。以下是接入 WhatsApp、飞书、钉钉和 Discord 的详细步骤。
WhatsApp 是最流行的接入方式之一。
# 安装 WhatsApp 渠道插件
openclaw add-channel whatsapp
# 按提示配置:
# 1. 输入你的 WhatsApp Business API Key
# 2. 输入你的手机号码(完整的国际区号格式)
# 3. 完成后重启服务
openclaw restart-whatsapp
WhatsApp 需要申请 Business API,建议使用第三方服务商(如 Twilio)。
Telegram 对开发者非常友好,免费且安全。
# 安装 Telegram 插件
openclaw add-channel telegram
# 按提示输入 Bot Token(通过 BotFather 创建机器人获取)
openclaw restart-telegram
飞书是中国企业内部沟通的主流工具,OpenClaw 对其支持非常友好。
# 安装通用插件包(包含飞书插件)
openclaw plugins install -china/channels
# 启用飞书 Channel
openclaw config set channels.feishu.enabled true
# 配置凭证(请替换 YOUR_APP_ID 和 YOUR_APP_SECRET)
openclaw config set channels.feishu.appId "YOUR_APP_ID"
openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"
# 配置安全策略(推荐配置)
openclaw config set channels.feishu.connectionMode "websocket"
# 推荐使用 websocket 连接
openclaw config set channels.feishu.dmPolicy "pairing"
# 私聊策略:仅已配对用户
openclaw config set channels.feishu.groupPolicy "allowlist"
# 群聊策略:仅白名单群聊
openclaw config set channels.feishu.requireMention true
# 群聊中必须 @机器人 才响应
说明:以上配置会在
-/.openclaw/openclaw.json中生成对应的 JSON 配置块。
# 重启网关以加载新配置
openclaw restart
在飞书中搜索你的 Bot 并发送 ping 或 !help,如果回复成功则表示接入成功。
钉钉是阿里巴巴推出的企业通讯工具,OpenClaw 对其也有完整支持。
# 同样使用通用插件包(已包含钉钉插件)
openclaw plugins install -china/channels
# 启用钉钉 Channel
openclaw config set channels.dingtalk.enabled true
# 配置凭证(请替换 YOUR_APP_KEY 和 YOUR_APP_SECRET)
openclaw config set channels.dingtalk.clientId "YOUR_APP_KEY"
openclaw config set channels.dingtalk.clientSecret "YOUR_APP_SECRET"
# 配置安全策略(推荐配置)
openclaw config set channels.dingtalk.connectionMode "websocket"
openclaw config set channels.dingtalk.dmPolicy "pairing"
openclaw config set channels.dingtalk.groupPolicy "allowlist"
openclaw config set channels.dingtalk.requireMention true
提示:钉钉的配置键名通常是
clientId和clientSecret,请参考实际插件文档。
# 重启网关
openclaw restart
在钉钉中私聊你的机器人或在群中 @机器人 发送 ping,如果收到回复则表示接入成功。
Discord 是全球流行的社交与社区平台,OpenClaw 的插件支持直接接入。
MzU2...)。# 安装 Discord 插件
openclaw plugins install -discord
# 启用 Discord Channel
openclaw config set channels.discord.enabled true
# 配置 Bot Token
openclaw config set channels.discord.token "YOUR_BOT_TOKEN"
# 配置安全策略(推荐配置)
openclaw config set channels.discord.connectionMode "websocket"
openclaw config set channels.discord.dmPolicy "pairing"
openclaw config set channels.discord.groupPolicy "allowlist"
openclaw config set channels.discord.requireMention true
说明:Discord 通常只需要填入 Bot Token,其他策略默认即可,但强烈建议开启
requireMention防止被刷屏。
# 重启网关
openclaw restart
在 Discord 服务器中私聊 Bot 或在频道中 @Bot 发送 !help,如果 Bot 回复帮助信息则表示接入成功。
配置完成后,你可以像使用 ChatGPT 那样开始对话,并利用它的强大功能。
在 Dashboard 或你的聊天软件中输入:
帮我检查一下 `/etc/hosts` 文件是否被篡改?
如果 Agent 有 Shell 权限,它会自动读取文件内容并回复。
OpenClaw 支持多种插件,例如:
你可以通过指令启用或查看插件列表:
# 查看已安装的插件
openclaw skills list
# 启用 Bash 插件(危险操作,请确保安全)
openclaw skills enablebash
在对话中输入以下格式的指令,OpenClaw 会自动生成脚本并执行:
写一个 Bash 脚本,每隔 5 分钟检查一次 CPU 使用率是否超过 80%,如果超过就发送邮件提醒。
它会输出脚本内容,并提示你是否执行。
node -v 检查版本,必须是 22+。-p 18789:18789 正确。Port 18789 被占用:
# 查看占用情况
lsof -i:18789
# 更改端口(编辑配置文件)
nano ~/.config/openclaw/config.yaml
使用 pm2 管理进程:确保服务异常退出后自动重启。
npm install -g pm2
pm2 start "$(which openclaw)" --name openclaw
pm2 save
OpenClaw 是开源项目。如果你想自定义 Agent 行为或开发新插件:
plugins/ 目录下编写新的插件。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online