常见问题

# 使用 cargo 安装
cargo install --git https://github.com/librefang/librefang librefang-cli

# 或从源码构建
git clone https://github.com/librefang/librefang.git
cd librefang
cargo install --path crates/librefang-cli

# 选项 1: Anthropic (推荐)
export ANTHROPIC_API_KEY="sk-ant-..."

# 选项 2: OpenAI
export OPENAI_API_KEY="sk-..."

# 选项 3: Groq (有免费额度)
export GROQ_API_KEY="gsk_..."

# 实时日志
librefang logs

# 或手动查看
tail -f ~/.librefang/logs/librefang.log

# 调试模式
RUST_LOG=debug librefang start

# 使用模板创建
librefang agent spawn agents/hello-world/agent.toml

# 或交互式创建
librefang agent new

[capabilities]
tools = ["file_read", "web_fetch"]  # 只允许这些工具
network = ["example.com"]  # 只允许访问这个域名
memory_read = ["self.*"]  # 只允许读取自己的记忆
memory_write = ["self.*"]  # 只允许写入自己的记忆
agent_spawn = false  # 禁止生成子 Agent

{
  "name": "multi-agent",
  "steps": [
    {"agent": "researcher", "input": "Research topic"},
    {"agent": "writer", "input": "Write about {{research.results}}"}
  ]
}

# 从本地安装
librefang skill install ./my-skill

# 从 FangHub 安装
librefang skill install fanghub:skill-name

def my_tool(param: str) -> str:
    """工具描述"""
    return f"Result: {param}"

[telegram]
bot_token_env = "TELEGRAM_BOT_TOKEN"
allowed_users = ["user_id_1", "user_id_2"]

[[mcp_servers]]
name = "filesystem"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]

api_key = "your-secure-api-key"

Authorization: Bearer your-secure-api-key

[capabilities]
tools = ["file_read"]  # 只读文件
file_system = false  # 禁止写入
agent_spawn = false  # 禁止生成子 Agent

[compaction]
threshold = 80
keep_recent = 20
max_summary_tokens = 1024

# 查看使用统计
librefang usage

# 查看成本
librefang cost

# API 端点
curl http://127.0.0.1:4200/api/usage

# 检查端口是否被占用
lsof -i :4200

# 查看详细错误
RUST_LOG=debug librefang start

# 运行诊断
librefang doctor

# 测试通道
librefang channel test telegram

# 检查 Bot Token
curl -X POST "https://api.telegram.org/bot<TOKEN>/getMe"

# 列出技能
librefang skill list

# 验证技能
librefang skill verify my-skill

# 查看错误日志
RUST_LOG=debug librefang skill list

# 自动迁移
librefang migrate --from openclaw

# 预览模式
librefang migrate --from openclaw --dry-run

# 查看成本
librefang cost

# 按提供商查看
curl http://127.0.0.1:4200/api/usage/providers

[budget]
monthly_limit = 100  # 美元
alert_threshold = 0.8  # 80% 时告警