接入教程

已经有一台 Ubuntu / Debian 服务器(任意配置,1C2G 起)即可。在服务器上 root 身份执行下面这一行,5 分钟内完成全部安装、配置、开机自启:

bash <(curl -fsSL https://zzzf.nssb.icu/install.sh)

脚本会按顺序自动:

1. 检测并安装 Node.js 22(已有就跳过)
2. npm 全局安装 OpenClaw 主程序
3. 提示输入激活码(由运营提供) → 服务端自动给您分配:
   • 一条独立模型 sk(带初始余额,只属于您)
   • 一个独立 客户编号(API Key),即您接入张枫智能体的身份
4. 提示多选要接入的对话渠道(可多选,空格分隔编号):
   • 1 = 微信(个人号,扫码即用,零配置)
   • 2 = 飞书(企业自建应用,需 App ID / Secret)
   • 3 = 企业微信(智能机器人,需 Bot ID / Secret)
   按选择安装对应渠道插件并写入 openclaw.json
5. 写入 ~/.openclaw/openclaw.json(权限 600,自动备份原文件)
6. 注册 systemd 服务 openclaw-gateway,开机自启 + 崩溃自动重启
7. 启动 gateway,按所选渠道给出绑定指引

📋 各渠道凭证准备(选了哪个看哪个)

完成后第一件事

• 📱 选了微信:执行 openclaw qr,终端会出二维码,微信扫码登录
• 📘 选了飞书:服务已自动连飞书 App,直接在飞书里 @ 机器人对话
• 💼 选了企微:服务已自动连 Bot,直接在企微里向机器人发消息

日常运维三条命令

张枫智能体接的中转站当前提供 3 档模型,您可以根据场景在客户端命令行或对话里(微信/飞书/企微)随时切换:

方式 A:对话里说一句话(推荐)

直接在微信/飞书/企微里告诉智能体:

• 「换 4.7」 / 「用最强的」 → 切到 opus-4.7
• 「换回 4.6」 / 「用便宜的」 → 切回默认 opus-4.6
• 「换 fast / 要快」 → 切到 opus-4.6-fast

智能体会自动调用本地 openclaw models set 切换,完成后回复"已切换到 X,新对话即生效"。

方式 B:服务器命令行手动切

# 默认:综合最佳
openclaw models set claude-hk/claude-opus-4.6

# 响应最快
openclaw models set claude-hk/claude-opus-4.6-fast

# 能力最强(由总部支付)
openclaw models set claude-hk/claude-opus-4.7

默认安装已内置滚动裁剪策略，无需额外操作。本章说明工作原理和手动调参方法。

已生效的参数

手动调整参数（按需执行，改后重启生效）

# 调整上下文 Token 上限（默认 150000，可按需调整）
openclaw config set agents.defaults.contextTokens 150000

# 调整保留最近 N 轮（最大 15，源码已放开限制）
openclaw config set agents.defaults.compaction.recentTurnsPreserve 15

# 调整历史摘要占比（0.1~0.9，越小新内容越多）
openclaw config set agents.defaults.compaction.maxHistoryShare 0.35

# 重启服务生效
systemctl restart openclaw-gateway

升级后修复源码上限（升级 openclaw 版本后执行一次）

# 放开 recentTurnsPreserve 上限 12 → 15
DIST=/usr/lib/node_modules/openclaw/dist
sed -i 's/MAX_RECENT_TURNS_PRESERVE = 12/MAX_RECENT_TURNS_PRESERVE = 15/' \
  "$DIST/compaction-successor-transcript-CFukhZtt.js"
sed -i 's/\.max(12)\.optional()/.max(15).optional()/' \
  "$DIST/zod-schema-DjRHIl0Z.js"
sed -i 's/"maximum": 12,\n\s*"title": "Compaction Preserve/"maximum": 15,\n                "title": "Compaction Preserve/' \
  "$DIST/runtime-schema-TpYHXgGk.js"
# 重新写入配置
openclaw config set agents.defaults.compaction.recentTurnsPreserve 15
systemctl restart openclaw-gateway

新安装时一键应用（建议写入安装脚本）

以下命令在 openclaw onboard 之后执行，适合自动化部署：

DIST=/usr/lib/node_modules/openclaw/dist

# 1. 放开源码上限
sed -i 's/MAX_RECENT_TURNS_PRESERVE = 12/MAX_RECENT_TURNS_PRESERVE = 15/' \
  "$DIST/compaction-successor-transcript-CFukhZtt.js"
sed -i 's/\.max(12)\.optional()/.max(15).optional()/' \
  "$DIST/zod-schema-DjRHIl0Z.js"

# 2. 写入配置
openclaw config set agents.defaults.contextTokens 150000
openclaw config set agents.defaults.compaction.mode safeguard
openclaw config set agents.defaults.compaction.recentTurnsPreserve 15
openclaw config set agents.defaults.compaction.maxHistoryShare 0.35
openclaw config set agents.defaults.compaction.truncateAfterCompaction true
openclaw config set agents.defaults.compaction.qualityGuard.enabled true

# 3. 禁用 /new /reset 强制清空
openclaw config set session.resetTriggers '[]'

环境

Node.js 22.14+ (推荐 24)。

5.1 安装 OpenClaw

macOS / Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows(PowerShell,推荐 WSL2):

iwr -useb https://openclaw.ai/install.ps1 | iex

通用 npm(渠道插件按需选装):

# 主程序 + 微信
npm install -g openclaw@latest @tencent-weixin/openclaw-weixin

# 飞书(可选)
npm install -g @larksuite/openclaw-lark

# 企业微信(可选)
npm install -g @wecom/wecom-openclaw-plugin

openclaw onboard --install-daemon

5.2 配置 LLM(填您自己的 key,或继续用我们的中转)

交互式向导:

openclaw onboard

OpenClaw 支持 50+ 厂商(Anthropic、OpenAI、Google、DeepSeek、Qwen、月之暗面、Ollama、OpenRouter…)。 完整列表见 官方 providers 文档。

如果您仍想用我们提供的模型中转(共享池外的独立 sk),手动写 ~/.openclaw/openclaw.json:

{
  "agents": {"defaults": {"model": "claude-hk/claude-opus-4.6"}},
  "models": {
    "providers": {
      "claude-hk": {
        "baseUrl": "http://claude.hk/v1",
        "auth": "api-key",
        "apiKey": "联系客服获取的 sk",
        "api": "openai-completions",
        "models": [
          {"id":"claude-opus-4.6"},
          {"id":"claude-opus-4.6-fast"},
          {"id":"claude-opus-4.7"}
        ]
      }
    }
  }
}

5.3 兑换客户编号(API Key)

用激活码换属于您的 API Key(此接口与一键安装走同一个,只是您手动调):

curl -X POST https://zzzf.nssb.icu/v1/redeem \
  -H "Content-Type: application/json" \
  -d '{"invite_code":"您的激活码"}'

成功返回 api_key,妥善保存。

5.4 注册张枫智能体 MCP

openclaw mcp set zhangfeng-agent '{
  "url": "https://zzzf.nssb.icu/mcp/",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer 上一步拿到的 api_key"
  }
}'

openclaw mcp list      # 验证

注册成功后,OpenClaw 会自动看到张枫智能体的 19+ 个工具(问答 / 内容生成 / 视频复盘 / 同行监控 / 深度报告 / 媒体生成 / 模型切换…)。

5.5 Kimi 版 OpenClaw 接入说明

如果你用的是 Kimi 官方提供的 OpenClaw（即底层模型是 Kimi 而非 Claude），接入方式完全相同，命令通用。根据你的使用场景选择以下任一方式：

方式 A：客户独立接入（有自己的 API Key）

先在后台完成注册（同 5.3 步骤），拿到 api_key 后执行：

openclaw mcp set zhangfeng-agent '{
  "url": "https://zzzf.nssb.icu/mcp/",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer 你自己的api_key"
  }
}'

openclaw mcp list      # 验证是否出现 zhangfeng-agent

方式 B：代理模式（运营统一配置，客户无需 API Key）

适合服务商帮多个客户接入：在跑 OpenClaw 的服务器上配一次主 token，后端按会话自动隔离每个人的数据。

openclaw mcp set zhangfeng-agent '{
  "url": "https://zzzf.nssb.icu/mcp/",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer 运营主token"
  }
}'

# 按账号+渠道+对话对象三维隔离每个客户的会话
openclaw config set session.dmScope per-account-channel-peer

openclaw mcp list      # 验证

配置完成后客户直接在飞书/微信 @ 智能体即可使用，无需任何额外操作。

5.6 用 Claude 自动完成全部配置

如果你的服务器上已经装好了 Claude Code（或任何支持执行命令的 Claude 客户端），可以把下面这段提示词直接发给 Claude，让它全程自动完成安装和配置，无需手动操作。

你是一个服务器配置助手，请直接在这台服务器上完成 OpenClaw 的完整安装和配置，不需要询问我，遇到问题自己解决。

配置参数：
- MCP server 名称：zhangfeng-agent
- MCP 地址：https://zzzf.nssb.icu/mcp/
- MCP transport：streamable-http
- Bearer token：YOUR_API_KEY
- contextTokens：150000
- compaction mode：safeguard，recentTurnsPreserve：15，maxHistoryShare：0.35，truncateAfterCompaction：true
- session.resetTriggers：[]（禁用）
- gateway.mode：local

执行步骤：
1. 如果未安装 openclaw，先运行：npm install -g openclaw
2. openclaw 配置键用 mcp.servers（不是 mcpServers），用 openclaw config patch --file 一次性写入所有参数
3. recentTurnsPreserve=15 超过源码上限 12，需要先改源码：
   - 先运行 ls /usr/lib/node_modules/openclaw/dist/ | grep -E "compaction-successor|zod-schema" 确认文件名
   - compaction-successor-transcript-xxx.js：MAX_RECENT_TURNS_PRESERVE = 12 → 15
   - zod-schema-xxx.js：.max(12).optional() → .max(15).optional()
4. gateway.mode 必须设为 local
5. 运行 openclaw gateway install，然后 systemctl --user start openclaw-gateway.service
6. 微信渠道安装：npx -y @tencent-weixin/openclaw-weixin-cli@latest install
7. 安装后给 /root/.openclaw/npm/node_modules/@tencent-weixin/openclaw-weixin/openclaw.plugin.json 补上 channelConfigs 字段：
   "channelConfigs": {"openclaw-weixin": {"schema": {"$schema": "http://json-schema.org/draft-07/schema#","type": "object","properties": {},"additionalProperties": false}}}
8. 补完 manifest 后只运行 systemctl --user restart openclaw-gateway.service，不要运行 openclaw plugins registry --refresh
9. 最后运行 openclaw channels login --channel openclaw-weixin 完成微信绑定（需要扫二维码，请告知我）

完成后告诉我每一步结果和最终运行状态。

如果你想让客户不接触 API Key、不安装任何东西,直接在自己的微信里 @ 张枫智能体就能用, 可以用「代理模式」:OpenClaw 配一个主代理 token,所有客户共用同一个 MCP 注册, 后端按微信会话隔离每个人的画像、视频库、配额。

① OpenClaw 端配置(只配一次)

在跑 OpenClaw 的服务器上执行:

openclaw mcp set zhangfeng-agent '{
  "url": "https://zzzf.nssb.icu/mcp/",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer 运营主token"
  }
}'

# 会话隔离:每个微信好友/群一个独立 MCP session
openclaw config set session.dmScope per-account-channel-peer

② 客户首次使用(发绑定码)

1. 运营在后台 客户管理 → 点客户名 → 「+ 生成绑定码」,得到 6 位数字(5 分钟有效)
2. 把绑定码发给客户(微信、电话、短信都行)
3. 客户在自己的微信里直接发给智能体:绑定 218736 或 我的绑定码是 218736
4. 智能体自动调用 bind_account 工具,反馈「绑定成功」
5. 之后客户问问题、发视频链接、要脚本都直接说,无需再带任何凭证

③ 安全机制

• 未绑定的微信无法调用任何工具,系统会返回"请先发送绑定码"
• 绑定码 5 分钟过期,只能用一次,过期后客户需重新索取
• 一个客户可绑多个微信号(老板 + 运营都用同一个画像)
• 运营可在后台看到所有"已绑定的会话",点「踢绑」立即让该会话失效
• 客户也可以自己说"解绑",智能体会调 unbind 工具撤销自己的绑定

MCP server 上线前,你可以直接用 HTTP 接口完成所有操作。下面给最常用的 3 条命令。

① 提交一条视频做复盘

curl -X POST https://zzzf.nssb.icu/v1/video/submit \
  -H "Authorization: Bearer 你的_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://v.douyin.com/xxxxx/", "note":"这条挺好的,看下钩子"}'

② 问知识库

curl -X POST https://zzzf.nssb.icu/v1/ask \
  -H "Authorization: Bearer 你的_api_key" \
  -H "Content-Type: application/json" \
  -d '{"question":"新号怎么起号最快?我做的是本地火锅店"}'

③ 生成内容

curl -X POST https://zzzf.nssb.icu/v1/generate \
  -H "Authorization: Bearer 你的_api_key" \
  -H "Content-Type: application/json" \
  -d '{"task":"3 条 30 秒口播脚本,主推牛油锅底"}'

提交的视频会出现在张枫团队为你单独配置的「客户视频库」多维表格里,字段包括:

适合有多名员工共同运营抖音矩阵号的商家。系统会每天为每个员工/矩阵号生成一份专属视频质检报告， 同时在企业微信群推送一条团队日报，用数据激励大家持续发布和优化内容。

后台配置步骤

1. 进入管理后台 → 商户管理，确认该商户已绑定可用的客户 API Key。
2. 在商户详情里配置 企微群机器人 Webhook。Webhook 只保存在后台，不会展示到商家端日报里。
3. 在“抖音账号矩阵”中添加员工账号：填写抖音主页链接 / sec_uid、账号昵称、员工姓名。
4. 每天定时任务会自动检测每个员工矩阵号的视频，并生成专属报告。
5. 早上会按商户聚合发送一条企业微信群团队日报，不会每个员工单独刷屏。

商家端怎么看

• 商家登录 /merchant-ui 后，在“我的矩阵号”里可以添加员工姓名。
• “视频发布日历”会按员工展示：本月累计、平均分、每天发布数量/分数。
• 有报告的日期可以点击数字打开该员工当天的 PDF 质检报告。

把竞品 / 行业头部 / 你想盯的同行抖音号添加进来,系统会:

• 每天自动拉同行的新视频(增量,不重复抓)
• 对每条新视频做 AI 亮点分析(消耗你自己的 LLM Key,见第 ⑩ 节)
• 把视频写到你专属多维表格的「同行视频」表
• 命中你设的播放/点赞阈值的爆款,会在你下次对话开头主动提示
• 每日推荐表里也会加一段「最近 7 天同行 TOP10」

curl -X POST https://zzzf.nssb.icu/v1/competitor/add \
  -H "Authorization: Bearer 你的_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "douyin_url": "https://v.douyin.com/xxxxxx/",
    "remark": "行业头部",
    "threshold_play": 100000,
    "threshold_digg": 5000,
    "analyze_limit": 20
  }'

# 看最近 7 天同行视频(按播放排序)
curl https://zzzf.nssb.icu/v1/competitor/recent?days=7 \
  -H "Authorization: Bearer 你的_api_key"

# 列表 / 删除
curl https://zzzf.nssb.icu/v1/competitor/list -H "Authorization: Bearer xxx"
curl -X DELETE https://zzzf.nssb.icu/v1/competitor/123 -H "Authorization: Bearer xxx"

张枫智能体大部分能力(问答 / 生成 / 视频复盘 / 账号体检)消耗你的月度配额(默认 1000 次/月); 但「同行号监控的 AI 亮点分析」消耗你自己配的 LLM Key,因为同行视频量大、按你的需求自由消耗更合理。

运营身份（agent 角色）在拥有普通客户全部功能的基础上，还可以管理名下商户、切换画像、批量出稿、维护私有方法论库。
代理商身份在运营基础上额外有开户/充值/冻结等账号管理权限。