Shell / BashNode.jsAI
OpenClaw 钉钉对接教程：在 Linux 部署本地 AI 智能体
介绍如何在 Linux 服务器上部署开源本地 AI 助手 OpenClaw，并集成钉钉机器人。内容包括环境准备（Node.js、Git）、服务安装配置、Web UI 访问及钉钉应用凭证获取与 Channel 配置。通过 TUI 或 Web 界面管理 AI 能力，实现邮件、日程、网页浏览等自动化任务。支持通义千问等模型，强调数据隐私与本地控制。
介绍如何在 Linux 服务器上部署开源本地 AI 助手 OpenClaw，并集成钉钉机器人。内容包括环境准备（Node.js、Git）、服务安装配置、Web UI 访问及钉钉应用凭证获取与 Channel 配置。通过 TUI 或 Web 界面管理 AI 能力，实现邮件、日程、网页浏览等自动化任务。支持通义千问等模型，强调数据隐私与本地控制。
OpenClaw 是一款开源的本地 AI 助手，支持在你自己的服务器上部署，通过钉钉、飞书、WhatsApp、Telegram 等聊天工具交互。与云端 SaaS 服务不同，OpenClaw 让你完全掌控数据隐私，可以执行系统命令、浏览网页、管理文件，甚至编写代码。本教程将手把手教你在 Linux 系统下安装 OpenClaw 并对接钉钉机器人，打造专属的智能助理。
注意：本教程在 Linux 系统下进行
OpenClaw（原名 Clawdbot，后更名为 Moltbot，现正式命名为 OpenClaw）是一个运行在你本地环境的高权限 AI 智能体。它的核心特性包括：
无论是邮件管理、日程安排、数据查询还是代码编写，OpenClaw 都能成为你的得力助手。
首先准备一台闲置的云服务器或 VPS（推荐使用香港或海外节点）。由于 OpenClaw 运行时权限较大，出于安全考虑，不建议在本地或工作机上安装，推荐在一台独立的空服务器上部署。准备完成后，登录到服务器。
第一步安装 Git
sudo apt update
sudo apt install git -y
第二步安装 Node.js
# 安装 NVM
# 国内使用 gitee 的镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 国外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
# 重新加载环境变量
source ~/.bashrc
# 安装 Node.js 22
nvm install 22
# 查看 nodejs 版本
node -v
# 输出 v22 即可，版本只要 22 就行
curl -fsSL https://openclaw.bot/install.sh | bash
服务器在国内，如果安装失败的话，可能需要解决网络问题
其他平台安装方式请参考 OpenClaw 安装文档
你会看到如下图输出
如果首次安装，时间会很长，需要耐心等待。 如果最后输出如下内容：
→ npm install failed; cleaning up and retrying...
新的脚本服务器内存要求变高了，据我使用下来 2G 内存，肯定会 OOM，如果出错的话，建议使用 swap 把硬盘空间当作交互内存使用。
成功之后会输出如下图片
第一个选项选择 yes，就是询问你是否知道风险的。
第二步选择 QuickStart
第三步选择模型服务商，这里选择 Qwen，免费额度充足，适合入门使用
选择千问模型后，会提供一个链接，复制并在浏览器中打开，如下图
打开浏览器后，会看到如下界面。由于我已登录过，所以显示账户信息；如果尚未登录，按照提示完成登录即可。
登录完成后，会出现以下选项，提示选择对应的千问模型，如下图
选择默认模型即可。接下来会提示选择 channel，这里先跳过，后续再添加
继续下面选择 skills，也是选择 No，如下图
继续下面选择 hooks，也是使用 空格 选择 No，如下图
然后等待安装完成，最后会出现以下选项，这里选择 TUI
如果看到 TUI 聊天界面，说明安装成功，可以尝试输入 Hello 进行测试。
然后直接使用 ctrl+c 先关闭，后面我们再来设置
可以使用下面的命令来查看
openclaw status
会看到如下图的结果就说明服务启动了
如何访问面板？服务监听在 http://127.0.0.1:18789/ 端口上，我们现在通过 ssh 隧道来访问，输入下面的命令
ssh -N -L 18789:127.0.0.1:18789 用户名@服务器IP
# 回车之后 用户名@服务器 IP's password:
# 输入密码
然后在浏览器打开 http://127.0.0.1:18789/，你会看到 Dashboard 了，如下图
图中显示的是未授权状态，回到服务器，输入以下命令
openclaw dashboard
会看到下面的面板数据
复制对应的 Dashboard URL 到浏览器打开，即可正常查看聊天记录。
至此 OpenClaw 已安装完成，可以正常访问了。然后聊天框里面首次输入 Hello，OpenClaw 会询问你他应该叫什么，应该叫你什么。就是你需要给它设置个名字，还有 bot 改叫你什么。你可以在聊天框这么输入
Name: OpenClaw My Name: Boss
钉钉是国内使用最广泛的企业办公平台之一，OpenClaw 支持通过钉钉机器人进行交互。本节将介绍如何配置钉钉机器人对接 OpenClaw。
首先安装钉钉插件，输入以下命令直接运行 openclaw 插件安装命令，openclaw 会自动处理下载、安装依赖和注册。时间有可能比较久，等待即可
openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git
登录 钉钉开放平台，点击「创建应用」
注意：创建钉钉应用需要你的钉钉账号有开发者权限。如果没有，可以联系组织管理员获取，或参考 获取开发者权限
在应用开发的左侧导航栏中，点击「钉钉应用」，然后点击右上角「创建应用」。
填写应用名称和应用描述，上传应用图标后保存。
在应用开发的左侧导航栏中，点击「添加应用能力」，然后点击添加「机器人」。
添加完机器人之后，就是配置一些基本信息之后，点击发布。
最后得消息接受模式一定要是
stream 模式
在发布完机器人之后，一定要发布版本。在应用开发的左侧导航栏中，点击「版本管理与发布」，然后点击右上角「创建新版本」。
发布版本成功之后，点击左侧菜单的「凭证与基础信息」，获取以下凭证信息
Agent ID (应用 ID)
找到 openclaw.json 配置文件。使用下面的命令找到配置文件
find / | grep openclaw.json
# 本人服务器的输出如下，每个人都不一样，按实际情况找
#/root/.openclaw/openclaw.json.bak
#/root/.openclaw/openclaw.json.bak.1
#/root/.openclaw/openclaw.json // 这个就是配置文件
#/root/.openclaw/openclaw.json.bak.2
然后找到对应的 channels 配置
{"channels":{"dingtalk":{"enabled":true,"clientId":"dingxxxxxx","clientSecret":"your-app-secret","robotCode":"dingxxxxxx","corpId":"dingxxxxxx","agentId":"123456789","dmPolicy":"open","groupPolicy":"open","messageType":"markdown","debug":false}}}
如果你找不到对应的配置，也不用担心，使用下面的命令配置也是可以的
openclaw config set channels.dingtalk.enabled true
openclaw config set channels.dingtalk.clientId 你的 Client ID
openclaw config set channels.dingtalk.clientSecret 你的 Client Secret
openclaw config set channels.dingtalk.robotCode Robot Code (与 Client ID 相同)
openclaw config set channels.dingtalk.corpId 你的 corpId
openclaw config set channels.dingtalk.agentId Agent ID
openclaw config set channels.dingtalk.dmPolicy open
openclaw config set channels.dingtalk.groupPolicy open
openclaw config set channels.dingtalk.messageType markdown
openclaw config set channels.dingtalk.debug false
配置完成之后，重启服务
openclaw gateway restart
回到钉钉客户端软件，在顶部搜索栏目搜索机器人名称 openclaw
点击机器人就可以直接跟机器人聊天了。可以输入 Hello
OpenClaw 是该项目的最新正式名称。项目最初叫 Clawdbot，后因商标问题更名为 Moltbot，最终在 2025 年 1 月正式定名为 OpenClaw。三者是同一个项目的不同阶段命名。
OpenClaw 支持多种 AI 模型服务商，包括 Anthropic Claude、OpenAI GPT、通义千问（Qwen）、KIMI、小米 MiMo 等。本教程使用通义千问是因为其免费额度充足，适合入门学习。
这通常是服务器内存不足导致的。新版本脚本对内存要求较高，2G 内存可能会出现 OOM（内存溢出）。建议配置 swap 交换空间，将硬盘空间作为虚拟内存使用。
可以。OpenClaw 支持 Mac、Windows 和 Linux 系统。本教程以 Linux 为例，其他系统的安装方式可参考 官方文档。
请检查以下几点：
clawdbot plugins install @openclaw-china/channels）Card.Streaming.Write 和 Card.Instance.Write 权限OpenClaw 运行在你自己的服务器上，所有数据都在本地存储，不会上传到第三方云端。但由于它具有系统级权限，建议在独立的服务器上部署，避免在生产环境或重要数据的机器上运行。
OpenClaw 支持多个聊天平台，包括飞书、企业微信、QQ、WhatsApp、Telegram、Discord、Slack、Microsoft Teams、Signal、iMessage、Google Chat、Twitch 等。每个平台需要安装对应的插件。国内平台推荐使用 @openclaw-china/channels 插件。
OpenClaw 可以执行多种任务：
使用以下命令更新：
openclaw update
OpenClaw 更名后，官方推荐使用 openclaw 命令，但为了兼容性，clawdbot 命令仍然可用。两者功能完全相同，建议新用户直接使用 openclaw 命令。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online