# Awada Channel Setup

配置 Awada 账号、crew 路由及默认启用的 CustomerDB hook，检查消息权限、本地 slash、标准媒体与统一动作接口。用于用户或 main 明确选定...

- Repository: https://github.com/TeamWiseFlow/xiaobei (8678 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add TeamWiseFlow/xiaobei --skill awada-channel-setup -g -a claude-code -y`
Codex: `npx skills add TeamWiseFlow/xiaobei --skill awada-channel-setup -g -a codex -y`
Cursor: `npx skills add TeamWiseFlow/xiaobei --skill awada-channel-setup -g -a cursor -y`
Gemini CLI: `npx skills add TeamWiseFlow/xiaobei --skill awada-channel-setup -g -a gemini-cli -y`

## Description

配置 Awada 账号、crew 路由及默认启用的 CustomerDB hook，检查消息权限、本地 slash、标准媒体与统一动作接口。用于用户或 main 明确选定 Awada 后的启用和修复。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Awada Relay V2 配置

用户或 main 选定 Awada 后使用本技能；channel 选择仍由用户决定。启用 Awada channel 时，配置并验证 CustomerDB hook 是标准动作，不再单独询问是否启用；仅用户明确要求不启用或已有明确停用设置时跳过。Awada 是本项目局部插件，默认连接 `https://relay.openclaw-for-business.com/api/v2/awada`。所有账号使用相同动作和参数格式；不询问服务端底层实现，不按账号筛掉能力，也不在本地预判某个业务动作是否支持。执行支持和限制由 Awada server 返回。

## 配置前

- 本机工具和字段名备忘查 `AGENTS.md` 的 `## Tools` 节，程序路径查 `OFB_ENV.md`；不创建或更新独立 `TOOLS.md`。旧版本遗留的 `TOOLS.md` / `HEARTBEAT.md` 由用户升级后手动删除，不在渠道配置流程中迁移或清理。
- 从 `OFB_ENV.md` 确认项目路径；Docker 通常为 `/opt/openclaw`。插件要求 OpenClaw 2026.10.4，局部依赖为 `silk-wasm`、`typebox`、`ws`、`zod`。安装器已负责安装；缺依赖时按项目升级流程修复，不把依赖装进 `~/.openclaw/node_modules`。
- 获取 Awada 账号的 `awadaKey`，使用 `X-OFB-Key`，scope 须含 `awada:lane:<完整 laneId>`。客户端仅配置 Awada 访问凭据；`OFB_KEY` 不是 awadaKey。
- 确定 crew 和 OpenClaw accountId。lane 默认不填，由服务端解析唯一 `user` lane；只有服务端返回歧义或用户明确选择其他 lane 时才指定。一个 lane 绑定一个企业微信（企微）账号。
- key 优先复用已有配置或读取 `AWADA_KEY` 环境变量；交互终端可隐藏输入。不要把 key 写进命令参数或日志。配置路径依次使用显式 `--config`、`OPENCLAW_CONFIG_PATH`、`OPENCLAW_JSON`、stateDir/openclaw.json。
- 已有 key 不因环境中出现另一个 key 而被覆盖；轮换时显式使用 `--replace-key`，可通过 `--key-env <变量名>` 选择新 key 来源。多账号未指定 defaultAccount 时必须传 `--account-id`。

## 预览和应用

```bash
awada-channel-setup --project-root <项目根> --account-id <账号> --agent-id sales-cs --dry-run
awada-channel-setup --project-root <项目根> --account-id <账号> --agent-id sales-cs
```

先审阅脱敏预览，再在用户已授权的配置范围内应用。已有 lane 会保留；显式 `--lane ""` 恢复服务端默认，其他 lane 使用 `--lane <laneId>`。脚本统一处理以下动作，不要手拼 JSON 或覆盖整段数组：

The rest: https://github.com/TeamWiseFlow/xiaobei/blob/HEAD/crews/it-engineer/skills/awada-channel-setup/SKILL.md