OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书
查看原始文档 最近生成：2026/03/08 15:37

简要总结

Discord

这页说明书是教你怎样让你的智能小助手（我们叫它 OpenClaw）在 Discord 里跟你聊天。Discord 就像一个有很多房间的俱乐部，你可以和朋友们在里面打字说话。现在，我们想让你的小助手也加入这个俱乐部，这样你就可以在 Discord 里直接问它问题啦！

你需要先为小助手在 Discord 里创建一个“机器人”身份，就像给它办一张会员卡，然后把它邀请到你的私人服务器（也就是你的专属俱乐部房间），最后再把它们俩连接起来。准备好了吗？我们开始吧！

五岁小孩版解释

第一步：创建 Discord 机器人和拿到“钥匙”

我们要先去一个叫“Discord 开发者门户”的网站，为你的小助手创建一个机器人身份。

  1. 创建应用和机器人：这就像给你的小助手起个名字、办个身份证。

    • 做什么：去 Discord 开发者门户，点击 New Application（新建应用）。
    • 怎么做：给它起个名字，比如“OpenClaw”。然后在左边菜单点 Bot（机器人），设置一个 Username（用户名），就是你希望小助手在 Discord 里叫什么。

  2. 打开重要的“开关”：为了让小助手能看懂消息和认识服务器里的成员，我们需要打开几个特别的权限开关。

    • 做什么：还是在 Bot 页面，往下找到 Privileged Gateway Intents（特权网关意图）。
    • 怎么做：把下面这些开关都打开：
      • Message Content Intent（消息内容意图）必须打开。
      • Server Members Intent（服务器成员意图）建议打开，这样小助手才能认识人。
      • Presence Intent（在线状态意图）可以不开，除非你需要小助手知道谁在线。

  3. 复制你的机器人令牌：这个令牌就像机器人的超级秘密密码，千万不能告诉别人哦！

    • 做什么：在 Bot 页面上方，点击 Reset Token（重置令牌）。
    • 小心：别被名字吓到，第一次点它就会生成密码，并不是真的重置了什么。
    • 怎么做：把生成的那串字母数字复制下来，好好保存。这就是你的 Bot Token（机器人令牌），等下要用。

  4. 生成邀请链接，把机器人请进你的服务器：现在我们要给小助手发一张进入你私人俱乐部的门票。

    • 做什么：点击左边菜单的 OAuth2，我们要生成一个带有正确权限的邀请链接。
    • 怎么做：
      1. 在 OAuth2 URL Generator（URL生成器）下面，勾选 bot 和 applications.commands。
      2. 下面会出现 Bot Permissions（机器人权限），勾选这些：查看频道、发送消息、读取消息历史、嵌入链接、附加文件。（“添加反应”可以选，不是必须的。）
      3. 把页面最下面生成的链接复制下来，贴到你的浏览器里打开。
      4. 选择你想邀请机器人进入的 Discord 服务器，点击 Continue（继续）。现在你应该能在你的服务器成员列表里看到你的机器人啦！

  5. 打开“开发者模式”，拿到你的 ID：我们需要几个数字 ID 来告诉小助手你是谁、你的服务器是哪个。

    • 做什么：回到 Discord 软件里，打开一个叫“开发者模式”的功能，这样你就能复制这些内部 ID 了。
    • 怎么做：
      1. 点你的头像旁边的齿轮图标 User Settings（用户设置）→ Advanced（高级）→ 打开 Developer Mode（开发者模式）。
      2. 在左边服务器列表里，右键点你的 服务器图标 → Copy Server ID（复制服务器 ID）。
      3. 右键点你自己的 头像 → Copy User ID（复制用户 ID）。
    • 记住：把 Server ID（服务器ID）和 User ID（用户ID）和你刚才的 Bot Token 放在一起保存好。

  6. 允许机器人给你发私信：为了让后面的“配对”步骤能成功，你需要允许机器人给你发私人消息。

    • 做什么：在 Discord 里，右键点你的 服务器图标 → Privacy Settings（隐私设置）→ 打开 Direct Messages（私信）这个开关。
    • 注意：如果你只想在服务器频道里聊天，配对完成后可以关掉它。

第二步：告诉 OpenClaw 你的机器人密码，并把它们连起来

现在我们要回到 OpenClaw 这边，把刚才拿到的东西告诉它。

  1. 安全地设置机器人令牌（千万不要在聊天里发这个！）：机器人的令牌是秘密，要悄悄地告诉运行 OpenClaw 的电脑。

    • 做什么：在运行 OpenClaw 的电脑上，输入命令来设置令牌并启动网关（网关就像小助手的耳朵和嘴巴）。
    • 怎么做：打开终端（命令行），输入：
      openclaw config set channels.discord.token '"YOUR_BOT_TOKEN"' --json
openclaw config set channels.discord.enabled true --json
openclaw gateway
    • 注意：如果 OpenClaw 已经在后台运行了，就用 openclaw gateway restart 这个命令。

  2. 配置 OpenClaw 并配对：现在告诉小助手你的用户 ID 和服务器 ID，完成连接。

    • 方法一（通过聊天）：如果你已经在其他渠道（比如 Telegram）和小助手聊着天，就直接对它说：

      “我已经在配置里设置好 Discord 机器人令牌了。请用 User ID <你的用户ID> 和 Server ID <你的服务器ID> 完成 Discord 设置。”

    • 方法二（通过配置文件）：你也可以直接修改配置文件，把 enabled 设为 true，token 设成你的令牌。

  3. 批准第一次私信配对：最后一步，让小助手在 Discord 里跟你打个招呼确认一下。

    • 做什么：等网关运行起来后，在 Discord 里给你的机器人发一条私信。
    • 怎么做：它会回复你一个配对码。你需要把这个码告诉 OpenClaw 来批准连接。
      • 通过聊天：在你原来聊天的地方对小助手说：“批准这个 Discord 配对码：<配对码>”。
      • 通过命令行：也可以用 openclaw pairing approve discord <配对码> 这个命令。
    • 小心：配对码 1 小时后就会失效哦！

完成啦！现在你应该能在 Discord 的私信里和你的小助手聊天了。

让机器人在整个服务器里工作（推荐）

如果你希望小助手不光在私信里，也能在你服务器的各个频道里回答大家的问题，可以接着设置：

  1. 把服务器加入“允许名单”：告诉小助手它可以在这个服务器里所有频道说话。

    • 对你的小助手说：“把我的 Discord 服务器 ID <服务器ID> 加到公会允许名单里”。

  2. 允许它不用@也能回答：默认在服务器频道里，需要@小助手它才会回答。如果你的服务器只有你自己，可以关掉这个限制。

    • 对小助手说：“允许我的小助手在这个服务器里不用被@也能回复”。

  3. 为频道聊天准备“记忆”：小助手的长篇记忆（MEMORY.md 文件）默认只在私信时自动读取。在服务器频道里，如果你需要用到那些记忆，可以告诉它：“当我在 Discord 频道里提问时，如果你需要 MEMORY.md 里的长期记忆，就用 memory_search 或 memory_get 工具去找”。

现在，在你的 Discord 服务器里创建一些频道（比如 #编程、#学习），就可以开始聊天了！每个频道对小助手来说都是一个独立的小房间。