agent-channeltalk
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAgent 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 format:
blocks. The CLI handles this automatically when you pass plain text.[{ type: "text", value: "..." }]
开始使用前,先了解Channel Talk的几个术语:
- Channel = 工作区(并非Slack那样的聊天频道)。API中称其为"channel",但实际指的是你的整个工作区。
- UserChats = 与终端用户(客户)的一对一对话。
- Groups = 团队收件箱频道(类似Slack频道),通过ID引用。
- DirectChats = 管理员之间的直接消息。
- Managers = 团队中的人工客服。
- Bots = 工作区中的自动化Agent。
- Messages 使用格式:
blocks。当你传入纯文本时,CLI会自动处理这种格式。[{ type: "text", value: "..." }]
Quick Start
快速开始
bash
undefinedbash
undefinedGet 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
undefinedagent-channeltalk chat list
undefinedAuthentication
身份验证
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:
- (JWT) - your account identity
x-account - (JWT) - your session token
ch-session-1
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 to obtain credentials. The CLI extracts from the desktop app first, falling back to Chromium browsers if the app isn't installed.
agent-channeltalk auth extract首次使用时,凭据会自动从Channel Talk桌面应用(或备选的Chromium浏览器)中提取。无需手动设置,无需API密钥。只需运行任意命令,身份验证会在后台静默完成。
Channel Talk桌面应用将认证Cookie存储在SQLite数据库中。在macOS上,Cookie是明文存储的,无需Keychain提示。在Windows上,Cookie采用DPAPI加密,会自动解密。当备选使用macOS上的Chromium浏览器时,Cookie需要Keychain解密。CLI会读取两个Cookie:
- (JWT)- 你的账户身份标识
x-account - (JWT)- 你的会话令牌
ch-session-1
这些Cookie大约30天后过期。过期后,下次运行命令时,CLI会自动从桌面应用或浏览器中重新提取新的Cookie。
重要提示:请始终使用来获取凭据。CLI首先从桌面应用提取,如果未安装应用,则备选从Chromium浏览器提取。
agent-channeltalk auth extractMulti-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
undefinedList 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>
undefinedagent-channeltalk auth remove <workspace-id>
undefinedMemory
记忆功能
The agent maintains a file as persistent memory across sessions. This is agent-managed, the CLI does not read or write this file. Use the and tools to manage your memory file.
~/.config/agent-messenger/MEMORY.mdReadWriteAgent会在文件中保存跨会话的持久化记忆。该文件由Agent管理,CLI不会读取或写入它。请使用和工具来管理你的记忆文件。
~/.config/agent-messenger/MEMORY.mdReadWriteReading Memory
读取记忆
At the start of every task, read using the tool to load any previously discovered workspace IDs, group IDs, chat IDs, manager IDs, and preferences.
~/.config/agent-messenger/MEMORY.mdRead- 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.
在每个任务开始时,使用工具读取,加载之前发现的工作区ID、群组ID、聊天ID、管理员ID和偏好设置。
Read~/.config/agent-messenger/MEMORY.md- 如果文件尚未存在,无需担心。继续操作即可,当你有有用信息需要存储时再创建它。
- 如果无法读取文件(权限问题、目录缺失),无需报错,继续无记忆操作。
Writing Memory
写入记忆
After discovering useful information, update using the tool. Write triggers include:
~/.config/agent-messenger/MEMORY.mdWrite- After discovering workspace IDs and names (from ,
auth list, etc.)snapshot - After discovering group IDs and names (from ,
group list, etc.)snapshot - After discovering chat IDs (from , etc.)
chat list - After discovering manager IDs and names (from , etc.)
manager list - After discovering bot names (from , etc.)
bot list - 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 tool overwrites the entire file.
Write发现有用信息后,使用工具更新。触发写入的场景包括:
Write~/.config/agent-messenger/MEMORY.md- 发现工作区ID和名称后(来自、
auth list等命令)snapshot - 发现群组ID和名称后(来自、
group list等命令)snapshot - 发现聊天ID后(来自等命令)
chat list - 发现管理员ID和名称后(来自等命令)
manager list - 发现Bot名称后(来自等命令)
bot list - 用户给出别名或偏好设置后(比如“将这个称为支持工作区”、“我的主要群组是X”)
写入时,请包含完整的文件内容。工具会覆盖整个文件。
WriteWhat 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 . Don't blindly trust memorized data. Verify when something seems off. Prefer re-listing over using a memorized ID that might be stale.
MEMORY.md如果记忆中的ID返回错误(聊天未找到、群组未找到),请从中删除该ID。不要盲目信任记忆中的数据。当出现异常时请验证信息。优先重新列出数据,而非使用可能过期的记忆ID。
MEMORY.mdFormat / Example
格式/示例
markdown
undefinedmarkdown
undefinedAgent Messenger Memory
Agent Messenger Memory
Channel Talk Workspaces
Channel Talk Workspaces
- - Acme Support
abc123
- - Acme Support
abc123
Groups (Acme Support)
Groups (Acme Support)
- - Support Inbox
grp_111 - - Billing Inbox
grp_222 - - Engineering
grp_333
- - Support Inbox
grp_111 - - Billing Inbox
grp_222 - - Engineering
grp_333
Recent UserChats (Acme Support)
Recent UserChats (Acme Support)
- - John Doe inquiry (opened)
uc_aaa - - Refund request (closed)
uc_bbb
- - John Doe inquiry (opened)
uc_aaa - - Refund request (closed)
uc_bbb
Managers (Acme Support)
Managers (Acme Support)
- - Alice (Team Lead)
mgr_001 - - Bob (Support Agent)
mgr_002
- - Alice (Team Lead)
mgr_001 - - Bob (Support Agent)
mgr_002
Bots (Acme Support)
Bots (Acme Support)
- - Support Bot
bot_001 - - Notification Bot
bot_002
- - Support Bot
bot_001 - - Notification Bot
bot_002
Aliases
Aliases
- "support" -> (Support Inbox in Acme Support)
grp_111
- "support" -> (Support Inbox in Acme Support)
grp_111
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
undefinedbash
undefinedExtract 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>
undefinedagent-channeltalk auth remove <workspace-id>
undefinedWhoami Command
Whoami命令
bash
undefinedbash
undefinedShow 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
undefinedbash
undefinedSend 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
undefinedagent-channeltalk message search <query>
agent-channeltalk message search "deployment" --scope team-chat
agent-channeltalk message search "refund" --scope user-chat --limit 10
undefinedChat Commands (UserChats)
聊天命令(UserChats)
bash
undefinedbash
undefinedList 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>
undefinedagent-channeltalk chat get <chat-id>
undefinedGroup Commands
群组命令
bash
undefinedbash
undefinedList 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
undefinedagent-channeltalk group messages <group-id>
agent-channeltalk group messages grp_abc123 --limit 50 --sort asc
undefinedManager Commands
管理员命令
bash
undefinedbash
undefinedList all managers
列出所有管理员
agent-channeltalk manager list
agent-channeltalk manager list --limit 50
undefinedagent-channeltalk manager list
agent-channeltalk manager list --limit 50
undefinedBot Commands
Bot命令
bash
undefinedbash
undefinedList all bots
列出所有Bot
agent-channeltalk bot list
agent-channeltalk bot list --limit 50
undefinedagent-channeltalk bot list
agent-channeltalk bot list --limit 50
undefinedSnapshot Command
快照命令
Get workspace overview for AI agents (brief by default):
bash
undefined为AI Agent获取工作区概览(默认简略版):
bash
undefinedBrief 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 flag for formatted output:
--prettybash
agent-channeltalk group list --pretty使用标志获取格式化输出:
--prettybash
agent-channeltalk group list --prettyGlobal Options
全局选项
| Option | Description |
|---|---|
| Human-readable output instead of JSON |
| Use a specific workspace for this command |
| 选项 | 描述 |
|---|---|
| 输出人类可读格式而非JSON |
| 此命令使用指定的工作区 |
Common Patterns
常见模式
See for typical AI agent workflows.
references/common-patterns.md请查看获取典型AI Agent工作流。
references/common-patterns.mdTemplates
模板
See directory for runnable examples:
templates/- - Send messages with error handling
post-message.sh - - Poll for new UserChats
monitor-chat.sh - - Generate workspace summary
workspace-summary.sh
请查看目录获取可运行的示例:
templates/- - 带错误处理的消息发送脚本
post-message.sh - - 轮询新UserChats的脚本
monitor-chat.sh - - 生成工作区摘要的脚本
workspace-summary.sh
Error Handling
错误处理
All commands return consistent error format:
json
{
"error": "No credentials. Run \"agent-channeltalk auth extract\" first."
}Common errors: , , .
No credentialsWorkspace not foundInvalid --limit value所有命令返回一致的错误格式:
json
{
"error": "No credentials. Run \"agent-channeltalk auth extract\" first."
}常见错误:、、。
No credentialsWorkspace not foundInvalid --limit valueConfiguration
配置
Credentials stored in (0600 permissions). See references/authentication.md for format and security details.
~/.config/agent-messenger/channel-credentials.jsonConfig 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": "..."
}
}
}凭据存储在(权限为0600)。请查看references/authentication.md获取格式和安全细节。
~/.config/agent-messenger/channel-credentials.json配置格式:
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
| Feature | agent-channeltalk (user) | agent-channeltalkbot (bot) |
|---|---|---|
| Auth method | Auto-extract cookies | API key + secret |
| Setup required | None (zero-config) | Manual key setup |
| Acts as | You (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) |
|---|---|---|
| 认证方式 | 自动提取Cookie | API密钥+密钥 |
| 所需设置 | 无(零配置) | 手动设置密钥 |
| 身份角色 | 你自己(管理员) | 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)
- 无@名称群组引用(请使用获取的群组ID)
group list - 仅支持纯文本消息(v1版本无富文本块)
- Cookie约30天后过期(会自动重新提取)
Troubleshooting
故障排除
agent-channeltalk: command not found
agent-channeltalk: command not foundagent-channeltalk: command not found
agent-channeltalk: command not foundagent-channeltalkagent-messengerIf the package is installed globally, use directly:
agent-channeltalkbash
agent-channeltalk snapshot --prettyIf the package is NOT installed, run it directly with :
npx -ybash
npx -y agent-messenger channeltalk snapshot --prettyNote: If the user prefers a different package runner (e.g.,,bunx,pnpx), use that instead.pnpm dlx
NEVER run , , or . It will fail or install a wrong package since is not the npm package name.
npx agent-channeltalkbunx agent-channeltalkpnpm dlx agent-channeltalkagent-channeltalkagent-channeltalkagent-messenger如果包已全局安装,可直接使用:
agent-channeltalkbash
agent-channeltalk snapshot --pretty如果未安装包,请使用直接运行:
npx -ybash
npx -y agent-messenger channeltalk snapshot --pretty注意:如果用户偏好其他包运行器(如、bunx、pnpx),请使用对应的工具。pnpm dlx
切勿运行、或。这会失败或安装错误的包,因为不是npm包名称。
npx agent-channeltalkbunx agent-channeltalkpnpm dlx agent-channeltalkagent-channeltalkChannel Talk desktop app not found
未找到Channel Talk桌面应用
The CLI looks for the Channel Talk desktop app's cookie database in these locations:
macOS:
- (Mac App Store version)
~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies - (direct download / Electron version)
~/Library/Application Support/Channel Talk/Cookies
Windows:
%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:
- (Mac App Store版本)
~/Library/Containers/com.zoyi.channel.desk.osx/Data/Library/Application Support/Channel Talk/Cookies - (直接下载/Electron版本)
~/Library/Application Support/Channel Talk/Cookies
Windows:
%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:
- Open the Channel Talk desktop app or desk.channel.io in a supported Chromium browser
- Make sure you're logged in
- Run
agent-channeltalk auth extract
For other troubleshooting, see references/authentication.md.
Cookie大约30天后过期。下次运行命令时,CLI会自动重新提取。如果自动提取失败:
- 打开Channel Talk桌面应用或在支持的Chromium浏览器中打开desk.channel.io
- 确保已登录
- 运行
agent-channeltalk auth extract
其他故障排除内容,请查看references/authentication.md。
References
参考资料
- Authentication Guide
- Common Patterns
- 身份验证指南
- 常见模式