agent-channeltalk

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Channel

Agent Channel

A TypeScript CLI tool that enables AI agents and humans to interact with Channel Talk workspaces through a simple command interface. Features zero-config credential extraction from the Channel Talk desktop app (with browser fallback) and multi-workspace support.
一款TypeScript CLI工具,支持AI Agent和人类通过简单的命令行界面与Channel Talk工作区交互。具备零配置凭据提取功能(从Channel Talk桌面应用提取,浏览器作为备选方案),并支持多工作区。

Key Concepts

核心概念

Before diving in, a few things about Channel Talk's terminology:
  • Channel = workspace (not a chat channel like Slack). The API calls it a "channel," but it means your entire workspace.
  • UserChats = 1:1 conversations with end users (customers).
  • Groups = team inbox channels (similar to Slack channels). Referenced by ID.
  • DirectChats = direct messages between managers.
  • Managers = human agents on your team.
  • Bots = automated agents in the workspace.
  • Messages use a
    blocks
    format:
    [{ type: "text", value: "..." }]
    . The CLI handles this automatically when you pass plain text.
开始使用前,先了解Channel Talk的几个术语:
  • Channel = 工作区(并非Slack那样的聊天频道)。API中称其为"channel",但实际指的是你的整个工作区。
  • UserChats = 与终端用户(客户)的一对一对话。
  • Groups = 团队收件箱频道(类似Slack频道),通过ID引用。
  • DirectChats = 管理员之间的直接消息。
  • Managers = 团队中的人工客服。
  • Bots = 工作区中的自动化Agent。
  • Messages 使用
    blocks
    格式:
    [{ type: "text", value: "..." }]
    。当你传入纯文本时,CLI会自动处理这种格式。

Quick Start

快速开始

bash
undefined
bash
undefined

Get workspace snapshot (credentials are extracted automatically)

获取工作区快照(凭据会自动提取)

agent-channeltalk snapshot --pretty
agent-channeltalk snapshot --pretty

Send a message to a group

向群组发送消息

agent-channeltalk message send group grp_abc123 "Hello from the CLI!"
agent-channeltalk message send group grp_abc123 "Hello from the CLI!"

Send a message to a user chat

向用户聊天发送消息

agent-channeltalk message send user-chat uc_abc123 "Thanks for reaching out!"
agent-channeltalk message send user-chat uc_abc123 "Thanks for reaching out!"

List user chats

列出用户聊天记录

agent-channeltalk chat list
undefined
agent-channeltalk chat list
undefined

Authentication

身份验证

Credentials are extracted automatically from the Channel Talk desktop app (or Chromium browser as fallback) on first use. No manual setup required, no API keys needed. Just run any command and authentication happens silently in the background.
The Channel Talk desktop app stores auth cookies in a SQLite database. On macOS, cookies are plaintext and no Keychain prompt is needed. On Windows, cookies are DPAPI-encrypted and decrypted automatically. When falling back to a Chromium browser on macOS, cookies require Keychain decryption. The CLI reads two cookies:
  • x-account
    (JWT) - your account identity
  • ch-session-1
    (JWT) - your session token
These cookies expire after roughly 30 days. When they expire, the CLI automatically re-extracts fresh cookies from the desktop app or browser on the next command.
IMPORTANT: Always use
agent-channeltalk auth extract
to obtain credentials. The CLI extracts from the desktop app first, falling back to Chromium browsers if the app isn't installed.
首次使用时,凭据会自动从Channel Talk桌面应用(或备选的Chromium浏览器)中提取。无需手动设置,无需API密钥。只需运行任意命令,身份验证会在后台静默完成。
Channel Talk桌面应用将认证Cookie存储在SQLite数据库中。在macOS上,Cookie是明文存储的,无需Keychain提示。在Windows上,Cookie采用DPAPI加密,会自动解密。当备选使用macOS上的Chromium浏览器时,Cookie需要Keychain解密。CLI会读取两个Cookie:
  • x-account
    (JWT)- 你的账户身份标识
  • ch-session-1
    (JWT)- 你的会话令牌
这些Cookie大约30天后过期。过期后,下次运行命令时,CLI会自动从桌面应用或浏览器中重新提取新的Cookie。
重要提示:请始终使用
agent-channeltalk auth extract
来获取凭据。CLI首先从桌面应用提取,如果未安装应用,则备选从Chromium浏览器提取。

Multi-Workspace Support

多工作区支持

If you're logged into multiple Channel Talk workspaces, all are discovered automatically. The first workspace is selected by default.
bash
undefined
如果你登录了多个Channel Talk工作区,所有工作区都会被自动发现。默认选择第一个工作区。
bash
undefined

List all available workspaces

列出所有可用工作区

agent-channeltalk auth list
agent-channeltalk auth list

Switch to a different workspace

切换到不同的工作区

agent-channeltalk auth use <workspace-id>
agent-channeltalk auth use <workspace-id>

Check auth status

检查认证状态

agent-channeltalk auth status
agent-channeltalk auth status

Remove a stored workspace

删除存储的工作区

agent-channeltalk auth remove <workspace-id>
undefined
agent-channeltalk auth remove <workspace-id>
undefined

Memory

记忆功能

The agent maintains a
~/.config/agent-messenger/MEMORY.md
file as persistent memory across sessions. This is agent-managed, the CLI does not read or write this file. Use the
Read
and
Write
tools to manage your memory file.
Agent会在
~/.config/agent-messenger/MEMORY.md
文件中保存跨会话的持久化记忆。该文件由Agent管理,CLI不会读取或写入它。请使用
Read
Write
工具来管理你的记忆文件。

Reading Memory

读取记忆

At the start of every task, read
~/.config/agent-messenger/MEMORY.md
using the
Read
tool to load any previously discovered workspace IDs, group IDs, chat IDs, manager IDs, and preferences.
  • If the file doesn't exist yet, that's fine. Proceed without it and create it when you first have useful information to store.
  • If the file can't be read (permissions, missing directory), proceed without memory. Don't error out.
每个任务开始时,使用
Read
工具读取
~/.config/agent-messenger/MEMORY.md
,加载之前发现的工作区ID、群组ID、聊天ID、管理员ID和偏好设置。
  • 如果文件尚未存在,无需担心。继续操作即可,当你有有用信息需要存储时再创建它。
  • 如果无法读取文件(权限问题、目录缺失),无需报错,继续无记忆操作。

Writing Memory

写入记忆

After discovering useful information, update
~/.config/agent-messenger/MEMORY.md
using the
Write
tool. Write triggers include:
  • After discovering workspace IDs and names (from
    auth list
    ,
    snapshot
    , etc.)
  • After discovering group IDs and names (from
    group list
    ,
    snapshot
    , etc.)
  • After discovering chat IDs (from
    chat list
    , etc.)
  • After discovering manager IDs and names (from
    manager list
    , etc.)
  • After discovering bot names (from
    bot list
    , etc.)
  • After the user gives you an alias or preference ("call this the support workspace", "my main group is X")
When writing, include the complete file content. The
Write
tool overwrites the entire file.
发现有用信息后,使用
Write
工具更新
~/.config/agent-messenger/MEMORY.md
。触发写入的场景包括:
  • 发现工作区ID和名称后(来自
    auth list
    snapshot
    等命令)
  • 发现群组ID和名称后(来自
    group list
    snapshot
    等命令)
  • 发现聊天ID后(来自
    chat list
    等命令)
  • 发现管理员ID和名称后(来自
    manager list
    等命令)
  • 发现Bot名称后(来自
    bot list
    等命令)
  • 用户给出别名或偏好设置后(比如“将这个称为支持工作区”、“我的主要群组是X”)
写入时,请包含完整的文件内容
Write
工具会覆盖整个文件。

What to Store

存储内容

  • Workspace IDs with names
  • Group IDs with names
  • UserChat IDs with context
  • Manager IDs with names
  • Bot IDs with names
  • User-given aliases ("support workspace", "billing group")
  • Any user preference expressed during interaction
  • 带名称的工作区ID
  • 带名称的群组ID
  • 带上下文的UserChat ID
  • 带名称的管理员ID
  • 带名称的Bot ID
  • 用户指定的别名(比如“支持工作区”、“账单群组”)
  • 交互过程中用户表达的任何偏好设置

What NOT to Store

禁止存储内容

Never store cookies, tokens, credentials, or any sensitive data. Never store full message content (just IDs and context). Never store personal user data.
切勿存储Cookie、令牌、凭据或任何敏感数据。切勿存储完整的消息内容(仅存储ID和上下文)。切勿存储用户的个人数据。

Handling Stale Data

处理过期数据

If a memorized ID returns an error (chat not found, group not found), remove it from
MEMORY.md
. Don't blindly trust memorized data. Verify when something seems off. Prefer re-listing over using a memorized ID that might be stale.
如果记忆中的ID返回错误(聊天未找到、群组未找到),请从
MEMORY.md
中删除该ID。不要盲目信任记忆中的数据。当出现异常时请验证信息。优先重新列出数据,而非使用可能过期的记忆ID。

Format / Example

格式/示例

markdown
undefined
markdown
undefined

Agent Messenger Memory

Agent Messenger Memory

Channel Talk Workspaces

Channel Talk Workspaces

  • abc123
    - Acme Support
  • abc123
    - Acme Support

Groups (Acme Support)

Groups (Acme Support)

  • grp_111
    - Support Inbox
  • grp_222
    - Billing Inbox
  • grp_333
    - Engineering
  • grp_111
    - Support Inbox
  • grp_222
    - Billing Inbox
  • grp_333
    - Engineering

Recent UserChats (Acme Support)

Recent UserChats (Acme Support)

  • uc_aaa
    - John Doe inquiry (opened)
  • uc_bbb
    - Refund request (closed)
  • uc_aaa
    - John Doe inquiry (opened)
  • uc_bbb
    - Refund request (closed)

Managers (Acme Support)

Managers (Acme Support)

  • mgr_001
    - Alice (Team Lead)
  • mgr_002
    - Bob (Support Agent)
  • mgr_001
    - Alice (Team Lead)
  • mgr_002
    - Bob (Support Agent)

Bots (Acme Support)

Bots (Acme Support)

  • bot_001
    - Support Bot
  • bot_002
    - Notification Bot
  • bot_001
    - Support Bot
  • bot_002
    - Notification Bot

Aliases

Aliases

  • "support" ->
    grp_111
    (Support Inbox in Acme Support)
  • "support" ->
    grp_111
    (Support Inbox in Acme Support)

Notes

Notes

  • User prefers --pretty output for snapshots
  • Main workspace is "Acme Support"

> Memory lets you skip repeated `group list` and `chat list` calls. When you already know an ID from a previous session, use it directly.
  • User prefers --pretty output for snapshots
  • Main workspace is "Acme Support"

> 记忆功能可让你避免重复执行`group list`和`chat list`命令。当你从之前的会话中已经知道某个ID时,可以直接使用它。

Commands

命令

Auth Commands

认证命令

bash
undefined
bash
undefined

Extract cookies from Channel Talk desktop app or browser (usually automatic)

从Channel Talk桌面应用或浏览器提取Cookie(通常自动完成)

agent-channeltalk auth extract agent-channeltalk auth extract --browser-profile ~/browser-data agent-channeltalk auth extract --browser-profile "$HOME/work-profile,$HOME/personal-profile"
agent-channeltalk auth extract agent-channeltalk auth extract --browser-profile ~/browser-data agent-channeltalk auth extract --browser-profile "$HOME/work-profile,$HOME/personal-profile"

--browser-profile accepts repeatable or comma-separated Chromium profile/user-data dirs

--browser-profile 接受重复或逗号分隔的Chromium配置文件/用户数据目录

Check auth status

检查认证状态

agent-channeltalk auth status agent-channeltalk auth status --workspace <id>
agent-channeltalk auth status agent-channeltalk auth status --workspace <id>

Clear all stored credentials

清除所有存储的凭据

agent-channeltalk auth clear
agent-channeltalk auth clear

List all stored workspaces

列出所有存储的工作区

agent-channeltalk auth list
agent-channeltalk auth list

Switch active workspace

切换活跃工作区

agent-channeltalk auth use <workspace-id>
agent-channeltalk auth use <workspace-id>

Remove a stored workspace

删除存储的工作区

agent-channeltalk auth remove <workspace-id>
undefined
agent-channeltalk auth remove <workspace-id>
undefined

Whoami Command

Whoami命令

bash
undefined
bash
undefined

Show current authenticated user

显示当前已认证用户

agent-channeltalk whoami agent-channeltalk whoami --pretty agent-channeltalk whoami --workspace <workspace-id>

Output includes the authenticated user's identity information.
agent-channeltalk whoami agent-channeltalk whoami --pretty agent-channeltalk whoami --workspace <workspace-id>

输出包含已认证用户的身份信息。

Message Commands

消息命令

bash
undefined
bash
undefined

Send a message (chat-type: group, user-chat, or direct-chat)

发送消息(chat-type: group、user-chat或direct-chat)

agent-channeltalk message send <chat-type> <chat-id> <text> agent-channeltalk message send group grp_abc123 "Hello team!" agent-channeltalk message send user-chat uc_abc123 "Thanks for reaching out!" agent-channeltalk message send direct-chat dc_abc123 "Quick question..."
agent-channeltalk message send <chat-type> <chat-id> <text> agent-channeltalk message send group grp_abc123 "Hello team!" agent-channeltalk message send user-chat uc_abc123 "Thanks for reaching out!" agent-channeltalk message send direct-chat dc_abc123 "Quick question..."

List messages from a group, user chat, or direct chat

列出群组、用户聊天或直接聊天中的消息

agent-channeltalk message list <chat-type> <chat-id> agent-channeltalk message list group grp_abc123 --limit 50 agent-channeltalk message list user-chat uc_abc123 --sort asc
agent-channeltalk message list <chat-type> <chat-id> agent-channeltalk message list group grp_abc123 --limit 50 agent-channeltalk message list user-chat uc_abc123 --sort asc

Get a specific message by ID

通过ID获取特定消息

agent-channeltalk message get <chat-type> <chat-id> <message-id>
agent-channeltalk message get <chat-type> <chat-id> <message-id>

Search messages across team chats or user chats

在团队聊天或用户聊天中搜索消息

agent-channeltalk message search <query> agent-channeltalk message search "deployment" --scope team-chat agent-channeltalk message search "refund" --scope user-chat --limit 10
undefined
agent-channeltalk message search <query> agent-channeltalk message search "deployment" --scope team-chat agent-channeltalk message search "refund" --scope user-chat --limit 10
undefined

Chat Commands (UserChats)

聊天命令(UserChats)

bash
undefined
bash
undefined

List user chats assigned to me (default: opened)

列出分配给我的用户聊天(默认:已打开)

agent-channeltalk chat list agent-channeltalk chat list --state opened agent-channeltalk chat list --state snoozed agent-channeltalk chat list --state closed agent-channeltalk chat list --limit 50
agent-channeltalk chat list agent-channeltalk chat list --state opened agent-channeltalk chat list --state snoozed agent-channeltalk chat list --state closed agent-channeltalk chat list --limit 50

Get a specific user chat

获取特定用户聊天

agent-channeltalk chat get <chat-id>
undefined
agent-channeltalk chat get <chat-id>
undefined

Group Commands

群组命令

bash
undefined
bash
undefined

List groups

列出群组

agent-channeltalk group list agent-channeltalk group list --limit 50
agent-channeltalk group list agent-channeltalk group list --limit 50

Get a group by ID

通过ID获取群组

agent-channeltalk group get <group-id>
agent-channeltalk group get <group-id>

Get messages from a group

获取群组中的消息

agent-channeltalk group messages <group-id> agent-channeltalk group messages grp_abc123 --limit 50 --sort asc
undefined
agent-channeltalk group messages <group-id> agent-channeltalk group messages grp_abc123 --limit 50 --sort asc
undefined

Manager Commands

管理员命令

bash
undefined
bash
undefined

List all managers

列出所有管理员

agent-channeltalk manager list agent-channeltalk manager list --limit 50
undefined
agent-channeltalk manager list agent-channeltalk manager list --limit 50
undefined

Bot Commands

Bot命令

bash
undefined
bash
undefined

List all bots

列出所有Bot

agent-channeltalk bot list agent-channeltalk bot list --limit 50
undefined
agent-channeltalk bot list agent-channeltalk bot list --limit 50
undefined

Snapshot Command

快照命令

Get workspace overview for AI agents (brief by default):
bash
undefined
为AI Agent获取工作区概览(默认简略版):
bash
undefined

Brief snapshot (default) — fast, minimal API calls

简略快照(默认)——快速、API调用最少

agent-channeltalk snapshot
agent-channeltalk snapshot

Full snapshot — includes messages, managers, bots (slow, large output)

完整快照——包含消息、管理员、Bot(较慢、输出量大)

agent-channeltalk snapshot --full
agent-channeltalk snapshot --full

Filtered full snapshots

筛选后的完整快照

agent-channeltalk snapshot --full --groups-only agent-channeltalk snapshot --full --chats-only
agent-channeltalk snapshot --full --groups-only agent-channeltalk snapshot --full --chats-only

Limit messages per group/chat (only with --full)

限制每个群组/聊天的消息数量(仅适用于--full)

agent-channeltalk snapshot --full --limit 10

Default returns brief JSON with:

- Workspace metadata (id, name)
- Groups (id, name)
- UserChat summary (total count, by state)
- Hint for next commands

With `--full`, returns comprehensive JSON with:

- Workspace metadata (id, name)
- Groups with recent messages (id, name, messages)
- UserChat summary (total count, by state, recent opened)
- Managers (id, name, email)
- Bots (id, name)
agent-channeltalk snapshot --full --limit 10

默认返回包含以下内容的简略JSON:

- 工作区元数据(id、名称)
- 群组(id、名称)
- UserChat摘要(总数量、按状态分类)
- 后续命令提示

使用`--full`时,返回包含以下内容的全面JSON:

- 工作区元数据(id、名称)
- 包含最近消息的群组(id、名称、消息)
- UserChat摘要(总数量、按状态分类、最近已打开的聊天)
- 管理员(id、名称、邮箱)
- Bot(id、名称)

Output Format

输出格式

JSON (Default)

JSON(默认)

All commands output JSON by default for AI consumption:
json
{
  "id": "msg_abc123",
  "channel_id": "ch_def456",
  "chat_id": "uc_ghi789",
  "chat_type": "user-chat",
  "person_type": "manager",
  "plain_text": "Hello world",
  "created_at": 1705312200000
}
所有命令默认输出JSON格式,供AI使用:
json
{
  "id": "msg_abc123",
  "channel_id": "ch_def456",
  "chat_id": "uc_ghi789",
  "chat_type": "user-chat",
  "person_type": "manager",
  "plain_text": "Hello world",
  "created_at": 1705312200000
}

Pretty (Human-Readable)

美观格式(人类可读)

Use
--pretty
flag for formatted output:
bash
agent-channeltalk group list --pretty
使用
--pretty
标志获取格式化输出:
bash
agent-channeltalk group list --pretty

Global Options

全局选项

OptionDescription
--pretty
Human-readable output instead of JSON
--workspace <id>
Use a specific workspace for this command
选项描述
--pretty
输出人类可读格式而非JSON
--workspace <id>
此命令使用指定的工作区

Common Patterns

常见模式

See
references/common-patterns.md
for typical AI agent workflows.
请查看
references/common-patterns.md
获取典型AI Agent工作流。

Templates

模板

See
templates/
directory for runnable examples:
  • post-message.sh
    - Send messages with error handling
  • monitor-chat.sh
    - Poll for new UserChats
  • workspace-summary.sh
    - Generate workspace summary
请查看
templates/
目录获取可运行的示例:
  • post-message.sh
    - 带错误处理的消息发送脚本
  • monitor-chat.sh
    - 轮询新UserChats的脚本
  • workspace-summary.sh
    - 生成工作区摘要的脚本

Error Handling

错误处理

All commands return consistent error format:
json
{
  "error": "No credentials. Run \"agent-channeltalk auth extract\" first."
}
Common errors:
No credentials
,
Workspace not found
,
Invalid --limit value
.
所有命令返回一致的错误格式:
json
{
  "error": "No credentials. Run \"agent-channeltalk auth extract\" first."
}
常见错误:
No credentials
Workspace not found
Invalid --limit value

Configuration

配置

Credentials stored in
~/.config/agent-messenger/channel-credentials.json
(0600 permissions). See references/authentication.md for format and security details.
Config format:
json
{
  "current": { "workspace_id": "abc123" },
  "workspaces": {
    "abc123": {
      "workspace_id": "abc123",
      "workspace_name": "Acme Support",
      "account_id": "acc_001",
      "account_name": "Alice",
      "account_cookie": "...",
      "session_cookie": "..."
    }
  }
}
凭据存储在
~/.config/agent-messenger/channel-credentials.json
(权限为0600)。请查看references/authentication.md获取格式和安全细节。
配置格式:
json
{
  "current": { "workspace_id": "abc123" },
  "workspaces": {
    "abc123": {
      "workspace_id": "abc123",
      "workspace_name": "Acme Support",
      "account_id": "acc_001",
      "account_name": "Alice",
      "account_cookie": "...",
      "session_cookie": "..."
    }
  }
}

Feature Comparison: agent-channeltalk vs agent-channeltalkbot

功能对比:agent-channeltalk vs agent-channeltalkbot

Featureagent-channeltalk (user)agent-channeltalkbot (bot)
Auth methodAuto-extract cookiesAPI key + secret
Setup requiredNone (zero-config)Manual key setup
Acts asYou (manager)Bot identity
Send messages
List messages
Search messages-
Close/delete chats-
Create/delete bots-
Set default bot-
Group @name references-
Direct chat support-
Multi-workspace
CI/CD friendly-
Use agent-channeltalk when you want zero-config access acting as yourself. Use agent-channeltalkbot for server-side automation, CI/CD pipelines, or when you need bot-specific features like closing chats.
功能agent-channeltalk(用户)agent-channeltalkbot(Bot)
认证方式自动提取CookieAPI密钥+密钥
所需设置无(零配置)手动设置密钥
身份角色你自己(管理员)Bot身份
发送消息
列出消息
搜索消息-
关闭/删除聊天-
创建/删除Bot-
设置默认Bot-
群组@名称引用-
直接聊天支持-
多工作区
CI/CD友好-
当你需要零配置、以自身身份访问时,请使用agent-channeltalk。当你需要服务器端自动化、CI/CD流水线,或需要关闭聊天等Bot专属功能时,请使用agent-channeltalkbot

Limitations

限制

  • Desktop app extraction: macOS and Windows. Browser fallback: macOS, Linux, and Windows.
  • No real-time events / WebSocket connection
  • No file upload support
  • No message editing or deletion
  • No chat close/delete (use agent-channeltalkbot for chat management)
  • No bot creation/deletion (use agent-channeltalkbot for bot management)
  • No @name group references (use group IDs from
    group list
    )
  • Plain text messages only (no rich blocks in v1)
  • Cookies expire after ~30 days (auto-re-extracted)
  • 桌面应用提取:支持macOS和Windows。浏览器备选方案:支持macOS、Linux和Windows。
  • 无实时事件/WebSocket连接
  • 无文件上传支持
  • 无消息编辑或删除功能
  • 无聊天关闭/删除功能(如需聊天管理,请使用agent-channeltalkbot)
  • 无Bot创建/删除功能(如需Bot管理,请使用agent-channeltalkbot)
  • 无@名称群组引用(请使用
    group list
    获取的群组ID)
  • 仅支持纯文本消息(v1版本无富文本块)
  • Cookie约30天后过期(会自动重新提取)

Troubleshooting

故障排除

agent-channeltalk: command not found

agent-channeltalk: command not found

agent-channeltalk
is NOT the npm package name.
The npm package is
agent-messenger
.
If the package is installed globally, use
agent-channeltalk
directly:
bash
agent-channeltalk snapshot --pretty
If the package is NOT installed, run it directly with
npx -y
:
bash
npx -y agent-messenger channeltalk snapshot --pretty
Note: If the user prefers a different package runner (e.g.,
bunx
,
pnpx
,
pnpm dlx
), use that instead.
NEVER run
npx agent-channeltalk
,
bunx agent-channeltalk
, or
pnpm dlx agent-channeltalk
. It will fail or install a wrong package since
agent-channeltalk
is not the npm package name.
agent-channeltalk
不是npm包名称
。npm包名称是
agent-messenger
如果包已全局安装,可直接使用
agent-channeltalk
bash
agent-channeltalk snapshot --pretty
如果未安装包,请使用
npx -y
直接运行:
bash
npx -y agent-messenger channeltalk snapshot --pretty
注意:如果用户偏好其他包运行器(如
bunx
pnpx
pnpm dlx
),请使用对应的工具。
切勿运行
npx agent-channeltalk
bunx agent-channeltalk
pnpm dlx agent-channeltalk
。这会失败或安装错误的包,因为
agent-channeltalk
不是npm包名称。

Channel Talk desktop app not found

未找到Channel Talk桌面应用

The CLI looks for the Channel Talk desktop app's cookie database in these locations:
macOS:
  1. ~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies
    (Mac App Store version)
  2. ~/Library/Application Support/Channel Talk/Cookies
    (direct download / Electron version)
Windows:
  1. %APPDATA%\Channel Talk\Network\Cookies
If none exist, log in to Channel Talk in a supported Chromium browser (Chrome, Edge, Arc, Brave) or install the desktop app and log in.
CLI会在以下位置查找Channel Talk桌面应用的Cookie数据库:
macOS:
  1. ~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies
    (Mac App Store版本)
  2. ~/Library/Application Support/Channel Talk/Cookies
    (直接下载/Electron版本)
Windows:
  1. %APPDATA%\Channel Talk\Network\Cookies
如果这些位置都不存在,请在支持的Chromium浏览器(Chrome、Edge、Arc、Brave)中登录Channel Talk,或安装桌面应用并登录。

Cookies expired

Cookie过期

Cookies expire after roughly 30 days. The CLI automatically re-extracts on the next command. If auto-extraction fails:
  1. Open the Channel Talk desktop app or desk.channel.io in a supported Chromium browser
  2. Make sure you're logged in
  3. Run
    agent-channeltalk auth extract
For other troubleshooting, see references/authentication.md.
Cookie大约30天后过期。下次运行命令时,CLI会自动重新提取。如果自动提取失败:
  1. 打开Channel Talk桌面应用或在支持的Chromium浏览器中打开desk.channel.io
  2. 确保已登录
  3. 运行
    agent-channeltalk auth extract
其他故障排除内容,请查看references/authentication.md

References

参考资料

  • Authentication Guide
  • Common Patterns
  • 身份验证指南
  • 常见模式