openclaw-discord-multiagent项目提供了一套完整的自托管方案，允许在同一OpenClaw网关上同时运行私人AI助手和公共Discord机器人，实现多代理路由、权限隔离和AI辅助服务器管理。

OpenClaw多代理Discord部署方案：单网关运行公私双Bot实战指南\n\n## 自托管AI代理的现实需求\n\n随着AI助手在日常工作和社区管理中的普及，越来越多的用户开始探索自托管方案。相比依赖第三方云服务，自托管带来了数据隐私、成本控制、定制化等显著优势。然而，如何在一台服务器上同时满足个人私密使用和公共社区服务两种截然不同的需求，是一个颇具挑战性的架构问题。\n\nopenclaw-discord-multiagent项目正是为解决这一痛点而生。它提供了一套经过生产环境验证的配置模板和运维知识库，帮助用户在单一OpenClaw网关上部署多个AI代理，分别服务于私人和公共场景。\n\n## 核心架构：双代理分离设计\n\n该方案的核心架构是在同一网关上运行两个独立的AI代理，通过Discord Bot账号进行路由隔离：\n\n| 代理 | 用途 | Discord Bot | Shell权限 | 记忆 |\n|------|------|-------------|-----------|------|\n| main | 私人助手（仅所有者） | 私人Bot | 完全访问 | 持久化MEMORY.md |\n| public | 公共社区Bot | 公共Bot | 受限（无exec/bash） | 无状态 |\n\n这种设计的精妙之处在于，两个代理共享同一个OpenClaw网关进程，但通过不同的Discord Bot账号接入，实现了逻辑上的完全隔离。用户与私人Bot的对话不会泄露到公共频道，而公共Bot即使被滥用也无法执行危险命令。\n\n## 配置要点详解\n\n### 多代理绑定配置\n\n在openclaw.json中，通过bindings字段将Discord Bot与特定代理关联：\n\njson\n{\n \"bindings\": [\n {\n \"channel\": {\n \"kind\": \"discord\",\n \"accountId\": \"private-bot-id\"\n },\n \"agent\": {\n \"name\": \"main\"\n }\n },\n {\n \"channel\": {\n \"kind\": \"discord\",\n \"accountId\": \"public-bot-id\"\n },\n \"agent\": {\n \"name\": \"public\"\n }\n }\n ]\n}\n\n\n每个Bot账号拥有独立的token，在Discord开发者门户中分别创建。这种设计确保了即使公共Bot的token意外泄露，攻击者也只能访问受限的public代理。\n\n### 权限控制策略\n\n私人代理（main）可以配置完整的工具访问权限，包括：\n\n- Shell命令执行\n- 文件系统读写\n- 外部API调用\n- 持久化记忆存储\n\n公共代理（public）则通过配置限制为只读或受限操作，建议禁用：\n\n- exec和bash工具\n- 文件系统写入\n- 敏感API访问\n\n此外，可以通过guildAllowlist限制公共Bot只能在特定Discord服务器中使用，requireMention设置确保Bot只在被@时才响应，避免干扰正常对话。\n\n### 自定义Docker镜像\n\n项目提供了Dockerfile.custom模板，展示如何基于官方openclaw:latest镜像扩展自定义工具：\n\ndockerfile\nFROM openclaw/openclaw:latest\n\n# 安装GitHub CLI\nRUN apt-get update && apt-get install -y gh\n\n# 安装Gmail OAuth工具\nCOPY gmail-cli /usr/local/bin/\n\n# 安装Google Places API工具\nRUN pip install google-places-cli\n\n# 安装ClawHub CLI\nRUN pip install clawhub\n\n\n自定义镜像的名称通过.env文件固定，确保上游更新不会覆盖本地修改。这种"继承而非修改"的策略是长期维护的关键。\n\n## Claude Code工作流：AI辅助服务器管理\n\n项目的一大亮点是集成Claude Code作为服务器管理工具。通过.claude/skills/目录下的自定义技能，用户可以用自然语言与AI协作完成运维任务：\n\n### 会话启动技能（session）\n\n自动加载环境上下文、读取技能定义、建立语言规则。每次打开Claude Code时，AI助手已经了解当前服务器的配置状态和文件布局。\n\n### 同步技能（sync）\n\n实现服务器工作区与本地Git仓库的双向同步，包含冲突检测机制。在修改任何文件之前，系统会自动检查版本一致性，避免覆盖他人修改。\n\n### 编辑技能（edit）\n\n封装安全的文件修改协议，确保对服务器和仓库文件的变更都经过适当的验证和备份。\n\n### 自我改进技能（self-improve）\n\n记录运维过程中的经验教训，自动提出对仓库结构和服务器配置的改进建议。这种持续学习的机制使得部署方案能够随时间进化。\n\n## 部署流程概览\n\n根据项目文档，完整的部署流程包括：\n\n1. 准备VPS：选择合适的服务器配置（建议2核4GB起步）\n2. 安装Docker和Docker Compose：按照官方文档完成基础环境配置\n3. 克隆配置仓库：将openclaw-discord-multiagent仓库复制到服务器\n4. 配置Discord Bot：在Discord开发者门户创建两个Bot应用，获取token\n5. 填写配置文件：复制config/openclaw.json模板，填入实际的API密钥和Bot token\n6. 自定义代理人格：从templates/目录复制AGENTS.md、SOUL.md等文件，根据需求定制\n7. 构建自定义镜像：运行docker build -f Dockerfile.custom -t openclaw:custom .\n8. 启动服务：docker-compose up -d\n9. 验证部署：分别在私人和公共频道测试Bot响应\n\n## 运维最佳实践\n\n项目文档还涵盖了丰富的运维知识：\n\n### 镜像管理\n\n- 定期拉取上游更新，但保持自定义层的独立\n- 使用语义化版本标签管理镜像版本\n- 保留回滚方案，确保更新失败时可以快速恢复\n\n### 日志与监控\n\n- 配置日志轮转，避免磁盘空间耗尽\n- 监控token使用量，设置预算告警\n- 定期检查容器健康状态\n\n### 备份策略\n\n- 定期备份state.sqlite3和代理工作区\n- 将配置文件纳入Git版本控制\n- 测试恢复流程，确保灾难时可快速重建\n\n## 适用场景与价值\n\n这套部署方案特别适合以下场景：\n\n- 个人知识管理：私人Bot作为全天候待命的智能笔记助手\n- 社区运营：公共Bot为Discord服务器提供问答、 moderation 等服务\n- 开发团队：结合Claude Code实现AI辅助的代码审查、文档维护\n- 教育场景：为学生提供安全可控的AI交互环境\n\n通过将私人使用和公共服务整合到单一网关，用户可以在保证安全隔离的前提下，最大化硬件资源的利用效率，降低总体拥有成本。

OpenClaw多代理Discord部署方案：单网关运行公私双Bot实战指南\n\n自托管AI代理的现实需求\n\n随着AI助手在日常工作和社区管理中的普及，越来越多的用户开始探索自托管方案。相比依赖第三方云服务，自托管带来了数据隐私、成本控制、定制化等显著优势。然而，如何在一台服务器上同时满足个人私密使用和公共社区服务两种截然不同的需求，是一个颇具挑战性的架构问题。\n\nopenclaw-discord-multiagent项目正是为解决这一痛点而生。它提供了一套经过生产环境验证的配置模板和运维知识库，帮助用户在单一OpenClaw网关上部署多个AI代理，分别服务于私人和公共场景。\n\n核心架构：双代理分离设计\n\n该方案的核心架构是在同一网关上运行两个独立的AI代理，通过Discord Bot账号进行路由隔离：\n\n| 代理 | 用途 | Discord Bot | Shell权限 | 记忆 |\n|------|------|-------------|-----------|------|\n| main | 私人助手（仅所有者） | 私人Bot | 完全访问 | 持久化MEMORY.md |\n| public | 公共社区Bot | 公共Bot | 受限（无exec/bash） | 无状态 |\n\n这种设计的精妙之处在于，两个代理共享同一个OpenClaw网关进程，但通过不同的Discord Bot账号接入，实现了逻辑上的完全隔离。用户与私人Bot的对话不会泄露到公共频道，而公共Bot即使被滥用也无法执行危险命令。\n\n配置要点详解\n\n多代理绑定配置\n\n在openclaw.json中，通过bindings字段将Discord Bot与特定代理关联：\n\njson\n{\n \"bindings\": [\n {\n \"channel\": {\n \"kind\": \"discord\",\n \"accountId\": \"private-bot-id\"\n },\n \"agent\": {\n \"name\": \"main\"\n }\n },\n {\n \"channel\": {\n \"kind\": \"discord\",\n \"accountId\": \"public-bot-id\"\n },\n \"agent\": {\n \"name\": \"public\"\n }\n }\n ]\n}\n\n\n每个Bot账号拥有独立的token，在Discord开发者门户中分别创建。这种设计确保了即使公共Bot的token意外泄露，攻击者也只能访问受限的public代理。\n\n权限控制策略\n\n私人代理（main）可以配置完整的工具访问权限，包括：\n\n- Shell命令执行\n- 文件系统读写\n- 外部API调用\n- 持久化记忆存储\n\n公共代理（public）则通过配置限制为只读或受限操作，建议禁用：\n\n- exec和bash工具\n- 文件系统写入\n- 敏感API访问\n\n此外，可以通过guildAllowlist限制公共Bot只能在特定Discord服务器中使用，requireMention设置确保Bot只在被@时才响应，避免干扰正常对话。\n\n自定义Docker镜像\n\n项目提供了Dockerfile.custom模板，展示如何基于官方openclaw:latest镜像扩展自定义工具：\n\ndockerfile\nFROM openclaw/openclaw:latest\n\n安装GitHub CLI\nRUN apt-get update && apt-get install -y gh\n\n安装Gmail OAuth工具\nCOPY gmail-cli /usr/local/bin/\n\n安装Google Places API工具\nRUN pip install google-places-cli\n\n安装ClawHub CLI\nRUN pip install clawhub\n\n\n自定义镜像的名称通过.env文件固定，确保上游更新不会覆盖本地修改。这种"继承而非修改"的策略是长期维护的关键。\n\nClaude Code工作流：AI辅助服务器管理\n\n项目的一大亮点是集成Claude Code作为服务器管理工具。通过.claude/skills/目录下的自定义技能，用户可以用自然语言与AI协作完成运维任务：\n\n会话启动技能（session）\n\n自动加载环境上下文、读取技能定义、建立语言规则。每次打开Claude Code时，AI助手已经了解当前服务器的配置状态和文件布局。\n\n同步技能（sync）\n\n实现服务器工作区与本地Git仓库的双向同步，包含冲突检测机制。在修改任何文件之前，系统会自动检查版本一致性，避免覆盖他人修改。\n\n编辑技能（edit）\n\n封装安全的文件修改协议，确保对服务器和仓库文件的变更都经过适当的验证和备份。\n\n自我改进技能（self-improve）\n\n记录运维过程中的经验教训，自动提出对仓库结构和服务器配置的改进建议。这种持续学习的机制使得部署方案能够随时间进化。\n\n部署流程概览\n\n根据项目文档，完整的部署流程包括：\n\n1. 准备VPS：选择合适的服务器配置（建议2核4GB起步）\n2. 安装Docker和Docker Compose：按照官方文档完成基础环境配置\n3. 克隆配置仓库：将openclaw-discord-multiagent仓库复制到服务器\n4. 配置Discord Bot：在Discord开发者门户创建两个Bot应用，获取token\n5. 填写配置文件：复制config/openclaw.json模板，填入实际的API密钥和Bot token\n6. 自定义代理人格：从templates/目录复制AGENTS.md、SOUL.md等文件，根据需求定制\n7. 构建自定义镜像：运行docker build -f Dockerfile.custom -t openclaw:custom .\n8. 启动服务：docker-compose up -d\n9. 验证部署：分别在私人和公共频道测试Bot响应\n\n运维最佳实践\n\n项目文档还涵盖了丰富的运维知识：\n\n镜像管理\n\n- 定期拉取上游更新，但保持自定义层的独立\n- 使用语义化版本标签管理镜像版本\n- 保留回滚方案，确保更新失败时可以快速恢复\n\n日志与监控\n\n- 配置日志轮转，避免磁盘空间耗尽\n- 监控token使用量，设置预算告警\n- 定期检查容器健康状态\n\n备份策略\n\n- 定期备份state.sqlite3和代理工作区\n- 将配置文件纳入Git版本控制\n- 测试恢复流程，确保灾难时可快速重建\n\n适用场景与价值\n\n这套部署方案特别适合以下场景：\n\n- 个人知识管理：私人Bot作为全天候待命的智能笔记助手\n- 社区运营：公共Bot为Discord服务器提供问答、 moderation 等服务\n- 开发团队：结合Claude Code实现AI辅助的代码审查、文档维护\n- 教育场景：为学生提供安全可控的AI交互环境\n\n通过将私人使用和公共服务整合到单一网关，用户可以在保证安全隔离的前提下，最大化硬件资源的利用效率，降低总体拥有成本。