在Zo Computer部署OpenClaw AI智能体：打造自动化数字助手

1. 项目概述：在 Zo Computer 上部署全能 AI 助手

如果你手头有一台 Zo Computer，并且已经厌倦了每次都需要手动登录、输入指令来让它干活，那么把 OpenClaw 这个 AI 智能体框架部署上去，绝对能打开新世界的大门。这不仅仅是多了一个聊天机器人，而是给你的服务器注入了一个拥有“记忆”、“身份”和“自主行动能力”的数字伙伴。想象一下，一个能 7x24 小时待命，帮你监控服务、自动回复消息、整理日程、甚至根据你的日历和邮件内容主动生成日报的助手。这听起来像是科幻片里的情节，但通过 OpenClaw 与 Zo Computer 原生 MCP 工具的深度整合，今天就能实现。

我花了几天时间，从零开始在我的 Zo Computer 上搭建并调试好了这套系统。整个过程就像是在组装一个超级工具箱：OpenClaw 提供了智能体的“大脑”和“躯干”（记忆、调度、多通道通信），而 Zo Computer 则提供了超过 50 种现成的“手”和“眼睛”（Gmail、日历、图像生成、网页研究、部署等）。通过 mcporter 这个桥梁，两者得以无缝连接。最终的效果是，我可以通过 Telegram 给我的 AI 助手发一句“帮我查查今天 AI 圈有什么新闻，然后发个摘要到我邮箱”，它就能自动完成搜索、总结、并发送邮件这一系列操作，全程无需我干预。

这篇文章，就是我这次搭建过程的完整记录和深度复盘。我会详细拆解每一个步骤背后的原理、可能遇到的坑，以及如何确保这个智能体能够稳定、持久地运行。无论你是想打造一个个人自动化助理，还是探索 AI 智能体的可能性，这篇指南都能让你少走很多弯路。

2. 核心组件与架构解析

在开始动手之前，理解整个系统的架构和各组件的职责至关重要。这能帮助你在遇到问题时，快速定位是哪个环节出了岔子。

2.1 三大核心组件：OpenClaw, Zo Computer 与 mcporter

OpenClaw是整个智能体的核心框架。你可以把它理解为一个智能体的“操作系统”或“运行时环境”。它主要负责几件事：

1. 对话与记忆管理：处理来自 Telegram、Discord 等消息通道的输入，维护对话的上下文和历史，让智能体拥有“短期记忆”。
2. 任务调度与执行：允许你为智能体设置定时任务（Cron Jobs），比如每天上午 9 点自动检查日历并发送日程提醒。
3. 基础工具集成：内置了访问服务器 Shell、读写本地文件、进行基础网页浏览等核心工具。这是智能体与它所运行的服务器环境交互的基础能力。
4. LLM 集成与推理：负责连接 Anthropic Claude 或 OpenAI GPT 等大语言模型，将用户的指令、上下文和可用工具信息组织成提示词（Prompt），并解析模型的输出，决定下一步行动。

Zo Computer在这里扮演了两个角色。首先，它是一个云服务器，提供了 Linux 环境、预装的 Node.js 等，是 OpenClaw 的“宿主”。其次，也是更关键的一点，Zo 平台通过其MCP（Model Context Protocol）协议，暴露了超过 50 个预集成的、开箱即用的工具。这些工具不是简单的 API 包装，而是已经完成了 OAuth 等繁琐认证流程的“即插即用”模块。这意味着你的智能体无需处理获取 Gmail API 令牌、配置 Google Cloud 项目等复杂步骤，直接就能调用“发送邮件”、“读取日历”等功能。

mcporter是连接 OpenClaw 和 Zo MCP 工具的“粘合剂”。MCP 协议本身是一种标准，但 OpenClaw 不能直接调用 Zo 的 MCP 服务。mcporter 作为一个独立的服务或命令行工具，充当了 MCP 服务器（Zo）和 MCP 客户端（OpenClaw 智能体）之间的代理或适配器。它负责：

• 认证：使用你的 Zo 账户凭证（Access Token）与 Zo 的 MCP API 建立安全连接。
• 工具发现与注册：从 Zo 获取所有可用工具的列表及其描述，并将它们“暴露”给 OpenClaw，让智能体知道有哪些工具可以用。
• 调用转发：当 OpenClaw 智能体决定使用某个 Zo 工具（如generate_image）时，mcporter 负责将调用请求转发给 Zo 的 MCP 服务，并将结果返回给智能体。

2.2 数据流与工作流程

理解了组件，我们来看一次完整的交互是如何发生的：

1. 用户触发：你在 Telegram 上给你的 Bot 发送消息：“查看我今天的日程”。
2. 通道接收：OpenClaw Gateway（网关服务）接收到来自 Telegram 的消息。
3. 会话管理：OpenClaw 将这条新消息与之前的对话历史合并，形成当前的对话上下文。
4. 工具决策：OpenClaw 将上下文发送给配置的 LLM（如 Claude）。LLM 分析后认为，需要调用 Zo 的日历工具use_app_google_calendar。
5. 工具调用：由于你在TOOLS.md工作区文件中定义了通过mcporter call zo.use_app_google_calendar ...来使用该工具，OpenClaw 会尝试执行这个 Shell 命令。
6. 桥接执行：mcporter命令行工具被调用，它携带你的 Access Token 向https://api.zo.computer/mcp发起请求。
7. 结果返回：Zo 平台执行日历查询，将结果（今天的日程列表）通过 mcporter 返回给 OpenClaw。
8. 回复生成：OpenClaw 将工具返回的结果再次融入上下文，发送给 LLM。LLM 生成一段人类可读的回复，例如“您今天有两个会议：上午 10 点的项目同步，下午 3 点的客户评审。”
9. 消息发送：OpenClaw 通过 Telegram 通道将这条回复发送给你。

整个流程在几秒内完成，对你而言，只是在 Telegram 里问了一句话。但对系统来说，这是一次涉及多个服务、认证、工具调用和 LLM 推理的复杂协同作业。

2.3 权限模型与安全边界

这是一个必须厘清的关键概念。你的智能体将在你的 Zo Computer 上运行，这意味着它本质上拥有对该服务器环境的访问权限。OpenClaw 通过tools.profile配置项来控制这种权限级别：

• messaging：最低权限。智能体只能进行对话，无法执行任何 Shell 命令、读写文件或访问网络。这适合完全封闭的聊天场景。
• full：我们需要的权限。智能体可以执行 Shell 命令、读写服务器文件、进行网络访问。这是让智能体能够通过 mcporter 调用 Zo 工具，以及执行任何自动化脚本的前提。

重要安全提示：将tools.profile设置为full意味着你赋予了这个 AI 智能体在服务器上执行任意命令的能力。请务必确保你的工作区文件（IDENTITY.md,TOOLS.md）中包含了明确的行为准则，并且你信任所使用的 LLM（如 Claude）的安全性。切勿在来历不明的服务器或共享环境中进行此操作。

3. 环境准备与核心配置详解

好了，理论部分结束，我们开始动手。这一部分我会带你完成所有前置条件的准备和核心组件的安装，每一步我都会解释“为什么这么做”，以及如何验证是否成功。

3.1 获取必要的密钥与令牌

在登录 Zo Computer 之前，我们需要先准备好三把“钥匙”。

第一把钥匙：Zo Computer 访问权限这很简单，你需要一个 Zo Computer 的账户。任何套餐都可以，因为基础套餐也提供了完整的 SSH 和 MCP 工具访问能力。

第二把钥匙：LLM API 密钥OpenClaw 本身不提供 AI 能力，它需要连接一个大语言模型。最推荐的是Anthropic Claude，它在遵循指令和工具使用方面表现非常出色。

1. 访问 Anthropic 控制台 。
2. 注册/登录后，在Settings->API Keys页面，点击Create Key。
3. 为这个密钥起个名字，比如openclaw-on-zo，然后复制生成的以sk-ant-开头的密钥字符串。这个密钥只会显示一次，请立即妥善保存。

为什么选择 Claude？相比于其他模型，Claude 在理解复杂指令、安全边界意识和工具调用规划上更为可靠。对于需要高自主性和安全性的智能体应用，它是目前的最佳选择之一。模型建议选择claude-3-5-sonnet-20241022，它在能力、速度和成本之间取得了很好的平衡。如果追求极致能力且不计成本，可以考虑claude-3-5-haiku-20241022或更新的版本。

第三把钥匙：消息通道令牌智能体需要与你通信。Telegram Bot 是最简单、稳定的选择。

1. 在 Telegram 中搜索@BotFather并打开对话。
2. 发送/newbot指令。
3. 按照提示，先给你的 Bot 起一个显示名称（如My Zo Assistant），然后起一个唯一的用户名（必须以bot结尾，如my_zo_assistant_bot）。
4. 创建成功后，BotFather 会给你一个长字符串令牌，格式类似1234567890:ABCdefGhIJKlmNoPQRsTUVwxyZ。复制并保存好。

3.2 安装 OpenClaw 与初始配置

通过 SSH 连接到你的 Zo Computer。Zo 的服务器环境通常是基于 Debian/Ubuntu 的 Linux，并且已经预装了 Node.js 和 npm。

# 1. 全局安装 OpenClaw。使用 `@latest` 确保获取最新稳定版。 npm install -g openclaw@latest # 2. 验证安装是否成功。成功会显示版本号，例如 `2026.3.2`。 openclaw --version # 3. 如果上一步报错 `command not found: npm`，则需要先安装 Node.js。 # （Zo Computer 通常已预装，此步大概率可跳过） curl -fsSL https://deb.nodesource.com/setup_22.x | bash - apt-get install -y nodejs

安装完成后，运行初始化向导。这个交互式向导会帮你创建基础配置文件。

openclaw onboard

向导会依次询问你：

1. LLM Provider：选择Anthropic。
2. API Key：粘贴你从 Anthropic 控制台复制的sk-ant-...密钥。
3. Model：选择claude-3-5-sonnet-20241022（推荐）或claude-3-opus-20240229（能力更强，更贵更慢）。
4. Permissions：这里非常关键！务必选择Full access。如果错过这一步，后续智能体将无法执行任何命令。
5. Starter Skills：可以选择安装一些示例技能，也可以直接跳过。

向导运行完毕后，会在/root/.openclaw/目录下生成openclaw.json配置文件。

实操心得：即使你在向导中选择了Full access，有时由于版本或 bug，生成的配置里tools.profile可能仍然是"messaging"。这是新手遇到的第一个大坑，会导致智能体“哑火”。所以安装后第一件事就是检查并修正它。

3.3 关键配置修正：确保工具权限完整

让我们立即检查并修复这个最重要的配置项。

# 检查当前的工具权限配置 openclaw config get tools.profile # 如果输出不是 "full"，则必须将其设置为 "full" openclaw config set tools.profile full # 再次确认修改已生效 openclaw config get tools.profile

如果config set命令没有生效，或者你想更直接地修改，可以手动编辑配置文件：

# 使用 sed 命令直接替换配置文件中的值 sed -i 's/"tools": {[^}]*"profile": "messaging"/"tools": {\n "profile": "full"/' /root/.openclaw/openclaw.json # 或者，用文本编辑器（如 nano）打开文件，找到 "tools" 部分，确保其内容如下： # "tools": { # "profile": "full" # }

为什么这一步如此重要？tools.profile是 OpenClaw 内部的安全开关。当它为"messaging"时，OpenClaw 会严格限制智能体，禁止它执行任何 Shell 命令（包括调用mcporter）。这意味着即使 mcporter 和 Zo 工具配置得再好，智能体也无法触及它们，因为它根本没有执行mcporter call这条命令的权限。你会看到智能体在对话中承诺会去做某事，然后陷入沉默，因为它被系统层面禁止了行动。

3.4 配置消息通道（以 Telegram 为例）

现在，让我们把智能体的“嘴巴”和“耳朵”装上，即配置 Telegram 通道。

# 启用 Telegram 通道 openclaw config set channels.telegram.enabled true # 设置你的 Telegram Bot Token openclaw config set channels.telegram.botToken "YOUR_TELEGRAM_BOT_TOKEN_HERE" # （可选但推荐）配置群组策略。如果你希望 Bot 在群组中也能响应，设置为 "open"。 # 如果设置为 "allowlist"，则需要额外配置允许的发送者 ID，否则群组消息会被静默忽略。 openclaw config set channels.telegram.groupPolicy open

将YOUR_TELEGRAM_BOT_TOKEN_HERE替换为之前从 @BotFather 那里获取的令牌。完成这一步后，你的 OpenClaw 智能体已经具备了基础能力：能思考（LLM），能与你对话（Telegram），并且被允许在服务器上执行命令（tools.profile: full）。

4. 打通任督二脉：安装与配置 mcporter

这是将 Zo Computer 强大原生能力赋予智能体的关键一步。没有 mcporter，智能体只是一个能聊天的脚本；有了 mcporter，它才真正成为你的数字雇员。

4.1 安装 mcporter

安装过程很简单，同样通过 npm 进行。

npm install -g mcporter

安装完成后，可以运行mcporter --help查看基本命令。但此时它还无法工作，因为它不知道如何连接你的 Zo 账户。

4.2 获取并配置认证令牌

mcporter 需要一把“钥匙”来访问你的 Zo MCP 服务。这里有两种类型的钥匙，选择哪一种直接决定了你未来维护的复杂度。

方案A：使用永久访问令牌（Access Token）—— 强烈推荐这是 Zo 平台提供的永久性 API 密钥，不会自动过期，除非你手动撤销。

1. 登录 Zo Computer 控制面板 。
2. 进入Settings->Advanced页面。
3. 在Access Tokens区域，输入一个描述性的名称（例如mcporter-integration），然后点击+按钮。
4. 页面会立即生成并显示一个以zo_sk_开头的令牌。这个令牌只会显示这一次！请立即将其复制并保存到安全的地方（如密码管理器）。

方案B：使用 JWT 令牌（不推荐）你的 Zo Computer 服务器上存在一个文件/root/.zo_secrets，里面包含了一个 JWT (JSON Web Token)。这个令牌也可以用来认证。但是，它有一个致命缺陷：大约每 24 小时会自动刷新（失效）。如果你使用这个 JWT 配置 mcporter，那么每隔一天，你的智能体就会因为认证失败而“失声”，所有 Zo 工具调用都会失败，且错误信息可能不直观。你需要手动更新配置文件中的令牌，这完全违背了自动化的初衷。

避坑指南：我强烈建议，并且所有稳定运行的案例都表明，必须使用永久访问令牌（Access Token）。这能彻底消除因凭证过期导致的周期性故障，是保障智能体 7x24 小时稳定运行的基础。

4.3 创建 mcporter 配置文件

有了访问令牌，我们来创建 mcporter 的配置文件，告诉它如何连接 Zo。

# 创建 mcporter 的配置目录 mkdir -p /root/.mcporter # 创建配置文件，并填入你的访问令牌 cat > /root/.mcporter/mcporter.json << 'EOF' { "mcpServers": { "zo": { "baseUrl": "https://api.zo.computer/mcp", "description": "Zo Computer MCP tools (native platform)", "headers": { "Authorization": "Bearer zo_sk_your_actual_access_token_here" } } }, "imports": [] } EOF

请务必将zo_sk_your_actual_access_token_here替换成你刚刚生成的永久访问令牌。

4.4 验证连接

配置文件就绪后，进行一次连接测试，确保 mcporter 能成功看到 Zo 提供的所有工具。

mcporter list

如果一切正常，你会看到一个长长的列表，显示zo服务器状态为healthy，并列出其下的所有工具（如web_search,send_email_to_user,generate_image等），数量应该在 60 个左右。

如果遇到问题：

• Error: auth required或列表为空：99% 的原因是令牌错误或已失效。请回到 Zo 控制面板的Settings->Advanced，确认你的 Access Token 存在且未被撤销。然后仔细检查配置文件中的Authorization头，确保Bearer后面有一个空格，并且令牌字符串完全正确，没有多余的空格或换行。
• 命令未找到：确认npm install -g mcporter已成功执行。可以尝试which mcporter查看安装路径。

5. 赋予智能体“知识与记忆”：工作区文件配置

OpenClaw 智能体在每次启动新会话时，会加载/root/.openclaw/workspace/目录下的所有 Markdown (.md) 文件，并将其内容作为系统提示词的一部分提供给 LLM。这是你塑造智能体性格、告知其能力、设定其行为准则的地方。你可以把它想象成给新员工的一份入职手册。

5.1 创建核心工具说明文件 (TOOLS.md)

这是最重要的文件。它明确告诉智能体：你有另一套强大的工具叫 mcporter，应该这样使用它们。

# 创建 workspace 目录（如果不存在） mkdir -p /root/.openclaw/workspace # 创建 TOOLS.md 文件 cat > /root/.openclaw/workspace/TOOLS.md << 'EOF' # 可用工具与集成说明 ## 通过 mcporter 访问 Zo 平台工具 你除了拥有 OpenClaw 内置的工具（如执行 Shell 命令、读写文件）外，还通过 `mcporter` 桥接器获得了访问 Zo Computer 原生 MCP 工具的权限。这些工具功能强大且已预先完成认证。 ### 如何使用 mcporter 工具 当需要调用 Zo 平台的工具时，请在你的思考过程中明确，并在最终执行时使用以下命令格式： ```bash mcporter call zo.<工具名称> 参数1=值1 参数2=值2 ...

对于需要 JSON 对象的复杂参数，请将 JSON 字符串用单引号包裹传递。

重要工具类别与示例

1. 网络与搜索

• web_search: 网络搜索。例：mcporter call zo.web_search query="最新的深度学习框架" time_range="week"
• web_research: 深度研究，会综合多个来源。例：mcporter call zo.web_research query="OpenClaw 与 LangChain 对比"
• read_webpage: 读取并总结网页内容。例：mcporter call zo.read_webpage url="https://example.com"

2. 通信与协作

• send_email_to_user: 向我的注册邮箱发送邮件。例：mcporter call zo.send_email_to_user subject="项目日报" markdown_body="## 今日完成..."
• send_sms_to_user: 发送短信（需账户支持）。
• use_app_google_calendar: 管理 Google 日历。这是最强大的工具之一，通过tool_name指定操作：
  • 查看日程：mcporter call zo.use_app_google_calendar tool_name="list-events" configured_props='{"maxResults": 5}'
  • 创建事件：mcporter call zo.use_app_google_calendar tool_name="create-event" configured_props='{"summary": "团队会议", "start": {"dateTime": "2024-01-01T10:00:00"}}'

3. 内容生成与媒体

• generate_image: 文生图。例：mcporter call zo.generate_image prompt="赛博朋克风格的城市夜景，霓虹灯光" file_stem="cyberpunk-city" aspect_ratio="16:9"
• generate_video: 生成短视频（实验性）。
• edit_image: 编辑图片（如扩图、局部重绘）。

4. 文件与部署（Zo 空间）

• read_file/create_or_rewrite_file/edit_file/list_files: 管理你在 Zo 空间内的文件。
• update_space_route: 部署一个网页到你的 Zo 子域名。例：mcporter call zo.update_space_route path="/dashboard" route_type="page" public=true code='export default function() { return <h1>我的数据看板</h1> }'
• create_website: 创建更复杂的静态网站。

5. 自动化与代理

• create_agent: 创建一个新的定时任务代理。
• list_agents: 查看现有代理。

关键注意事项

1. 工具是分离的：OpenClaw 的内置工具（如run_shell）和 Zo 的 mcporter 工具是两套系统。需要操作服务器本身时用前者，需要调用 Zo 平台服务（邮件、日历、生成等）时用后者。
2. 参数格式：使用key=value格式，不是--key value或 JSON 对象直接传递。复杂 JSON 用单引号包裹。
3. 探索工具：如果不确定工具用法，可以随时使用mcporter call zo.tool_docs tool_name="<工具名>"来查询详细文档。
4. 列出所有工具：运行mcporter list zo可以查看所有可用的 Zo 工具及其简要描述。 EOF

### 5.2 创建身份与行为准则文件 (`IDENTITY.md`) 这个文件定义了智能体是谁，以及它应该如何行事。 ```bash cat > /root/.openclaw/workspace/IDENTITY.md << 'EOF' # 身份与职责 你是运行在 Zo Computer 上的 AI 助手，名为“哨兵”（Sentinel）。你的核心使命是高效、可靠地协助我处理数字事务，并在我允许的范围内主动优化工作流。 ## 核心原则 1. **主动性**：在清晰授权或符合惯例的范围内，主动执行任务。例如，当我问“今天天气如何？”时，你应该直接调用 `web_search` 查询并告诉我结果，而不是反问“需要我帮你查天气吗？”。 2. **简洁性**：回复应直接、信息密集，避免不必要的寒暄和冗余解释。提供结论、数据或下一步行动建议。 3. **可靠性**：对于任何操作（尤其是写文件、发邮件、创建日历事件），在执行前应在思考中明确该操作的影响。如果存在潜在风险（如覆盖重要文件），可以简要确认，但不要过度谨慎阻碍常规流程。 4. **工具优先**：充分利用你所有的工具。能自动化完成的绝不手动描述步骤。需要信息时，优先使用 `web_search` 或 `web_research`；需要操作外部服务时，优先使用对应的 mcporter 工具。 ## 能力范围 - 你拥有对当前服务器的完整 Shell 和文件访问权限 (`tools.profile: full`)。 - 你可以通过 mcporter 调用所有 Zo 平台工具（邮件、日历、生成、部署等）。 - 你可以访问互联网以获取信息。 - 你能够维护对话上下文，拥有短期记忆。 ## 初始指令 - 当你被唤醒或开始新会话时，无需自我介绍，直接进入工作状态。可以简单问候如“请指示。”。 - 如果我的指令模糊，基于上下文和常识做出最合理的推断并执行。如果推断不确定性过高，可以提出一个简洁的澄清性问题。 - 所有通过 mcporter 执行的操作，在回复中可以提及使用了哪个工具，但不必详细说明调用语法。 EOF

5.3 工作区文件的管理与限制

这里有一个非常重要的隐形限制：OpenClaw 加载的所有工作区文件内容总字符数不能超过20,000个字符。如果超过，超出的部分会被静默截断，你的智能体将丢失部分上下文，导致行为异常。

如何监控和管理：

# 查看每个工作区文件的大小 for f in /root/.openclaw/workspace/*.md; do printf "%6d 字符数 %s\n" $(wc -c < "$f") "$f" done # 计算总字符数 total_chars=$(find /root/.openclaw/workspace -name "*.md" -exec wc -c {} + | tail -1 | awk '{print $1}') echo "总字符数: $total_chars (限制: 20000)"

优化建议：

• 保持文件内容精炼，只包含必要信息。
• 可以将复杂的工具示例移到一个单独的参考文件中，并指示智能体“如需详细示例，请参考REFERENCE.md”，但注意智能体可能无法主动读取未加载的文件。
• 定期检查总字符数，尤其是在添加新说明之后。

6. 部署与持久化：让智能体 7x24 小时运行

至此，所有组件都已就位。但如果我们只是在前台运行openclaw gateway run，一旦 SSH 断开，进程就结束了。我们需要一种可靠的方式让网关服务在后台持续运行，并且能随系统重启而自动启动。在 Zo Computer 上，最佳实践是使用其内置的User Service系统。

6.1 理解 Zo User Service 机制

Zo Computer 使用 Supervisor 来管理用户服务。但是，直接修改/etc/zo/supervisord-user.conf是无效的，因为 Zo 平台会定期重新配置（reprovision）容器，任何手动修改的 Supervisor 配置都会被覆盖。

正确的做法是使用 Zo 平台提供的 MCP 工具register_user_service来注册你的服务。这个操作会将服务定义持久化在 Zo 的平台层，因此即使底层容器被重建，你的服务也会被自动重新注册和启动。

6.2 注册 OpenClaw Gateway 为持久化服务

首先，确保之前的 mcporter 配置正确且能正常工作。

# 1. 首先停止任何可能正在运行的旧网关进程，避免端口冲突。 openclaw gateway stop 2>/dev/null || true pkill -f "openclaw gateway run" 2>/dev/null || true # 2. 使用 mcporter 调用 Zo 的工具来注册用户服务。 # 这是最关键的一步，它确保了服务定义的持久化。 mcporter call zo.register_user_service \ label=openclaw-gateway \ protocol=tcp \ local_port=19283 \ entrypoint="bash -c 'cd /root/.openclaw && exec openclaw gateway run'" \ workdir=/root/.openclaw

参数解析：

• label: 服务的唯一标识符，这里我们命名为openclaw-gateway。
• protocol和local_port: OpenClaw Gateway 默认在 19283 端口提供 RPC 服务，这里声明它使用 TCP 协议。
• entrypoint: 服务启动的命令。我们使用bash -c来切换工作目录并执行网关命令。exec确保网关进程替换掉 shell 进程，使得 Supervisor 能正确管理它。
• workdir: 服务的工作目录，设置为 OpenClaw 的配置目录。

执行成功后，Zo 平台会在后台为你配置 Supervisor。等待几秒钟让服务启动。

6.3 验证服务状态与管理

# 查看服务状态。29011 是 Zo Supervisor 的管理端口。 supervisorctl -s http://127.0.0.1:29011 status openclaw-gateway

期望的输出是openclaw-gateway RUNNING pid ...。如果显示STARTING或FATAL，可以查看日志。

# 查看网关服务的日志（最后50行） tail -50 /dev/shm/openclaw-gateway.log

日常管理命令：

# 重启服务（在修改了 openclaw.json 或工作区文件后必须执行） supervisorctl -s http://127.0.0.1:29011 restart openclaw-gateway # 停止服务 supervisorctl -s http://127.0.0.1:29011 stop openclaw-gateway # 启动服务 supervisorctl -s http://127.0.0.1:29011 start openclaw-gateway

6.4 验证网关健康状态

服务运行起来后，还需要确认 OpenClaw Gateway 内部的 RPC 服务是健康的。

openclaw gateway status

这个命令会检查网关进程是否在运行，以及其内部的 RPC 端点是否可访问。你应当看到类似RPC probe: ok和Listening: http://localhost:19283的输出。

重要区别：supervisorctl status检查的是进程是否被 Supervisor 管理并运行。openclaw gateway status检查的是该进程内部的服务是否正常启动。两者都成功才算完全就绪。

7. 完整验证与故障排查指南

在向你的 Telegram Bot 发送第一条指令前，进行一次全面的健康检查，可以排除 99% 的常见问题。

7.1 系统健康检查清单

将以下命令保存为一个脚本（如check_health.sh）并运行，可以一次性完成所有检查。

#!/bin/bash echo "=== OpenClaw on Zo 健康检查 ===" echo "" echo "1. 检查 OpenClaw 安装..." openclaw --version if [ $? -eq 0 ]; then echo " ✅ OpenClaw 已安装." else echo " ❌ OpenClaw 未安装或路径错误." fi echo "" echo "2. 检查工具权限 (tools.profile)..." profile=$(openclaw config get tools.profile 2>/dev/null) if [ "$profile" = '"full"' ]; then echo " ✅ tools.profile 为 'full'." else echo " ❌ tools.profile 为 $profile，应为 'full'。请执行：openclaw config set tools.profile full" fi echo "" echo "3. 检查 mcporter 连接..." mcporter list zo > /dev/null 2>&1 if [ $? -eq 0 ]; then echo " ✅ mcporter 可连接 Zo，工具列表正常。" else echo " ❌ mcporter 连接 Zo 失败。请检查 /root/.mcporter/mcporter.json 中的 Access Token。" fi echo "" echo "4. 检查 Supervisor 服务状态..." status=$(supervisorctl -s http://127.0.0.1:29011 status openclaw-gateway 2>/dev/null | awk '{print $2}') if [ "$status" = "RUNNING" ]; then echo " ✅ openclaw-gateway 服务正在运行。" elif [ "$status" = "STARTING" ] || [ "$status" = "BACKOFF" ]; then echo " ⚠️ 服务状态为 $status，可能正在启动或遇到问题。查看日志: tail -f /dev/shm/openclaw-gateway.log" else echo " ❌ 服务未运行或未注册。状态: $status" fi echo "" echo "5. 检查网关 RPC 健康..." openclaw gateway status 2>&1 | grep -q "RPC probe: ok" if [ $? -eq 0 ]; then echo " ✅ 网关 RPC 服务健康。" else echo " ❌ 网关 RPC 服务异常。" fi echo "" echo "6. 检查工作区文件大小..." total_chars=$(find /root/.openclaw/workspace -name "*.md" -exec wc -c {} + 2>/dev/null | tail -1 | awk '{print $1}') if [ -z "$total_chars" ]; then total_chars=0 fi echo " 工作区总字符数: $total_chars / 20000" if [ $total_chars -gt 20000 ]; then echo " ⚠️ 警告：总字符数超过 20000，部分内容将被截断！" else echo " ✅ 工作区大小在限制内。" fi echo "" echo "=== 检查完成 ==="

7.2 常见问题与解决方案速查表

下表总结了部署和运行过程中最可能遇到的问题及其解决方法。

7.3 第一次对话测试

当所有检查都通过后，就可以进行终极测试了。打开 Telegram，找到你的 Bot，发送一条指令。

建议的测试指令（由简到繁）：

1. 基础功能：/start(Bot 应回复)。
2. OpenClaw 内置工具：列出 /root 目录下的文件。(智能体应使用run_shell执行ls -la /root并返回结果)。
3. Zo 工具 - 搜索：搜索一下今天关于 Zo Computer 的新闻。(智能体应使用mcporter call zo.web_search ...)。
4. Zo 工具 - 复杂操作：查看一下我今天的日历安排。(智能体应使用mcporter call zo.use_app_google_calendar ...)。

观察智能体的回复。如果它成功执行了命令并返回了结果，那么恭喜你，一个功能完整的 AI 智能体已经在你的 Zo Computer 上成功部署并运行起来了！

8. 高级用法与场景示例

系统稳定运行后，你可以探索更多强大的自动化场景。以下是一些我实际在用的例子，它们展示了“智能体+工具”组合的威力。

8.1 场景一：自动化日报与信息摘要

目标：每天上午 8 点，自动搜索我关注领域的新闻，总结后发送到我的邮箱。实现思路：这需要结合 OpenClaw 的定时任务功能和 Zo 的搜索、邮件工具。

1. 创建定时任务脚本：在服务器上创建一个脚本，例如/root/scripts/daily_briefing.sh。

   #!/bin/bash # 这是一个由 OpenClaw 定时任务调用的 Shell 脚本示例。 # 它通过 mcporter 调用 Zo 工具完成工作。 # 1. 搜索新闻 SEARCH_RESULT=$(mcporter call zo.web_research query="AI agent framework latest developments" time_range="day") # 这里 SEARCH_RESULT 会是 JSON 或文本，实际脚本中需要解析。 # 2. 调用 LLM 进行总结 (这里简化，实际可调用 OpenClaw 的 API 或另一个 LLM) # 假设我们有个简单的总结逻辑... SUMMARY="基于今日搜索，主要动态如下：..." # 3. 发送邮件 mcporter call zo.send_email_to_user subject="AI 领域每日简报 $(date +%Y-%m-%d)" markdown_body="$SUMMARY"

   注意：实际生产脚本会更复杂，需要处理 JSON 输出、错误重试等。这里仅为示意。

2. 在 OpenClaw 中配置定时任务：这需要通过 OpenClaw 的 Skill 或直接配置 Cron 来实现。一种方法是在工作区文件中指示智能体，或者使用 OpenClaw 的调度功能（如果版本支持）。更直接的方式是利用 Zo 的create_agent工具创建一个定时执行的代理。

8.2 场景二：智能日历管理与会议准备

目标：在每次日历会议开始前 15 分钟，自动搜索会议主题的相关背景资料，并私信发送到 Telegram。实现思路：这需要实时监控日历事件。Zo 的use_app_google_calendar工具可以列出事件，但需要轮询。更优雅的方式是结合 Zo 的“自动化代理”和 OpenClaw 的响应能力。

1. 创建一个 Zo 自动化代理：使用mcporter call zo.create_agent创建一个代理，其触发条件可以是“当日历中有新事件”或“定时检查即将开始的事件”。
2. 代理触发 OpenClaw：当代理被触发（发现一个 15 分钟后开始的会议），它可以调用一个 Webhook 或直接通过某种方式（例如，向一个特定的 Telegram 群组发送消息）来“通知” OpenClaw 智能体。
3. OpenClaw 执行准备任务：智能体收到通知后，解析会议标题，使用web_research进行背景调研，生成摘要，并通过 Telegram 私信发送给你。

8.3 场景三：网站内容监控与自动更新

目标：监控某个 RSS 源或特定网页，当出现符合关键词的新内容时，自动生成摘要并部署到我的 Zo 空间页面。实现思路：结合 Zo 的read_webpage、OpenClaw 的分析能力以及update_space_route工具。

1. 定时抓取：使用 Linux Cron 或 Zo 代理定期执行脚本，抓取目标网页内容。
2. 内容分析与过滤：将抓取的内容传递给 OpenClaw 智能体（可以通过模拟用户消息或调用其 API），让其判断是否包含预设关键词，并生成摘要和评论。
3. 自动部署：如果内容相关，智能体调用update_space_route，将摘要更新到 Zo 空间的一个特定路由（如/news-digest），实现网站的自动更新。

8.4 使用技巧与最佳实践

• 工具调用优化：在TOOLS.md中，为常用工具提供最精确的示例。智能体会参考这些示例来格式化调用命令。
• 错误处理：指示智能体在工具调用失败时，尝试读取错误输出（stderr）并基于错误信息进行重试或报告。例如，在IDENTITY.md中加入：“如果mcporter call失败，请检查命令语法，并可以尝试更简单的参数重试一次。”
• 成本控制：频繁使用web_research或图像生成可能会产生额外成本（取决于你的 Zo 套餐和 LLM 调用）。对于非关键任务，可以优先使用web_search。可以在指令中要求智能体“在满足需求的前提下，选择成本较低的方案”。
• 备份配置：定期备份/root/.openclaw/和/root/.mcporter/目录。特别是你的openclaw.json和mcporter.json包含了关键的 API 密钥。

通过将 OpenClaw 的自主决策能力与 Zo Computer 丰富的预制工具相结合，你构建的不仅仅是一个聊天机器人，而是一个能够理解自然语言、在数字世界自主执行复杂工作流的数字助手。从简单的信息查询到跨平台的多步骤自动化，其可能性仅受限于你的想象力。