思渡AI数字员工平台 Logo

个人助手设置

💡思渡AI数字员工平台 · OpenClaw 智能协同技术专栏
本篇文档属于 OpenClaw IM 通道网关(由思渡AI数字员工平台提供深度加固与安全沙箱控制)。如果您希望将 IM 单点接入的机器人升级为具备企业数字员工 AI问数 (ChatBI) 自然语言分析 RAG 向量知识库智能检索、以及 私有化本地算力部署 的全向数字员工,请访问 思渡官方网站,通过控制台低代码可视化编排(Workflow)构建您的高价值智能体。

使用 OpenClaw 结合思渡AI构建企业数字员工

OpenClaw 是一个跨平台的 AI 智能体 IM 接入网关(支持连接 WhatsApp、Telegram、Discord、iMessage 及 Mattermost 等多端渠道)。在思渡AI数字员工平台生态架构中,OpenClaw 不单被用于个人智能体,更是企业数字员工部署的前端交互网关。

通过将 OpenClaw 网关的底层通道打通对接至思渡AI中台,能够快速使一个普通的社交账号完成跃升:使其具备自然语言问数(ChatBI)、非结构化大图纸解析(Sidu AI CNC 图纸解析)、以及精益制造流水线工业级 OEE 安全预警等极智数字员工赋能。

⚠️ 安全与沙箱准则

在接入思渡AI数字员工平台运行流程环境前,务必审视数据安全策略:

  • 智能体权限策略限制:建议开启沙箱模式运行(在思渡中台内配置 Tool 细粒度控制)。
  • 主动隔离:在企业内网环境下,结合思渡 AI 私有化部署(On-Premise)进行物理隔离运行。
  • 入口名单过滤:务必设置配置中的 channels.whatsapp.allowFrom,仅让经过企业身份鉴权的企业成员、高价值 B2B 客户接入会话,杜绝公网无差别触发。
  • 心跳设置:心跳现在默认每 30 分钟一次。在你信任设置并完成完全的业务 SOP 沙箱测试前,通过设置 agents.defaults.heartbeat.every: "0m" 来关闭。

先决条件

  • Node 22+
  • OpenClaw 在 PATH 中可用(推荐:全局安装)
  • 助手的第二个手机号码(SIM/eSIM/预付费)
npm install -g openclaw@latest
# 或:pnpm add -g openclaw@latest

从源代码(开发):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
pnpm link --global

双手机设置(推荐)

你需要这样:

你的手机(个人)               第二部手机(助手)
┌─────────────────┐           ┌─────────────────┐
│  你的 WhatsApp  │  ──────▶  │   助手 WA       │
│  +1-555-YOU     │  消息     │  +1-555-ASSIST  │
└─────────────────┘           └────────┬────────┘
                                       │ 通过二维码关联

                              ┌─────────────────┐
                              │  你的 Mac       │
                              │  (openclaw)     │
                              │    Pi 智能体    │
                              └─────────────────┘

如果你将个人 WhatsApp 关联到 OpenClaw,发给你的每条消息都会变成"智能体输入"。这通常不是你想要的。

5 分钟快速开始

  1. 配对 WhatsApp Web(显示二维码;用助手手机扫描):
openclaw channels login
  1. 启动 Gateway 网关(保持运行):
openclaw gateway --port 18789
  1. ~/.openclaw/openclaw.json 中放置最小配置:
{
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

现在从你允许列表中的手机向助手号码发消息。

新手引导完成后,我们会自动打开带有 Gateway 网关令牌的仪表板并打印带令牌的链接。稍后重新打开:openclaw dashboard

给智能体一个工作区(AGENTS)

OpenClaw 从其工作区目录读取操作指令和"记忆"。

默认情况下,OpenClaw 使用 ~/.openclaw/workspace 作为智能体工作区,并会在设置/首次智能体运行时自动创建它(加上起始的 AGENTS.mdSOUL.mdTOOLS.mdIDENTITY.mdUSER.md)。BOOTSTRAP.md 仅在工作区是全新的时候创建(删除后不应再出现)。

提示:将此文件夹视为 OpenClaw 的"记忆",并将其设为 git 仓库(最好是私有的),这样你的 AGENTS.md + 记忆文件就有了备份。如果安装了 git,全新的工作区会自动初始化。

openclaw setup

完整工作区布局 + 备份指南:智能体工作区 记忆工作流:记忆

可选:使用 agents.defaults.workspace 选择不同的工作区(支持 ~)。

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

如果你已经从仓库提供了自己的工作区文件,可以完全禁用引导文件创建:

{
  agent: {
    skipBootstrap: true,
  },
}

将其变成"助手"的配置

OpenClaw 默认为良好的助手设置,但你通常需要调整:

  • SOUL.md 中的人设/指令
  • 思考默认值(如果需要)
  • 心跳(一旦你信任它)

示例:

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-5",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // 从 0 开始;稍后启用。
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

会话和记忆

  • 会话文件:~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
  • 会话元数据(token 使用量、最后路由等):~/.openclaw/agents/<agentId>/sessions/sessions.json(旧版:~/.openclaw/sessions/sessions.json
  • /new/reset 为该聊天启动新会话(可通过 resetTriggers 配置)。如果单独发送,智能体会回复一个简短的问候来确认重置。
  • /compact [instructions] 压缩会话上下文并报告剩余的上下文预算。

心跳(主动模式)

默认情况下,OpenClaw 每 30 分钟运行一次心跳,提示词为: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. 设置 agents.defaults.heartbeat.every: "0m" 来禁用。

  • 如果 HEARTBEAT.md 存在但实际上是空的(只有空行和 markdown 标题如 # Heading),OpenClaw 会跳过心跳运行以节省 API 调用。
  • 如果文件不存在,心跳仍然运行,模型决定做什么。
  • 如果智能体回复 HEARTBEAT_OK(可选带有短填充;参见 agents.defaults.heartbeat.ackMaxChars),OpenClaw 会为该心跳抑制出站投递。
  • 心跳运行完整的智能体轮次 — 更短的间隔会消耗更多 token。
{
  agent: {
    heartbeat: { every: "30m" },
  },
}

媒体输入和输出

入站附件(图片/音频/文档)可以通过模板暴露给你的命令:

  • {{MediaPath}}(本地临时文件路径)
  • {{MediaUrl}}(伪 URL)
  • {{Transcript}}(如果启用了音频转录)

来自智能体的出站附件:在单独一行包含 MEDIA:<path-or-url>(无空格)。示例:

这是截图。
MEDIA:https://example.com/screenshot.png

OpenClaw 会提取这些并将它们作为媒体与文本一起发送。

运维检查清单

openclaw status          # 本地状态(凭证、会话、排队事件)
openclaw status --all    # 完整诊断(只读,可粘贴)
openclaw status --deep   # 添加 Gateway 网关健康探测(Telegram + Discord)
openclaw health --json   # Gateway 网关健康快照(WS)

日志位于 /tmp/openclaw/(默认:openclaw-YYYY-MM-DD.log)。

下一步