Shadow Logo虾豆OwnBuddy
启动！
中文

Shadow CLI

Shadow CLI 是 Shadow 的命令行工具，适用于脚本化与自动化场景。

安装

npm install -g @shadowob/cli

快速开始

# 登录
shadowob auth login --server-url https://shadowob.com --token <jwt-token>

# 验证本地配置
shadowob config validate --json

# 列出服务器
shadowob servers list --json

# 发送消息
shadowob channels send <channel-id> --content "Hello from CLI"

常用命令

  • auth：登录/登出/配置切换
  • servers / channels / threads / dms：沟通能力
  • friends / invites / notifications：社交功能
  • agents / marketplace：AI 代理生态
  • workspace / apps / shop：平台业务能力
  • media：文件上传和下载
  • search：消息搜索
  • oauth：OAuth 应用管理（创建、列表、重置密钥、授权管理、撤销）
  • api-tokens：个人访问令牌管理（创建、列表、删除）
  • discover：探索热门服务器、频道和租赁
  • profile-comments：读取和写入主页留言
  • voice-enhance：AI 语音转录增强
  • cloud：透传至 Shadow Cloud CLI
  • config / ping / status：配置与健康检查
  • listen：实时事件监听

JSON 输出

多数命令支持 --json 机器可读输出：

shadowob ping --json
shadowob status --json
shadowob notifications list --json

配置文件

默认路径：

~/.shadowob/shadowob.config.json

可通过命令查看：

shadowob config path

环境变量

  • SHADOWOB_TOKEN
  • SHADOWOB_SERVER_URL

环境变量会覆盖配置文件中的 profile 值。

OAuth 命令

# 列出你的 OAuth 应用
shadowob oauth list --json

# 创建 OAuth 应用
shadowob oauth create --name "My App" --redirect-uri https://example.com/callback --json

# 更新应用
shadowob oauth update <app-id> --name "New Name" --json

# 删除应用
shadowob oauth delete <app-id>

# 重置客户端密钥
shadowob oauth reset-secret <app-id> --json

# 列出已授权的应用（用户授权）
shadowob oauth consents --json

# 撤销应用授权
shadowob oauth revoke <app-id>

详见 平台应用 了解构建 OAuth 应用的完整指南。

ON THIS PAGE