跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表
JavaScriptNode.jsAI

OpenClaw 安装部署与渠道接入指南

综述由AI生成OpenClaw 是一款支持系统级权限的 AI Agent 工具,允许用户在本地或私有环境中运行自动化任务。从环境准备、多方式安装(脚本/手动/Docker)、初始化配置到网关启动的完整流程。重点涵盖了权限安全设置及多渠道接入方案(包括飞书、钉钉、WhatsApp 等),并提供了核心功能使用示例与故障排查指南。适合希望构建自托管 AI 工作流的开发者参考。

292440837发布于 2026/3/16更新于 2026/5/55 浏览
OpenClaw 安装部署与渠道接入指南

OpenClaw 安装部署与渠道接入指南

OpenClaw Dashboard Overview

一、环境准备与安全考虑

OpenClaw 具备系统级权限(Agent Mode),这意味着它可以执行 Shell 命令、访问文件系统等。因此,强烈建议在以下环境中运行:

  • 推荐:Linux 服务器(如 Ubuntu 22.04)或 macOS。
  • Windows 用户:强烈建议使用 WSL2(Linux 子系统)。不要直接在原生 Windows 环境中运行,除非你非常了解风险。因为 Windows 的文件系统权限模型较为脆弱,可能导致误删系统文件。

最低硬件要求:

  • 内存:8GB(建议 16GB,尤其是使用本地模型时)。
  • 磁盘:至少 20GB 可用空间(插件和模型缓存可能占用较多磁盘)。
  • CPU:64 位处理器,若运行大型语言模型(LLM)推荐更高频率 CPU。

二、安装方式

OpenClaw 提供了三种主要安装方式,你可以根据自己的需求选择。

2.1 推荐方式:一键安装脚本

这是一键式安装,自动检测系统环境并完成安装。

Windows PowerShell:

# 设置执行权限
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 运行一键脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

macOS / Linux Terminal:

# 直接运行脚本
curl -fsSL https://openclaw.ai/install.sh | bash

此脚本会自动安装 Node.js(≥22)并完成 CLI 配置。

2.2 手动安装

如果你想自定义安装路径或贡献代码,可以手动安装。

# 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

2.3 Docker 部署

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,省去了系统环境配置的麻烦。

三、初始化配置 (Onboarding)

安装完成后,你需要进行一次初始化向导来完成服务注册、模型配置和权限设置。

# 进入交互式配置向导
openclaw onboard

向导主要包括以下步骤:

  1. 选择模型提供商:
    • OpenAI (GPT-4)
    • Anthropic (Claude)
    • 本地模型(如 Llama.cpp)
    • 国内推荐:APIYI(星火)、通义千问(阿里云)。
  2. 输入 API Key:
    • 将你的密钥粘贴进去,程序会自动验证。
  3. 设置权限 (极其重要):
    • OpenClaw 采用 Agent Mode,默认具备执行 Shell 权限。
    • 强烈建议:仅勾选'File System Access'和'Shell Access',禁止'Network Access'(网络访问)以防止恶意代码外泄。
  4. 生成或导入人格配置:
    • 你可以选择预设人格(如'开发者助手'),也可以自定义名称和描述。

⚠️ 权限警告:如果你选择了'无风险模式(No Risk)',OpenClaw 将仅作为一个聊天机器人,失去自动化执行任务的能力。

四、启动网关与 Dashboard

配置完成后,你需要启动网关服务并打开 Web Dashboard。

# 启动网关(默认端口 18789)
openclaw start
# 或者使用守护进程方式(推荐用于服务器)
openclaw onboard --install-daemon

网关默认监听 http://127.0.0.1:18789 ,可以通过浏览器访问 Web 控制面板。

访问 Dashboard

打开浏览器,输入 http://127.0.0.1:18789 ,你将看到类似以下的控制面板:

  • Skill Market:技能商城。
  • Agent Settings:Agent 设置。
  • Plugins:插件管理。
  • Chat:即时对话窗口。

五、接入即时通讯渠道

OpenClaw 最强大的特性是可以通过聊天软件与 AI 交互。以下是接入 WhatsApp、Telegram、飞书、钉钉和 Discord 的详细步骤。

5.1 接入 WhatsApp

WhatsApp 是最流行的接入方式之一。

# 安装 WhatsApp 渠道插件
openclaw add-channel whatsapp
# 按提示配置:
# 1. 输入你的 WhatsApp Business API Key
# 2. 输入你的手机号码(完整的国际区号格式)
# 3. 完成后重启服务
openclaw restart-whatsapp

WhatsApp 需要申请 Business API,建议使用第三方服务商(如 Twilio)。

5.2 接入 Telegram

Telegram 对开发者非常友好,免费且安全。

# 安装 Telegram 插件
openclaw add-channel telegram
# 按提示输入 Bot Token(通过 BotFather 创建机器人获取)
openclaw restart-telegram

5.3 接入飞书 (Feishu / Lark)

飞书是中国企业内部沟通的主流工具,OpenClaw 对其支持非常友好。

前置准备:获取 App ID 和 App Secret
  1. 访问 飞书开放平台(https://open.feishu.cn/ )。
  2. 创建企业自建应用,填写应用名称、图标等信息。
  3. 在凭证与基础信息中获取:
    • App ID(客户端 ID)
    • App Secret(客户端密钥)
    • Verification Token(消息校验 Token,推荐开启)
  4. 在机器人模块中开启机器人权限,并将机器人添加到企业(或单聊/群聊)。
安装飞书插件
# 安装通用插件包(包含飞书插件)
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,如果回复成功则表示接入成功。

5.4 接入钉钉 (Dingtalk)

钉钉是阿里巴巴推出的企业通讯工具,OpenClaw 对其也有完整支持。

前置准备:获取 AppKey 和 AppSecret
  1. 访问 钉钉开放平台(https://open.dingtalk.com/ )。
  2. 创建企业内部应用,设置名称、图标等。
  3. 在应用信息页面获取:
    • AppKey(即 Client ID)
    • AppSecret(客户端密钥)
  4. 配置安全设置中的机器人,获取Verification Token(可选,但建议配置)。
安装钉钉插件
# 同样使用通用插件包(已包含钉钉插件)
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,如果收到回复则表示接入成功。

5.5 接入 Discord

Discord 是全球流行的社交与社区平台,OpenClaw 的插件支持直接接入。

前置准备:获取 Bot Token
  1. 访问 Discord 开发者门户(https://discord.com/developers/applications )。
  2. 创建一个新应用,进入Bot标签页,开启 Bot 并获取 Bot Token(形如 MzU2...)。
  3. 在OAuth2 -> URL Generator中勾选bot权限,生成邀请链接,将 Bot 邀请到目标服务器中。
安装 Discord 插件
# 安装 Discord 插件
openclaw plugins install -discord
配置 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 那样开始对话,并利用它的强大功能。

6.1 直接对话

在 Dashboard 或你的聊天软件中输入:

帮我检查一下 `/etc/hosts` 文件是否被篡改?

如果 Agent 有 Shell 权限,它会自动读取文件内容并回复。

6.2 使用插件 (Skills)

OpenClaw 支持多种插件,例如:

  • File System:读写本地文件。
  • Bash:执行 Shell 命令。
  • Web Scraper:抓取网页信息。

你可以通过指令启用或查看插件列表:

# 查看已安装的插件
openclaw skills list
# 启用 Bash 插件(危险操作,请确保安全)
openclaw skills enablebash

6.3 自动化脚本 (Agent)

在对话中输入以下格式的指令,OpenClaw 会自动生成脚本并执行:

写一个 Bash 脚本,每隔 5 分钟检查一次 CPU 使用率是否超过 80%,如果超过就发送邮件提醒。

它会输出脚本内容,并提示你是否执行。

七、故障排除与进阶技巧

7.1 常见错误处理

  • Node.js 版本不兼容:确保使用 node -v 检查版本,必须是 22+。
  • Docker 端口映射错误:确保 Docker 运行命令中的 -p 18789:18789 正确。

Port 18789 被占用:

# 查看占用情况
lsof -i:18789
# 更改端口(编辑配置文件)
nano ~/.config/openclaw/config.yaml

7.2 安全加固建议

  • 不在生产服务器上开启网络访问权限,除非你明确知道对方在做什么。

使用 pm2 管理进程:确保服务异常退出后自动重启。

npm install -g pm2
pm2 start "$(which openclaw)" --name openclaw
pm2 save

7.3 贡献与二次开发

OpenClaw 是开源项目。如果你想自定义 Agent 行为或开发新插件:

  • Fork 项目源码。
  • 在 plugins/ 目录下编写新的插件。
  • 提交 Pull Request。

OpenClaw 是一个极具潜力的 AI 自动化平台,核心优势在于自托管(数据不出本地)和系统级权限(可执行实际任务)。通过以上步骤,你已经拥有了一个属于自己的'数字员工'。

目录

  1. OpenClaw 安装部署与渠道接入指南
  2. 一、环境准备与安全考虑
  3. 二、安装方式
  4. 2.1 推荐方式:一键安装脚本
  5. 设置执行权限
  6. 运行一键脚本
  7. 直接运行脚本
  8. 2.2 手动安装
  9. 1. 安装 Node.js (建议使用 nvm)
  10. 2. 安装 OpenClaw CLI
  11. 或者 pnpm add -g openclaw@latest
  12. 2.3 Docker 部署
  13. 三、初始化配置 (Onboarding)
  14. 进入交互式配置向导
  15. 四、启动网关与 Dashboard
  16. 启动网关(默认端口 18789)
  17. 或者使用守护进程方式(推荐用于服务器)
  18. 访问 Dashboard
  19. 五、接入即时通讯渠道
  20. 5.1 接入 WhatsApp
  21. 安装 WhatsApp 渠道插件
  22. 按提示配置:
  23. 1. 输入你的 WhatsApp Business API Key
  24. 2. 输入你的手机号码(完整的国际区号格式)
  25. 3. 完成后重启服务
  26. 5.2 接入 Telegram
  27. 安装 Telegram 插件
  28. 按提示输入 Bot Token(通过 BotFather 创建机器人获取)
  29. 5.3 接入飞书 (Feishu / Lark)
  30. 前置准备:获取 App ID 和 App Secret
  31. 安装飞书插件
  32. 安装通用插件包(包含飞书插件)
  33. 配置飞书渠道
  34. 启用飞书 Channel
  35. 配置凭证(请替换 YOURAPPID 和 YOURAPPSECRET)
  36. 配置安全策略(推荐配置)
  37. 推荐使用 websocket 连接
  38. 私聊策略:仅已配对用户
  39. 群聊策略:仅白名单群聊
  40. 群聊中必须 @机器人 才响应
  41. 启动并验证
  42. 重启网关以加载新配置
  43. 5.4 接入钉钉 (Dingtalk)
  44. 前置准备:获取 AppKey 和 AppSecret
  45. 安装钉钉插件
  46. 同样使用通用插件包(已包含钉钉插件)
  47. 配置钉钉渠道
  48. 启用钉钉 Channel
  49. 配置凭证(请替换 YOURAPPKEY 和 YOURAPPSECRET)
  50. 配置安全策略(推荐配置)
  51. 启动并验证
  52. 重启网关
  53. 5.5 接入 Discord
  54. 前置准备:获取 Bot Token
  55. 安装 Discord 插件
  56. 安装 Discord 插件
  57. 配置 Discord 渠道
  58. 启用 Discord Channel
  59. 配置 Bot Token
  60. 配置安全策略(推荐配置)
  61. 启动并验证
  62. 重启网关
  63. 六、核心功能与日常使用
  64. 6.1 直接对话
  65. 6.2 使用插件 (Skills)
  66. 查看已安装的插件
  67. 启用 Bash 插件(危险操作,请确保安全)
  68. 6.3 自动化脚本 (Agent)
  69. 七、故障排除与进阶技巧
  70. 7.1 常见错误处理
  71. 查看占用情况
  72. 更改端口(编辑配置文件)
  73. 7.2 安全加固建议
  74. 7.3 贡献与二次开发
  • 💰 8折买阿里云服务器限时8折了解详情
  • GPT-5.5 超高智商模型1元抵1刀ChatGPT中转购买
  • 代充Chatgpt Plus/pro 帐号了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • 前端拖拽排序实现详解:基于原生 HTML5 API
  • Windows 10 使用 dynv6 + ddns-go 实现 IPv6 固定域名远程访问
  • 大模型训练实战经验总结
  • 基于 Ocelot 与 Nacos 的 WebAPI 网关鉴权实现
  • 微软开源 GraphRAG:基于图的检索增强生成技术解析
  • C++ 基础:链表、缓冲区与指针概念
  • 滑动窗口算法专题:经典题目实战
  • Git 与 GitHub 入门指南:版本控制与协作实战
  • 深度学习 yolo11 空域安全无人机检测识别系统
  • Ubuntu 部署 OpenClaw 完整指南
  • 分布式任务调度:多数据库兼容的策略封装
  • HarmonyOS RcList 组件事件处理机制与实战应用
  • Visual C++ 运行库一键安装指南
  • Python 元编程基础:深入理解描述符与装饰器
  • 户外机器人 GNSS 仿真测试方案:实现高精度定位与双天线定向
  • Python 爬虫项目:爬取百度贴吧帖子,保存标题与评论内容
  • 二分查找算法实战:x 的平方根与搜索插入位置
  • 基于STM32和FreeRTOS的智能手环项目设计与实现
  • LeetCode 964. 最少运算符表示数字
  • 利用 Python 开发副业:数据抓取与变现实战指南

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online