玩转OpenClaw | OpenClaw安装与IM接入文档

发表于 2026-03-09 更新于 2026-03-13 阅读次数：本文字数： 4.8k 阅读时长 ≈ 18 分钟

什么是OpenClaw

OpenClaw（曾用名Clawdbot/Moltbot）是一款开源的个人AI助手，它不仅能在本地电脑或云服务器上自主执行任务，还能通过Discord、钉钉、飞书等即时通讯工具与用户交互。

系统要求

Node 22+ (OpenClaw安装脚本会自动安装)
macOS、Linux（Ubuntu22.04+、CentOS8）、Windows（推荐WSL2）
pnpm（只有在从源代码构建时才需要）
推荐配置：4核CPU8G内存50G+硬盘（首选SSD）

实验环境

说明
OpenClaw作为具备持久记忆与主动执行能力的开源AI智能体，可调用系统资源，在缺乏管控下存在信息泄露、误操作与系统破坏等风险，因此不建议在个人常用终端上直接安装，可以选择闲置设备或购买云服务器进行部署体验

配置	操作系统	内网IP	公网IP
4 vCPUs 8GB 超高IO云盘200GB	Ubuntu 22.04 64位	192.168.1.16	58.23.212.226

Ubuntu软件源配置

说明
本文使用的是阿里云Ubuntu 22.04 LTS (jammy) 的源，如果你使用的是其他版本的Ubuntu，请到阿里云Ubuntu镜像站拷贝对应版本的软件源配置

# 备份源文件
cp /etc/apt/sources.list /etc/apt/sources.list.bak
echo > /etc/apt/sources.list

# 根据Ubuntu版本到阿里云Ubuntu镜像站拷贝对应版本的配置更新源文件
cat > /etc/apt/sources.list << EOF
deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse

# deb https://mirrors.aliyun.com/ubuntu/ jammy-proposed main restricted universe multiverse
# deb-src https://mirrors.aliyun.com/ubuntu/ jammy-proposed main restricted universe multiverse

deb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse
deb-src https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse
EOF

# 更新软件包索引
apt-get update

# 修复所有未配置的软件包
dpkg --configure -a

安装OpenClaw

下载CLI，通过npm进行全局安装，并跳过启动引导向导。

1	curl -fsSL https://openclaw.ai/install.sh \| bash -s -- --no-onboard

当出现如下输出时代表OpenClaw已经安装完成

......
🦞 OpenClaw installed successfully (OpenClaw 2026.3.8 (3caab92))!
cracks claws Alright, what are we building?

· Skipping onboard (requested); run openclaw onboard later

FAQ: https://docs.openclaw.ai/start/faq

初始化配置向导

执行以下命令启动初始化配置向导

1	openclaw onboard --install-daemon

说明
在初始化配置向导中通过上下左右方向键选择选项，通过回车键确认选项

确认已阅读安全提示

1 2	* I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue? \| > Yes / No

选择快速启动（之后可通过openclaw configure修改配置）

1
2
3

*  Onboarding mode
|  > QuickStart (Configure details later via openclaw configure.)
|    Manual

选择AI模型提供商。如果要对接的模型有在内置的Provider中，选择对应选项按照提示填写相关信息即可；反之则到对应的模型开放平台获取“API base_url”、“API Key”、“Model ID”信息，然后选择“Custom Provider”进行自定义配置。(本文以对接DeepSeek为例)

开放平台	网址
DeepSeek开放平台	https://platform.deepseek.com/
阿里云百炼	https://bailian.console.aliyun.com/cn-beijing/?tab=api#/api

*  Model/auth provider
|    OpenAI
|    Anthropic
|    Chutes
|    vLLM
|    MiniMax
|    Moonshot AI (Kimi K2.5)
|    Google
|    xAI (Grok)
|    Mistral AI
|    Volcano Engine
|    BytePlus
|    OpenRouter
|    Kilo Gateway
|    Qwen
|    Z.AI
|    Qianfan
|    Copilot
|    Vercel AI Gateway
|    OpenCode Zen
|    Xiaomi
|    Synthetic
|    Together AI
|    Hugging Face
|    Venice AI
|    LiteLLM
|    Cloudflare AI Gateway
|  > Custom Provider (Any OpenAI or Anthropic compatible endpoint)
|    Skip for now

填写“API base_url”

1 2	* API Base URL \| https://api.deepseek.com/v1█

选择直接粘贴“API Key”存储在OpenClaw配置文件中

1
2
3

*  How do you want to provide this API key?
|  > Paste API key now (Stores the key directly in OpenClaw config)
|    Use external secret provider

输入“API Key”

1 2	* API Key (leave blank if not required) \| sk-e4xxxxxxxx

根据对接的模型选择对应的API接口标准，此处选择“OpenAI-compatible”

*  Endpoint compatibility
|  > OpenAI-compatible (Uses /chat/completions)
|    Anthropic-compatible
|    Unknown (detect automatically)

填写模型名称“Model ID”

说明
deepseek-chat对应DeepSeek-V3.2的非思考模式，deepseek-reasoner对应DeepSeek-V3.2的思考模式。

1 2	* Model ID \| deepseek-chat█

OpenClaw会自动对配置的模型进行接口验证，出现如下提示说明接口测试成功

1	o Verification successful.

配置当前模型接入配置的内部名称（可自定义）

1 2	* Endpoint ID \| custom-api-deepseek-com█

配置模型别名（可选）

1 2	* Model alias (optional) \| DeepSeek-Chat█

配置通道，OpenClaw默认支持与多种即时通讯软件对接，但大部分都是国外平台，国内的只有一个飞书，此处先选择“Skip for now”，之后再进行通道配置

*  Select channel (QuickStart)
|    Telegram (Bot API)
|    WhatsApp (QR link)
|    Discord (Bot API)
|    IRC (Server + Nick)
|    Google Chat (Chat API)
|    Slack (Socket Mode)
|    Signal (signal-cli)
|    iMessage (imsg)
|    LINE (Messaging API)
|    Feishu/Lark (飞书)
|    Nostr (NIP-04 DMs)
|    Microsoft Teams (Bot Framework)
|    Mattermost (plugin)
|    Nextcloud Talk (self-hosted)
|    Matrix (plugin)
|    BlueBubbles (macOS app)
|    Zalo (Bot API)
|    Zalo (Personal Account)
|    Synology Chat (Webhook)
|    Tlon (Urbit)
|  > Skip for now (You can add channels later via `openclaw channels add`)

配置实时搜索功能（先跳过）

*  Search provider
|    Brave Search
|    Gemini (Google Search)
|    Grok (xAI)
|    Kimi (Moonshot)
|    Perplexity Search
|  > Skip for now (Configure later with openclaw configure --section web)

选择是否配置OpenClaw技能（先跳过）

1 2	* Configure skills now? (recommended) \| Yes / > No

选择要启用的钩子，此处建议勾选session-memory和command-logger

hooks	功能
boot-md	启动时自动加载某些指令/提示词
bootstrap-extra-files	启动时自动加载额外文件
command-logger	自动记录所有通过AI助手执行的命令事件，生成审计日志，便于后续的操作回溯、调试排查或安全审计。
session-memory	发`/new`或`/reset`时自动保存当前对话记忆

*  Enable hooks?
|  [ ] Skip for now
|  [ ] 🚀 boot-md
|  [ ] 📎 bootstrap-extra-files
|  [+] 📝 command-logger (Log all command events to a centralized audit file)
|  [+] 💾 session-memory (Save session context to memory when /new or /reset command is issued)

选择在终端还是在网页上进行聊天测试，此处选择在终端进行测试

*  How do you want to hatch your bot?
|  > Hatch in TUI (recommended)
|    Open the Web UI
|    Do this later

如下图，在TUI界面输入“你现在是什么模型”，若返回的是你上面配置的模型信息，即为配置成功。

说明
按两次“Ctrl+C”可退出TUI测试界面

访问OpenClaw Gateway Dashboard

执行以下命令获取Dashboard访问地址，地址格式如：http://IP:PORT/#token=xxxxx，然后通过浏览器访问。

1	openclaw dashboard

说明
出于安全考虑，Dashboard监听在环回接口127.0.0.1上，默认只允许在部署OpenClaw的机器上访问。如果你的OpenClaw是部署在云服务器上，可以先通过以下几种方式建立隧道转发后再在你本地主机进行访问
方式一
本地主机如果是MacOS/Linux，可以直接打开终端执行以下命令建议隧道转发
1
ssh -N -L 18789:127.0.0.1:18789 root@<服务器公网IP>
方式二
在SecureCRT中配置隧道转发

方式三
在XShell中配置隧道转发

如果觉得自动生成的Token过长不好记，也可以通过以下命令自定义Token并重启网关生效

1
2
3

openclaw config set gateway.auth.token "<自定义Token>"
openclaw gateway restart
openclaw dashboard

开启工具执行权限

在最近的OpenClaw 2026.3.2版本更新中，OpenClaw默认的权限策略发生了变化：

默认情况下，Agent只允许进行纯对话
涉及调用Skills工具外部接口的动作，会受到更严格的权限控制
当某个操作被当前权限策略禁止时，你会在对话中看到类似提示：
- “我没有权限执行此操作”
- 或其他表示“当前不允许调用技能/工具”的说明

那么即便模型正常、通道正常、Skills已安装，机器人也可能因为默认权限收紧而拒绝帮你调用工具。

因此如果你安装的OpenClaw 2026.3.2之后的版本，为了恢复Agent在对话中调用Skills/工具的能力，需要执行以下命令将工具执行权限调整为完整模式

1
2
3

openclaw config set tools.profile full
openclaw gateway restart
openclaw config get tools.profile

对接即时通讯(IM)软件

对接QQ机器人

前往腾讯QQ开放平台官网，使用手机QQ扫描图中二维码注册登录

说明
如果当前尚未注册QQ开放平台，执行扫码操作后，系统将自动完成QQ开放平台注册流程，并将扫码所用的QQ账号与该平台账号进行绑定。

在QQ开放平台的QQ机器人页面，点击“创建机器人”，即可直接新建一个QQ机器人。

机器人创建完成后，在页面中找到“AppID”和“AppSecret”两个参数，分别点击右侧“复制”按钮，将其保存到个人记事本或备忘录中，后续步骤中需要使用。

说明
出于安全考虑，AppSecret不支持明文保存，二次查看将会强制重置，请自行妥善保存。

回到QQ软件，可以看到新建的QQ机器人已经被添加至消息列表中，并向你发送了第一条消息。但此时还不能与机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与之前部署的OpenClaw打通，需要继续后面的配置步骤

登录部署OpenClaw的服务器，执行以下命令为OpenClaw应用配置QQ机器人的AppID和AppSecret

说明
如果安装QQBot插件失败，可以执行npm config set registry https://registry.npmmirror.com将npm源切换到淘宝源再安装

# 安装OpenClaw开源社区QQBot插件
openclaw plugins install @sliverp/qqbot@latest
# 配置绑定当前QQ机器人
openclaw channels add --channel qqbot --token "<AppID>:<AppSecret>"
# 重启OpenClaw服务
openclaw gateway restart

配置完成之后尝试和QQ机器人进行聊天，如果QQ机器人能够正常回答，说明已经成功完成OpenClaw接入QQ机器人了。

对接企业微信机器人

说明
出于安全考虑防止企业敏感数据泄露，如果需要对接到企业微信机器人的话，建议优先选择自建企业进行体验

创建企业

按照企业微信官方文档完成企业创建

说明
一定要创建企业，不要选择个人组建团队，因为个人组建团队是没有工作台功能的。

以长连接方式创建智能机器人，获取Bot ID和Secret

说明
通过长连接方式创建的智能机器人，支持主动向用户发送消息。

在客户端-工作台，点击“智能机器人”

点击“创建机器人”，选择“手动创建”

填写机器人信息（包含头像、名称、简介），设置可见范围，然后下拉到底部，点击“API模式创建”

选择“使用长链接”方式创建，并获取Bot ID和Secret信息并记录，后续步骤需要用到

将OpenClaw关联到企业微信机器人

登录部署OpenClaw的服务器，执行以下命令安装企业微信插件

1	openclaw plugins install @wecom/wecom-openclaw-plugin

重启OpenClaw服务

1	openclaw gateway restart

执行以下命令，添加渠道

1	openclaw channels add

选择“Yes”

1 2	* Configure chat channels now? \| > Yes / No

选择“企业微信 (WeCom)”

*  Select a channel
|    Telegram (Bot API)
|    WhatsApp (QR link)
|    Discord (Bot API)
|    IRC (Server + Nick)
|    Google Chat (Chat API)
|    Slack (Socket Mode)
|    Signal (signal-cli)
|    iMessage (imsg)
|    LINE (Messaging API)
|    QQ Bot
|  > 企业微信 (WeCom) (需要设置 · disabled)
|    Feishu/Lark (飞书)
|    Nostr (NIP-04 DMs)
|    Microsoft Teams (Bot Framework)
|    Mattermost (plugin)
|    Nextcloud Talk (self-hosted)
|    Matrix (plugin)
|    BlueBubbles (macOS app)
|    Zalo (Bot API)
|    Zalo (Personal Account)
|    Synology Chat (Webhook)
|    Tlon (Urbit)
|    Finished

输入上面获取到的企业微信机器人Bot ID和Secret

o  企业微信机器人 Bot ID
|  aibCxxxxxxxxxxxxxYjeq
|
o  企业微信机器人 Secret
|  PSLxxxxxxxxxxxxxxxxxxxxxxxxxxFAOp█
—

选择“finish”

*  Select a channel
|    Telegram (Bot API)
|    WhatsApp (QR link)
|    Discord (Bot API)
|    IRC (Server + Nick)
|    Google Chat (Chat API)
|    Slack (Socket Mode)
|    Signal (signal-cli)
|    iMessage (imsg)
|    LINE (Messaging API)
|    QQ Bot
|    企业微信 (WeCom)
|    Feishu/Lark (飞书)
|    Nostr (NIP-04 DMs)
|    Microsoft Teams (Bot Framework)
|    Mattermost (plugin)
|    Nextcloud Talk (self-hosted)
|    Matrix (plugin)
|    BlueBubbles (macOS app)
|    Zalo (Bot API)
|    Zalo (Personal Account)
|    Synology Chat (Webhook)
|    Tlon (Urbit)
|  > Finished (Done)

选择”Yes“配置配对方式，然后选择“Pairing”

o  Configure DM access policies now? (default: pairing)
|  Yes
|
o  企业微信 DM access ---------------------------------------------------------------------+
|                                                                                          |
|  Default: pairing (unknown DMs get a pairing code).                                      |
|  Approve: openclaw pairing approve wecom <code>                                          |
|  Allowlist DMs: channels.wecom.dmPolicy="allowlist" + channels.wecom.allowFrom entries.  |
|  Public DMs: channels.wecom.dmPolicy="open" + channels.wecom.allowFrom includes "*".     |
|  Multi-user DMs: run: openclaw config set session.dmScope "per-channel-peer" (or         |
|  "per-account-channel-peer" for multi-account channels) to isolate sessions.             |
|  Docs: channels/pairing             |
|                                                                                          |
+------------------------------------------------------------------------------------------+
|
*  企业微信 DM policy
|  > Pairing (recommended)
|    Allowlist (specific users only)
|    Open (public inbound DMs)
|    Disabled (ignore DMs)
—

按照提示完成后续配置

o  Add display names for these accounts? (optional)
|  Yes
|
o  wecom account name (default)
|  企业微信
Config overwrite: /root/.openclaw/openclaw.json (sha256 df4583de8dd0c8fd1a7f7f4959ebeae3a831c973e1283dd20713379bdcbc6158 -> 3eb746c7b36bb73343974e7809b64c63d6b1bd01233812de35d6184b779e562c, backup=/root/.openclaw/openclaw.json.bak)
|
—  Channels updated.

回到企业微信工作台中，点击“保存”完成机器人创建

然后跟机器人任意发一条消息，比如“你好”，机器人会回复一个配置密钥信息

复制此信息最后一行，并到终端上执行完成配对。

root@openclaw:~# openclaw pairing approve wecom RJSHVK7E
11:23:44 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: qqbot (/root/.openclaw/extensions/qqbot/index.ts), wecom-openclaw-plugin (/root/.openclaw/extensions/wecom-openclaw-plugin/dist/index.esm.js). Set plugins.allow to explicit trusted ids.

🦞 OpenClaw 2026.3.8 (3caab92) — Built by lobsters, for humans. Don't question the hierarchy.

Approved wecom sender LiMingXian.
root@openclaw:~#

此时就可在企业微信中正常对话了。

对接钉钉机器人

说明
出于安全考虑防止企业敏感数据泄露，如果需要对接到钉钉机器人的话，建议优先选择自建企业进行体验

创建企业

打开手机钉钉App，点击左上角头像，选择“创建/加入新的企业团队”，使用场景选择“企业”-“创建企业/团队”，按照提示完成信息填写即可。

一键创建OpenClaw机器人

登录钉钉开发者后台，组织选择上一步自建的企业

在应用开发-钉钉应用下，点击“立即创建”，一键创建OpenClaw机器人

在创建OpenClaw机器人界面，填写机器人基本信息（包括机器人名称、机器人简介和机器人图标），最后点击“确定”

OpenClaw机器人创建成功后，会自动展示应用的Client ID和Client Secret，复制保存好用于后续使用。

说明

Client ID和Client Secret是应用的关键信息，也是操作应用数据的核心参数，请妥善保管，切勿轻易提供给他人使用。

关闭窗口后仍可在应用「凭证与基础信息」中查看

说明
自动创建的OpenClaw机器人会默认开通Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg权限，开发者无需再手动申请。

将OpenClaw关联到钉钉机器人

登录部署OpenClaw的服务器，执行以下命令安装钉钉官方插件

1	openclaw plugins install @dingtalk-real-ai/dingtalk-connector

执行vim ~/.openclaw/openclaw.json进入文件编辑，在~/.openclaw/openclaw.json文件中添加channels/dingtalk-connector、gateway/auth和gateway/http/endpoints3个配置项属性

说明
下方已省略其他配置项，只提供了核心配置项及需要配置钉钉的相关属性内容。

{
  "channels": {
    "dingtalk-connector": {
      "clientId": "钉钉应用的Client ID",       // 必选：填入上方的 钉钉 Client ID
      "clientSecret": "钉钉应用的Client Secret", // 必选：填入上方的 Client Secret
      "gatewayToken": "Gateway 认证 token",  // 必选：Gateway 认证 token, openclaw.json配置中 gateway.auth.token 的值 
      "gatewayPassword": "",              // 可选：Gateway 认证 password（与 token 二选一）
      "sessionTimeout": 1800000           // 可选：会话超时(ms)，默认 30 分钟
    }
  },
  "gateway": { // gateway通常是已有的节点，配置时注意把http部分追加到已有节点下
    "auth": {
      "mode": "token",
      "token": "Gateway 认证 token" // 必选：一般是安装时默认就有
    },
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true // 必选
        }
      }
    }
  }
}

重启OpenClaw服务

1	openclaw gateway restart

执行以下命令确认dingtalk-connector已加载

1	openclaw plugins list

使用钉钉机器人

场景一：单聊中使用机器人

在顶部搜索框中搜索已创建机器人名称直接使用。

场景二：群聊中使用机器人

打开钉钉客户端，进入任意群聊。

如果是已有群聊，需要确保群归属组织与创建机器人时的组织相同。
创建新的群聊，请确保创建时候选择的归属组织与创建机器人时的组织相同。

单击群设置（右上角），然后选择“机器人”，在机器人管理模块下，选择“添加机器人”，搜索上面创建并发布的机器人名称，点击机器人进行添加即可。

机器人添加成功后，通过@机器人，实现自动回复。

什么是OpenClaw

系统要求

实验环境

Ubuntu软件源配置

安装OpenClaw

初始化配置向导

访问OpenClaw Gateway Dashboard

开启工具执行权限

对接即时通讯(IM)软件

对接QQ机器人

对接企业微信机器人

创建企业

以长连接方式创建智能机器人，获取Bot ID和Secret

将OpenClaw关联到企业微信机器人

对接钉钉机器人

创建企业

一键创建OpenClaw机器人

将OpenClaw关联到钉钉机器人

使用钉钉机器人

参考文档